- パートナータブから、パートナーの名前をクリックし、続いてWorkflows タブを選択します。ドキュメントを追加してワークフローを起動する方法については、ドキュメントの選択または追加を参照してください。
- ドキュメントタブから、既存のドキュメントの名前をクリックするか、Add Document を選択して新しいドキュメントを作成します。ドキュメントを追加してワークフローを起動する方法については、ドキュメントタブからのドキュメントの作成を参照してください。
ドキュメントワークフローの追加
ドキュメントワークフローの定義には、次の手順が含まれます：- Add Document Workflow 画面を完了します。
- パートナータブからドキュメントを追加する場合は、Add Workflow をクリックしてドキュメントワークフローを起動します。この場合、Add Document Workflow 画面のフィールドは事前入力されています。ドキュメント名は変更できますが、その他のフィールドはすべて固定です。
- ドキュメントタブからドキュメントを追加する場合は、Add Document Workflow 画面のフィールドを手動で完了する必要があります。
- ソースまたは宛先のコネクタの選択と設定
- マッピングの設定。マッピングは、マッピングを使用しないFile、AMQP、Apache Kafkaを除くすべてのコネクタに適用されます。詳細については、マッピングなしのドキュメントワークフローを参照してください。
ソースまたは宛先の選択と設定
受信 ドキュメントを作成する場合は、データが追加される宛先コネクタを指定する必要があります。送信 ドキュメントを作成する場合は、データを取得するソースコネクタを指定する必要があります。利用可能なコネクタは、 のDatabaseコネクタおよびOtherコネクタ、Fileコネクタ、Workspace Sendコネクタ（受信ドキュメントのみ）、Workspace Receiveコネクタ（送信ドキュメントのみ）です。 次の画像は送信ドキュメントのソースの設定を示していますが、受信ドキュメントの宛先にも同じ原則が適用されます。この例では、パートナーのWorkflow タブからソースを定義していますが、Documents タブからも同じ結果を得ることができます。-
Workflow タブから、Add Source をクリックします。
-
Select Source 一覧でコネクタをハイライトし、Add をクリックします。
-
プラス記号を使用して新しいConnection を作成するか、ドロップダウンを使用して既存のものを選択します。
-
新しい接続を追加する場合は、Add Connection ウィンドウで次のフィールドを完了します：
- Name
- Server
- Port
- User
- Password
- AWS Access Key（オプション）
- AWS Secret Key（オプション）
- AWS Role ARN（オプション）
- Test Connection をクリックします。
-
送信ドキュメントで利用可能なアクションは
Selectのみであるため、接続を追加してテストしたら、Next をクリックします。（受信ドキュメントのアクションはUpsertです。詳細については、アクションを参照してください。）
- その他の設定タブ（Settings やAutomation など）を使用して、コネクタの設定を完了します。設定オプションの詳細については、疑問符のヘルプアイコンをクリックして、コネクタのドキュメントを開いてください。
- 最初のセットアップ後に接続を変更する必要がある場合は、Settings タブのConnection フィールドを使用します。
マッピングの設定
接続を確立したら、マッピングが必要なテーブルを選択する必要があります。受信ドキュメントを作成する場合は、Add Destination Structure をクリックします。送信ドキュメントを作成する場合は、Add Source Structure をクリックします。この例では宛先構造の追加を示しています。 次の画像は、完成したマッピングに、画面上の各要素を説明する注釈を付けたものです。各番号は以下の説明に対応しています。
- ドキュメントまたはコネクタの名前。
- コネクタの種類。
- ドキュメントのアクション。値は、受信ドキュメントの場合はUpsert、送信ドキュメントの場合はSelect です。
- マッピングのテストステータス。値は、Test Successful、Tested with Errors、またはNot Tested です。
- XML ストリーミングのオン / オフを切り替えます。オンの場合、マッピングエンジンは、ループの完了後に、マッピング内の最上位の
Foreachの現在のイテレーションのドキュメントオブジェクトモデル（DOM）を破棄します。これにより、大きなXML ドキュメントのパフォーマンスが大幅に向上します。マッピングエンジンがマッピングを解決できない場合は、自動的にXML ストリーミングをオフに切り替えます。 - XML 属性を表示するか非表示にするかを切り替えます。
- マッピングを更新します。
- Test Mapping ページを開きます。テスト結果は#4 に表示されます。（詳細については、マッピングのテストを参照してください。）
- マッピングを保存します。
- 設定されたデータソース内のターゲットテーブル。
- マッピングの方向。
- EDI ドキュメントのスキーマ（この例では810 請求書）。
- ソース側と宛先側の検索バー。
- ソーステーブルの構造。
- テーブルの名前。これはテーブルノードとも呼ばれます。
- テーブル内の列。これは列ノードとも呼ばれます。
- 宛先ドキュメントの構造。
- 完成したマッピング。
以前に保存したマッピングを編集するには、EDI > Documents をクリックし、続いてドキュメント名をクリックします。Document Workflow セクションで、Document Destination（受信ドキュメントの場合）またはDocument Source（送信ドキュメントの場合）のコネクタへのリンクをクリックします。
ソースと宛先について
前述のとおり、受信 ドキュメントを作成する場合は、データの送信先となる宛先コネクタを指定する必要があります。EDI ドキュメント構造は左ペインに、コネクタテーブル構造は右ペインに表示されます。 送信 ドキュメントを作成する場合は、データを取得するソースコネクタを指定する必要があります。この場合、コネクタテーブル構造は左ペインに、EDI ドキュメント構造は右ペインに表示されます。 には、テーブルおよびドキュメント構造内の情報を操作するさまざまな方法があります。詳細については、テーブル構造ノードおよびドキュメントノードを参照してください。 ドキュメントスキーマを変更する、またはソースや宛先のXML 構造を表すテンプレートファイルをアップロードするには、ドキュメントスキーマへのリンクをクリックしてUpload File を選択します。これは、パートナーが送受信を想定しているもののサンプルドキュメントを提供してくれる場合に役立ちます。例えば、パートナーがサンプルのX12 850 を提供してくれた場合、通常のワークスペースでX12 コネクタをX12 to XML モードで実行することで、それをXML に変換できます。続いて、その出力XML をテンプレートファイルとしてアップロードできます。
アクション
コネクタを設定する際には、2つのアクションが利用できます：- Upsert は受信ドキュメントのアクションです。このアクションは、ターゲットの宛先テーブルにデータを挿入または更新します。宛先テーブルにレコードがすでに存在する場合は、入力から提供された値を使用して既存のデータに対する更新が実行されます。
- Select は送信ドキュメントのアクションです。このアクションは、ターゲットのデータソースからデータを取得します。
テーブル構造ノード
このセクションでは、ソースまたは宛先のテーブル構造を表示するマッピングペインで利用可能なオプションについて説明します。構造には、テーブルノードと列ノードの2種類のノードがあります。テーブルノードはテーブル自体を表し、列ノードはテーブル内の列を表します。テーブルノード
テーブルノードはテーブルアイコンで示されます。テーブルノードにカーソルを合わせると、2つの追加オプションが表示されます：- じょうごアイコンをクリックすると、マッピングにフィルター条件を追加できるAdd Mapping Conditions ページが開きます。詳細については、条件エディタの使用を参照してください。（受信ドキュメントマッピングでのみ利用可能。）
-
省略記号をクリックすると、そのテーブルノードのオプション一覧が開きます：
- Rename Table では、ノードの名前を変更できます。
- Remove Table はノードを削除します。
- Table Settings は、マッピングに含める列、およびフィルターを適用するかどうかを選択できる編集ウィンドウを開きます。（送信ドキュメントマッピングでのみ利用可能。）
- Edit Columns は、マッピングに含める列を選択できる編集ウィンドウを開きます。（受信ドキュメントマッピングでのみ利用可能。）
- Add は、マッピングで作成して使用できるノードの新しい一覧を開きます。（受信ドキュメントマッピングでのみ利用可能。）オプションは次のとおりです：
- Add Header は、値をマッピングできるヘッダーノードを作成します。マッピングされた値は出力ファイルには含まれませんが、マッピング出力メッセージのヘッダーとして追加されます。
- Add Loop は、選択したノードの上にループノードを作成し、そのノードはループノード内にネストされます。詳細については、ループのマッピングを参照してください。
- Add Condition では、条件がtrue の場合にのみデータが宛先にUpsert されるよう、宛先ノードに条件を追加できます。詳細については、条件エディタの使用を参照してください。
- Add Code Script は、スクリプトノードに名前を付けてカスタムのScript を指定できるAdd Script ウィンドウを開きます。
- Add Variable は、選択したノードの下に変数ノードを作成します。詳細については、変数を参照してください。
列ノード
列ノードは、テーブル内の列を表します。すべての列ノードには、データベース内の列のデータ型である型があります。7つの異なるデータ型があり、それぞれに固有のシンボルがあります。列にカーソルを合わせると、そのデータ型、サイズ、null 許容かどうかが表示されます。データ型は次のとおりです：- String
- Number
- Binary
- Boolean
- Date
- Time
- Date and Time
- Rename Column では、ノードの名前を変更できます。
- Remove Column はノードを削除します。
- Add は、マッピングで作成して使用できるノードの新しい一覧を開きます。（受信ドキュメントマッピングでのみ利用可能。）オプションは次のとおりです：
- Add Header は、値をマッピングできるヘッダーノードを作成します。マッピングされた値は出力ファイルには含まれませんが、マッピング出力メッセージのヘッダーとして追加されます。
- Add Loop は、選択したノードの上にループノードを作成し、そのノードはループノード内にネストされます。詳細については、ループのマッピングを参照してください。
- Add Code Script は、スクリプトノードに名前を付けてカスタムのScript を指定できるAdd Script ウィンドウを開きます。
- Add Variable は、選択したノードの下に変数ノードを作成します。詳細については、変数を参照してください。
- Add Tracking は、追跡されたヘッダーをマッピングに追加します。ノードで追跡が有効になっていると、コンパスアイコンが表示されます。
ドキュメントノード
ドキュメントノードは、マッピングのもう一方の側、つまり非データベース側のノードを指します。これらのノードはデータソース（列を持つテーブル）に明示的に関連付けられているわけではなく、EDI データをXML 構造で表します。これらのノードは、送信ドキュメントの場合はマッピング先となり、受信ドキュメントの場合はマッピング元となります。 送信ドキュメント（Select アクションを使用）の場合、じょうごアイコンをクリックすると、マッピングにフィルター条件を追加できるAdd Mapping Conditions ページが開きます。詳細については、条件エディタの使用を参照してください。省略記号をクリックすると、宛先ドキュメントで次のオプションを使用できます：- Rename Node では、ノードの名前を変更できます。
- Edit XPath では、ノードのXPath を編集できます（すでに
Foreachとしてマッピングされている要素のみ）。 - Delete Node では、ドキュメントからノードを削除できます。
- Add Node
- Add Sibling は、選択したノードと同じレベルにノードを追加します。
- Add Attribute は、選択したノードに属性を追加します。
- Add Child は、選択したノードの子としてノードを追加します。
- Add Header は、値をマッピングできるヘッダーノードを作成します。マッピングされた値は出力ファイルには含まれませんが、マッピング出力メッセージのヘッダーとして追加されます。
- Add Loop は、選択したノードの上にループノードを作成し、そのノードはループノード内にネストされます。詳細については、ループのマッピングを参照してください。
- Add Condition は、条件がtrue の場合にのみデータが宛先にUpsert されるよう、条件を追加できる条件エディタを開きます。
- Add Code Script は、スクリプトノードに名前を付けてカスタムのScript を指定できるAdd Script ウィンドウを開きます。
- Add Variable は、選択したノードの下に変数ノードを作成します。詳細については、変数を参照してください。
- Cut Node は、選択したノードを現在の場所から切り取ります。
- Copy Node は、選択したノードをコピーします。
- Paste as Child は、切り取りまたはコピーしたノードを選択したノードの子として貼り付けます。
- Rename Node では、ノードの名前を変更できます。
- Delete Node では、ドキュメントからノードを削除できます。
- Add Node
- Add Sibling は、選択したノードと同じレベルにノードを追加します。
- Add Attribute は、選択したノードに属性を追加します。
- Add Child は、選択したノードの子としてノードを追加します。
- Cut Node は、選択したノードを現在の場所から切り取ります。
- Copy Node は、選択したノードをコピーします。
- Paste as Child は、切り取りまたはコピーしたノードを選択したノードの子として貼り付けます。
マッピングのテスト
マッピングを設定したら、テストする必要があります。ページ上部のTest Mapping ボタンをクリックします。次の画像は、受信ドキュメントのテストを示しています。
受信ドキュメントをテストする場合は、ライブデータでテストすることになります。Test Mapping をクリックすると、 はマッピングのテスト後に
upsert の実行を試みます。フィルターの使用
ソーステーブル構造でコネクタが選択するデータをフィルタリングする必要がある場合は、省略記号をクリックしてTable Settings を選択し、続いてFilters タブをクリックします。Edit <TableName> Settings ウィンドウが開き、個々のフィルターとフィルターグループを定義できます。
フィルタールールの作成
フィルターを作成するには、次の手順に従います：- Add Filter をクリックします。
- 新しいルールのドロップダウン一覧で、フィルタリングしたい列を選択します。
- フィルタリング条件を選択します。利用可能なフィルタリング条件は、選択する列のデータ型によって異なります。
- フィルタリング条件に値が必要な場合は、空白の値フィールドにその値を入力します。フィルタリング条件に値が不要な場合（例えば、Is Null を選択した場合）は、値フィールドが消えます。
フィルターグループ
Add Filter をクリックして、テーブルに複数のフィルターを適用できます。フィルターはグループで分けられ、デフォルトではすべてのフィルターが同じグループに属します。Add Group をクリックして、フィルターを分ける複数のグループを作成できます。 グループ内の各フィルターは、グループの上部で選択するオプションに基づいて、互いに作用します：- NOT トグルを使用して、フィルター条件を反転します。例えば、上記のAuthor フィルターの例でNOT トグルを有効にすると、コネクタはSmith を含まない Author の値を選択するよう指示されます。
- AND またはOR を選択して、複数のフィルターのグループロジックを決定します。
- AND を選択すると、フィルター条件を満たすには、グループ内のすべてのフィルターがtrue である必要があります。
- OR を選択すると、フィルター条件を満たすには、グループ内の少なくとも1つのフィルターがtrue である必要があります。複数のフィルターを満たすこともでき、結果は1つだけ満たされた場合と同じです。
クエリビューの使用
Query View をオンに切り替えると、データソースからデータを選択するカスタムSQL クエリを記述できます。これにより、デザイナーで作成されたクエリが上書きされます。