テクニカル リファレンス

このセクションには、SAP BAPI の使用時に必要となる有用な情報が含まれています。

table 入力型の配列入力の構築

[BAPI を実行] アクティビティでは、BAPI のテーブル入力型は配列入力として表されます。これには、オブジェクトを手動で構築する必要があります。 私たちは、配列のマッピングを簡素化し、全体的なエクスペリエンスを向上させるソリューションに積極的に取り組んでいます。

このセクションでは、SAP BAPI でネイティブ型のテーブルと同等の配列入力を構築する方法を、デスクトップ版の Studio 2023.10 と Studio Web での例を交えて説明します。

このトピックについては、 BAPI_PO_CREATE オブジェクトの例で説明します。

デスクトップ版の Studio (言語: C#)

1. [ BAPI を実行 ] アクティビティで、 BAPI_PO_CREATE オブジェクトを選択します。
2. オブジェクトを選択すると、残りのフィールドが自動的に取得されます。
3. たとえば、 PO_ITEMSのテーブルの場合は、同等のオブジェクトの配列を構築します。 [PO_ITEMS] フィールドの横にあるプラス + ボタン メニューを選択して、[式エディター] を開きます。
4. [ 式エディター] ウィンドウに「 UiPath.IntegrationService.Activities.SWEntitiesと入力します。 項目のリストが読み込まれます。 IntelliSense を使用してトラバースを支援できます。
5. リストから、InArgument に対応する項目を選択します (この場合は bapis_sub_execute_TABLES_sub_PO_ITEMS_CREATE)。 このアイテムは、テーブルに対して常に一意です。
   
   

   

   
   
6. 次に、ピリオド (.) を入力し、使用可能なリストから Bundle.bapis_sub_execute_TABLES_sub_PO_ITEMS_Create を選択します。 末尾に角かっこを 2 組追加します ( []{})。
7. この時点で、配列がインスタンス化され、その中にオブジェクトを構築する準備が整います。
   
   

   

   
   
   手記：CEBA75DCD15 ID は UiPath 側で生成される一意の識別子で、各オブジェクトの SAP BAPI 接続に固有です。ID は各オブジェクトに固有です。
8. 前の手順の行をコピーし、末尾に括弧 () を追加します。 これで、オブジェクト内のプロパティをマップする準備が整いました。
   
   

   

   
   
9. 期間 (.) を入力して、オブジェクト内のすべてのプロパティを検索します。
   
   

   

   
   
10. 必要に応じてプロパティをマッピングし 、[保存] を選択します。
    
    

    

    
    

サンプル:

new UiPath.IntegrationService.Activities.SWEntities.CD6D3C0011F_bapis_sub_execute_TABLES_sub_PO_ITEMS_Create_CFXVARGYNSGMNQOY1M9XDRN8OK3VIHY.Bundle.bapis_sub_execute_TABLES_sub_PO_ITEMS_Create[] {
    new UiPath.IntegrationService.Activities.SWEntities.CD6D3C0011F_bapis_sub_execute_TABLES_sub_PO_ITEMS_Create_CFXVARGYNSGMNQOY1M9XDRN8OK3VIHY.Bundle.bapis_sub_execute_TABLES_sub_PO_ITEMS_Create()
    {
        PO_ITEM = 00001,
        PUR_MAT = "TG12",
        PLANT = "1710"
    },
    new UiPath.IntegrationService.Activities.SWEntities.CD6D3C0011F_bapis_sub_execute_TABLES_sub_PO_ITEMS_Create_CFXVARGYNSGMNQOY1M9XDRN8OK3VIHY.Bundle.bapis_sub_execute_TABLES_sub_PO_ITEMS_Create()
    {
        PO_ITEM = 00002,
        PUR_MAT = "TG12",
        PLANT = "1710"
    }
}

Studio Web (言語: VB)

同じ例を使って、Studio Web でこの結果を得る方法を見てみましょう。

1. [ BAPI を実行 ] アクティビティで、 BAPI_PO_CREATE オブジェクトを選択します。
2. オブジェクトを選択すると、残りのフィールドが自動的に取得されます。
3. たとえば、 PO_ITEMSのテーブルの場合は、同等のオブジェクトの配列を構築します。 [その他を表示] ボタンのメニューを選択して式エディターを開きます。
   
   

   

   
   
4. 「」と入力し Newスペースを入力してから、「」と入力します bapis。 これにより、IntelliSense がトリガーされ、項目の一覧が表示されます。 リストから、入力引数に一致する項目を選択します。この場合は bapis_sub_execute_TABLES_sub_PO_ITEMS_CREATE。 このアイテムは、テーブルに対して常に一意です。
   
   

   

   
   
   
   

   

   
   
5. 次に、中括弧のペアを {}追加します。 の括弧内にピリオド .を入力します。 その後、オブジェクト内で使用可能なプロパティを確認できます。
   
   

   

   
   
6. 必要に応じてプロパティをマッピングし 、[保存] を選択します。
   
   

   

   
   

サンプル:

{ 
    New bapis_sub_execute_TABLES_sub_PO_ITEMS_Create With 
    { 
        .PO_ITEM = 00001,
        .PUR_MAT = "TG12",
        .PLANT = "1710"
    },
    New bapis_sub_execute_TABLES_sub_PO_ITEMS_Create With 
    { 
        .PO_ITEM = 00002,
        .PUR_MAT = "TG12",
        .PLANT = "1710"
    }
}

よくある質問

SAP BAPI アクティビティ パッケージは Windows プロジェクトおよびクロスプラットフォーム プロジェクトに対応していますか?

はい、SAP BAPI アクティビティ パッケージは、デスクトップ版の Studio の Windows プロジェクトとクロスプラットフォーム プロジェクトの両方に対応しています。

BAPI の必須プロパティがすべてアクティビティ キャンバスに表示されないのはなぜですか?

特定の BAPI のプロパティが structure 型の場合、入力 (構造体) 自体は [ BAPI を実行] アクティビティのキャンバスには表示されませんが、その基になるプロパティは表示されます。 構造内の特定のプロパティが BAPI で必須であっても、プライマリキャンバスではオプションとして表示され、多くの場合、アクティビティのインターフェイスが煩雑になります。 SAP では、構造内でどの項目が必須であるかは示さず、必須構造に関する情報のみを提供します。 そのため、必要なフィールドを手動で特定し、適宜マッピングする必要があります。 この制限について詳しくは、SAP コミュニティのスレッド「 BAPI Mandatory Fields (BAPI 必須フィールド)」をご覧ください。

BAPI のテーブル入力型が表示されないのはなぜですか?

[BAPI を実行] アクティビティでは、BAPI のテーブル入力型は配列入力として表されます。これには、オブジェクトを手動で構築する必要があります。 「テーブル入力型の配列入力の構築」に示されている例を参照してください。

私たちは、配列マッピングを簡素化するソリューションに積極的に取り組んでいます。

キャンバスにすべての入力が表示されないのはなぜですか?

既定では、必須フィールドのみがメイン アクティビティ キャンバスに表示されます。 [ プロパティを管理 ] パネルで任意のフィールドにアクセスして設定できます。 必要な追加の入力を選択し、[ フィールドを更新 ] オプションを使用してそれらをプライマリ キャンバスに取り込みます。

RFCの呼び出しはサポートされていますか?

RFC の呼び出しは、SAP BAPI アクティビティ パッケージでは現在サポートされていません。

SAP BAPI アクティビティを使用するためのインストールの前提条件はありますか?

Integration Service の新しい SAP BAPI アクティビティを使用するために、インストールは必要ありません。 v2023.10 以降の UiPath Studio が必要です。または、Studio Web で直接オートメーションの作成を開始できます。

[BAPI を実行] アクティビティが成功したかどうかを確認するには、どうすればよいですか?

すべての BAPI では、出力テーブルセクション内に_RETURN配列が含まれています。これにより、 LOG_NO、 CODE、 MESSAGEなどの出力が提供されます。これらの値を確認して、BAPI 実行の成功または失敗を評価します。

ホスト名にDNS名の代わりにIPアドレスを使用できますか?

IPアドレスの使用には、一意性という大きな利点があります。 mycompany.com/sap/bapiなどの DNS 名を使用する場合は、DNS 変換、ルーティング、およびその他のネットワーク コンポーネントに依存します。これにより、潜在的な問題やネットワークの問題が発生する可能性があります。 そのため、より信頼性の高いコネクション作成エクスペリエンスを確保するために、IP アドレスを使用することをお勧めします。

SAP アプリケーションがオンプレミスまたは専用クラウドでホストされている場合、Integration Service の SAP BAPI アクティビティを使用できますか?

はい。 SAP S/4HANA システムが Azure などのクラウド プラットフォームでホストされている場合は、アクセスに十分なパブリック IP アドレスが必要です。 SAP システムがオンプレミスの場合は、特定の外部 IP アドレスからのアクセスを許可する必要があります。これには、ファイアウォール設定の構成が必要です。

システムは BAPI のコミットを自動的に処理しますか?

はい。 SAP Java コネクタを使用しているため、BAPI がコミットを必要としているかどうかが自動的に検出され、トランザクションが確実に保存されるように BAPI_TRANSACTION_COMMIT トリガーされます。 これにより、手動での介入が不要になります。