---
schema_version: "1"
id: be58896bc4f27316d2abc503e6a7ac3f1122b6cc4388aeb89e265ef069d68c0e
title: メッセージ種別のリファレンスマップの作成
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/partner-manager/latest/create-reference-map.md
canonical_url: https://docs.mulesoft.com/jp/partner-manager/latest/create-reference-map
source_site: docs.mulesoft.com
content_type: documentation
content_hash: ffdd32e752ecdbaba5297f6541e9750f666a69ed277cf2bca8c0313eef38bdb7
description: MuleSoft Documentation Site
release: 2.x
latest: true
---
# メッセージ種別のリファレンスマップの作成

CSV、JSON、または XML 形式の新しい \[Source at Host (ホストの送信元)\] または \[Receive from Partners (パートナーから受信)\] メッセージ種別を作成する場合、そのメッセージ種別を DataWeave リファレンスマップに関連付ける必要があります。これは、EDFIACT または X12 形式の \[Receive from Partners (パートナーから受信)\] メッセージ種別では省略可能です。リファレンスマップには、実行時にメッセージペイロードから抽出されるカスタムメッセージ属性を含めることができます。抽出された属性はペイロードに表示され、検索や追跡で使用できます。

メッセージ種別の定義にアップロードされたスキーマが含まれている場合、リファレンスマップの入力はそのスキーマに準拠するペイロードです。

リファレンスマップの出力には次の項目が含まれます。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 33.3333%;">
<col style="width: 33.3333%;">
<col style="width: 33.3334%;">
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>項目</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>説明</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>必須または省略可能</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">partnerReferenceId</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">パートナーを一意に識別する識別子</p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必須:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>すべての [Source at Host (ホストの送信元)] メッセージ種別</p>
</li>
<li>
<p>CSV、JSON、または XML 形式の [Receive from Partners (パートナーから受信)] メッセージ種別</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>この値は、データ処理とルーティングのニーズに応じて静的値としてハードコード化できます。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">hostReferenceId</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">ホストを一意に識別する識別子</p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p>必須:</p>
<div class="ulist">
<ul>
<li>
<p>CSV、JSON、または XML 形式の [Receive from Partners (パートナーから受信)] メッセージ種別</p>
</li>
</ul>
</div>
</li>
<li>
<p>省略可能:</p>
<div class="ulist">
<ul>
<li>
<p>EDIFACT または X12 形式でフォーマットされた [Receive from Partners (パートナーから受信)] メッセージ種別</p>
</li>
<li>
<p>すべての [Source at Host (ホストの送信元)] メッセージ種別</p>
</li>
</ul>
</div>
</li>
</ul>
</div>
<div class="paragraph">
<p>この値は、データ処理とルーティングのニーズに応じて静的値としてハードコード化できます。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">businessDocumentKey。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">キーリファレンス値 (例: <code>Order Number (注文番号)</code>​ または ​<code>Invoice Number (請求書番号)</code>​)。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">省略可能</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">customAttributes</p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ペイロードから抽出するカスタムメッセージ属性の配列。特定の環境では、最大 100 件のカスタムメッセージ属性を指定でき、そのうち最大 25 件を検索可能にできます。
<br>
<br>
カスタムメッセージ属性を指定するには、リファレンスマップで以下の項目を設定します。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>alias</p>
<div class="paragraph">
<p>事前に定義されているカスタムメッセージ属性設定を一意に識別する別名。リファレンスマップの別名は、メッセージ種別の属性定義と一致する必要があります。マップに存在しない別名が含まれていると、メッセージ種別の作成や更新は失敗します。</p>
</div>
</li>
<li>
<p>values</p>
<div class="paragraph">
<p>注文番号や請求書番号などの値の配列。
<br>
<br>
抽出する属性が 1 つしか存在しない場合でも、文字列の配列を使用してください。配列を使用することで、1 対多のリレーションを持つトランザクション (1 通の出荷通知に複数の注文番号が含まれるようなトランザクションなど) をサポートできるようになります。</p>
</div>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>省略可能</p>
</div></div></td>
</tr>
</tbody>
</table>

リファレンスマップの出力は、次の検証スキーマに準拠している必要があります。

%dw 2.0
output application/json
---

{
	"definitions": {},
	"$schema": "http://json-schema.org/draft-07/schema#",
	"title": "Root",
	"type": "object",

	"properties": {
		"partnerReferenceId": {
			"type": "string",
			"default": "",
			"pattern": "^.\*$"
		},
		"hostReferenceId": {
			"type": \["string", "null"\],
			"default": "",
			"pattern": "^.\*$"
		},
		"businessDocumentKey": {
			"type": \["string", "null"\],
			"default": "",
			"pattern": "^.\*$"
		},
		"customAttributes": {
			"type": "array",
			"default": \[\],
			"items":{
				"type": "object",
				"required": \[
					"alias",
					"values"
				\],
				"properties": {
					"alias": {
						"type": "string",
						"default": "",
						"pattern": "^.\*$"
					},
					"values": {
						"type": "array",
						"default": \[\],
						"items":{
							"type": "string",
							"default": "",
							"pattern": "^.\*$"
						}
					}
				}
			}

		}
	}
}

リファレンスマップの出力が検証スキーマに準拠していないと、カスタムメッセージ属性は Partner Manager GUI に表示されません。次の Exchange の例に示すように、X12 EDI 用 Anypoint Connector (X12 Connector) の ​**Validate schema**​ 操作を MuleSoft アプリケーションに追加することで、リファレンスマップの出力が検証スキーマに準拠していることを保証できます。

- [B2B/EDI: Order to Cash - Mapping Examples (B2B/EDI: 受注から回収までのマッピングの例)](https://anypoint.mulesoft.com/exchange/com.mulesoft.muleesb.modules/b2b-order-to-cash-mapping/)
- [B2B/EDI: Procure to Pay Mapping Examples (B2B/EDI: 調達から支払までのマッピングの例)](https://www.mulesoft.com/exchange/com.mulesoft.muleesb.modules/b2b-procure-to-pay-mappings/)

リファレンスマップを作成する場合、それらのマップ内で他のソースメッセージ属性にアクセスできます。詳細は、​[「ソースメッセージ属性へのアクセス」^](https://docs.mulesoft.com/jp/partner-manager/latest/access-source-message-attributes)​を参照してください。

## [](#receive-from-partners-パートナーから受信-メッセージ種別のマップ例)\[Receive from Partners (パートナーから受信)\] メッセージ種別のマップ例

次のマップは、パートナーのインバウンド X12 ペイロードを変換します。このマップには、ビジネスドキュメントキーと 2 つのカスタムメッセージ属性が含まれています。

- ビジネスドキュメントキーの値は ​`payload.TransactionSets.v004010."855".Heading."020_BAK".BAK03[0]`​ です。
- `purchaseOrderNumber`​ カスタムメッセージ属性の値は ​`payload.TransactionSets.v004010."855".Heading."020_BAK".BAK03[0]`​ です。
- `vendorSalesOrderNumber`​ カスタムメッセージ属性の値は ​`payload.TransactionSets.v004010."855".Heading."020_BAK".BAK08[0]`​ です。

マップへの入力は次のようになります。

%dw 2.0
output application/json
{
	businessDocumentKey: payload.TransactionSets.v004010."855".Heading."020\_BAK".BAK03\[0\] default "",
	customAttributes: \[
		{
			alias: "purchaseOrderNumber",
			values: \[payload.TransactionSets.v004010."855".Heading."020\_BAK".BAK03\[0\]\]
		},
		{
			alias: "vendorSalesOrderNumber",
			values: \[payload.TransactionSets.v004010."855".Heading."020\_BAK".BAK08\[0\]\]
		}
	\]
}

生成されるマップの出力は次のようになります。

{
  "businessDocumentKey": "ORDER-70010",
  "customAttributes": \[
    {
      "alias": "purchaseOrderNumber",
      "values": \[
        "ORDER-70010"
      \]
    },
    {
      "alias": "vendorSalesOrderNumber",
      "values": \[
        "SO-5100803142"
      \]
    }
  \]
}

## [](#source-at-host-ホストの送信元-メッセージ種別のマップ例)\[Source at Host (ホストの送信元)\] メッセージ種別のマップ例

次のマップは、バックエンドからのアウトバウンド JSON または XML ペイロードを変換します。マップには、パートナーリファレンス Id、ホストリファレンス ID、ビジネスドキュメントキー、3 つのカスタム属性が含まれます。

- パートナーリファレンス ID の値は ​`payload.Header.CustomerName`​ です。
- ホストリファレンス ID の値は ​`payload.Invoice.Header.LineOfBusiness`​ です。
- ビジネスドキュメントキーの値は ​`payload.Invoice.Header.InvoiceNumber`​ です。
- `invoiceNumber`​ カスタム属性の値は ​`payload.Invoice.Header.InvoiceNumber`​ です。
- `purchaseOrderNumber`​ カスタムメッセージ属性の値は ​`payload.Invoice.Header.PurchaseOrderNumber`​ です。
- `invoiceAmount`​ カスタムメッセージ属性の値は ​`payload.Invoice.Header.TotalInvoiceAmt`​ です。

マップへの入力は次のようになります。

%dw 2.0
output application/json
---
{
	partnerReferenceId: payload.Invoice.Header.CustomerName,
	hostReferenceId: payload.Invoice.Header.LineOfBusiness default "MYTHICAL",
	businessDocumentKey: payload.Invoice.Header.InvoiceNumber,
	customAttributes: \[
		{
			alias: "invoiceNumber",
			values: \[payload.Invoice.Header.InvoiceNumber default "UNKNOWN"\]
	},
	{
			alias: "purchaseOrderNumber",
			values: \[payload.Invoice.Header.PurchaseOrderNumber default "UNKNOWN"\]
	},
	{
			alias: "invoiceAmount",
			values: \[ "\\$ " ++ payload.Invoice.Header.TotalInvoiceAmt default "UNKNOWN"\]
	}
\]
}

生成されるマップの出力は次のようになります。

{
  "partnerReferenceId": "ALPHA-CAN",
  "hostReferenceId": "Mythical-MG",
  "businessDocumentKey": "INV97750061",
  "customAttributes": \[
    {
      "alias": "invoiceNumber",
      "values": \[
        "INV97750061"
      \]
    },
    {
      "alias": "purchaseOrderNumber",
      "values": \[
        "ORD3893988"
      \]
    },
    {
      "alias": "invoiceAmount",
      "values": \[
        "$ 3756.24"
      \]
    }
  \]
}

## [](#dataweave-マップの-exchange-の例)DataWeave マップの Exchange の例

カスタムメッセージ属性を含む Exchange での DataWeave マップの例は、以下を参照してください。

- [B2B/EDI: Order to Cash - Mapping Examples (B2B/EDI: 受注から回収までのマッピングの例)](https://anypoint.mulesoft.com/exchange/com.mulesoft.muleesb.modules/b2b-order-to-cash-mapping/)
- [B2B/EDI: Procure to Pay Mapping Examples (B2B/EDI: 調達から支払までのマッピングの例)](https://www.mulesoft.com/exchange/com.mulesoft.muleesb.modules/b2b-procure-to-pay-mappings/)

## [](#関連情報)関連情報

- [メッセージ種別の作成](https://docs.mulesoft.com/jp/partner-manager/latest/partner-manager-create-message-type)
- [メッセージ種別設定の変更](https://docs.mulesoft.com/jp/partner-manager/latest/modify-message-type-settings)
- [メッセージ種別でのカスタムメッセージ属性の使用](https://docs.mulesoft.com/jp/partner-manager/latest/use-custom-attributes)