RosettaNet では PIP を随時追加しているため、これらの新しい PIP をサポートできるように、または PIP のアップグレードをサポートできるように、独自の PIP パッケージを作成しなければならない場合があります。特に明記されていない限り、このセクションでは、PIP 5C4 V01.03.00 の PIP 文書フロー・パッケージの作成手順について説明します。WebSphere Partner Gateway が提供しているのは 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 行目で定義されています。
150 行目の ContactInformation 定義には、次のカーディナリティーを持つ 4 つの子エレメントが含まれます。
ただし、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"
図 35 は、変更前の productProviderFieldApplicationEngineer エレメントを示しています。
<xsd:element name="productProviderFieldApplicationEngineer">
<xsd:complexType>
<xsd:sequence>
<xsd:element ref="ContactInformation"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
図 36 は、変更後の 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 メッセージの GlobalRegistrationComplexityLevelCode では、「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"
図 37 は、変更前の 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>
図 38 は、変更後の 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"
図 39 は、変更前の beginDate エレメントを示しています。
<xsd:element name="beginDate">
<xsd:complexType">
<xsd:sequence>
<xsd:element ref="DateStamp"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
図 40 は、変更後の 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_Package_RNIFV02.00_5C4V01.03.zip および BCG_Package_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_5C4RegistrationStatus
Notification_V01.02 |
BCG_5C4RegistrationStatus
Notification_V01.03 |
ファイル拡張子を含まない確認メッセージ XSD ファイルの名前 (2 アクション PIP の場合のみ) | なし | なし |
要求メッセージに対する XSD ファイルのルート・エレメント名 | Pip5C4RegistrationStatus
Notification |
Pip5C4RegistrationStatus
Notification |
確認メッセージに対する XSD ファイルのルート・エレメント名 (2 アクション PIP の場合のみ) | なし | なし |
更新する情報 | 説明 | 5C4 パッケージの値 |
---|---|---|
アクティビティー名 | 表 3-2 で指定 | 配布登録状況 |
イニシエーターの役割名 | 表 3-1 で指定 | 製品プロバイダー |
応答者の役割名 | 表 3-1 で指定 | 要求作成者 |
要求アクション名 | 表 4-2 で指定 | 登録状況通知 |
確認アクション名 | 表 4-2 で指定 (2 アクション PIP の場合のみ) | なし |
更新する情報 | 説明 | 5C4 パッケージの値 | XML ファイルのエレメント・パス |
---|---|---|---|
NonRepudiation
Required |
表 3-3 で指定 | N | ns1:Package
ns1:Protocol ns1:Process ns1:Attribute (ATTRIBUTEKEY は NonRepudiationRequired) ns1:AttributeValue AttributePickListItem ATTRVALUEKEY |
NonRepudiationOf
Receipt |
表 3-3 で指定 | N | ns1:Package
ns1:Protocol ns1:Process ns1:Attribute (ATTRIBUTEKEY は NonRepudiationOfReceipt) ns1:AttributeValue AttributePickListItem ATTRVALUEKEY |
DigitalSignature
Required |
表 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 |
バックエンド統合パッケージを作成するには、次の手順を除いて、ステップ 1 から 6 までを繰り返します。
XML および XSD ファイルを作成すると、PIP 文書フロー・パッケージを作成できるようになります。
RNIF パッケージを作成するには、以下のステップを実行します。
バックエンド統合パッケージを作成するには、RNIF ファイルの代わりにバックエンド統合 XML ファイルを使用して、ステップ 1 から 3 までを繰り返します。
PIP パッケージを作成すると、RNIF および PIP の文書フロー・パッケージの手順を使用して、PIP パッケージをアップロードできるようになります。