BAPI/RFC関数を使用したマッピングとマッピングタスク

1. 1データ統合にBAPI/RFCマップレットを生成します。
2. 2生成されたBAPI/RFCマップレットを使用してマッピングを設定します。Integration IDフィールドおよびその他の入力と出力をマッピングします。マッピングを保存して実行するか、このマッピングを使用してマッピングタスクを作成します。

ビジネスサービスとしてのSAP BAPIコネクタの設定

BAPI/RFCマップレットの生成

1マップレットを作成するには、［データ統合］ > ［新規］ > ［マップレット］ > ［マップレット - SAP BAPI］をクリックし、［作成］をクリックします。
マップレットを編集するには、［エクスプローラ］ページでマップレットに移動します。マップレットが含まれている行で、［アクション］をクリックし、［編集］を選択します。
2BAPI/RFCマップレットの一意の名前を入力します。
3必要に応じて、生成するBAPI/RFCマップレットの説明を入力します。
4トランスフォーメーションタイプとして［BAPI］を選択します。
5 使用するBAPI/RFC接続を選択します。
6トランスフォーメーションの範囲を選択します。
リアルタイム処理には、トランスフォーメーション範囲に［トランザクション］を選択します。非本番環境でのバッチ処理および検証には、トランスフォーメーション範囲に［すべての入力］を選択します。
7 BAPI/RFC関数の名前を入力します。
BAPI/RFC関数は、「%」をワイルドカードとして検索文字列と共に入力することにより検索することもできます。例えば、「Customer」という語で始まる名前のBAPI/RFC関数をすべて検索するには、検索文字列を「Customer%」と入力します。「Customer」という語で終わる名前のBAPI/RFC関数をすべて検索するには、検索文字列を「%Customer」と入力します。
8［オブジェクトの取得］をクリックします。
［ソースオブジェクトの選択］ダイアログボックスが表示され、検索結果を表示します。［ソースオブジェクトの選択］ダイアログボックスに検索文字列を入力すると、検索結果をさらにドリルダウンできます。
9必要なBAPI/RFC関数名をクリックし、［選択］をクリックします。
BAPI/RFC関数のインポート、エクスポート、テーブルパラメータの詳細が表示されます。
10BAPIのテーブルパラメータが入力、出力、両方のいずれであるかを示す、テーブルの方向を指定します。
11［保存］をクリックします。
指定したBAPI/RFC関数用のマップレットが作成されます。生成したマップレット用のマッピングを作成できます。

BAPI/RFCマップレットを使用したマッピングの設定

1マッピングを作成するには、［Data Integration］ > ［新規］ > ［マッピング］をクリックします。［マッピング］を選択して、［作成］をクリックします。
2マッピングの名前と説明を入力し、［OK］をクリックします。
マッピング名には、英数字とアンダースコア（_）を使用できます。
3ソースを設定するには、［トランスフォーメーション］パレットで［ソース］をクリックします。
4［プロパティ］パネルの［全般］タブで、名前と説明を入力できます。
5［ソース］タブをクリックして、ソースの詳細を設定します。
接続タイプに基づいて、ソースの詳細と詳細ソースプロパティが表示されます。
6BAPI/RFCマップレットトランスフォーメーションを追加するには、［トランスフォーメーションパレット］で［マップレット］をクリックします。
1. a［全般］タブで、マップレットの名前と説明を入力します。
2. b以前のトランスフォーメーションをマップレットトランスフォーメーションに接続するリンクを設定します。
3. c［マップレット］タブで、［選択］をクリックします。
［マップレットの選択］ダイアログボックスが表示されます。
4. dデータ統合で生成したBAPI/RFCマップレットを指定し、［OK］をクリックします。
5. e［接続］をクリックし、SAP RFC/BAPIインタフェース接続を指定します。接続の作成、接続の選択、または接続のパラメータ名の指定を行うことができます。
6. fフィールドのプレビュー、フィールドルールの設定、またはフィールド名の変更を行うには、［追加フィールド］をクリックします。
7. g［フィールドマッピング］をクリックし、受信ソースフィールドとBAPI/RFCマップレットのIntegration IDをマッピングします。
7他のトランスフォーメーションを追加するには、［トランスフォーメーションパレット］でトランスフォーメーション名をクリックします。または、トランスフォーメーションをマッピングキャンバスにドラッグします。
1. a［全般］タブで、トランスフォーメーションの名前と説明を入力します。
2. b以前のトランスフォーメーションをトランスフォーメーションに接続するリンクを設定します。
トランスフォーメーションをリンクすると、ダウンストリームトランスフォーメーションは以前のトランスフォーメーションから追加フィールドを継承します。
ジョイナトランスフォーメーションの場合は、マスタリンクと詳細リンクを設定します。
3. cフィールドのプレビュー、フィールドルールの設定、またはフィールド名の変更を行うには、［追加フィールド］をクリックします。
4. d必要に応じて、トランスフォーメーションの追加プロパティを設定します。
設定するプロパティは、作成するトランスフォーメーションのタイプによって変わります。
5. e別のトランスフォーメーションを追加するには、これらの手順を繰り返します。
8ターゲットトランスフォーメーションを追加するには、［トランスフォーメーションパレット］で［ターゲット］をクリックします。
1. a［全般］タブで、名前と説明を入力できます。
2. b以前のトランスフォーメーションをターゲットトランスフォーメーションに接続するリンクを設定します。
3. c［ターゲット］タブをクリックして、ターゲットの詳細を設定します。必要に応じて、詳細なターゲットプロパティを設定します。
接続タイプに基づいて、ターゲットの詳細と詳細ターゲットプロパティが表示されます。
4. dフィールドのプレビュー、フィールドルールの設定、またはフィールド名の変更を行うには、［追加フィールド］をクリックします。
5. e［フィールドマッピング］をクリックして、書き込むフィールドをターゲットにマップします。
6. f別のターゲットトランスフォーメーションを追加するには、これらの手順を繰り返します。
9マッピングを保存して実行するか、マッピングタスクを保存および作成します。

BAPI/RFC関数を使用したマッピングの例

手順1: データ統合でbapi_salesorder_createfromdat1 BAPI関数用のBAPI/RFCマップレットを生成します。

データ統合にログインして、bapi_salesorder_createfromdat1 BAPI関数のメタデータが含まれるBAPI/RFCマップレットを生成します。

手順2: 生成されたマップレットを使用してマッピングを設定します。

マッピングを設定するには、次の手順を実行します。

1. 1ソースオブジェクトを指定して、ORDER_HEADER_IN構造体から注文ヘッダデータを、ORDER_PARTNERSテーブルを使用してパートナデータを、ORDER_ITEMS_INテーブルを使用して項目データを、それぞれ入力パラメータとして入力します。
2. 2マップレットトランスフォーメーションを追加します。フラットファイルソーストランスフォーメーションをマップレットトランスフォーメーションに接続するリンクを設定します。次のリンクを設定します。
• ▪ BAPIマップレットのScalar_Input入力ポートに対するORDER_HEADER_INソースオブジェクト。
• ▪ BAPIマップレットのTable_Input_Order_Items_IN入力ポートに対するORDER_ITEMS_INソースオブジェクト。
• ▪ BAPIマップレットのTable_Input_Order_partners入力ポートに対するORDER_PARTNERSソースオブジェクト。
3. 3マップレットトランスフォーメーションを設定します。
1. a生成されたマップレットを選択します。マップレットのSAP RFC/BAPIインタフェース接続を指定していることを確認します。
2. bBAPIパラメータプロパティを使用して入力ソースフィールドをマッピングします。
4. 4受注詳細を書き込むことができるフラットファイルオブジェクトを設定します。マップレットトランスフォーメーションのテーブル出力をフラットファイルターゲットトランスフォーメーションに接続するリンクを設定します。受注を書き込む複数のフラットファイルターゲットオブジェクトを作成します。次のターゲットオブジェクトを作成し、BAPIマップレットの関連付けられた出力ポートにマッピングします。
• ▪ 項目設定データを書き込むORDER_CFGS_BLOB、ORDER_CFGS_INST、ORDER_CFGS_PART_OF、ORDER_CFGS_REF、ORDER_CFGS_VALUE。
• ▪ 詳細項目データを書き込むORDER_ITEMS_OUT。
• ▪ クレジットカードの詳細を書き込むORDER_CCARD。
• ▪ 英語のフィールド名を使用してVBEPの構造を書き込むORDER_SCHEDULE_EX。
• ▪ マップレットからScalar_Outputを書き込むScalar_Output。
• ▪ マップレットからError_Outputを書き込むError_Output。

手順1: データ統合でのBAPI_SALESORDER_CREATEFROMDAT1 BAPI関数用のBAPI/RFCマップレットの生成

1マップレットを作成するには、［データ統合］ > ［新規］ > ［マップレット］ > ［マップレット - SAP］をクリックし、［作成］をクリックします。
マップレットを編集するには、［エクスプローラ］ページでマップレットに移動します。マップレットが含まれている行で、［アクション］をクリックし、［編集］を選択します。
［新規SAPマップレット］ページが表示されます。次の図に、［新規SAPマップレット］ページを示します。

2BAPI/RFCマップレットの一意の名前を入力します。
3必要に応じて、生成するBAPI/RFCマップレットの説明を入力します。
4トランスフォーメーションタイプとして［BAPI］を選択します。
5 使用するBAPI/RFC接続を選択します。
6トランスフォーメーションの範囲を選択します。
リアルタイムで、トランスフォーメーションオプションとして［トランザクション］を選択します。非プロダクション環境でのバッチ処理と検証の場合、トランスフォーメーション範囲として［すべての入力］を選択します。
7BAPI/RFC関数の名前を入力します。
注: 取得するBAPI/RFC関数の正確な名前を入力していることを確認します。
8［オブジェクトの取得］をクリックします。
BAPI/RFC関数のインポート、エクスポート、およびテーブルパラメータの詳細を確認できます。
9BAPIのテーブルパラメータが入力、出力、両方のいずれであるかを示す、テーブルの方向を指定します。
10［OK］をクリックします。
指定したBAPI/RFC関数用のマップレットが作成されます。生成したマップレット用のマッピングを作成できます。

手順2: bapi_salesorder_createfromdat1マップレットでのマッピングの設定

1マッピングを作成するには、［Data Integration］ > ［新規］ > ［マッピング］をクリックします。［マッピング］を選択して、［作成］をクリックします。
2マッピングの名前と説明を入力し、［OK］をクリックします。
3フラットファイルソースを設定するには、［トランスフォーメーション］パレットで［ソース］をクリックします。
4［プロパティ］パネルの［全般］タブで、名前と説明を入力します。
5［ソース］タブをクリックして、ソースの詳細を設定します。
1. aフラットファイル接続を選択します。
2. b［ソースタイプ］として［単一オブジェクト］を選択します。
3. c［選択］をクリックして、ソースフィールドが含まれるフラットファイルを指定します。
次の図に、フラットファイルソースの詳細を示します。

6マッピングのフラットファイルソースオブジェクトとして、注文ヘッダ、注文項目、および注文パートナを追加します。
7BAPI/RFCマップレットトランスフォーメーションを追加するには、［トランスフォーメーションパレット］で［マップレット］をクリックします。
1. a［全般］タブで、マップレットの名前と説明を入力します。
2. bフラットファイルソーストランスフォーメーションをマップレットトランスフォーメーションに接続するリンクを設定します。
3. c［マップレット］タブで、［選択］をクリックします。
［マップレットの選択］ダイアログボックスが表示されます。
4. dbapi_salesorder_createfromdat1マップレットを選択して、［OK］をクリックします。
5. e［接続］をクリックし、SAP RFC/BAPIインタフェース接続を指定します。
次の図に、bapi_salesorder_createfromdat1マップレットの詳細を示します。

6. fフィールドのプレビュー、フィールドルールの設定、またはフィールド名の変更を行うには、［追加フィールド］をクリックします。
7. g［フィールドマッピング］をクリックして、受信ソースフィールドを適切なマップレット入力フィールドにマッピングします。
次の図に、受信ソースフィールドとマップレット入力フィールドのフィールドマッピングを示します。

8フラットファイルターゲットを追加するには、［トランスフォーメーション］パレットで［ターゲット］をクリックします。
9［全般］タブで、マップレットの名前と説明を入力します。
10［ターゲット］タブをクリックして、ターゲットの詳細を設定します。
1. aターゲットのフラットファイル接続を選択します。
2. b［ソースタイプ］として［単一オブジェクト］を選択します。
3. c［選択］をクリックして、ターゲットオブジェクトを指定します。
［ターゲットオブジェクト］ダイアログボックスが表示されます。
4. dフラットファイルオブジェクトを選択して、［OK］をクリックします。
5. e必要に応じて、［詳細ターゲット］オプションで、拒否された行の転送を選択できます。
6. f上記の手順を繰り返して、すべてのフラットファイルターゲットオブジェクトを追加します。
次の図に、ターゲットトランスフォーメーションの詳細を示します。

11マップレットトランスフォーメーションの出力ポートをフラットファイルターゲットトランスフォーメーションに接続するリンクを設定します。
次の図に、bapi_salesorder_createfromdat1マップレットに設定されたマッピングを示します。

12マッピングを保存して実行します。

SAPマップレットプロパティ