# tSAPBapi

複数の入出力パラメーターまたはドキュメントタイプパラメーターを使用し、SAPサーバーからデータを抽出、または、SAPサーバーへデータのロードを行います。

tSAPBapiはSAPサーバーに接続し、BAPIファンクションを呼び出して、SAPサーバーとの間でデータの抽出またはロードを行います。

## tSAPBapiの標準プロパティ

これらのプロパティは、標準ジョブのフレームワークで実行されているtSAPBapiを設定するために使われます。

標準のtSAPBapiコンポーネントは、ビジネスファミリーに属しています。

このフレームワーク内のコンポーネントは、すべてのサブスクリプションベースのTalend製品で利用できます。

情報メモ注: 「このコンポーネントにはsapjco.jarが必要です」と表示されたら、モジュールをダウンロードし、[SAP Java Connector](https://support.sap.com/ja/product/connectors/jco.html)の手順をご覧ください。

## 基本設定

| [Properties] (プロパティ) | 説明 |
| --- | --- |
| プロパティタイプ | <ul> <li> <p><span>[Built-in] (組み込み)</span>と<span>[Repository] (リポジトリー)</span>のいずれかです。</p> </li> <li> <p> <span>[Built-in] (組み込み)</span>: そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。</p> </li> <li> <p> <span>[Repository] (リポジトリー)</span>: スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。</p> </li> </ul> |
| [Use an existing connection] (既存の接続を使用) | このチェックボックスをオンにして、表示されたリストから、定義済みの接続詳細を再利用する、該当する接続コンポーネントを選択します。<br><br>ジョブに親ジョブと子ジョブが含まれている場合、リストには同じジョブレベルの接続コンポーネントだけが表示されます。 |
| [Server Type] (サーバータイプ) | 接続するサーバーのタイプとして[Application Server] (アプリケーションサーバー)または[Message Server] (メッセージサーバー)のいずれかを選択します。 |
| [Client] (クライアント) | SAPシステムクライアントIDを指定します。 |
| [UserId] (ユーザーID)と[Password] (パスワード) | ユーザー接続IDとパスワードを指定します。<br><br>パスワードを入力するためには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符で囲んで入力して[OK]をクリックし、設定を保存します。 |
| [Language] (言語) | SAPシステムの言語を指定します。 |
| [Host name] (ホスト名) | SAPサーバーが稼働しているホストの名前またはIPアドレスを入力します。 |
| [System number] (システム番号) | システム番号を入力します。<br><br>このフィールドは、[Server Type] (サーバータイプ)ドロップダウンリストから [Application Server] (アプリケーションサーバー)を選択した場合にのみ表示されます。 |
| [System ID] (システムID) | システムIDを入力します。<br><br>このフィールドは、[Server Type] (サーバータイプ)ドロップダウンリストから [Message Server] (メッセージサーバー)を選択した場合にのみ表示されます。 |
| [Group Name] (グループ名) | グループ名を入力します。<br><br>このフィールドは、[Server Type] (サーバータイプ)ドロップダウンリストから [Message Server] (メッセージサーバー)を選択した場合にのみ表示されます。 |
| [SAP Function] (SAP関数) | 呼び出すBAPIファンクションの名前を指定します。 |
| [tick it to enable multiple input/output;not tick it to enable document] (複数の入出力を有効にする場合は選択、ドキュメントを有効にする場合には選択を解除) | このチェックボックスをオンにすると、SAP関数の呼び出し時に複数の入力および出力パラメーターが使用されます。<br><br>SAP関数の呼び出し時にドキュメントタイプの入力および出力パラメーターを使用するには、このチェックボックスをオフにします。 |
| [Schema] (スキーマ)と[Edit schema] (スキーマを編集) | スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。<br><br>スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを利用できます。<br><br><ul> <li> <p> <span>[View schema] (スキーマを表示)</span>: スキーマのみを表示する場合は、このオプションを選択します。</p> </li> <li> <p> <span>[Change to built-in property] (組み込みのプロパティに変更)</span>: ローカルで変更を行うためにスキーマを<span>組み込み</span>に変更する場合は、このオプションを選択します。</p> </li> <li> <p> <span>[Update repository connection] (リポジトリー接続をアップデート)</span>: リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。</p> <p>変更を現在のジョブにのみ反映する場合は、変更後、<span>[No] (いいえ)</span>を選択し、<span>[Repository Content] (リポジトリーコンテンツ)</span>ウィンドウで再びこのスキーマのメタデータを選択します。</p> </li> </ul><br><br>[Schema] (スキーマ)リストと[Edit schema] (スキーマを編集)ボタンは、[tick it to enable multiple input/output;not tick it to enable document] (複数の入出力を有効にする場合は選択、ドキュメントを有効にする場合には選択を解除)チェックボックスがオフになっている場合にのみ表示されます。 |
| [Input] (入力) | テーブルの下の[+]ボタンをクリックして、必要な数の行を出力パラメーターとして追加し、入力パラメーターの各行に以下の属性を設定します:<br><br><ul> <li> <p> <span>[Name] (名)</span>: 入力パラメーター名を二重引用符で囲んで入力します。</p> </li> <li> <p> <span>[Type] (タイプ)</span>: セルをクリックし、ドロップダウンリストから入力パラメーターのタイプとして<span>[Single] (単一)</span>、<span>[Structure] (ストラクチャー)</span>、または<span>[Table] (テーブル)</span>を選択します。</p> </li> <li> <p> <span>[Schema] (スキーマ)</span>: セルを選択し、セルの<span>[...]</span>ボタンをクリックしてスキーマエディターを開き、入力パラメーターのスキーマを定義します。<span>[Single] (単一)</span>または<span>[Structure] (ストラクチャー)</span>タイプの入力パラメーターの場合、各カラムの値は、スキーマエディターの<span>[Value] (値)</span>カラムで定義されます。</p> </li> <li> <p> <span>[Source Row] (ソース行)</span>: <span>[Table] (テーブル)</span>タイプの入力パラメーターで、セルをクリックし、ドロップダウンリストからパラメーターの入力データの転送を受信するリンクを選択します。</p> </li> <li> <p> <span>[Changing] (変更)</span>: 入力パラメーターが変更パラメーターの場合は、このチェックボックスをオンにします。</p> </li> </ul><br><br>このテーブルは、[tick it to enable multiple input/output;not tick it to enable document] (複数の入出力を有効にする場合は選択、ドキュメントを有効にする場合には選択を解除)チェックボックスが選択されている場合にのみ表示されます。 |
| [Output] (出力) | テーブルの下の[+]ボタンをクリックして、必要な数の行を出力パラメーターとして追加し、出力パラメーターの各行に以下の属性を設定します:<br><br><ul> <li> <p> <span>[Name] (名)</span>: 出力パラメーター名を二重引用符で囲んで入力します。</p> </li> <li> <p> <span>[Type] (タイプ)</span>: セルをクリックし、ドロップダウンリストから出力パラメーターのタイプとして<span>[Single] (単一)</span>、<span>[Structure] (ストラクチャー)</span>または<span>[Table] (テーブル)</span>を選択します。</p> </li> <li> <p> <span>[Schema] (スキーマ)</span>: セルを選択し、セルの<span>[...]</span>ボタンをクリックしてスキーマエディターを開き、出力パラメーターのスキーマを定義します。</p> </li> </ul><br><br>このテーブルは、[tick it to enable multiple input/output;not tick it to enable document] (複数の入出力を有効にする場合は選択、ドキュメントを有効にする場合には選択を解除)チェックボックスが選択されている場合にのみ表示されます。 |
| [Die on error] (エラー発生時に強制終了) | このオプションをオンにすると、コンポーネントにエラーが発生した時にジョブの実行が停止されます。<br><br>このオプションが選択されていない場合、コンポーネントに発生したエラーはログに記録され、ジョブが続行されます。<br><br>デフォルトでは、このオプションは選択されていません。 |

## 詳細設定

| [Properties] (プロパティ) | 説明 |
| --- | --- |
| [SAP Properties] (SAPプロパティ) | 使用中のSAPシステムでカスタム設定を使用する必要がある場合は、カスタマイズするプロパティをこのテーブルで設定します。例:<br><br><ul> <li> <p>SAPシステムと<span>Talend Studio</span>の間にUnicode接続を確立するには、<kbd>jco.server.unicode</kbd>プロパティを追加してその値を<kbd>1</kbd>に設定する必要があります。このプロパティはSAP Java Connector 2.xを使用している場合に機能します。SAP Java Connector 3.0以降のバージョンでは不要です。 </p> </li> <li> <p>セキュリティで保護されたネットワーク通信(SNC)を使用してSAP接続を設定するには、このフィールドに以下のプロパティを追加し、設定する必要があります。</p> <ul> <li> <span>jco.client.snc_mode</span> </li> <li> <span>jco.client.snc_myname</span> </li> <li> <span>jco.client.snc_lib=.../sapcrypto/sapcrypto.dll</span> </li> <li> <span>jco.client.snc_partnername</span> </li> <li> <span>jco.client.snc_qop</span> </li> </ul> <div><span>情報メモ</span><span>注:</span>  上記プロパティの値はシステム環境によって異なります。プロパティの設定方法が不明な場合は、SAPシステムの管理者にお問い合わせください。</div> <p>SNCパラメータの設定については、<a href="https://help.sap.com/viewer/10977ac76c531014a966b3f130d4f853/7.0.36/en-US/d9e8a740bbaa4d8f8bee6f7b173bd99f.html" target="_blank">SNC の設定をご覧ください: SNCをサポートするRFC</a>と<a href="https://help.sap.com/viewer/10977ac76c531014a966b3f130d4f853/7.0.36/en-US/76128150317a47b6a326e63a17017729.html" target="_blank">通信パスを使用したAS ABAPへの外部プログラム</a>。</p> </li> </ul><br><br>このプロパティは、[Use an existing connection] (既存の接続を使用)チェックボックスがオンになっている場合は表示されません。 |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスをオンにすると、ジョブレベルやコンポーネントレベルでジョブ処理メタデータが収集されます。 |

## [Global Variables] (グローバル変数)

| 変数 | 説明 |
| --- | --- |
| グローバル変数 | ERROR\_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、[Die on error] (エラー発生時に強制終了)がオフになっている場合のみ機能します。<br><br>Flow変数はコンポーネントの実行中に機能し、After変数はコンポーネントの実行後に機能します。<br><br>フィールドまたは式に変数を入力する場合は、Ctrl + スペースを押して変数リストにアクセスし、使用する変数を選択します。<br><br>変数の詳細は、[コンテキストと変数を使用](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/contexts-and-variables)をご覧ください。 |

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| **使用ルール** | このコンポーネントは、通常、他の出力コンポーネントと共に開始コンポーネントとして、または他の入出力コンポーネントと共に中間コンポーネントとして使用されます。 |
| **サポート** | S4/HANAを含め、SAPのERP部分と連携するためにtSAPBapiを使用する必要があります。 |
| [Connections] (接続) | <ul> <li>外部リンク(このコンポーネントから別のコンポーネントへのリンク):<ul> <li> <p> <span>[Row] (行)</span>: [Main] (メイン)</p> </li> <li> <p> <span>[Trigger] (トリガー)</span>: サブジョブOK時、サブジョブエラー時</p> </li> </ul> </li> <li> <p>受信リンク(あるコンポーネントからこのコンポーネントへのリンク):</p> <ul> <li> <p> <span>[Row] (行)</span>: [Main] (メイン)、[Iterate] (反復処理)</p> </li> <li> <p> <span>[Trigger] (トリガー)</span>: [On Subjob Ok] (サブジョブがOKの場合)、[On Subjob Error] (サブジョブがエラーの場合)、[On Component Ok] ( コンポーネントがOKの場合)、[On Component Error] (コンポーネントがエラーの場合)</p> </li> </ul> </li> </ul><br><br>接続の詳細は、[ジョブにおける接続の使い方](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/using-connections-in-job)をご覧ください。 |
| 制限事項 | Talend StudioおよびTalend Studioをホストしているワークステーションに、SAPから提供された特定のJARファイルとDLLファイルを追加する必要があります。正確な手順は、32ビットまたは64ビットのWindowsやLinuxなど、使用しているプラットフォームで異なります。<br><br><ul> <li> <p>詳細については、<a href="https://help.qlik.com/talend/r/ja-JP/8.0/components/sap/installing-sap-jco">SAP Java Connectorのインストール方法</a>および<a href="https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/centralizing-sap-metadata" target="_blank">SAPメタデータを一元管理</a>を参照してください。</p> </li> </ul> |

**関連概念**

* [ドキュメントタイプパラメーターを使用したBAPI関数の呼び出しによるSAPシステムからのデータの取得](https://help.qlik.com/talend/ja-JP/components/8.0/sap/tsapbapi-txmlmap-tlogrow-tfixedflowinput-retrieving-data-from-sap-system-by-calling-bapi-function-using-document-type-parameters-standard-component-enterprise-this)
* [複数の入出力パラメーターを使用したBAPI関数の呼び出しによるSAPシステムからのデータの取得](https://help.qlik.com/talend/ja-JP/components/8.0/sap/tsapbapi-tlogrow-tfixedflowinput-tfixedflowinput-retrieving-data-from-sap-system-by-calling-bapi-function-using-multiple-input-output-parameters-standard-component-enterprise-this)