RosettaNet では PIP を随時追加しているため、これらの新しい PIP をサポートできるように、または PIP のアップグレードをサポートできるように、独自の PIP パッケージを作成しなければならない場合があります。特に明記されていない限り、このセクションでは、PIP 5C4 V01.03.00 の PIP 文書フロー・パッケージの作成手順について説明します。Business Integration Connect が提供しているのは PIP 5C4 V01.02.00 の PIP 文書フロー・パッケージであるため、実際にはアップグレード方法について説明しています。ただし、PIP 文書フロー・パッケージの作成手順は同様であり、追加ステップについては手順内で示しています。
始める前に、www.rosettanet.org から新しいバージョンの PIP 仕様をダウンロードします。アップグレードを実行する場合は、古いバージョンもダウンロードします。例えば、この手順に記載されたアップグレードを実行する場合は、5C4_DistributeRegistrationStatus_V01_03_00.zip および 5C4_DistributeRegistrationStatus_V01_02_00.zip をダウンロードします。仕様には次のファイル・タイプが含まれます。
PIP 文書フロー・パッケージを作成またはアップグレードする手順では、以下の作業を行います。
PIP 文書フロー・パッケージには、メッセージ・フォーマットおよびエレメントの許容値を定義する XML スキーマ・ファイルが含まれます。次の手順では、PIP 仕様ファイルの内容に基づいてこれらのファイルを作成する方法について説明します。
PIP 仕様ファイル内の DTD ファイルごとに、XSD ファイルを少なくとも 1 つ作成します。PIP 5C4 V01.03.00 ではメッセージ・フォーマットが変更されているため、このバージョンにアップグレードする例では、BCG_5C4RegistrationStatusNotification_V01.03.xsd ファイルの作成方法を例として示します。XSD ファイルの詳細については、検証の概要を参照してください。
PIP 文書フロー・パッケージの XSD ファイルを作成するには、以下の手順を実行します。
一般に、ガイドライン内のエレメントは、DTD ファイル内のエレメントの定義と一致します。ただし、ガイドラインには、名前が同じであってもカーディナリティーが異なるエレメントが含まれる場合があります。この場合、DTD はカーディナリティーを提供できないため、XSD を変更する必要があります。例えば、5C4_MG_V01_03_00_RegistrationStatusNotification.htm ガイドライン・ファイルでは、次のカーディナリティーを持つ 5 つの子エレメントを含む ContactInformation が 15 行目で定義されています。
1 contactName
0..1 EmailAddress
0..1 facsimileNumber
0..1 PhysicalLocation
0..1 telephoneNumber
150 行目の ContactInformation 定義には、次のカーディナリティーを持つ 4 つの子エレメントが含まれます。
1 contactName
1 EmailAddress
0..1 facsimileNumber
1 telephoneNumber
ただし、XSD ファイルの ContactInformation のそれぞれの子には、両方の定義に適合するカーディナリティーが 1 つ含まれます。
<xsd:element name="ContactInformation"> <xsd:complexType> <xsd:sequence> <xsd:element ref="contactName"/> <xsd:element maxOccurs="1" minOccurs="0" ref="EmailAddress"/> <xsd:element maxOccurs="1" minOccurs="0" ref="facsimileNumber"/> <xsd:element maxOccurs="1" minOccurs="0" ref="PhysicalLocation"/> <xsd:element maxOccurs="1" minOccurs="0" ref="telephoneNumber"/> </xsd:sequence> </xsd:complexType> </xsd:element>
別のバージョンのパッケージに基づいて PIP 文書フロー・パッケージを更新し、別のバージョンの定義を再利用する場合は、各定義に対して以下の手順を実行します。
<xsd:complexType name="ContactInformation_type7"> <xsd:sequence> <xsd:element name="contactName" type="common_FreeFormText_R"/> <xsd:element name="EmailAddress" type="common_EmailAddres_R" minOccurs="0"/> <xsd:element name="facsimileNumber" type="common_CommunicationsNumber_R" minOccurs="0"/> <xsd:element name="PhysicalLocation" type="PhysicalLocation_type1" minOccurs="0" /> <xsd:element name="telephoneNumber" type="common_CommunicationsNumber_R minOccurs="0" /> </xsd:sequence> </xsd:complexType>
<xsd:include schemaLocation="BCG_ContactInformation_Types.xsd"/>
name="ContactInformation type="ContactInformation_type7"
PIP 文書フロー・パッケージを作成する場合、または PIP 文書フロー・パッケージをアップグレードする際に、使用する定義が別のバージョン内に存在しない場合は、ガイドライン内のエレメントのインスタンスごとに以下の手順を実行します。
<xsd:complexType name="ContactInformation_localType1"> <xsd:sequence> <xsd:element ref="contactName"/> <xsd:element maxOccurs="1" minOccurs="0" ref="EmailAddress"/> <xsd:element maxOccurs="1" minOccurs="0" ref="facsimileNumber"/> <xsd:element maxOccurs="1" minOccurs="0" ref="PhysicalLocation"/> <xsd:element maxOccurs="1" minOccurs="0" ref="telephoneNumber"/> </xsd:sequence> </xsd:complexType>
name="ContactInformation type="ContactInformation_localType1"
変更前の productProviderFieldApplicationEngineer エレメント:
<xsd:element name="productProviderFieldApplicationEngineer"> <xsd:complexType> <xsd:sequence> <xsd:element ref="ContactInformation"/> </xsd:sequence> </xsd:complexType> </xsd:element>
変更後の productProviderFieldApplicationEngineer エレメント:
<xsd:element name="productProviderFieldApplicationEngineer"> <xsd:complexType> <xsd:sequence> <xsd:element name="ContactInformation" type="ContactInformation_localType1"/> </xsd:sequence> </xsd:complexType> </xsd:element>
したがって、PIP 5C4 V01.03.00 メッセージの GlobalRegistrationComplexityLegelCode では、「Above average」、「Average」、「Maximum」、「Minimum」、「None」、および「Some」の値のみが有効です。
別のバージョンのパッケージに基づいて PIP 文書フロー・パッケージを更新し、別のバージョンの列挙値セットを再利用する場合は、セットごとに以下の手順を実行します。
<xsd:simpleType name="_GlobalRegistrationComplexityLevelCode"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="Above average"/> <xsd:enumeration value="Average"/> <xsd:enumeration value="Maximum"/> <xsd:enumeration value="Minimum"/> <xsd:enumeration value="None"/> <xsd:enumeration value="Some"/> </xsd:restriction> </xsd:simpleType>
<xsd:include schemaLocation= "BCG_GlobalRegistrationComplexityLevelCode_Types.xsd" />
name="GlobalRegistrationComplexityLevelCode" type="_GlobalRegistrationComplexityLevelCode"
PIP 文書フロー・パッケージを作成する場合、または PIP 文書フロー・パッケージをアップグレードする際に、必要な列挙値の定義が別のバージョン内に存在しない場合は、ガイドライン内の列挙値を持つすべてのエレメントに対して以下の手順を実行します。
<xsd:simpleType name="GlobalRegistrationComplexityLevelCode_localType"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="Above average"/> <xsd:enumeration value="Average"/> <xsd:enumeration value="Maximum"/> <xsd:enumeration value="Minimum"/> <xsd:enumeration value="None"/> <xsd:enumeration value="Some"/> </xsd:restriction> </xsd:simpleType>
name="GlobalRegistrationComplexityLevelCode" type="GlobalRegistrationComplexityLevelCode_localType"
変更前の DesignAssemblyInformation エレメント:
<xsd:element name="DesignAssemblyInformation"> <xsd:complexType> <xsd:sequence> <xsd:element maxOccurs="1" minOccurs="0" ref="assemblyComments"/> <xsd:element maxOccurs="1" minOccurs="0" ref="demandCreatorTrackingIdentifier"/> <xsd:element maxOccurs="unbounded" minOccurs="0" ref="DesignPartInformation"/> <xsd:element ref="DesignRegistrationIdentification"/> <xsd:element maxOccurs="1" minOccurs="0" ref="GeographicRegion"/> <xsd:element maxOccurs="1" minOccurs="0" ref="GlobalRegistrationComplexityLevelCode"/> <xsd:element maxOccurs="1" minOccurs="0" ref="GlobalRegistrationInvolvementLevelCode"/> <xsd:element maxOccurs="1" minOccurs="0" ref="RegistrationStatus"/> </xsd:sequence> </xsd:complexType> </xsd:element>
変更後の DesignAssemblyInformation エレメント:
<xsd:element name="DesignAssemblyInformation"> <xsd:complexType> <xsd:sequence> <xsd:element maxOccurs="1" minOccurs="0" ref="assemblyComments"/> <xsd:element maxOccurs="1" minOccurs="0" ref="demandCreatorTrackingIdentifier"/> <xsd:element maxOccurs="unbounded" minOccurs="0" ref="DesignPartInformation"/> <xsd:element ref="DesignRegistrationIdentification"/> <xsd:element maxOccurs="1" minOccurs="0" ref="GeographicRegion"/> <xsd:element maxOccurs="1" minOccurs="0" name="GlobalRegistrationComplexityLevelCode" type="GlobalRegistrationComplexityLevelCode_localType"/> <xsd:element maxOccurs="1" minOccurs="0" ref="GlobalRegistrationInvolvementLevelCode"/> <xsd:element maxOccurs="1" minOccurs="0" ref="RegistrationStatus"/> </xsd:sequence> </xsd:complexType> </xsd:element>
別のバージョンのパッケージに基づいて PIP 文書フロー・パッケージを更新し、別のバージョンのデータ・エンティティー定義を再利用する場合は、セットごとに以下の手順を実行します。
<xsd:simpleType name="_common_DateStamp_R"> <xsd:restriction base="xsd:string"> <xsd:pattern value="[0-9]{8}Z" /> </xsd:restriction> </xsd:simpleType>
<xsd:include schemaLocation="BCG_common.xsd" />
name="DateStamp" type="_common_DateStamp_R"
PIP 文書フロー・パッケージを作成する場合、または PIP 文書フロー・パッケージをアップグレードする際に、必要なデータ・エンティティー定義が別のバージョン内に存在しない場合は、データ・エンティティー・エレメントごとに以下の手順を実行します。
<xsd:simpleType name="DateStamp_localType"> <xsd:restriction base="xsd:string"> <xsd:pattern value="[0-9]{8}Z" /> </xsd:restriction> </xsd:simpleType>
name="DateStamp" type="DateStamp_localType"
変更前の beginDate エレメント:
<xsd:element name="beginDate"> <xsd:complexType"> <xsd:sequence> <xsd:element ref="DateStamp"/> </xsd:sequence> </xsd:complexType> </xsd:element>
変更後 beginDate エレメント:
<xsd:element name="beginDate"> <xsd:complexType"> <xsd:sequence> <xsd:element name="DateStamp" type="DateStamp_localType"/> </xsd:sequence> </xsd:complexType> </xsd:element>
PIP 文書フロー・パッケージ用の XSD ファイルを作成すると、RNIF パッケージ用の XML ファイル、およびバックエンド統合パッケージ用の XML ファイルを作成できるようになります。例えば、BCG_RNIFV02.00_5C4V01.03.zip および BCG_RNSC1.0_RNIFV02.00_5C4V01.03.zip というパッケージをそれぞれ作成できます。以下に、RNIF パッケージ用の XML ファイルを作成する手順を示します。
変更する情報 | 古い値 | 新しい値 |
PIP ID
|
5C4
|
5C4
|
PIP のバージョン
|
V01.02
|
V01.03
|
ファイル拡張子を含まない要求メッセージ DTD ファイルの名前
|
5C4_MS_V01_02_
RegistrationStatusNotification
|
5C4_MS_V01_03_
RegistrationStatusNotification
|
ファイル拡張子を含まない確認メッセージ DTD ファイルの名前 (2 アクション PIP の場合のみ)
|
なし
|
なし
|
ファイル拡張子を含まない要求メッセージ XSD ファイルの名前
|
BCG_5C4RegistrationStatusNotification_
V01.02
|
BCG_5C4RegistrationStatusNotification_
V01.03
|
ファイル拡張子を含まない確認メッセージ XSD ファイルの名前 (2 アクション PIP の場合のみ)
|
なし
|
なし
|
要求メッセージに対する XSD ファイルのルート・エレメント名
|
Pip5C4RegistrationStatusNotification
|
Pip5C4RegistrationStatusNotification
|
確認メッセージに対する XSD ファイルのルート・エレメント名 (2 アクション PIP の場合のみ)
|
なし
|
なし
|
更新する情報 | 説明 | 5C4 パッケージの値 |
アクティビティー名
|
表 3-2 で指定
|
配布登録状況
|
イニシエーターの役割名
|
表 3-1 で指定
|
製品プロバイダー
|
応答者の役割名
|
表 3-1 で指定
|
要求作成者
|
要求アクション名
|
表 4-2 で指定
|
登録状況通知
|
確認アクション名
|
表 4-2 で指定 (2 アクション PIP の場合のみ)
|
なし
|
更新する情報 | 説明 | 5C4 パッケージの値 | XML ファイルのエレメント・パス |
NonRepudiationRequired
|
表 3-3 で指定
|
N
|
ns1:Package
ns1:Protocol
ns1:Process
ns1:Attribute (ATTRIBUTEKEY は NonRepudiationRequired)
ns1:AttributeValue
AttributePickListItem
ATTRVALUEKEY
|
NonRepudiationOfReceipt
|
表 3-3 で指定
|
N
|
ns1:Package
ns1:Protocol
ns1:Process
ns1:Attribute (ATTRIBUTEKEY は NonRepudiationOfReceipt)
ns1:AttributeValue
AttributePickListItem
ATTRVALUEKEY
|
DigitalSignatureRequired
|
表 5-1 で指定
|
Y
|
ns1:Package
ns1:Protocol
ns1:Process
ns1:Attribute (ATTRIBUTEKEY は DigitalSignatureRequired)
ns1:AttributeValue
AttributePickListItem
ATTRVALUEKEY
|
TimeToAcknowledge
|
表 3-3 で指定
|
2
(120 分)
|
ns1:Package
ns1:Protocol
ns1:Process
ns1:Attribute (ATTRIBUTEKEY は TimeToAcknowledge)
ns1:AttributeValue
ATTRVALUE
|
TimeToPerform
|
表 3-3 で指定
|
2
(120 分)
|
ns1:Package
ns1:Protocol
ns1:Process
ns1:Attribute (ATTRIBUTEKEY は TimeToPerform)
ns1:AttributeValue
ATTRVALUE
|
RetryCount
|
表 3-3 で指定
|
3
|
ns1:Package
ns1:Protocol
ns1:Process
ns1:Attribute (ATTRIBUTEKEY は RetryCount)
ns1:AttributeValue
ATTRVALUE
|
バックエンド統合パッケージを作成するには、次の点を除いて、上記手順を繰り返します。
XML および XSD ファイルを作成すると、PIP 文書フロー・パッケージを作成できるようになります。
RNIF パッケージを作成するには、以下の手順を実行します。
バックエンド統合パッケージを作成するには、RNIF ファイルの代わりにバックエンド統合 XML フィルを使用して、上記の手順を実行します。
PIP パッケージを作成すると、RNIF パッケージのアップロード手順に従って、PIP パッケージをアップロードできまるようになります。