# tSAPConnection

ジョブデータ全体を一度に1つのトランザクションとしてSAPシステムにコミットします。

tSAPConnectionは、現在のトランザクションのためにSAPシステムへの接続を開きます。

## tSAPConnectionの標準プロパティ

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

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

このフレームワーク内のコンポーネントは、すべてのTalend製品で利用できます。

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

## 基本設定

| [Properties] (プロパティ) | 説明 |
| --- | --- |
| [Property type] (プロパティタイプ) | <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> |
| [SAP API Version] (SAP APIバージョン) | ドロップダウンリストから、バージョンを選択します。<br><br><ul> <li> <span>talend sap api</span>: SAP JCOドライバーの上のカスタムビジネスレイヤー。</li> <li> <span>sap jco 3. * (非推奨)</span>: <span>Talend Studio</span>がSAPのRFCプロトコルを介してSAPシステムと通信できるようにするドライバー。</li> </ul><br><br>Talend sap apiが選択されている場合にのみ、tSAPBapiとtSAPTableInputは開かれたSAP接続を再利用できます。<br><br>情報メモ非推奨: Talendが提供する8.0.1 R2022-05以降のTalend Studioマンスリーアップデートをインストール済みである場合、sap jco 3.\*の利用は非推奨です。詳細は管理者にお問い合わせください。 |
| 接続設定 | [Client type] (クライアントタイプ): 通常のSAP接続を入力します。<br><br>[Userid] (ユーザーID): ユーザーのログインを入力します。<br><br>[Password] (パスワード): パスワードを入力します。<br><br>[Language] (言語): 言語を指定します。<br><br>[Host name] (ホスト名): SAPシステムのIPアドレスを入力します。<br><br>[System number] (システム番号): システム番号を入力します。<br><br>パスワードを入力するためには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符で囲んで入力して[OK]をクリックし、設定を保存します。 |
| [Specify a shared destination] (共有デスティネーションを指定) | このチェックボックスをオンにし、表示された[Shared destination name] (共有デスティネーションの名前)フィールドに共有デスティネーションを指定します。共有デスティネーションにより、SAPのコンポーネントは、 Talend RuntimeコンテナーOSGi環境内でESBルートまたはESBデータサービスの一部として実行された時に、 Talend Runtimeの共有デスティネーションを使えます。<br><br>コンポーネントで共有デスティネーションの名前を指定するだけでなく、 Talend RuntimeのSAP DataSourceを設定する必要もあります。SAP DataSourceを定義するうえで必要なことと、それを設定する方法は、Talend ESBパッケージの/add-ons/datasource/sapフォルダーに含まれているreadme.txtに記載されています。<br><br>コンポーネント自体の接続設定を使う場合、SAP接続はコンポーネントの末尾で閉じることになります。これを防ぐには、共有の宛先を名前を指定した状態で使ってください。 |
| [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] (既存の接続を使用)チェックボックスがオンになっている場合は表示されません。 |

## 詳細設定

| [Properties] (プロパティ) | 説明 |
| --- | --- |
| [ftp and http based programs] (ftpとhttpをベースとするプログラム) | SAPサーバーからドキュメントのダウンロードが必要な機能を呼び出すには、このチェックボックスをオンにし、SAPシステムにSAPGUIがインストールされていることを確認します。<br><br>このチェックボックスがオンでSAPGUIがインストールされていない場合は、エラーが発生します。<br><br>[Basic settings] (基本設定)タブで[Use an existing connection] (既存の接続を使用)チェックボックスをオンにすると、このチェックボックスは利用できません。 |
| [tStat Catcher 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)をご覧ください。 |

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| **使用ルール** | このコンポーネントは、一般的に、他のtSAP\*コンポーネント、特にtSAPCommitおよびtSAPRollbackコンポーネントと共に使います。 |
| **サポート** | S4/HANAを含め、SAPのERP部分と連携するためにtSAPConnectionを使う必要があります。 |
| 制限事項 | 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> |

**関連概念**

* [tSAPInfoCubeInputを使ってデータを抽出する](https://help.qlik.com/talend/ja-JP/components/8.0/sap/tsapinfocubeinput-tsapconnection-tfileoutputdelimited-tlogrow-extracting-data-using-tsapinfocubeinput-about "tSAPInfoCubeInputコンポーネントを使って、SAPアプリケーションテーブルからデータを取得できます。")