モデルが ERP システムを読み取りおよび更新する方法の管理
ERP 向けゼロコピーコネクタ で ERP (エンタープライズリソースプランニング) モデルを作成した後、パラメーターを使用して ERP システムを読み取りおよび更新する方法を指定できます。
モデルを作成および編集するには、sn_erp_integration.erp_admin ロールが必要です。
- エンティティの管理: 読み取るテーブル、OData サービス、または ERP システムの読み取りまたは更新に使用する BAPI (API に似たリモート プロシージャ呼び出し) を指定します。
- 入力を指定 (Specify inputs)：ERP システムのフィールドをパラメーターにマッピングする方法を定義して、データのクエリ方法を指定します。パラメーターを取得できない場合に ERP システムに渡すデフォルト値を定義することもできます。
- [出力を選択 (Choose output)]：出力を指定して、返されたデータを ServiceNow AI Platform に格納する方法を指定するパラメーターを定義します。
ERP システムの作成、読み取り、更新操作
ERP 向けゼロコピーコネクタ は、作成、読み取り、および更新操作を使用して ERP システムに接続します。
- BAPI、RFC、テーブルの読み取り、または OData を使用して、ERP システムを読み取ります。
- 読み取り操作のモデルにテーブル読み取りまたは BAPI 関数呼び出しのいずれかを追加しますが、両方を追加することはできません。
- テーブル読み取り操作に複数のテーブルを追加することができますが、関数呼び出しの読み取り操作に指定できる BAPI は 1 つだけです。
- 更新操作には、BAPI、RFC、OData、または IDoc を使用します。
- 作成操作には、BAPI、RFC、OData、または IDoc を使用します。
ERP 操作のテーブルとエンティティの管理
エンティティは、操作が ERP システムにアクセスして読み取りまたは更新する方法の基盤です。[エンティティを管理 (Manage entities)] タブを使用して、BAPI またはテーブル名を指定して、要求とその応答の内容を定義します。
- ERP 向けゼロコピーコネクタ が ERP システムからデータを取得する方法、または ERP システムに更新を送信する方法。
- エンティティの名前。
エンティティの追加手順については、「ERP 向けゼロコピーコネクタでモデルに操作を追加する」を参照してください。
操作入力パラメーターの管理
エンティティを指定すると、 ERP 向けゼロコピーコネクタ によって [ 入力を指定] タブに必要な入力パラメーターが自動的に入力されます。
ERP 向けゼロコピーコネクタ は、メソッド/関数呼び出しの一部としてパラメーターを使用して、ERP システムに渡されるデータを定義およびマッピングします。
- [出力パラメーター] セクションでは、ERP システムのクエリに使用されるパラメーターのオプションのデフォルト値を入力します。モデルのクエリ時に入力値が指定されていない場合は、各パラメーターの [デフォルト値] がフォールバックとして使用されます。デフォルト値は、定数のマッピングにも使用できます。
- テーブル (読み取り操作用)/関数呼び出し (BAPI 操作用) セクションでは、ERP 向けゼロコピーコネクタ が操作のパラメーターとして送信する ERP システムからのフィールドを定義してマッピングします。フィールドを選択すると、自動マッピング機能を使用してその マッピングされた値 を自動的に更新し、パラメーターの行を [出力パラメーター] セクションに追加します。[タイプ] として [定数] を定義し、[マッピングされた値] フィールドに定数値を入力すると、マッピングされた入力がフィルター基準として機能します。関連するパラメーターは、必要な数だけ追加してネストすることができます。
他のパラメーター (番地、市区町村など) を含む住所など、複雑なネストされたパラメーターを追加する場合、 ERP 向けゼロコピーコネクタ 追加の関連パラメーターが必要であることを自動的に識別します。 ERP 向けゼロコピーコネクタ では、関連する値の入力が必要な新しいネストされたパラメーター行が作成されます。ネストできるのは、データタイプがオブジェクトまたはアレイのパラメーターのみです。
- オブジェクト
- アレイ
- 文字列
- 日時
- 日付
- 時刻
- Char
- 10 進数
ユースケースの例としては、受注 BAPI を実行して、受注に含まれている明細を調べることが挙げられます。[マッピングされた値] フィールドで参照されるフィールドを定義するための自動マッピングオプションを使用して、テーブル (読み取り操作用)/関数呼び出し (BAPI 操作用) セクションでマッピングされたフィールドとして注文 ID を指定する必要があります。すべての操作の入力と出力を定義したら、 ワークフロースタジオでフローをビルドできます。フローで、ERP システムを呼び出すフローを実行するときに使用するパラメーターとして、注文 ID を入力します。
別の例としては、[テーブル] フィールド (テーブル読み取り操作用)/[関数呼び出し] (BAPI 操作用) セクションに [注文請求日 (Order billing date)] のパラメーターを追加し、その期間のすべての注文を取得する日付または日付範囲を指定できるフローをワークフロースタジオで構築します。
入力の管理手順については、「ERP 向けゼロコピーコネクタモデル操作の入力パラメーターの管理」を参照してください。
読み取り操作の出力の選択
データを ERP システムにマッピングして ServiceNow AI Platform に保存する方法を定義する出力パラメーターを作成する必要があります。
出力の管理手順については、「モデルの出力パラメーターの選択」を参照してください。
取得した ERP フィールドのテーブルへの追加
マッピングされたフィールドまたはパラメーターを出力として追加し、ERP システムを正常に読み取りまたは更新すると、各パラメーターがフィールドとして表示されます。その後、フィールドをリモートテーブルまたは抽出テーブルに追加できます。リモートテーブルまたは抽出テーブルのフィールドを管理して、取得したパラメーターを追加します。
ERP システムを呼び出すフローの構築
すべてのパラメーターを定義し、読み取り操作または更新操作を構築して実行したら、定義したパラメーターを使用するフローをワークフロースタジオで構築します。
フローのアクションの [必須項目] でパラメーターを選択するときに値を指定して、フィルター基準を入力します。詳細については、「ERP システムを読み取りまたは更新するフローのビルド」を参照してください。