# mulesoft Rosettanet Connector - Full Documentation # RosettaNet Connector サポートカテゴリ: Premium RosettaNet Connector は、RosettaNet Information Framework (RNIF) を使用して Rosetta Partner Interface Process (PIP) メッセージを交換することで、B2B 機能を提供します。 RosettaNet Connector は RNIF 2.00.01 をサポートします。 次の PIP がサポートされています。
PIP バージョン 目的

0A1

v02.00

失敗の通知

3A4

3A4MG1 v02.02

注文の要求

3A4

3A4MG2 v02.02

注文の要求

3A6

3A6MG1 v02.00, v02.02, v02.03

注文状況の配布

3B2

3B2MG1 v01.00

事前出荷通知

3C3

3C3MG1 v01.00, v01.11

請求通知
RosettaNet Connector は常にすべての失敗の通知メッセージで PIP 0A1 v02.00 を使用します。 **注意:**​ サンプルファイルのダウンロードについては、​[\[See Also\]](<#See Also>)​ を参照してください。 ## [](#始める前に)始める前に このドキュメントでは、読者が RosettaNet、Mule、Anypoint Connector、Anypoint Studio、Mule フロー、および Mule グローバル要素に精通していることを前提としています。 互換性については、​[RosettaNet のリリースノート](https://docs.mulesoft.com/jp/release-notes/connector/rosettanet-connector-release-notes-mule-4)​を参照してください。 RosettaNet Connector を本番環境で使用するには、Anypoint B2B 用の MuleSoft ライセンスを購入しておく必要があります。 ## [](#このコネクタの新機能)このコネクタの新機能 Mule 4 の RosettaNet Connector 2.x では、RosettaNet Connector 1.x の実装から設定や処理が少し変更されています。 - ソースのメタデータを自動的に供給 (1.x で必要だった個別のメタデータ定義は不要) - パートナーやメッセージごとに個別のフローを使用することでフロー構造を簡素化。 ## [](#anypoint-studio-7-でこのコネクタをインストールする)Anypoint Studio 7 でこのコネクタをインストールする 1. Studio で Mule プロジェクトを作成します。 2. Studio タスクバーの Exchange ​**(X)**​ アイコンをクリックします。 3. Exchange で、​**\[Login (ログイン)\]**​ をクリックし、Anypoint Platform のユーザー名とパスワードを指定します。 4. Exchange で ​**\[All assets (すべてのアセット)\]**​ を選択して「RosettaNet」を検索します。 5. 「RosettaNet」を選択して ​**\[Add to project (プロジェクトに追加)\]**​ をクリックします。 6. 画面の指示に従ってコネクタをインストールします。 ## [](#anypoint-studio-7-で-mule-プロジェクトを作成する)Anypoint Studio 7 で Mule プロジェクトを作成する コネクタをインストールしたら、すぐに使い始めることができます。まず、Mule とメッセージの交換に使用するパートナーエンドポイント用の HTTP リスナーと HTTP 要求を作成します。 1. キャンバスの下部にある \[Global Elements (グローバル要素)\] タブをクリックし、​**\[Create (作成)\]**​ をクリックします。 2. \[Connector Configuration (コネクタ設定)\] で \[HTTP Listener config (HTTP リスナー設定)\] を選択して ​**\[OK\]**​ をクリックします。 3. 設定の定義で、取引パートナーからのアクションやシグナルメッセージを受信するための​**ホスト**​と​**ポート**​を入力して ​**\[OK\]**​ をクリックします。 4. \[Global Elements (グローバル要素)\] タブで再び ​**\[Create (作成)\]**​ をクリックします。 5. **\[Connector Configuration (コネクタ設定)\]**​ で \[HTTP Request config (HTTP 要求設定)\] を選択して ​**\[OK\]**​ をクリックします。 6. 設定の定義で、取引パートナーにアクションやシグナルメッセージを送信するためのホストとポートを入力して ​**\[OK\]**​ をクリックします。 7. キャンバスの下部にある ​**\[Global Elements (グローバル要素)\]**​ タブをクリックし、​**\[Create (作成)\]**​ をクリックします。 8. **\[Connector Configuration (コネクタ設定)\]**​ で ​**\[RosettaNet Config (RosettaNet 設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。 9. 作成してあるグローバル HTTP リスナーとグローバル HTTP 要求の定義への参照情報を入力し、エンドポイントパス、セルフ/パートナー ID 情報、PIP ロールおよび定義パスを指定します (用意されている標準 PIP 定義を使用する場合は、​`/{pipId}/{version}.xml`​ の形式でパスを指定してください。例: `/PIP3A4/V02_02.xml`​)。 10. PIP 定義で署名入りメッセージを使用する場合は、​`Keystore path`​ と ​`Keystore access password`​ の値を設定する必要があります。また、署名入りメッセージを送信する場合には ​`Signing key password`​ も設定する必要があります。 11. **\[OK\]**​ をクリックして、グローバルコネクタ設定を保存します。 12. Studio の ​**\[Message Flow (メッセージフロー)\]**​ タブに戻ります。 13. RosettaNet コンポーネントをフローにドラッグし、各コンポーネントで使用する設定を選択します。 ### [](#コネクタコンポーネント)コネクタコンポーネント RosettaNet Connector には、アプリケーションフローで使用する 3 つのコンポーネントがあります。 - Action Source (アクションソース) - パートナーから受信したアクションメッセージを処理するためのソース。 - Action Sender (アクション送信者) - パートナー宛のアクションメッセージの送信者。 - Acknowledge Source (肯定応答ソース) - パートナーに送信したアクションメッセージの処理完了 (配信成功、例外、または失敗) のソース。 ## [](#設定の詳細)設定の詳細 ![「General (一般)」 タブのプロパティ](/mulesoft/current/ja-jp/rosettanet-connector/2.0/_images/rosettanet-buyer-config.png) RosettaNet Connector が使用するすべての設定プロパティは、Studio の \[General (一般)\] タブにあります。
設定プロパティ 説明

Global HTTP Listener (グローバル HTTP リスナー)

パートナーからのメッセージを受信するために使用する HTTP リスナー設定の名前。

Service Endpoint Path (サービスエンドポイントパス)

HTTP リスナー設定に相対的なパス (必要に応じて異なるパートナーの異なるパスで同じ HTTP リスナーを使用できるようにします)。

Global HTTP Request (グローバル HTTP 要求)

パートナーへのメッセージを送信するために使用する HTTP 要求設定の名前。

Request Endpoint Path (要求エンドポイントパス)

HTTP 要求設定に相対的なパス (必要に応じて異なるパスで同じ HTTP 要求を使用できるようにします)。

Keystore path (キーストアパス)

メッセージの検証や署名に使用するキーストア (署名入りメッセージの送受信時に必要) の絶対ファイルパスまたはプロジェクトの ​/src/main/resources​ ディレクトリに相対的なクラスパス。

Keystore access password (キーストアアクセスパスワード)

キーストア (署名入りメッセージの送受信時に必要) を保護するためのパスワード。

Signing key password (署名キーパスワード)

キーストア (署名入りメッセージの送受信時に必要) 内の署名用の非公開キーにアクセスするためのパスワード。

Force message signing (メッセージの署名を強制)

PIP 定義で求められていない場合でも、署名入りメッセージの使用を強制 (省略可能)。メッセージを署名する PIP 定義ではこの値は空白にし、どのメッセージにも署名しない場合は ​NEVER​、常に署名を要求する場合は ​ALWAYS​ に設定します。

Global usage code (グローバル使用コード)

コネクタの実行モード。次のいずれか:

  • 生産

  • テスト

  • Unchecked (未チェック)

Object store reference (オブジェクトストア参照)

肯定応答待ちのメッセージを保存するために使用するオブジェクトストア定義への参照です (省略可能)。設定しないと、コネクタは常に永続的なデフォルトのオブジェクトストアを使用して送信したメッセージを保存し、肯定応答または再試行を待機します。設定した場合、参照されているオブジェクトストア設定が使用されます。

Mule DUNS identifier (Mule DUNS 識別子)

この組織の Dun & Bradstreet Universal Numbering System (DUNS) ID。

Mule location identifier (Mule 場所識別子)

この組織の場所 ID。指定すると、送信されるすべてのメッセージに含められ、受信するすべてのメッセージにも含まれる必要があります。指定しないと、受信メッセージに含まれる値は受け入れられて無視されます。場所 ID を使用すると、キーストアのキーペアで使用する別名も変更されます。

Partner DUNS identifier (パートナー DUNS 識別子)

取引パートナー組織の Dun & Bradstreet Universal Numbering System (DUNS) ID。

Partner location identifier (パートナーの場所識別子)

予期されるパートナー組織の場所 ID。指定すると、送信されるすべてのメッセージに含められ、受信するすべてのメッセージにも含まれる必要があります。指定しないと、受信メッセージに含まれる値は受け入れられて無視されます。場所 ID を使用すると、キーストアのパートナー証明書で使用する別名も変更されます。

Role in PIP (PIP のロール)

Partner Interface Process (PIP) でのロール。次のいずれかになります。

  • INITIATOR

  • RESPONDER

PIP definition path (PIP 定義パス)

PIP 定義 XML ファイルの絶対ファイルパスまたはプロジェクトの ​/src/main/resources​ ディレクトリに相対的なクラスパス。ディストリビューションに含まれる標準 PIP 定義では、​/{pipId}/{version}.xml​ の形式になります (例: /PIP3A4/V02_02.xml​)。
### [](#xml-での設定オプション)XML での設定オプション Studio 設定にあるすべての値は XML で直接設定できます。
XML 値 Visual Studio オプション

globalUsageCode

Global usage code (グローバル使用コード)

keystorePass

Keystore access password (キーストアアクセスパスワード)

keystorePath

Keystore path (キーストアパス)

listenerConfigName

Global HTTP Listener (グローバル HTTP リスナー)

objectStore

Object store reference (オブジェクトストア参照)

partnerBusinessIdentifier

Partner DUNS identifier (パートナー DUNS 識別子)

partnerLocationId

Partner location identifier (パートナーの場所識別子)

pipFile

PIP definition path (PIP 定義パス)

pipRole

Role in PIP (PIP のロール)

privatePass

Signing key password (署名キーパスワード)

requestPath

Request Endpoint Path (要求エンドポイントパス)

requesterConfigName

Global HTTP Request (グローバル HTTP 要求)

selfBusinessIdentifier

Mule DUNS identifier (Mule DUNS 識別子)

selfLocationId

Mule location identifier (Mule 場所識別子)

servicePath

Service Endpoint Path (サービスエンドポイントパス)

signingOverride

Force message signing (メッセージの署名を強制)
## [](#オブジェクトストア)オブジェクトストア デフォルトのオブジェクトストアは、Mule のデフォルトの永続的なオブジェクトストアを使用します。そのため、送信されたメッセージは、肯定応答されるまで累積し、再実行時にはメッセージが再送信される場合があります。 次の定義を使用すると、テストとデバッグ用に一時的なオブジェクトストアを定義して、RosettaNet 設定からオブジェクトストアを名前で参照することができます。 ```xml ... ... ``` 永続的なオブジェクトストアを使用すると、肯定応答されていないメッセージは Mule アプリケーションを再起動しても保持され、アプリケーションの再起動時に (タイムアウト期限が切れたと判断されて) 再送信されます。肯定応答がないまま PIP 定義で指定されている再送信回数に達するか、または 3 日が経過すると、オブジェクトストアからすべてのメッセージが削除されます。次のシステムプロパティを設定することで、肯定応答されていないメッセージを Mule アプリケーションの起動時に強制的に削除できます。 `com.mulesoft.connectors.rosettanet.extension.internal.delivery.DeliveryManager.deleteStore=true` ## [](#pip-をカスタマイズする)PIP をカスタマイズする PIP をカスタマイズすると、PIP 設定に 2 通りの変更を加えることができます。 - パラメーター: PIP バージョンの XML ファイル内で設定を変更します。 - 詳細: カスタム DTD を作成して、そこから XSD ファイルを作成できます。 どちらの場合も、作成または変更したファイルは Studio プロジェクトの src/main/resources フォルダーに保存してください。 用意されている PIP 設定を開始ポイントとして使用できます。これらは、mule-rosettanet-extension-2.0.0-mule-plugin.jar に入っており、Studio でダウンロードして ​`/target/repository/com/mulesoft/connectors/mule-rosettanet-extension`​ ディレクトリのプロジェクトに追加できます。また、標準の MuleSoft Enterprise Maven リポジトリ (グループ ID の com.mulesoft.connectors の下) にもあります。各 PIP 設定は jar ファイルの個別のディレクトリ (例: `PIP3A4`​) に入っています。jar から PIP ディレクトリをコピーして、ニーズに合わせてコンテンツを編集できます。 PIP 設定ディレクトリには、特定の PIP バージョン (例: `V02_02.xml`​) 用のパラメーターが設定された XML ファイルもあります。この XML ファイルには、PIP で定義されている再試行回数、肯定応答のタイムアウト、アクションの署名要件の詳細が記述されています。また、このファイルは実際のアクションメッセージの DTD と XSD 定義を参照します (DTD は RosettaNet で使用され、XSD は Mule 内で DataSense 情報の提供に使用されるため、両方とも必要です)。 基本の PIP 定義ディレクトリを jar から Studio プロジェクトの src/main/resources フォルダーにコピーし、コピーしたディレクトリの名前をカスタマイズに合わせて変更します (例: `PIP3A4-custom`​)。その後、必要な変更を行ってから、変更した PIP ディレクトリ名を RosettaNet Connector 設定で (​`pipFile`​ 値として) 使用します。 ## [](#キーストア)キーストア RosettaNet は X.509 証明書を使用してメッセージを認証します。RosettaNet Connector は、現時点では JKS 形式のキーストアの証明書 (および署名に使用する非公開キー) の保存のみをサポートしています。Portecle など、さまざまなツールを使用してキーストアを処理して、キーと証明書を作成できます。 キーストアの別名は次の形式になります。​`{Partner/Self Business Identifier}[:{Partner/Self Location ID}]` 値は中括弧で囲まれており、場所 ID が定義されている場合にのみ使用する省略可能な部分は角括弧で囲まれています。 ### [](#詳細の確認)詳細の確認 RosettaNet プロトコル交換の詳細を確認する場合は、次のような行を追加することで、​`/src/main/resources/log4j2.xml`​ ロギング設定ファイルで ​`TRACE`​ ロギングを有効にしてください。 ```xml ... ... ``` ## [](#関連情報)関連情報 - [RosettaNet Connector リリースノート](https://docs.mulesoft.com/jp/release-notes/connector/rosettanet-connector-release-notes-mule-4) - [MuleSoft フォーラム](https://forums.mulesoft.com) サンプルファイル: - [sample-purchase-order-request-content.xml](https://s3-us-west-2.amazonaws.com/mulesoft-sites-vendorcontent/public-assets/sample-purchase-order-request-content.xml) - [sample-purchase-order-confirmation-content.xml](https://s3-us-west-2.amazonaws.com/mulesoft-sites-vendorcontent/public-assets/sample-purchase-order-confirmation-content.xml) - [partner1.jks](https://s3-us-west-2.amazonaws.com/mulesoft-sites-vendorcontent/public-assets/partner1.jks) - [partner2.jks](https://s3-us-west-2.amazonaws.com/mulesoft-sites-vendorcontent/public-assets/partner2.jks) - [rosetta-buyer.jar](https://s3-us-west-2.amazonaws.com/mulesoft-sites-vendorcontent/public-assets/rosetta-buyer.jar) - [rosetta-seller.jar](https://s3-us-west-2.amazonaws.com/mulesoft-sites-vendorcontent/public-assets/rosetta-seller.jar) # RosettaNet Connector サポートカテゴリ: Premium RosettaNet Connector は、RosettaNet Information Framework (RNIF) を使用して Rosetta Partner Interface Process (PIP) メッセージを交換することで、B2B 機能を提供します。 RosettaNet Connector は RNIF 2.00.01 をサポートします。 次の PIP がサポートされています。
PIP バージョン 目的

0A1

v02.00

失敗の通知

3A4

3A4MG1 v02.02

注文の要求

3A4

3A4MG2 v02.02

注文の要求

3A6

3A6MG1 v02.00, v02.02, v02.03

注文状況の配布

3B2

3B2MG1 v01.00

事前出荷通知

3C3

3C3MG1 v01.00, v01.11

請求通知
RosettaNet Connector は常にすべての失敗の通知メッセージで PIP 0A1 v02.00 を使用します。 **注意:**​ サンプルファイルのダウンロードについては、​[\[See Also\]](<#See Also>)​ を参照してください。 ## [](#始める前に)始める前に このドキュメントでは、読者が RosettaNet、Mule、Anypoint Connector、Anypoint Studio、Mule フロー、および Mule グローバル要素に精通していることを前提としています。 互換性については、​[RosettaNet のリリースノート](https://docs.mulesoft.com/jp/release-notes/connector/rosettanet-connector-release-notes-mule-4)​を参照してください。 RosettaNet Connector を本番環境で使用するには、Anypoint B2B 用の MuleSoft ライセンスを購入しておく必要があります。 ## [](#このコネクタの新機能)このコネクタの新機能 Mule 4 の RosettaNet Connector 2.x では、RosettaNet Connector 1.x の実装から設定や処理が少し変更されています。 - ソースのメタデータを自動的に供給 (1.x で必要だった個別のメタデータ定義は不要) - パートナーやメッセージごとに個別のフローを使用することでフロー構造を簡素化。 - 報告されたセキュリティの脆弱性に対処するため、キーストア利用状況に対して追加の検証が実行されるようになりました。 ## [](#anypoint-studio-7-でこのコネクタをインストールする)Anypoint Studio 7 でこのコネクタをインストールする 1. Studio で Mule プロジェクトを作成します。 2. Studio タスクバーの Exchange ​**(X)**​ アイコンをクリックします。 3. Exchange で、​**\[Login (ログイン)\]**​ をクリックし、Anypoint Platform のユーザー名とパスワードを指定します。 4. Exchange で ​**\[All assets (すべてのアセット)\]**​ を選択して「RosettaNet」を検索します。 5. 「RosettaNet」を選択して ​**\[Add to project (プロジェクトに追加)\]**​ をクリックします。 6. 画面の指示に従ってコネクタをインストールします。 ## [](#anypoint-studio-7-で-mule-プロジェクトを作成する)Anypoint Studio 7 で Mule プロジェクトを作成する コネクタをインストールしたら、すぐに使い始めることができます。まず、Mule とメッセージの交換に使用するパートナーエンドポイント用の HTTP リスナーと HTTP 要求を作成します。 1. キャンバスの下部にある \[Global Elements (グローバル要素)\] タブをクリックし、​**\[Create (作成)\]**​ をクリックします。 2. \[Connector Configuration (コネクタ設定)\] で \[HTTP Listener config (HTTP リスナー設定)\] を選択して ​**\[OK\]**​ をクリックします。 3. 設定の定義で、取引パートナーからのアクションやシグナルメッセージを受信するための​**ホスト**​と​**ポート**​を入力して ​**\[OK\]**​ をクリックします。 4. \[Global Elements (グローバル要素)\] タブで再び ​**\[Create (作成)\]**​ をクリックします。 5. **\[Connector Configuration (コネクタ設定)\]**​ で \[HTTP Request config (HTTP 要求設定)\] を選択して ​**\[OK\]**​ をクリックします。 6. 設定の定義で、取引パートナーにアクションやシグナルメッセージを送信するためのホストとポートを入力して ​**\[OK\]**​ をクリックします。 7. キャンバスの下部にある ​**\[Global Elements (グローバル要素)\]**​ タブをクリックし、​**\[Create (作成)\]**​ をクリックします。 8. **\[Connector Configuration (コネクタ設定)\]**​ で ​**\[RosettaNet Config (RosettaNet 設定)\]**​ を選択して ​**\[OK\]**​ をクリックします。 9. 作成してあるグローバル HTTP リスナーとグローバル HTTP 要求の定義への参照情報を入力し、エンドポイントパス、セルフ/パートナー ID 情報、PIP ロールおよび定義パスを指定します (用意されている標準 PIP 定義を使用する場合は、​`/{pipId}/{version}.xml`​ の形式でパスを指定してください。例: `/PIP3A4/V02_02.xml`​)。 10. PIP 定義で署名入りメッセージを使用する場合は、​`Keystore path`​ と ​`Keystore access password`​ の値を設定する必要があります。また、署名入りメッセージを送信する場合には ​`Signing key password`​ も設定する必要があります。 11. **\[OK\]**​ をクリックして、グローバルコネクタ設定を保存します。 12. Studio の ​**\[Message Flow (メッセージフロー)\]**​ タブに戻ります。 13. RosettaNet コンポーネントをフローにドラッグし、各コンポーネントで使用する設定を選択します。 ### [](#コネクタコンポーネント)コネクタコンポーネント RosettaNet Connector には、アプリケーションフローで使用する 3 つのコンポーネントがあります。 - Action Source (アクションソース) - パートナーから受信したアクションメッセージを処理するためのソース。 - Action Sender (アクション送信者) - パートナー宛のアクションメッセージの送信者。 - Acknowledge Source (肯定応答ソース) - パートナーに送信したアクションメッセージの処理完了 (配信成功、例外、または失敗) のソース。 ## [](#設定の詳細)設定の詳細 ![「General (一般)」タブのプロパティ](/mulesoft/current/ja-jp/rosettanet-connector/2.1/_images/rosettanet-buyer-config.png) RosettaNet Connector が使用するすべての設定プロパティは、Studio の \[General (一般)\] タブにあります。
設定プロパティ 説明

Global HTTP Listener (グローバル HTTP リスナー)

パートナーからのメッセージを受信するために使用する HTTP リスナー設定の名前。

Service Endpoint Path (サービスエンドポイントパス)

HTTP リスナー設定に相対的なパス (必要に応じて異なるパートナーの異なるパスで同じ HTTP リスナーを使用できるようにします)。

Global HTTP Request (グローバル HTTP 要求)

パートナーへのメッセージを送信するために使用する HTTP 要求設定の名前。

Request Endpoint Path (要求エンドポイントパス)

HTTP 要求設定に相対的なパス (必要に応じて異なるパスで同じ HTTP 要求を使用できるようにします)。

Keystore path (キーストアパス)

メッセージの検証や署名に使用するキーストア (署名入りメッセージの送受信時に必要) の絶対ファイルパスまたはプロジェクトの ​/src/main/resources​ ディレクトリに相対的なクラスパス。

Keystore access password (キーストアアクセスパスワード)

キーストア (署名入りメッセージの送受信時に必要) を保護するためのパスワード。

Signing key password (署名キーパスワード)

キーストア (署名入りメッセージの送受信時に必要) 内の署名用の非公開キーにアクセスするためのパスワード。

Force message signing (メッセージの署名を強制)

PIP 定義で求められていない場合でも、署名入りメッセージの使用を強制 (省略可能)。メッセージを署名する PIP 定義ではこの値は空白にし、どのメッセージにも署名しない場合は ​NEVER​、常に署名を要求する場合は ​ALWAYS​ に設定します。

Global usage code (グローバル使用コード)

コネクタの実行モード。次のいずれか:

  • 生産

  • テスト

  • Unchecked (未チェック)

Object store reference (オブジェクトストア参照)

肯定応答待ちのメッセージを保存するために使用するオブジェクトストア定義への参照です (省略可能)。設定しないと、コネクタは常に永続的なデフォルトのオブジェクトストアを使用して送信したメッセージを保存し、肯定応答または再試行を待機します。設定した場合、コネクタは、参照されているオブジェクトストア設定を代わりに使用します。

Mule DUNS identifier (Mule DUNS 識別子)

この組織の Dun & Bradstreet Universal Numbering System (DUNS) ID。

Mule location identifier (Mule 場所識別子)

この組織の場所 ID。指定すると、送信されるすべてのメッセージに含められ、受信するすべてのメッセージにも含まれる必要があります。指定しないと、受信メッセージに含まれる値は受け入れられて無視されます。場所 ID を使用すると、キーストアのキーペアで使用する別名も変更されます。

Partner DUNS identifier (パートナー DUNS 識別子)

取引パートナー組織の Dun & Bradstreet Universal Numbering System (DUNS) ID。

Partner location identifier (パートナーの場所識別子)

予期されるパートナー組織の場所 ID。指定すると、送信されるすべてのメッセージに含められ、受信するすべてのメッセージにも含まれる必要があります。指定しないと、受信メッセージに含まれる値は受け入れられて無視されます。場所 ID を使用すると、キーストアのパートナー証明書で使用する別名も変更されます。

Role in PIP (PIP のロール)

Partner Interface Process (PIP) でのロール。次のいずれかになります。

  • INITIATOR

  • RESPONDER

PIP definition path (PIP 定義パス)

PIP 定義 XML ファイルの絶対ファイルパスまたはプロジェクトの ​/src/main/resources​ ディレクトリに相対的なクラスパス。ディストリビューションに含まれる標準 PIP 定義では、​/{pipId}/{version}.xml​ の形式になります (例: /PIP3A4/V02_02.xml​)。
### [](#xml-での設定オプション)XML での設定オプション Studio 設定にあるすべての値は XML で直接設定できます。
XML 値 Visual Studio オプション

globalUsageCode

Global usage code (グローバル使用コード)

keystorePass

Keystore access password (キーストアアクセスパスワード)

keystorePath

Keystore path (キーストアパス)

listenerConfigName

Global HTTP Listener (グローバル HTTP リスナー)

objectStore

Object store reference (オブジェクトストア参照)

partnerBusinessIdentifier

Partner DUNS identifier (パートナー DUNS 識別子)

partnerLocationId

Partner location identifier (パートナーの場所識別子)

pipFile

PIP definition path (PIP 定義パス)

pipRole

Role in PIP (PIP のロール)

privatePass

Signing key password (署名キーパスワード)

requestPath

Request Endpoint Path (要求エンドポイントパス)

requesterConfigName

Global HTTP Request (グローバル HTTP 要求)

selfBusinessIdentifier

Mule DUNS identifier (Mule DUNS 識別子)

selfLocationId

Mule location identifier (Mule 場所識別子)

servicePath

Service Endpoint Path (サービスエンドポイントパス)

signingOverride

Force message signing (メッセージの署名を強制)
## [](#object-store-オブジェクトストア)Object Store (オブジェクトストア) デフォルトのオブジェクトストアは、Mule のデフォルトの永続的なオブジェクトストアを使用します。そのため、送信されたメッセージは、肯定応答されるまで累積し、再実行時にはメッセージが再送信される場合があります。 次の定義を使用すると、テストとデバッグ用に一時的なオブジェクトストアを定義して、RosettaNet 設定からオブジェクトストアを名前で参照することができます。 ```xml ... ... ``` 永続的なオブジェクトストアを使用すると、肯定応答されていないメッセージは Mule アプリケーションを再起動しても保持され、アプリケーションの再起動時に (タイムアウト期限が切れたと判断されて) 再送信されます。肯定応答がないまま PIP 定義で指定されている再送信回数に達するか、または 3 日が経過すると、オブジェクトストアからすべてのメッセージが削除されます。次のシステムプロパティを設定することで、肯定応答されていないメッセージを Mule アプリケーションの起動時に強制的に削除できます。 `com.mulesoft.connectors.rosettanet.extension.internal.delivery.DeliveryManager.deleteStore=true` ## [](#pip-をカスタマイズする)PIP をカスタマイズする PIP をカスタマイズすると、PIP 設定に 2 通りの変更を加えることができます。 - パラメーター: PIP バージョンの XML ファイル内で設定を変更します。 - 詳細: カスタム DTD を作成して、そこから XSD ファイルを作成できます。 どちらの場合も、作成または変更したファイルは Studio プロジェクトの src/main/resources フォルダーに保存してください。 用意されている PIP 設定を開始ポイントとして使用できます。これらは、mule-rosettanet-extension-2.0.0-mule-plugin.jar に入っており、Studio でダウンロードして ​`/target/repository/com/mulesoft/connectors/mule-rosettanet-extension`​ ディレクトリのプロジェクトに追加できます。また、標準の MuleSoft Enterprise Maven リポジトリ (グループ ID の com.mulesoft.connectors の下) にもあります。各 PIP 設定は jar ファイルの個別のディレクトリ (例: `PIP3A4`​) に入っています。jar から PIP ディレクトリをコピーして、ニーズに合わせてコンテンツを編集できます。 PIP 設定ディレクトリには、特定の PIP バージョン (例: `V02_02.xml`​) 用のパラメーターが設定された XML ファイルもあります。この XML ファイルには、PIP で定義されている再試行回数、肯定応答のタイムアウト、アクションの署名要件の詳細が記述されています。また、このファイルは実際のアクションメッセージの DTD と XSD 定義を参照します (DTD は RosettaNet で使用され、XSD は Mule 内で DataSense 情報の提供に使用されるため、両方とも必要です)。 基本の PIP 定義ディレクトリを jar から Studio プロジェクトの src/main/resources フォルダーにコピーし、コピーしたディレクトリの名前をカスタマイズに合わせて変更します (例: `PIP3A4-custom`​)。その後、必要な変更を行ってから、変更した PIP ディレクトリ名を RosettaNet Connector 設定で (​`pipFile`​ 値として) 使用します。 ## [](#キーストア)キーストア RosettaNet は X.509 証明書を使用してメッセージを認証します。RosettaNet Connector は、現時点では JKS 形式のキーストアの証明書 (および署名に使用する非公開キー) の保存のみをサポートしています。Portecle など、さまざまなツールを使用してキーストアを処理して、キーと証明書を作成できます。 キーストアの別名は次の形式になります。​`{Partner/Self Business Identifier}[:{Partner/Self Location ID}]` 値は中括弧で囲まれており、場所 ID が定義されている場合にのみ使用する省略可能な部分は角括弧で囲まれています。 ### [](#詳細の確認)詳細の確認 RosettaNet プロトコル交換の詳細を確認する場合は、次のような行を追加することで、​`/src/main/resources/log4j2.xml`​ ロギング設定ファイルで ​`TRACE`​ ロギングを有効にしてください。 ```xml ... ... ``` ## [](#関連情報)関連情報 - [RosettaNet Connector リリースノート](https://docs.mulesoft.com/jp/release-notes/connector/rosettanet-connector-release-notes-mule-4) - [MuleSoft フォーラム](https://forums.mulesoft.com) サンプルファイル: - [sample-purchase-order-request-content.xml](https://s3-us-west-2.amazonaws.com/mulesoft-sites-vendorcontent/public-assets/sample-purchase-order-request-content.xml) - [sample-purchase-order-confirmation-content.xml](https://s3-us-west-2.amazonaws.com/mulesoft-sites-vendorcontent/public-assets/sample-purchase-order-confirmation-content.xml) - [partner1.jks](https://s3-us-west-2.amazonaws.com/mulesoft-sites-vendorcontent/public-assets/partner1.jks) - [partner2.jks](https://s3-us-west-2.amazonaws.com/mulesoft-sites-vendorcontent/public-assets/partner2.jks) - [rosetta-buyer.jar](https://s3-us-west-2.amazonaws.com/mulesoft-sites-vendorcontent/public-assets/rosetta-buyer.jar) - [rosetta-seller.jar](https://s3-us-west-2.amazonaws.com/mulesoft-sites-vendorcontent/public-assets/rosetta-seller.jar) # RosettaNet Connector 2.0 リファレンス RosettaNet 用 Anypoint Connector (Rosettanet Connector) は、RosettaNet Information Framework (RNIF) を使用して RosettaNet Partner Interface Process (PIP) メッセージを交換することで、B2B 機能を提供します。 リリースノート: [RosettaNet Connector リリースノート](https://docs.mulesoft.com/jp/release-notes/connector/rosettanet-connector-release-notes-mule-4) ## [](#config)設定 RosettaNet Connector の設定。 ### [](#パラメーター)パラメーター
名前 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

x

Global HTTP Listener (グローバル HTTP リスナー)

String (文字列)

パートナーがアクションメッセージとシグナルメッセージに使用するサービスエンドポイントのグローバル HTTP リスナー定義への参照。

x

Service Endpoint Path (サービスエンドポイントパス)

String (文字列)

HTTP リスナーのベースパスの末尾に付加されるサービスエンドポイントパス。

x

Global HTTP Request (グローバル HTTP 要求)

String (文字列)

パートナーサービスエンドポイントのグローバル HTTP 要求定義。この値は、アクションメッセージとシグナルメッセージの送信時に使用されます。

x

Request Endpoint Path (要求エンドポイントパス)

String (文字列)

HTTP 要求のベースパスの末尾に付加されるパートナーエンドポイントパス。

x

Keystore path (キーストアパス)

String (文字列)

信頼済みパートナー証明書、および署名用のコネクタの非公開キーと証明書 (JKS 形式) が格納されるキーストア。

Keystore access password (キーストアアクセスパスワード)

String (文字列)

キーストアのアクセスパスワード。

Signing key password (署名キーパスワード)

String (文字列)

署名用の非公開キーのパスワード (アクションメッセージとシグナルメッセージへの署名時に必要)。

Override message signing (メッセージ署名の上書き)

Enumeration (列挙)。次のいずれかになります。

  • ALWAYS

  • NEVER

メッセージの署名をオンまたはオフにします。この値を ​ALWAYS​ に設定すると、PIP 定義によって設定された署名が上書きされます。

Global usage code (グローバル使用コード)

Enumeration (列挙)。次のいずれかになります。

  • テスト

  • 本番

テストモードと本番モードのどちらで操作するか。

本番

Object store reference (オブジェクトストア参照)

Object Store (オブジェクトストア)

オブジェクトストアの設定参照。

  • 設定すると、コネクタは参照されているオブジェクトストア設定を使用して、肯定応答や再試行のために送信済みのメッセージを保存します。

  • 指定しないと、コネクタは永続的なデフォルトのオブジェクトストアを使用して、肯定応答や再試行のために送信済みのメッセージを保存します。

Mule DUNS identifier (Mule DUNS 識別子)

String (文字列)

組織の DUNS 企業識別子。

x

Mule location identifier (Mule 場所識別子)

String (文字列)

組織の場所識別子。

  • 指定すると、この値は、送信するすべてのメッセージに含められ、受信するすべてのメッセージで検証されます。

  • 指定しないと、値は送信されず、受信した値は無視されます。

Partner DUNS identifier (パートナー DUNS 識別子)

String (文字列)

予期されるパートナー組織の DUNS 企業識別子。

x

Partner location identifier (パートナーの場所識別子)

String (文字列)

予期されるパートナー組織の場所識別子。

  • 指定すると、この値は、送信するすべてのメッセージに含められ、受信するすべてのメッセージで検証されます。

  • 指定しないと、値は送信されず、受信した値は無視されます。

Role in PIP (PIP のロール)

Enumeration (列挙)。次のいずれかになります。

  • INITIATOR

  • RESPONDER

PIP でのコネクタのロール。

x

PIP definition path (PIP 定義パス)

String (文字列)

PIP のファイルパス。

x

Expiration Policy (有効期限ポリシー)

Expiration Policy (有効期限ポリシー)

動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。 これは、インスタンスが有効期限の対象となった瞬間にプラットフォームでそのインスタンスが期限切れになるということではありません。必要に応じて、インスタンスがパージされます。
## [](#ソース)ソース - [Action source](#actionSource) - [Completion source](#completionSource) ### [](#actionSource)Action source `` #### [](#パラメーター-2)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Primary Node Only (プライマリノードのみ)

Boolean (ブール)

クラスターでの Mule インスタンスの実行時、このソースをプライマリノード上でのみ実行するかどうかを決定します。

Streaming Strategy (ストリーミング戦略)

Mule によるストリームの処理方法を設定します。デフォルトでは、Mule では反復可能ストリームが使用されます。

Redelivery Policy (再配信ポリシー)

Redelivery Policy (再配信ポリシー)

同じメッセージの再配信を処理するためのポリシーを設定します。
#### [](#出力)出力

型

Binary (バイナリ)

Attributes Type (属性型)

Message Attributes (メッセージ属性)
#### [](#次の設定の場合)次の設定の場合 - [設定](#config) ### [](#completionSource)Completion source `` #### [](#パラメーター-3)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Primary Node Only (プライマリノードのみ)

Boolean (ブール)

クラスターでの実行時、このソースをプライマリノード上でのみ実行する必要があるかどうか。

Redelivery Policy (再配信ポリシー)

Redelivery Policy (再配信ポリシー)

同じメッセージの再配信を処理するためのポリシーを設定します。
#### [](#出力-2)出力

型

Completion (完了)

Attributes Type (属性型)

Message Attributes (メッセージ属性)
#### [](#次の設定の場合-2)次の設定の場合 - [設定](#config) ## [](#操作)操作 - [Send Action](#sendAction) ### [](#sendAction)Send Action `` 取引パートナーに関連する電子文書を送信します。 #### [](#パラメーター-4)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Initiating action (開始アクション)

Reply Attributes (応答属性)

MIME メッセージのサービスヘッダーないで送信する応答属性をリストします。

Content (コンテンツ)

Binary (バイナリ)

取引パートナー間で交換されるビジネスドキュメントのコンテンツ。

#[payload]

Streaming Strategy (ストリーミング戦略)

Mule によるストリームの処理方法を設定します。デフォルトでは、Mule では反復可能ストリームが使用されます。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力を評価する式。式の結果は ​[Target Variable (対象変数)]​ 項目に保存されます。

#[payload]
#### [](#出力-3)出力

型

Binary (バイナリ)

Attributes Type (属性型)

Message Attributes (メッセージ属性)
#### [](#次の設定の場合-3)次の設定の場合 - [設定](#config) #### [](#スロー)スロー - ROSETTA:WRITE - ROSETTA:CONFIGURATION - ROSETTA:PARSE - ROSETTA:UNKNOWN ## [](#オブジェクト種別)オブジェクト種別 ### [](#Completion)Completion (完了) **Completion source**​ ソースの完了状況および詳細。
項目 型 説明 デフォルト値 必須

Completion Code (完了コード)

Enumeration (列挙)。次のいずれかになります。

  • SUCCESS

  • FAILURE

  • EXCEPTION

アクションメッセージの完了種別。有効な値:

  • SUCCESS: パートナーから肯定応答シグナルが返された。

  • EXCEPTION: パートナーから例外シグナルが返された。

  • FAILURE: PIP 設定で定義されているトランスミッション試行回数以内にパートナーから応答シグナルが返されなかった。

x

例外の詳細

例外の詳細

受信した例外シグナルの詳細。完了コードが ​EXCEPTION​ である場合に存在します。

Mime Data (MIME データ)

Binary (バイナリ)

受信した MIME シグナルメッセージ。署名入り肯定応答信号をサポートするアプリケーションに提供されます。完了コードが ​SUCCESS​ または ​EXCEPTION​ である場合に存在します。
### [](#ExceptionDetail)例外の詳細 受信した例外シグナルの詳細。
項目 型 説明 デフォルト値 必須

Exception Code (例外コード)

String (文字列)

エラーコード。

x

Exception Error Description (例外エラーの説明)

String (文字列)

エラーの説明。

x

Exception Component Code (例外完了コード)

String (文字列)

エラーが発生した取引を識別するコード。

x

Exception Type (例外種別)

String (文字列)

エラーカテゴリ。

x
### [](#ExpirationPolicy)Expiration Policy (有効期限ポリシー) 有効期限ポリシー戦略を設定します。
項目 型 説明 デフォルト値 必須

Max Idle Time (最大アイドル時間)

Number (数値)

動的設定インスタンスがアイドル状態を続けられる最大時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。

Time Unit (時間単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

[Max Idle Time (最大アイドル時間)]​ の時間単位。
### [](#MessageAttributes)Message Attributes (メッセージ属性) **Action source**​ ソース、​**Completion source**​ ソース、または ​**Send Action**​ 操作の出力。
項目 型 説明 デフォルト値 必須

Message Id (メッセージ ID)

String (文字列)

メッセージの一意の識別子。

x

Partner Business Id (パートナー企業 ID)

String (文字列)

取引パートナーの一意の識別子。

x

Partner location Id (パートナーの場所 ID)

String (文字列)

取引パートナーの場所を表す識別子。

x

Reply Attributes (応答属性)

Reply Attributes (応答属性)

別のアクションへの応答としてアクションメッセージを生成する際に使用する識別子の値。​Action source​ ソースによってこの値が設定されます。

x

Mime Data (MIME データ)

Binary (バイナリ)

MIME アクションメッセージまたはシグナルメッセージ (署名を使用する場合は署名を含む)。アプリケーションでは非否認をサポートするためにこの値を提供します。

x

肯定応答データ

Binary (バイナリ)

送信者に返される MIME 肯定応答信号 (署名を使用する場合は署名を含む)。​Action source​ ソースによってこの値が設定されます。

x
### [](#反復不可能ストリーム)反復不可能ストリーム 反復可能ストリーム機能を無効にして反復不可能ストリームを使用します。これにより、パフォーマンスオーバーヘッド、メモリ使用量、およびコストが抑えられます。 ### [](#reconnect)Reconnect (再接続) 標準再接続戦略を設定し、再接続の頻度と、コネクタソースまたは操作で実行できる再接続の試行回数を指定します。
項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

Count (数)

Number (数値)

再接続の試行回数。

blocking (ブロック)

Boolean (ブール)

false​ の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true
### [](#reconnect-forever)Reconnect Forever (繰り返し再接続) Mule アプリケーションが実行されている間はコネクタソースや操作によって指定された頻度で再接続が試行される Forever 再接続戦略を設定します。
項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true
### [](#RedeliveryPolicy)Redelivery Policy (再配信ポリシー) エラーを生成する要求を実行するための再配信ポリシーを設定します。再配信ポリシーは、フロー内のあらゆる提供元に追加できます。
項目 型 説明 デフォルト値 必須

Max Redelivery Count (最大再配信数)

Number (数値)

正常に処理されずに ​process-failed-message​ がトリガーされるまでにメッセージを再配信できる最大回数。

Use Secure Hash (セキュアハッシュを使用)

Boolean (ブール)

再配信されたメッセージの識別にセキュアハッシュアルゴリズムを使用するかどうか。

Message Digest Algorithm (メッセージダイジェストアルゴリズム)

String (文字列)

[Use Secure Hash (セキュアハッシュを使用)]​ が ​true​ の場合に使用するセキュアハッシュアルゴリズム。メッセージのペイロードが Java オブジェクトの場合、Mule ではこの値が無視され、ペイロードの ​hashCode()​ が返した値が返されます。

SHA-256

Id Expression (ID 式)

String (文字列)

メッセージがいつ再配信されたのかを判断する 1 つ以上の式。このプロパティは、​[Use Secure Hash (セキュアハッシュを使用)]​ が ​false​ の場合にのみ設定できます。

Object Store (オブジェクトストア)

Object Store (オブジェクトストア)

各メッセージの再配信カウンターが保存されるオブジェクトストアを設定します。
### [](#repeatable-file-store-stream)Repeatable File Store Stream (反復可能なファイルストアストリーム) 反復可能なファイルストアストリーミング戦略を設定します。この戦略では、ストリームコンテンツの一部がメモリ内に格納されます。ストリームのコンテンツが、設定されたバッファサイズよりも大きい場合、Mule はバッファのコンテンツをディスクにバックアップしてからメモリをクリアします。
項目 型 説明 デフォルト値 必須

Max In Memory Size (最大メモリ内サイズ)

Number (数値)

ストリームのデータで使用できるメモリの最大量。メモリ量がこの値を超えると、コンテンツはディスクにバッファされます。パフォーマンスを最適化する方法は、次のとおりです。

  • バッファサイズを大きくすると、Mule がバッファをディスクに書き込む回数を減らせます。これによってパフォーマンスが高まりますが、より多くのメモリが必要になるため、アプリケーションが処理できる同時要求数が制限されます。

  • バッファサイズを小さくすると、メモリの負荷は低減しますが、応答時間が長くなります。

Buffer Unit (バッファ単位)

Enumeration (列挙)。次のいずれかになります。

  • BYTE (バイト)

  • KB

  • MB

  • GB

[Max In Memory Size (最大メモリ内サイズ)]​ の単位。
### [](#repeatable-in-memory-stream)Repeatable In Memory Stream (反復可能なメモリ内ストリーム) データが最大バッファサイズを超えた場合に要求が失敗するメモリ内ストリーミング戦略を設定します。ユースケースで最適なバッファサイズは、必ずパフォーマンステストを実施して決めてください。
項目 型 説明 デフォルト値 必須

Initial Buffer Size (初期バッファサイズ)

Number (数値)

データストリームに割り当てるメモリの初期容量。ストリーミングされたデータがこの値を超える場合は、​[Buffer Size Increment (バッファサイズ増分)]​ の単位で ​[Max Buffer Size (最大バッファサイズ)]​ の値を上限としてバッファが拡張されます。

Buffer Size Increment (バッファサイズ増分)

Number (数値)

バッファサイズが初期サイズを超えた場合に、拡張する量。値を ​0​ またはそれ以下に設定すると、バッファは拡張されません。

Max Buffer Size (最大バッファサイズ)

Number (数値)

バッファの最大サイズ。バッファサイズがこの値を超える場合、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。​0​ 以下の値は無制限を意味します。

Buffer Unit (バッファ単位)

Enumeration (列挙)。次のいずれかになります。

  • BYTE (バイト)

  • KB

  • MB

  • GB

[Initial Buffer Size (初期バッファサイズ)]​ 項目、​[Buffer Size Increment (バッファサイズ増分)]​ 項目、​[Max Buffer Size (最大バッファサイズ)]​ 項目の単位。
### [](#ReplyAttributes)Reply Attributes (応答属性) 別のアクションへの応答としてアクションメッセージを生成する際に使用する値を設定します。
項目 型 説明 デフォルト値 必須

Message Id (メッセージ ID)

String (文字列)

応答に関連付けられたメッセージの識別子。

x

Action Id (アクション ID)

String (文字列)

応答の種別を識別する識別子。

x

Pip Instance Id (PIP インスタンス ID)

String (文字列)

PIP のインスタンスに関連付けられた識別子。

x
## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # RosettaNet Connector 2.1 リファレンス RosettaNet 用 Anypoint Connector (Rosettanet Connector) は、RosettaNet Information Framework (RNIF) を使用して RosettaNet Partner Interface Process (PIP) メッセージを交換することで、B2B 機能を提供します。 リリースノート: [RosettaNet Connector リリースノート](https://docs.mulesoft.com/jp/release-notes/connector/rosettanet-connector-release-notes-mule-4) ## [](#config)設定 RosettaNet Connector の設定。 ### [](#パラメーター)パラメーター
名前 型 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

x

Global HTTP Listener (グローバル HTTP リスナー)

String (文字列)

パートナーがアクションメッセージとシグナルメッセージに使用するサービスエンドポイントのグローバル HTTP リスナー定義への参照。

x

Service Endpoint Path (サービスエンドポイントパス)

String (文字列)

HTTP リスナーのベースパスの末尾に付加されるサービスエンドポイントパス。

x

Global HTTP Request (グローバル HTTP 要求)

String (文字列)

パートナーサービスエンドポイントのグローバル HTTP 要求定義。この値は、アクションメッセージとシグナルメッセージの送信時に使用されます。

x

Request Endpoint Path (要求エンドポイントパス)

String (文字列)

HTTP 要求のベースパスの末尾に付加されるパートナーエンドポイントパス。

x

Keystore path (キーストアパス)

String (文字列)

信頼済みパートナー証明書、および署名用のコネクタの非公開キーと証明書 (JKS 形式) が格納されるキーストア。

Keystore access password (キーストアアクセスパスワード)

String (文字列)

キーストアのアクセスパスワード。

Signing key password (署名キーパスワード)

String (文字列)

署名用の非公開キーのパスワード (アクションメッセージとシグナルメッセージへの署名時に必要)。

Override message signing (メッセージ署名の上書き)

Enumeration (列挙)。次のいずれかになります。

  • ALWAYS

  • NEVER

メッセージの署名をオンまたはオフにします。この値を ​ALWAYS​ に設定すると、PIP 定義によって設定された署名が上書きされます。

Global usage code (グローバル使用コード)

Enumeration (列挙)。次のいずれかになります。

  • テスト

  • 本番

テストモードと本番モードのどちらで操作するか。

本番

Object store reference (オブジェクトストア参照)

Object Store (オブジェクトストア)

オブジェクトストアの設定参照。

  • 設定すると、コネクタは参照されているオブジェクトストア設定を使用して、肯定応答や再試行のために送信済みのメッセージを保存します。

  • 指定しないと、コネクタは永続的なデフォルトのオブジェクトストアを使用して、肯定応答や再試行のために送信済みのメッセージを保存します。

Mule DUNS identifier (Mule DUNS 識別子)

String (文字列)

組織の DUNS 企業識別子。

x

Mule location identifier (Mule 場所識別子)

String (文字列)

組織の場所識別子。

  • 指定すると、この値は、送信するすべてのメッセージに含められ、受信するすべてのメッセージで検証されます。

  • 指定しないと、値は送信されず、受信した値は無視されます。

Partner DUNS identifier (パートナー DUNS 識別子)

String (文字列)

予期されるパートナー組織の DUNS 企業識別子。

x

Partner location identifier (パートナーの場所識別子)

String (文字列)

予期されるパートナー組織の場所識別子。

  • 指定すると、この値は、送信するすべてのメッセージに含められ、受信するすべてのメッセージで検証されます。

  • 指定しないと、値は送信されず、受信した値は無視されます。

Role in PIP (PIP のロール)

Enumeration (列挙)。次のいずれかになります。

  • INITIATOR

  • RESPONDER

PIP でのコネクタのロール。

x

PIP definition path (PIP 定義パス)

String (文字列)

PIP のファイルパス。

x

Expiration Policy (有効期限ポリシー)

Expiration Policy (有効期限ポリシー)

動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。 これは、インスタンスが有効期限の対象となった瞬間にプラットフォームでそのインスタンスが期限切れになるということではありません。必要に応じて、インスタンスがパージされます。
## [](#ソース)ソース - [Action source](#actionSource) - [Completion source](#completionSource) ### [](#actionSource)Action source `` #### [](#パラメーター-2)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Primary Node Only (プライマリノードのみ)

Boolean (ブール)

クラスターでの Mule インスタンスの実行時、このソースをプライマリノード上でのみ実行するかどうかを決定します。

Streaming Strategy (ストリーミング戦略)

Mule によるストリームの処理方法を設定します。デフォルトでは、Mule では反復可能ストリームが使用されます。

Redelivery Policy (再配信ポリシー)

Redelivery Policy (再配信ポリシー)

同じメッセージの再配信を処理するためのポリシーを設定します。
#### [](#出力)出力

型

Binary (バイナリ)

Attributes Type (属性型)

Message Attributes (メッセージ属性)
#### [](#次の設定の場合)次の設定の場合 - [設定](#config) ### [](#completionSource)Completion source `` #### [](#パラメーター-3)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Primary Node Only (プライマリノードのみ)

Boolean (ブール)

クラスターでの実行時、このソースをプライマリノード上でのみ実行する必要があるかどうか。

Redelivery Policy (再配信ポリシー)

Redelivery Policy (再配信ポリシー)

同じメッセージの再配信を処理するためのポリシーを設定します。
#### [](#出力-2)出力

型

Completion (完了)

Attributes Type (属性型)

Message Attributes (メッセージ属性)
#### [](#次の設定の場合-2)次の設定の場合 - [設定](#config) ## [](#操作)操作 - [Send Action](#sendAction) ### [](#sendAction)Send Action `` 取引パートナーに関連する電子文書を送信します。 #### [](#パラメーター-4)パラメーター
名前 型 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Initiating action (開始アクション)

Reply Attributes (応答属性)

MIME メッセージのサービスヘッダーないで送信する応答属性をリストします。

Content (コンテンツ)

Binary (バイナリ)

取引パートナー間で交換されるビジネスドキュメントのコンテンツ。

#[payload]

Streaming Strategy (ストリーミング戦略)

Mule によるストリームの処理方法を設定します。デフォルトでは、Mule では反復可能ストリームが使用されます。

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力を評価する式。式の結果は ​[Target Variable (対象変数)]​ 項目に保存されます。

#[payload]
#### [](#出力-3)出力

型

Binary (バイナリ)

Attributes Type (属性型)

Message Attributes (メッセージ属性)
#### [](#次の設定の場合-3)次の設定の場合 - [設定](#config) #### [](#スロー)スロー - ROSETTA:WRITE - ROSETTA:CONFIGURATION - ROSETTA:PARSE - ROSETTA:UNKNOWN ## [](#オブジェクト種別)オブジェクト種別 ### [](#Completion)Completion (完了) **Completion source**​ ソースの完了状況および詳細。
項目 型 説明 デフォルト値 必須

Completion Code (完了コード)

Enumeration (列挙)。次のいずれかになります。

  • SUCCESS

  • FAILURE

  • EXCEPTION

アクションメッセージの完了種別。有効な値:

  • SUCCESS: パートナーから肯定応答シグナルが返された。

  • EXCEPTION: パートナーから例外シグナルが返された。

  • FAILURE: PIP 設定で定義されているトランスミッション試行回数以内にパートナーから応答シグナルが返されなかった。

x

例外の詳細

例外の詳細

受信した例外シグナルの詳細。完了コードが ​EXCEPTION​ である場合に存在します。

Mime Data (MIME データ)

Binary (バイナリ)

受信した MIME シグナルメッセージ。署名入り肯定応答信号をサポートするアプリケーションに提供されます。完了コードが ​SUCCESS​ または ​EXCEPTION​ である場合に存在します。
### [](#ExceptionDetail)例外の詳細 受信した例外シグナルの詳細。
項目 型 説明 デフォルト値 必須

Exception Code (例外コード)

String (文字列)

エラーコード。

x

Exception Error Description (例外エラーの説明)

String (文字列)

エラーの説明。

x

Exception Component Code (例外完了コード)

String (文字列)

エラーが発生した取引を識別するコード。

x

Exception Type (例外種別)

String (文字列)

エラーカテゴリ。

x
### [](#ExpirationPolicy)Expiration Policy (有効期限ポリシー) 有効期限ポリシー戦略を設定します。
項目 型 説明 デフォルト値 必須

Max Idle Time (最大アイドル時間)

Number (数値)

動的設定インスタンスがアイドル状態を続けられる最大時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。

Time Unit (時間単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

[Max Idle Time (最大アイドル時間)]​ の時間単位。
### [](#MessageAttributes)Message Attributes (メッセージ属性) **Action source**​ ソース、​**Completion source**​ ソース、または ​**Send Action**​ 操作の出力。
項目 型 説明 デフォルト値 必須

Message Id (メッセージ ID)

String (文字列)

メッセージの一意の識別子。

x

Partner Business Id (パートナー企業 ID)

String (文字列)

取引パートナーの一意の識別子。

x

Partner location Id (パートナーの場所 ID)

String (文字列)

取引パートナーの場所を表す識別子。

x

Reply Attributes (応答属性)

Reply Attributes (応答属性)

別のアクションへの応答としてアクションメッセージを生成する際に使用する識別子の値。​Action source​ ソースによってこの値が設定されます。

x

Mime Data (MIME データ)

Binary (バイナリ)

MIME アクションメッセージまたはシグナルメッセージ (署名を使用する場合は署名を含む)。アプリケーションでは非否認をサポートするためにこの値を提供します。

x

肯定応答データ

Binary (バイナリ)

送信者に返される MIME 肯定応答信号 (署名を使用する場合は署名を含む)。​Action source​ ソースによってこの値が設定されます。

x
### [](#反復不可能ストリーム)反復不可能ストリーム 反復可能ストリーム機能を無効にして反復不可能ストリームを使用します。これにより、パフォーマンスオーバーヘッド、メモリ使用量、およびコストが抑えられます。 ### [](#reconnect)Reconnect (再接続) 標準再接続戦略を設定し、再接続の頻度と、コネクタソースまたは操作で実行できる再接続の試行回数を指定します。
項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

Count (数)

Number (数値)

再接続の試行回数。

blocking (ブロック)

Boolean (ブール)

false​ の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true
### [](#reconnect-forever)Reconnect Forever (繰り返し再接続) Mule アプリケーションが実行されている間はコネクタソースや操作によって指定された頻度で再接続が試行される Forever 再接続戦略を設定します。
項目 型 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続する頻度 (ミリ秒)。

blocking (ブロック)

Boolean (ブール)

false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。

true
### [](#RedeliveryPolicy)Redelivery Policy (再配信ポリシー) エラーを生成する要求を実行するための再配信ポリシーを設定します。再配信ポリシーは、フロー内のあらゆる提供元に追加できます。
項目 型 説明 デフォルト値 必須

Max Redelivery Count (最大再配信数)

Number (数値)

正常に処理されずに ​process-failed-message​ がトリガーされるまでにメッセージを再配信できる最大回数。

Use Secure Hash (セキュアハッシュを使用)

Boolean (ブール)

再配信されたメッセージの識別にセキュアハッシュアルゴリズムを使用するかどうか。

Message Digest Algorithm (メッセージダイジェストアルゴリズム)

String (文字列)

[Use Secure Hash (セキュアハッシュを使用)]​ が ​true​ の場合に使用するセキュアハッシュアルゴリズム。メッセージのペイロードが Java オブジェクトの場合、Mule ではこの値が無視され、ペイロードの ​hashCode()​ が返した値が返されます。

SHA-256

Id Expression (ID 式)

String (文字列)

メッセージがいつ再配信されたのかを判断する 1 つ以上の式。このプロパティは、​[Use Secure Hash (セキュアハッシュを使用)]​ が ​false​ の場合にのみ設定できます。

Object Store (オブジェクトストア)

Object Store (オブジェクトストア)

各メッセージの再配信カウンターが保存されるオブジェクトストアを設定します。
### [](#repeatable-file-store-stream)Repeatable File Store Stream (反復可能なファイルストアストリーム) 反復可能なファイルストアストリーミング戦略を設定します。この戦略では、ストリームコンテンツの一部がメモリ内に格納されます。ストリームのコンテンツが、設定されたバッファサイズよりも大きい場合、Mule はバッファのコンテンツをディスクにバックアップしてからメモリをクリアします。
項目 型 説明 デフォルト値 必須

Max In Memory Size (最大メモリ内サイズ)

Number (数値)

ストリームのデータで使用できるメモリの最大量。メモリ量がこの値を超えると、コンテンツはディスクにバッファされます。パフォーマンスを最適化する方法は、次のとおりです。

  • バッファサイズを大きくすると、Mule がバッファをディスクに書き込む回数を減らせます。これによってパフォーマンスが高まりますが、より多くのメモリが必要になるため、アプリケーションが処理できる同時要求数が制限されます。

  • バッファサイズを小さくすると、メモリの負荷は低減しますが、応答時間が長くなります。

Buffer Unit (バッファ単位)

Enumeration (列挙)。次のいずれかになります。

  • BYTE

  • KB

  • MB

  • GB

[Max In Memory Size (最大メモリ内サイズ)]​ の単位。
### [](#repeatable-in-memory-stream)Repeatable In Memory Stream (反復可能なメモリ内ストリーム) データが最大バッファサイズを超えた場合に要求が失敗するメモリ内ストリーミング戦略を設定します。ユースケースで最適なバッファサイズは、必ずパフォーマンステストを実施して決めてください。
項目 型 説明 デフォルト値 必須

Initial Buffer Size (初期バッファサイズ)

Number (数値)

データストリームに割り当てるメモリの初期容量。ストリーミングされたデータがこの値を超える場合は、​[Buffer Size Increment (バッファサイズ増分)]​ の単位で ​[Max Buffer Size (最大バッファサイズ)]​ の値を上限としてバッファが拡張されます。

Buffer Size Increment (バッファサイズ増分)

Number (数値)

バッファサイズが初期サイズを超えた場合に、拡張する量。値を ​0​ またはそれ以下に設定すると、バッファは拡張されません。

Max Buffer Size (最大バッファサイズ)

Number (数値)

バッファの最大サイズ。バッファサイズがこの値を超える場合、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。​0​ 以下の値は無制限を意味します。

Buffer Unit (バッファ単位)

Enumeration (列挙)。次のいずれかになります。

  • BYTE

  • KB

  • MB

  • GB

[Initial Buffer Size (初期バッファサイズ)]​ 項目、​[Buffer Size Increment (バッファサイズ増分)]​ 項目、​[Max Buffer Size (最大バッファサイズ)]​ 項目の単位。
### [](#ReplyAttributes)Reply Attributes (応答属性) 別のアクションへの応答としてアクションメッセージを生成する際に使用する値を設定します。
項目 型 説明 デフォルト値 必須

Message Id (メッセージ ID)

String (文字列)

応答に関連付けられたメッセージの識別子。

x

Action Id (アクション ID)

String (文字列)

応答の種別を識別する識別子。

x

Pip Instance Id (PIP インスタンス ID)

String (文字列)

PIP のインスタンスに関連付けられた識別子。

x
## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Rosettanet Connector の例 この例は 2 つのアプリケーションで構成されています。 - 購入者アプリケーションは、購入注文要求メッセージを販売者アプリケーションに送信します。 - 販売者アプリケーションは、注文が履行されたときに購入注文確認メッセージを購入者アプリケーションに送信します。 次の図は、2 つのアプリケーションのリレーションを示しています。 ![購入者アプリケーションと販売者アプリケーションのリレーション](/mulesoft/current/ja-jp/rosettanet-connector/2.0/_images/rosettanet-state-diagram.png) ## [](#購入者アプリケーション)購入者アプリケーション 購入者アプリケーションは次のアクションを実行します。 1. 入力購入注文要求ドキュメントを ​`HTTP POST`​ 経由で受信します。 2. RosettaNet の ​**Send action**​ 操作を使用して、購入注文要求メッセージを販売者アプリケーションに送信します。 3. 購入注文要求メッセージのメッセージ ID を、​`HTTP POST`​ への応答で使用するプレーンテキストに変換します。 4. 販売者アプリケーションから肯定応答シグナルを受信し、シグナルに関する情報を記録します。 5. 販売者アプリケーションから購入注文確認メッセージを受信し、確認メッセージに関する情報を記録します。 6. 販売者アプリケーションから完了状態を受信し、完了状態に関する情報を記録します。 次のスクリーンショットは、購入者アプリケーションの Anypoint Studio アプリケーションフローを示しています。 ![購入者アプリケーションの Studio フロー](/mulesoft/current/ja-jp/rosettanet-connector/2.0/_images/rosettanet-buyer-visual-flow.png)
購入者の非公開キー、購入者の証明書、販売者の証明書が含まれる購入者アプリケーションのキーストアは、プロジェクトの ​src/main/resources​ にあります。
### [](#購入者アプリケーションの最初のフローの作成)購入者アプリケーションの最初のフローの作成 購入者アプリケーションの最初のフローでは、購入注文要求ドキュメントを ​`HTTP POST`​ 経由で受信して、販売者アプリケーションに RosettaNet アクションメッセージとして送信します。このフローを作成するには、新しい Mule プロジェクトの作成、​**HTTP Listener**​ ソースの設定、​**Send action**​ 操作の追加、​**Transform**​ コンポーネントの追加を行う必要があります。 #### [](#http-listener-ソースの設定)HTTP Listener ソースの設定 デフォルトパス (​`/`​) へのコールが行われたときに Mule フローを開始するように ​**HTTP Listener**​ ソースを設定します。 1. Studio で新しい Mule プロジェクトを作成します。 2. **\[Mule Palette (Mule パレット)\]**​ ビューから、​**\[HTTP\]**​ を選択して ​**\[Listener\]**​ コンポーネントをキャンバスにドラッグします。 3. プロパティウィンドウで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にある ​**\[+\]**​ をクリックしてグローバル要素を追加します。 4. **\[Name (名前)\]**​ 項目に、​`「HTTP_InputListener」`​と入力し、デフォルト値を受け入れます。 #### [](#po_initiatorconfig_buyer-グローバル要素を追加する)PO\_I​nitiatorConfig\_Buyer グローバル要素を追加する **Send action**​ 操作の ​`PO_InitiatorConfig_Buyer`​ グローバル要素を追加します。 1. **Send action**​ 操作のプロパティウィンドウで、​**\[Module configuration (モジュール設定)\]**​ 項目の横にある ​**\[+\]**​ をクリックしてグローバル要素を追加します。 2. **\[RosettaNet Config (RosettaNet 設定)\]**​ ウィンドウで、次の項目を入力します。
Global HTTP Listener (グローバル HTTP リスナー) HTTP_Listener-config

Service Endpoint Path (サービスエンドポイントパス)

/partner1

Global HTTP Request (グローバル HTTP 要求)

HTTP_R​equest_configuration

Request Endpoint Path (要求エンドポイントパス)

/partner2

Keystore Path (キーストアパス)

/partner1.jks

Keystore Access password (キーストアアクセスパスワード)

nosecret

Signing key password (署名キーパスワード)

partner1

Global usage code (グローバル使用コード)

Test (テスト)

Mule DUNS identifier (Mule DUNS 識別子)

123456789

Mule location identifier (Mule 場所識別子)

partner1

Partner DUNS identifier (パートナー DUNS 識別子)

123456788

Partner location identifier (パートナーの場所識別子)

partner2

role in PIP (PIP のロール)

INITIATOR

PIP definition path (PIP 定義パス)

/PIP3A4/​V02_02​.xml
3. **\[OK\]**​ をクリックします。 #### [](#send-action-操作を追加する)Send Action 操作を追加する `PO_InitiatorConfig_Buyer`​ グローバル要素で定義された設定を使用して購入注文要求メッセージを販売者アプリケーションに送信するために、​**Send action**​ 操作を追加します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューから、​**\[RosettaNet\]**​ を選択して ​**\[Send action\]**​ 操作を ​**\[Listener\]**​ の横にドラッグします。 2. プロパティウィンドウで、次の項目を入力します。
項目 値

Display Name (表示名)

Send action

Module configuration (モジュール設定)

PO_I​nitiatorConfig_Buyer
#### [](#transform-message-コンポーネントの追加)Transform Message コンポーネントの追加 購入注文要求メッセージのメッセージ ID をプレーンテキストに変換する ​**Transform Message**​ コンポーネントを追加します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューから、​**\[Core (コア)\]**​ を選択して ​**\[Transform Message\]**​ コンポーネントを ​**\[Send action\]**​ の横にドラッグします。 2. プロパティウィンドウで、​**\[Output (出力)\]**​ セクションの括弧を次の DataWeave コードで上書きします。 ```dataweave %dw 2.0 output text/plain --- "Buyer sent action message " ++ attributes.messageId ++ "\n" ``` ### [](#購入者アプリケーションの-2-番目のフローの作成)購入者アプリケーションの 2 番目のフローの作成 購入者アプリケーションの 2 番目のフローでは、販売者アプリケーションから肯定応答シグナルを受信し、シグナルに関する情報を記録します。また、販売者アプリケーションから購入注文確認メッセージを受信し、メッセージに関する情報を記録します。 #### [](#アクションソースを設定する)アクションソースを設定する `/partner2`​ パスへのコールが行われたときに Mule フローを開始するように ​**Action source**​ ソースを設定します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューから、​**\[Rosettanet\]**​ を選択して ​**\[Action source\]**​ ソースをキャンバスにドラッグします。 2. **\[Module configuration (モジュール設定)\]**​ 項目に​`「PO_InitiatorConfig_Buyer」`​と入力します。 #### [](#logger-コンポーネントを追加する)Logger コンポーネントを追加する 肯定応答および購入注文確認メッセージに関する情報が含まれるメッセージを記録する ​**Logger**​ コンポーネントを追加します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューから、​**\[Core (コア)\]**​ を選択して ​**\[Logger\]**​ コンポーネントをキャンバス上の ​**Action source**​ の横にドラッグします。 2. **\[Message (メッセージ)\]**​ 項目に、次のテキストを入力します。 `"Buyer received action message #[attributes.messageId]"` ### [](#購入者アプリケーションの-3-番目のフローの作成)購入者アプリケーションの 3 番目のフローの作成 購入者アプリケーションの 3 番目のフローでは、販売者アプリケーションから完了状態を受信し、完了状態に関する情報を記録します。 #### [](#completion-source-を設定する)Completion Source を設定する 販売者からの購入注文完了状態メッセージをリスンするように ​**Completion source**​ ソースを設定します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューから、​**\[Rosettanet\]**​ を選択して ​**\[Completion source\]**​ ソースをキャンバスにドラッグします。 2. **\[Module configuration (モジュール設定)\]**​ 項目に​`「PO_InitiatorConfig_Buyer」`​と入力します。 #### [](#logger-コンポーネントを追加する-2)Logger コンポーネントを追加する 購入注文完了状態に関する情報を記録する ​**Logger**​ コンポーネントを追加します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューから、​**\[Core (コア)\]**​ を選択して ​**\[Logger\]**​ コンポーネントをキャンバス上の ​**Completion source**​ の横にドラッグします。 2. **\[Message (メッセージ)\]**​ 項目に、次のテキストを入力します。 `Buyer action message #[attributes.replyAttributes.messageId] completed as #[payload.completionCode]` #### [](#アプリケーションを保存して実行する)アプリケーションを保存して実行する アプリケーションを保存するには、​**\[File (ファイル)\] > \[Save (保存)\]**​ をクリックします。 アプリケーションを実行するには、​**\[Run (実行)\] > \[Run as (別のユーザーとして実行)\] > \[Mule Application (Mule アプリケーション)\]**​ をクリックします。 #### [](#購入者アプリケーションの-xml)購入者アプリケーションの XML 購入者アプリケーションのフローをすばやく Mule アプリケーションに読み込むには、次のコードを Studio XML エディターに貼り付けます。 ```xml ``` ## [](#販売者アプリケーション)販売者アプリケーション 販売者アプリケーションは次のアクションを実行します。 1. 入力購入注文要求確認ドキュメントを ​`HTTP POST`​ 経由で受信します。 2. RosettaNet の ​**Send action**​ 操作を使用して、購入注文確認メッセージを購入者に送信します。 3. 購入注文確認メッセージの RosettaNet メッセージ ID を、​`HTTP POST`​ への応答で使用するプレーンテキストに変換します。 4. 購入者アプリケーションから購入注文要求メッセージを受信し、要求メッセージに関する情報を記録します。 5. 購入者アプリケーションから肯定応答シグナルを受信し、シグナルに関する情報を記録します。 6. 購入者アプリケーションから完了状態メッセージを受信し、完了状態メッセージに関する情報を記録します。 次のスクリーンショットは、販売者アプリケーションの Anypoint Studio アプリケーションフローを示しています。 ![販売者アプリケーションの Studio フロー](/mulesoft/current/ja-jp/rosettanet-connector/2.0/_images/rosettanet-seller-visual-flow.png)
販売者の非公開キー、販売者の証明書、購入者の証明書が含まれる販売者アプリケーションのキーストアは、プロジェクトの ​src/main/resources​ にあります。
### [](#販売者アプリケーションの最初のフローの作成)販売者アプリケーションの最初のフローの作成 販売者アプリケーションの最初のフローでは、購入注文要求確認ドキュメントを ​`HTTP POST`​ 経由で受信して、購入者アプリケーションに RosettaNet アクションメッセージとして送信します。このフローを作成するには、新しい Mule プロジェクトの作成、​**HTTP Listener**​ ソースの設定、RosettaNet の ​**Send action**​ 操作の設定、​**Transform**​ コンポーネントの追加を行う必要があります。 #### [](#http-listener-ソースの設定-2)HTTP Listener ソースの設定 デフォルトパス (​`/`​) へのコールが行われたときに Mule フローを開始するように ​**HTTP Listener**​ ソースを設定します。 1. Studio で新しい Mule プロジェクトを作成します。 2. **\[Mule Palette (Mule パレット)\]**​ ビューから、​**\[HTTP\]**​ を選択して \[Listener\] コンポーネントをキャンバスにドラッグします。 3. プロパティウィンドウで、\[Connector configuration (コネクタ設定)\] 項目の横にある ​**\[+\]**​ をクリックしてグローバル要素を追加します。 4. **\[Name (名前)\]**​ に​`「HTTP_InputListener」`​と入力します。 5. **\[Port (ポート)\]**​ に​`「8082」`​と入力します。 6. **\[Read timeout (読み取りタイムアウト)\]**​ に​`「3000」`​と入力します。 #### [](#send-action-操作のグローバル要素を追加する)Send Action 操作のグローバル要素を追加する **Send action**​ 操作の ​`PO_ResponderConfig_Seller`​ というグローバル要素を作成します。 1. **Send action**​ 操作のプロパティウィンドウで、​**\[Module configuration (モジュール設定)\]**​ 項目の横にある ​**\[+\]**​ をクリックしてグローバル要素を追加します。 2. **\[RosettaNet Config (RosettaNet 設定)\]**​ ウィンドウで、次の項目を設定します。
項目 値

Global HTTP Listener (グローバル HTTP リスナー)

HTTP_Listener-config

Service Endpoint Path (サービスエンドポイントパス)

/partner2

Global HTTP Request (グローバル HTTP 要求)

HTTP_R​equest_configuration

Request Endpoint Path (要求エンドポイントパス)

/partner1

Keystore Path (キーストアパス)

/partner2.jks

Keystore Access password (キーストアアクセスパスワード)

nosecret

Signing key password (署名キーパスワード)

partner2

Global usage code (グローバル使用コード)

Test (テスト)

Mule DUNS identifier (Mule DUNS 識別子)

123456788

Mule location identifier (Mule 場所識別子)

partner2

Partner DUNS identifier (パートナー DUNS 識別子)

123456789

Partner location identifier (パートナーの場所識別子)

partner1

role in PIP (PIP のロール)

RESPONDER

PIP definition path (PIP 定義パス)

/PIP3A4/​V02_02​.xml
3. **\[OK\]**​ をクリックします。 #### [](#send-action-操作を追加する-2)Send Action 操作を追加する 購入注文確認メッセージを購入者アプリケーションに送信する ​**Send action**​ 操作を追加します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューから、​**\[RosettaNet\]**​ を選択して ​**\[Send action\]**​ 操作を ​**\[Listener\]**​ の横にドラッグします。 2. プロパティウィンドウで、次の項目を設定します。
項目 値

Display Name (表示名)

Send action

Module configuration (モジュール設定)

PO_R​esponderConfig_Seller
3. **\[OK\]**​ をクリックします。 #### [](#transform-message-コンポーネントの追加-2)Transform Message コンポーネントの追加 購入注文確認メッセージのメッセージ ID を、​`HTTP POST`​ への応答で使用するプレーンテキストに変換する ​**Transform Message**​ コンポーネントを追加します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューから、​**\[Core (コア)\]**​ を選択して ​**\[Transform Message\]**​ コンポーネントをキャンバス上の ​**\[Send action\]**​ の横にドラッグします。 2. プロパティウィンドウで、​**\[Output (出力)\]**​ セクションの括弧を次の DataWeave コードで上書きします。 ```dataweave %dw 2.0 output text/plain --- "Seller sent action message " ++ attributes.messageId ++ "\n" ``` ### [](#販売者アプリケーションの-2-番目のフローの作成)販売者アプリケーションの 2 番目のフローの作成 販売者アプリケーションの 2 番目のフローでは、購入者アプリケーションから肯定応答シグナルを受信し、シグナルに関する情報を記録します。また、購入者アプリケーションから購入注文要求メッセージを受信し、要求に関する情報を記録します。 #### [](#アクションソースを設定する-2)アクションソースを設定する デフォルトパス (​`/`​) へのコールが行われたときに Mule フローを開始するように ​**Action**​ ソースを設定します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューから、​**\[Rosettanet\]**​ を選択して ​**\[Action source\]**​ ソースをキャンバスにドラッグします。 2. **\[Module configuration (モジュール設定)\]**​ 項目に​`「PO_ResponderConfig_Seller」`​と入力します。 #### [](#logger-コンポーネントを追加する-3)Logger コンポーネントを追加する 肯定応答シグナルおよび購入注文要求メッセージに関する情報を記録する ​**Logger**​ コンポーネントを追加します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューから、​**\[Core (コア)\]**​ を選択して ​**\[Logger\]**​ コンポーネントをキャンバス上の ​**Completion source**​ の横にドラッグします。 2. **\[Message (メッセージ)\]**​ 項目に、次のテキストを入力します。 `Seller received action message #[attributes.messageId]` ### [](#販売者アプリケーションの-3-番目のフローの作成)販売者アプリケーションの 3 番目のフローの作成 販売者アプリケーションの 3 番目のフローでは、購入注文完了状態メッセージを購入者アプリケーションに送信し、購入注文完了状態メッセージに関する情報を記録します。このフローを作成するには、​**Action**​ ソースを設定し、​**Logger**​ コンポーネントを追加する必要があります。 #### [](#アクションソースを設定する-3)アクションソースを設定する 購入者アプリケーションから完了状態を受信するように ​**Action**​ ソースを設定します。 #### [](#logger-コンポーネントの追加)Logger コンポーネントの追加 購入注文完了状態メッセージに関する情報を記録する ​**Logger**​ コンポーネントを追加します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューから、​**\[Core (コア)\]**​ を選択して ​**\[Logger\]**​ コンポーネントをキャンバス上の ​**Action source**​ の横にドラッグします。 2. **\[Message (メッセージ)\]**​ 項目に、次のテキストを入力します。 `Seller action message #[attributes.replyAttributes.messageId] completed as #[payload.completionCode]` #### [](#アプリケーションを保存して実行する-2)アプリケーションを保存して実行する アプリケーションを保存するには、​**\[File (ファイル)\] > \[Save (保存)\]**​ をクリックします。 アプリケーションを実行するには、​**\[Run (実行)\] > \[Run as (別のユーザーとして実行)\] > \[Mule Application (Mule アプリケーション)\]**​ をクリックします。 ### [](#販売者アプリケーションの-xml)販売者アプリケーションの XML 販売者アプリケーションのフローをすばやく Mule アプリケーションに読み込むには、次のコードを Studio XML エディターに貼り付けます。 ```xml ``` ## [](#サンプルをテストする)サンプルをテストする 購入者アプリケーションと販売者アプリケーションをテストするには、アプリケーションの実行後に次の手順を実行します。 1. 購入者アプリケーションに購入注文要求を提供します。 2. 販売者アプリケーションに購入注文要求応答を提供します。 ### [](#購入注文要求ドキュメントの提供)購入注文要求ドキュメントの提供 購入者アプリケーションの ​`HTTP_InputListener`​ エンドポイントに対して HTTP POST を使用して、販売者に送信する購入注文要求を提供します。 [サンプル注文要求](https://s3-us-west-2.amazonaws.com/mulesoft-sites-vendorcontent/public-assets/sample-purchase-order-request-content.xml)​をダウンロードできます。次に、HTTP ツール (ブラウザープラグイン、PostMan などのスタンドアロンツール、または ​`curl`​ などのコンソールツール) を使用して、データを購入者アプリケーションに投稿します。 たとえば、次の ​`curl`​ コマンドは購入注文要求を投稿します。 `curl -v -H "Content-Type: application/xml" -XPOST --data-binary @sample-purchase-order-request-content.xml http://localhost:8801` RosettaNet Connector は、購入注文要求に基づいて RosettaNet メッセージを生成して販売者に送信し、HTTP POST 操作に対してメッセージ識別子を返します。コンソールの出力は次のようになります。 ```java INFO ... Seller received action message pMAIhTBMsGzAf/NFx83KBO9nt+T+DV2RNLhwlpNqnXM=0 INFO ... Buyer action message pMAIhTBMsGzAf/NFx83KBO9nt+T+DV2RNLhwlpNqnXM=0 completed as SUCCESS ``` ### [](#購入注文確認ドキュメントの提供)購入注文確認ドキュメントの提供 販売者アプリケーションの ​`HTTP_InputListener`​ エンドポイントに対して HTTP POST を使用して、購入者に送信する購入注文情報を提供します。 [サンプル購入注文確認](https://s3-us-west-2.amazonaws.com/mulesoft-sites-vendorcontent/public-assets/sample-purchase-order-confirmation-content.xml)​をダウンロードして、任意の HTTP ツールを使用して販売者アプリケーションにデータを投稿できます。 たとえば、次の ​`curl`​ コマンドは購入注文確認を投稿します。 `curl -v -H "Content-Type: application/xml" -XPOST --data-binary @sample-purchase-order-confirmation-content.xml http://localhost:8802` RosettaNet Connector は、購入注文確認に基づいて RosettaNet メッセージを生成して購入者に送信し、HTTP POST 操作に対してメッセージ識別子を返します。コンソールの出力は次のようになります。 ```java INFO ... Buyer received action message ng7+TalLLPTJZHok4tQSBi8RYZD8IsD9+iB85cubzM=1 INFO ... Seller action message sng7+TalLLPTJZHok4tQSBi8RYZD8IsD9+iB85cubzM=1 completed as SUCCESS ``` このサンプルアプリケーションが送信する購入注文確認アクションは単なる例です。実際の購入注文確認を送信するには、RosettaNet の ​`send-action`​ 操作で ​`replyAttributes`​ を設定して、対応する購入注文要求の受信時に提供された情報を提供する必要があります。これらの ​`replayAttributes`​ により、RosettaNet プロトコルは同時に発生する多くの要求を見分けることができます。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com) # Rosettanet Connector の例 この例は 2 つのアプリケーションで構成されています。 - 購入者アプリケーションは、購入注文要求メッセージを販売者アプリケーションに送信します。 - 販売者アプリケーションは、注文が履行されたときに購入注文確認メッセージを購入者アプリケーションに送信します。 次の図は、2 つのアプリケーションのリレーションを示しています。 ![購入者アプリケーションと販売者アプリケーションのリレーション](/mulesoft/current/ja-jp/rosettanet-connector/2.1/_images/rosettanet-state-diagram.png) ## [](#購入者アプリケーション)購入者アプリケーション 購入者アプリケーションは次のアクションを実行します。 1. 入力購入注文要求ドキュメントを ​`HTTP POST`​ 経由で受信します。 2. RosettaNet の ​**Send action**​ 操作を使用して、購入注文要求メッセージを販売者アプリケーションに送信します。 3. 購入注文要求メッセージのメッセージ ID を、​`HTTP POST`​ への応答で使用するプレーンテキストに変換します。 4. 販売者アプリケーションから肯定応答シグナルを受信し、シグナルに関する情報を記録します。 5. 販売者アプリケーションから購入注文確認メッセージを受信し、確認メッセージに関する情報を記録します。 6. 販売者アプリケーションから完了状態を受信し、完了状態に関する情報を記録します。 次のスクリーンショットは、購入者アプリケーションの Anypoint Studio アプリケーションフローを示しています。 ![購入者アプリケーションの Studio フロー](/mulesoft/current/ja-jp/rosettanet-connector/2.1/_images/rosettanet-buyer-visual-flow.png)
購入者の非公開キー、購入者の証明書、販売者の証明書が含まれる購入者アプリケーションのキーストアは、プロジェクトの ​src/main/resources​ にあります。
### [](#購入者アプリケーションの最初のフローの作成)購入者アプリケーションの最初のフローの作成 購入者アプリケーションの最初のフローでは、購入注文要求ドキュメントを ​`HTTP POST`​ 経由で受信して、販売者アプリケーションに RosettaNet アクションメッセージとして送信します。このフローを作成するには、新しい Mule プロジェクトの作成、​**HTTP Listener**​ ソースの設定、​**Send action**​ 操作の追加、​**Transform**​ コンポーネントの追加を行う必要があります。 #### [](#http-listener-ソースの設定)HTTP Listener ソースの設定 デフォルトパス (​`/`​) へのコールが行われたときに Mule フローを開始するように ​**HTTP Listener**​ ソースを設定します。 1. Studio で新しい Mule プロジェクトを作成します。 2. **\[Mule Palette (Mule パレット)\]**​ ビューから、​**\[HTTP\]**​ を選択して ​**\[Listener\]**​ コンポーネントをキャンバスにドラッグします。 3. プロパティウィンドウで、​**\[Connector configuration (コネクタ設定)\]**​ 項目の横にある ​**\[+\]**​ をクリックしてグローバル要素を追加します。 4. **\[Name (名前)\]**​ 項目に、​`「HTTP_InputListener」`​と入力し、デフォルト値を受け入れます。 #### [](#po_initiatorconfig_buyer-グローバル要素を追加する)PO\_I​nitiatorConfig\_Buyer グローバル要素を追加する **Send action**​ 操作の ​`PO_InitiatorConfig_Buyer`​ グローバル要素を追加します。 1. **Send action**​ 操作のプロパティウィンドウで、​**\[Module configuration (モジュール設定)\]**​ 項目の横にある ​**\[+\]**​ をクリックしてグローバル要素を追加します。 2. **\[RosettaNet Config (RosettaNet 設定)\]**​ ウィンドウで、次の項目を入力します。
Global HTTP Listener (グローバル HTTP リスナー) HTTP_Listener-config

Service Endpoint Path (サービスエンドポイントパス)

/partner1

Global HTTP Request (グローバル HTTP 要求)

HTTP_R​equest_configuration

Request Endpoint Path (要求エンドポイントパス)

/partner2

Keystore Path (キーストアパス)

/partner1.jks

Keystore Access password (キーストアアクセスパスワード)

nosecret

Signing key password (署名キーパスワード)

partner1

Global usage code (グローバル使用コード)

Test (テスト)

Mule DUNS identifier (Mule DUNS 識別子)

123456789

Mule location identifier (Mule 場所識別子)

partner1

Partner DUNS identifier (パートナー DUNS 識別子)

123456788

Partner location identifier (パートナーの場所識別子)

partner2

role in PIP (PIP のロール)

INITIATOR

PIP definition path (PIP 定義パス)

/PIP3A4/​V02_02​.xml
3. **\[OK\]**​ をクリックします。 #### [](#send-action-操作を追加する)Send Action 操作を追加する `PO_InitiatorConfig_Buyer`​ グローバル要素で定義された設定を使用して購入注文要求メッセージを販売者アプリケーションに送信するために、​**Send action**​ 操作を追加します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューから、​**\[RosettaNet\]**​ を選択して ​**\[Send action\]**​ 操作を ​**\[Listener\]**​ の横にドラッグします。 2. プロパティウィンドウで、次の項目を入力します。
項目 Value (値)

Display Name (表示名)

Send action

Module configuration (モジュール設定)

PO_I​nitiatorConfig_Buyer
#### [](#transform-message-コンポーネントの追加)Transform Message コンポーネントの追加 購入注文要求メッセージのメッセージ ID をプレーンテキストに変換する ​**Transform Message**​ コンポーネントを追加します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューから、​**\[Core (コア)\]**​ を選択して ​**\[Transform Message\]**​ コンポーネントを ​**\[Send action\]**​ の横にドラッグします。 2. プロパティウィンドウで、​**\[Output (出力)\]**​ セクションの括弧を次の DataWeave コードで上書きします。 ```dataweave %dw 2.0 output text/plain --- "Buyer sent action message " ++ attributes.messageId ++ "\n" ``` ### [](#購入者アプリケーションの-2-番目のフローの作成)購入者アプリケーションの 2 番目のフローの作成 購入者アプリケーションの 2 番目のフローでは、販売者アプリケーションから肯定応答シグナルを受信し、シグナルに関する情報を記録します。また、販売者アプリケーションから購入注文確認メッセージを受信し、メッセージに関する情報を記録します。 #### [](#アクションソースを設定する)アクションソースを設定する `/partner2`​ パスへのコールが行われたときに Mule フローを開始するように ​**Action source**​ ソースを設定します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューから、​**\[Rosettanet\]**​ を選択して ​**\[Action source\]**​ ソースをキャンバスにドラッグします。 2. **\[Module configuration (モジュール設定)\]**​ 項目に​`「PO_InitiatorConfig_Buyer」`​と入力します。 #### [](#logger-コンポーネントを追加する)Logger コンポーネントを追加する 肯定応答および購入注文確認メッセージに関する情報が含まれるメッセージを記録する ​**Logger**​ コンポーネントを追加します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューから、​**\[Core (コア)\]**​ を選択して ​**\[Logger\]**​ コンポーネントをキャンバス上の ​**Action source**​ の横にドラッグします。 2. **\[Message (メッセージ)\]**​ 項目に、次のテキストを入力します。 `"Buyer received action message #[attributes.messageId]"` ### [](#購入者アプリケーションの-3-番目のフローの作成)購入者アプリケーションの 3 番目のフローの作成 購入者アプリケーションの 3 番目のフローでは、販売者アプリケーションから完了状態を受信し、完了状態に関する情報を記録します。 #### [](#completion-source-を設定する)Completion Source を設定する 販売者からの購入注文完了状態メッセージをリスンするように ​**Completion source**​ ソースを設定します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューから、​**\[Rosettanet\]**​ を選択して ​**\[Completion source\]**​ ソースをキャンバスにドラッグします。 2. **\[Module configuration (モジュール設定)\]**​ 項目に​`「PO_InitiatorConfig_Buyer」`​と入力します。 #### [](#logger-コンポーネントを追加する-2)Logger コンポーネントを追加する 購入注文完了状態に関する情報を記録する ​**Logger**​ コンポーネントを追加します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューから、​**\[Core (コア)\]**​ を選択して ​**\[Logger\]**​ コンポーネントをキャンバス上の ​**Completion source**​ の横にドラッグします。 2. **\[Message (メッセージ)\]**​ 項目に、次のテキストを入力します。 `Buyer action message #[attributes.replyAttributes.messageId] completed as #[payload.completionCode]` #### [](#アプリケーションを保存して実行する)アプリケーションを保存して実行する アプリケーションを保存するには、​**\[File (ファイル)\] > \[Save (保存)\]**​ をクリックします。 アプリケーションを実行するには、​**\[Run (実行)\] > \[Run as (別のユーザーとして実行)\] > \[Mule Application (Mule アプリケーション)\]**​ をクリックします。 #### [](#購入者アプリケーションの-xml)購入者アプリケーションの XML 購入者アプリケーションのフローをすばやく Mule アプリケーションに読み込むには、次のコードを Studio XML エディターに貼り付けます。 ```xml ``` ## [](#販売者アプリケーション)販売者アプリケーション 販売者アプリケーションは次のアクションを実行します。 1. 入力購入注文要求確認ドキュメントを ​`HTTP POST`​ 経由で受信します。 2. RosettaNet の ​**Send action**​ 操作を使用して、購入注文確認メッセージを購入者に送信します。 3. 購入注文確認メッセージの RosettaNet メッセージ ID を、​`HTTP POST`​ への応答で使用するプレーンテキストに変換します。 4. 購入者アプリケーションから購入注文要求メッセージを受信し、要求メッセージに関する情報を記録します。 5. 購入者アプリケーションから肯定応答シグナルを受信し、シグナルに関する情報を記録します。 6. 購入者アプリケーションから完了状態メッセージを受信し、完了状態メッセージに関する情報を記録します。 次のスクリーンショットは、販売者アプリケーションの Anypoint Studio アプリケーションフローを示しています。 ![販売者アプリケーションの Studio フロー](/mulesoft/current/ja-jp/rosettanet-connector/2.1/_images/rosettanet-seller-visual-flow.png)
販売者の非公開キー、販売者の証明書、購入者の証明書が含まれる販売者アプリケーションのキーストアは、プロジェクトの ​src/main/resources​ にあります。
### [](#販売者アプリケーションの最初のフローの作成)販売者アプリケーションの最初のフローの作成 販売者アプリケーションの最初のフローでは、購入注文要求確認ドキュメントを ​`HTTP POST`​ 経由で受信して、購入者アプリケーションに RosettaNet アクションメッセージとして送信します。このフローを作成するには、新しい Mule プロジェクトの作成、​**HTTP Listener**​ ソースの設定、RosettaNet の ​**Send action**​ 操作の設定、​**Transform**​ コンポーネントの追加を行う必要があります。 #### [](#http-listener-ソースの設定-2)HTTP Listener ソースの設定 デフォルトパス (​`/`​) へのコールが行われたときに Mule フローを開始するように ​**HTTP Listener**​ ソースを設定します。 1. Studio で新しい Mule プロジェクトを作成します。 2. **\[Mule Palette (Mule パレット)\]**​ ビューから、​**\[HTTP\]**​ を選択して \[Listener\] コンポーネントをキャンバスにドラッグします。 3. プロパティウィンドウで、\[Connector configuration (コネクタ設定)\] 項目の横にある ​**\[+\]**​ をクリックしてグローバル要素を追加します。 4. **\[Name (名前)\]**​ に​`「HTTP_InputListener」`​と入力します。 5. **\[Port (ポート)\]**​ に​`「8082」`​と入力します。 6. **\[Read timeout (読み取りタイムアウト)\]**​ に​`「3000」`​と入力します。 #### [](#send-action-操作のグローバル要素を追加する)Send Action 操作のグローバル要素を追加する **Send action**​ 操作の ​`PO_ResponderConfig_Seller`​ というグローバル要素を作成します。 1. **Send action**​ 操作のプロパティウィンドウで、​**\[Module configuration (モジュール設定)\]**​ 項目の横にある ​**\[+\]**​ をクリックしてグローバル要素を追加します。 2. **\[RosettaNet Config (RosettaNet 設定)\]**​ ウィンドウで、次の項目を設定します。
項目 Value (値)

Global HTTP Listener (グローバル HTTP リスナー)

HTTP_Listener-config

Service Endpoint Path (サービスエンドポイントパス)

/partner2

Global HTTP Request (グローバル HTTP 要求)

HTTP_R​equest_configuration

Request Endpoint Path (要求エンドポイントパス)

/partner1

Keystore Path (キーストアパス)

/partner2.jks

Keystore Access password (キーストアアクセスパスワード)

nosecret

Signing key password (署名キーパスワード)

partner2

Global usage code (グローバル使用コード)

Test (テスト)

Mule DUNS identifier (Mule DUNS 識別子)

123456788

Mule location identifier (Mule 場所識別子)

partner2

Partner DUNS identifier (パートナー DUNS 識別子)

123456789

Partner location identifier (パートナーの場所識別子)

partner1

role in PIP (PIP のロール)

RESPONDER

PIP definition path (PIP 定義パス)

/PIP3A4/​V02_02​.xml
3. **\[OK\]**​ をクリックします。 #### [](#send-action-操作を追加する-2)Send Action 操作を追加する 購入注文確認メッセージを購入者アプリケーションに送信する ​**Send action**​ 操作を追加します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューから、​**\[RosettaNet\]**​ を選択して ​**\[Send action\]**​ 操作を ​**\[Listener\]**​ の横にドラッグします。 2. プロパティウィンドウで、次の項目を設定します。
項目 Value (値)

Display Name (表示名)

Send action

Module configuration (モジュール設定)

PO_R​esponderConfig_Seller
3. **\[OK\]**​ をクリックします。 #### [](#transform-message-コンポーネントの追加-2)Transform Message コンポーネントの追加 購入注文確認メッセージのメッセージ ID を、​`HTTP POST`​ への応答で使用するプレーンテキストに変換する ​**Transform Message**​ コンポーネントを追加します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューから、​**\[Core (コア)\]**​ を選択して ​**\[Transform Message\]**​ コンポーネントをキャンバス上の ​**\[Send action\]**​ の横にドラッグします。 2. プロパティウィンドウで、​**\[Output (出力)\]**​ セクションの括弧を次の DataWeave コードで上書きします。 ```dataweave %dw 2.0 output text/plain --- "Seller sent action message " ++ attributes.messageId ++ "\n" ``` ### [](#販売者アプリケーションの-2-番目のフローの作成)販売者アプリケーションの 2 番目のフローの作成 販売者アプリケーションの 2 番目のフローでは、購入者アプリケーションから肯定応答シグナルを受信し、シグナルに関する情報を記録します。また、購入者アプリケーションから購入注文要求メッセージを受信し、要求に関する情報を記録します。 #### [](#アクションソースを設定する-2)アクションソースを設定する デフォルトパス (​`/`​) へのコールが行われたときに Mule フローを開始するように ​**Action**​ ソースを設定します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューから、​**\[Rosettanet\]**​ を選択して ​**\[Action source\]**​ ソースをキャンバスにドラッグします。 2. **\[Module configuration (モジュール設定)\]**​ 項目に​`「PO_ResponderConfig_Seller」`​と入力します。 #### [](#logger-コンポーネントを追加する-3)Logger コンポーネントを追加する 肯定応答シグナルおよび購入注文要求メッセージに関する情報を記録する ​**Logger**​ コンポーネントを追加します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューから、​**\[Core (コア)\]**​ を選択して ​**\[Logger\]**​ コンポーネントをキャンバス上の ​**Completion source**​ の横にドラッグします。 2. **\[Message (メッセージ)\]**​ 項目に、次のテキストを入力します。 `Seller received action message #[attributes.messageId]` ### [](#販売者アプリケーションの-3-番目のフローの作成)販売者アプリケーションの 3 番目のフローの作成 販売者アプリケーションの 3 番目のフローでは、購入注文完了状態メッセージを購入者アプリケーションに送信し、購入注文完了状態メッセージに関する情報を記録します。このフローを作成するには、​**Action**​ ソースを設定し、​**Logger**​ コンポーネントを追加する必要があります。 #### [](#アクションソースを設定する-3)アクションソースを設定する 購入者アプリケーションから完了状態を受信するように ​**Action**​ ソースを設定します。 #### [](#logger-コンポーネントの追加)Logger コンポーネントの追加 購入注文完了状態メッセージに関する情報を記録する ​**Logger**​ コンポーネントを追加します。 1. **\[Mule Palette (Mule パレット)\]**​ ビューから、​**\[Core (コア)\]**​ を選択して ​**\[Logger\]**​ コンポーネントをキャンバス上の ​**Action source**​ の横にドラッグします。 2. **\[Message (メッセージ)\]**​ 項目に、次のテキストを入力します。 `Seller action message #[attributes.replyAttributes.messageId] completed as #[payload.completionCode]` #### [](#アプリケーションを保存して実行する-2)アプリケーションを保存して実行する アプリケーションを保存するには、​**\[File (ファイル)\] > \[Save (保存)\]**​ をクリックします。 アプリケーションを実行するには、​**\[Run (実行)\] > \[Run as (別のユーザーとして実行)\] > \[Mule Application (Mule アプリケーション)\]**​ をクリックします。 ### [](#販売者アプリケーションの-xml)販売者アプリケーションの XML 販売者アプリケーションのフローをすばやく Mule アプリケーションに読み込むには、次のコードを Studio XML エディターに貼り付けます。 ```xml ``` ## [](#サンプルをテストする)サンプルをテストする 購入者アプリケーションと販売者アプリケーションをテストするには、アプリケーションの実行後に次の手順を実行します。 1. 購入者アプリケーションに購入注文要求を提供します。 2. 販売者アプリケーションに購入注文要求応答を提供します。 ### [](#購入注文要求ドキュメントの提供)購入注文要求ドキュメントの提供 購入者アプリケーションの ​`HTTP_InputListener`​ エンドポイントに対して HTTP POST を使用して、販売者に送信する購入注文要求を提供します。 [サンプル注文要求](https://s3-us-west-2.amazonaws.com/mulesoft-sites-vendorcontent/public-assets/sample-purchase-order-request-content.xml)​をダウンロードできます。次に、HTTP ツール (ブラウザープラグイン、PostMan などのスタンドアロンツール、または ​`curl`​ などのコンソールツール) を使用して、データを購入者アプリケーションに投稿します。 たとえば、次の ​`curl`​ コマンドは購入注文要求を投稿します。 `curl -v -H "Content-Type: application/xml" -XPOST --data-binary @sample-purchase-order-request-content.xml http://localhost:8801` RosettaNet Connector は、購入注文要求に基づいて RosettaNet メッセージを生成して販売者に送信し、HTTP POST 操作に対してメッセージ識別子を返します。コンソールの出力は次のようになります。 ```java INFO ... Seller received action message pMAIhTBMsGzAf/NFx83KBO9nt+T+DV2RNLhwlpNqnXM=0 INFO ... Buyer action message pMAIhTBMsGzAf/NFx83KBO9nt+T+DV2RNLhwlpNqnXM=0 completed as SUCCESS ``` ### [](#購入注文確認ドキュメントの提供)購入注文確認ドキュメントの提供 販売者アプリケーションの ​`HTTP_InputListener`​ エンドポイントに対して HTTP POST を使用して、購入者に送信する購入注文情報を提供します。 [サンプル購入注文確認](https://s3-us-west-2.amazonaws.com/mulesoft-sites-vendorcontent/public-assets/sample-purchase-order-confirmation-content.xml)​をダウンロードして、任意の HTTP ツールを使用して販売者アプリケーションにデータを投稿できます。 たとえば、次の ​`curl`​ コマンドは購入注文確認を投稿します。 `curl -v -H "Content-Type: application/xml" -XPOST --data-binary @sample-purchase-order-confirmation-content.xml http://localhost:8802` RosettaNet Connector は、購入注文確認に基づいて RosettaNet メッセージを生成して購入者に送信し、HTTP POST 操作に対してメッセージ識別子を返します。コンソールの出力は次のようになります。 ```java INFO ... Buyer received action message ng7+TalLLPTJZHok4tQSBi8RYZD8IsD9+iB85cubzM=1 INFO ... Seller action message sng7+TalLLPTJZHok4tQSBi8RYZD8IsD9+iB85cubzM=1 completed as SUCCESS ``` このサンプルアプリケーションが送信する購入注文確認アクションは単なる例です。実際の購入注文確認を送信するには、RosettaNet の ​`send-action`​ 操作で ​`replyAttributes`​ を設定して、対応する購入注文要求の受信時に提供された情報を提供する必要があります。これらの ​`replayAttributes`​ により、RosettaNet プロトコルは同時に発生する多くの要求を見分けることができます。 ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com)