# tSAPDSOInputの標準プロパティ

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

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

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

情報メモ注: このコンポーネントにはsapjco.jarが必要であるという指示が表示されたら、それに従ってモジュールをダウンロードしてインストールします。

## 基本設定

| [Property Type] (プロパティタイプ) | 接続の詳細を設定する方法を選択します。<br><br><ul> <li> <p> <span>[Built-In] (組み込み)</span>: このコンポーネントの接続の詳細がローカルに設定されます。関連するすべての接続のプロパティ値を手動で指定する必要があります。</p> </li> <li> <p> <span>[Repository] (リポジトリー)</span>: <span><span>[Repository] (リポジトリー)</span> &gt; <span>[Metadata] (メタデータ)</span></span>で一元的に保存された接続の詳細が、このコンポーネントによって再使用されます。このチェックボックスの横にある <span>[...]</span> ボタンをクリックし、表示された <span>[Repository Content] (リポジトリーのコンテンツ)</span>ダイアログボックスで、再使用する接続の詳細を選択すると、関連するすべての接続のプロパティに値が自動的に入力されます。</p> </li> </ul> |
| --- | --- |
| [Use an existing connection] (既存の接続を使用) | このチェックボックスをオンにし、表示された[Connection configuration] (接続設定)ドロップダウンリストから、再利用する該当するデータベース接続が設定されているコンポーネントを選択します。<br><br>ジョブに親ジョブと子ジョブが含まれている場合、リストには同じジョブレベルの接続コンポーネントだけが表示されます。 |
| [Server Type] (サーバータイプ) | 接続するSAPサーバーのタイプ([Application Server] (アプリケーションサーバー)または[Message Server] (メッセージサーバー))を選択します。 |
| [Client] (クライアント) | SAPシステムのクライアントID。 |
| [UserId] (ユーザーID)と[Password] (パスワード) | ユーザーの接続IDとパスワード。<br><br>パスワードを入力するには、パスワードフィールドの横にある[...]ボタンをクリックし、ポップアップダイアログボックスにパスワードを二重引用符の間に入力し、OKをクリックして設定を保存します。 |
| [Language] (言語) | SAPシステムの言語。 |
| [Host name] (ホスト名) | SAPサーバーが実行されているホストの名前またはIPアドレス。 |
| [System number] (システム番号) | SAPのシステム番号。<br><br>このプロパティは、[Server Type] (サーバータイプ)ドロップダウンリストから、[Application Server] (アプリケーションサーバー)が選択されている場合のみ利用できます。 |
| [System ID] (システムID) | SAPのシステムID。<br><br>このプロパティは、[Server Type] (サーバータイプ)ドロップダウンリストから、[Message Server] (メッセージサーバー)が選択されている場合のみ利用できます。 |
| [Group Name] (グループ名) | SAPのグループ名。<br><br>このプロパティは、[Server Type] (サーバータイプ)ドロップダウンリストから、[Message Server] (メッセージサーバー)が選択されている場合のみ利用できます。 |
| [Schema] (スキーマ)と[Edit schema] (スキーマを編集) | スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。<br><br><ul> <li> <p> <span>[Built-in] (組み込み)</span>: そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。</p> </li> <li> <p> <span>[Repository] (リポジトリー)</span>: スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。</p> </li> </ul><br><br>スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。<br><br>情報メモ注: 変更を加えると、スキーマは自動的に組み込みになります。<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>: リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。変更を現在のジョブにのみ反映する場合は、変更後、<span>[No] (いいえ)</span>を選択し、<span>[Repository Content] (リポジトリーコンテンツ)</span>ウィンドウで再びこのスキーマのメタデータを選択します。</p> </li> </ul><br><br>このコンポーネントは、ダイナミックスキーマ機能の利点を備えているので、ソースファイルから不明なカラムを取得したり、各カラムを個別にマッピングしなくてもソースからカラムを一括してコピーしたりできます。ダイナミックスキーマの詳細は、*Talend Studio* *ユーザーガイド*をご覧ください。<br><br>このダイナミックスキーマ機能は、テーブルの不明なカラムを取得する目的で設計されており、この目的に限り使用をお勧めします。テーブルの作成で使用することは勧められていません。 |
| [Name] (名前) | データを取得するデータストアオブジェクトの名前を入力します。 |
| [Max row number] (最大行数) | 取得する行の最大数を指定します。デフォルトでは、値は-1に設定されています。これは、すべての行が取得されることを意味します。 |
| [Filter Group] (フィルターグループ) | 取得するデータのフィルタリングに使う検索条件を指定します。[ + ]ボタンをクリックして必要な行数を追加します。各行が検索条件となります。各条件に以下の属性値を設定するために使われます。<br><br><ul> <li> <p> <span>[Column] (カラム)</span>: 取得されたデータをフィルタリングする時のベースとなるスキーマカラムの名前を入力します。</p> </li> <li> <p> <span>[Sign] (記号)</span>: ドロップダウンリストから、<kbd>Include</kbd>または<kbd>Exclude</kbd>を選択します。</p> <ul> <li> <p> <kbd>Include</kbd>: 条件を満たすデータが取得されます。</p> </li> <li> <p> <kbd>Exclude</kbd>: 条件を満たさないデータが取得されます。</p> </li> </ul> </li> <li> <p> <span>[Operator] (演算子)</span>: ドロップダウンリストから、検索条件の設定に使うデータフィルター演算子を選択します。</p> </li> <li> <p> <span>[Value] (値)</span>: 検索条件の構成に使用する検索値を指定します。ワイルドカード文字はサポートされていません。</p> </li> <li> <p> <span>[High value] (高値)</span>: <span>Between</span>演算子の検索条件を構成するために使う別の検索値を指定します。</p> <p>日付型のカラムを使用してフィルターを指定する時は、<span>[Value] (値)</span>カラムと<span>[High Value] (高値)</span>カラム内の日付と時刻の値は、<kbd>yyyyMMdd</kbd>および<kbd>HHMMSS</kbd>の形式にする必要があります。これは、スキーマエディターで定義した形式とは異なる場合があります。ワイルドカード文字はサポートされていません。</p> </li> </ul><br><br>パターンを使用して検索値を指定する時は、以下のワイルドカード文字が使用できます。<br><br><ul> <li> <p> <kbd>*</kbd>: マッチングする文字数に制限はありません。</p> </li> <li> <p> <kbd>+</kbd>: 1文字にマッチングします。</p> </li> <li> <p> <kbd>#</kbd>: エスケープ文字(*, #など)に、および大文字小文字が区別される完全一致の比較に使用されます。</p> </li> </ul><br><br>情報メモ注: [Operator] (オペレーター)カラムのドロップダウンリストにある[Contains pattern] (パターンを含む)演算子は、将来の拡張のためのものです。 |
| [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接続はコンポーネントの末尾で閉じることになります。これを防ぐには、共有デスティネーションを名前を指定した状態で使ってください。 |
| [Use FTP-Batch Options] (FTPバッチオプションを使用) | 取得するデータのサイズが[Fetch size] (フェッチサイズ)フィールドで指定したサイズを上回る場合は、このチェックボックスをオンにします。このチェックボックスがオンの場合、SAPシステムは必要な数のファイルを生成し、取得したデータをそれらのファイルに書き込みます。続いて、こコンポーネントがFTP接続経由でファイルを読み取ってデータを取得し、取得したデータを出力コンポーネントに転送します。<br><br>このチェックボックスをオンにする時は、以下のプロパティを指定する必要があります。<br><br><ul> <li> <span>[File Protocol] (ファイルプロトコル)</span>: FTPまたはセキュリティで保護された代替SFTPを選択します。 </li> <li> <p> <span>[Host] (ホスト)</span>: FTPサーバーのIPアドレスまたはホスト名。</p> </li> <li> <p> <span>[Port] (ポート)</span>: FTPサーバーのリスニングポート番号。</p> </li> <li> <p> <span>[User] (ユーザー)</span>と<span>[Password] (パスワード)</span>: FTPサーバーへのアクセスに必要なユーザー認証データ。</p> </li> <li> <p> <span>[Directory] (ディレクトリー)</span>: SAPシステムによって生成されたファイルが保存されるディレクトリー。</p> </li> <li> <p> <span>[Data filename prefix] (データファイル名プレフィックス)</span>: SAPシステムによって生成されたファイルのプレフィックス。</p> </li> </ul> |

## 詳細設定

| [Fetch size] (フェッチサイズ) | BAPI コールやリクエストに応答してSAP BWデータベースから返される結果セットの最大サイズ(行数)を入力します。<br><br>デフォルトの値である-1を指定すると、デフォルトのフェッチサイズが使われます。このフェッチサイズはSAP側のJavaコードやBAPIによって決定されます。<br><br>ジョブに割り当てられたメモリスペースと、要求されたフィールドの数に応じてこのフィールドを設定することをお勧めします。与えられたメモリスペースにより、要求されたフィールドの数が多ければ多いほどフェッチサイズは小さくなります。 |
| --- | --- |
| [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><span> (英語のみ)</span>と<a href="https://help.sap.com/viewer/10977ac76c531014a966b3f130d4f853/7.0.36/en-US/76128150317a47b6a326e63a17017729.html" target="_blank">通信パスを使用したAS ABAPへの外部プログラム</a><span> (英語のみ)</span>。</p> </li> </ul><br><br>これらのプロパティは、[Use an existing connection] (既存の接続を使用)チェックボックスがオンになっている場合は表示されません。 |
| [SAP function extraction path] (SAP関数抽出パス) | このオプションを選択すると、抽出されたデータを保持するファイルを生成するSAP関数のディレクトリーを指定できます。右側のテキストフィールドにディレクトリーへのパスを入力します。<br><br>このオプションが選択されていない場合、ファイルは[Basic settings] (基本設定)ビューの[FTP directory] (FTPディレクトリー)フィールドで指定されたディレクトリーに生成されます。<br><br>このオプションは、[Basic settings] (基本設定)ビューで[Use FTP-Batch Options] (FTPバッチオプションを使用する)オプションを選択した場合に利用できます。<br><br>Talend Studioは、[SAP function extraction path] (SAP関数抽出パス)および[FTP directory] (FTPディレクトリー)フィールドで指定されたディレクトリーを同期しないため、これら2つのフィールドが同じリソースを指していることをご確認ください。<br><br>情報メモ注: このオプションは、TalendのR2021-01以降のStudioマンスリーアップデートをインストール済みである場合のみ利用できます。詳細は管理者にお問い合わせください。 |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスを選択すると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。 |

## グローバル変数

| ERROR\_MESSAGE | エラー発生時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。 |
| --- | --- |

## 使用方法

| 使用ルール | このコンポーネントは、通常、ジョブまたはサブジョブの開始コンポーネントとして使い、常に出力リンクが必要です。 |
| --- | --- |
| 制限事項 | SAPから提供された特定のjarファイルとdllファイルを、StudioおよびStudioをホストしているワークステーションに追加する必要があります。正確な手順は、32ビットまたは64ビットのWindowsやLinuxなど、使用しているプラットフォームで異なります。<br><br><ul> <li> <p>詳細は、<cite><span>Talend Studio</span>ユーザーガイド</cite>で<cite>SAP Java Connectorのインストール方法</cite>と「SAPメタデータを一元管理」をご覧ください。</p> </li> <li> <p>SAP Java Connectorのインストール方法の例は、<span>Talend Help Center</span> (<a href="https://help.talend.com/" target="_blank">https://help.talend.com</a><span> (英語のみ)</span>)および<span>Talend Studio</span>ユーザーガイドで「SAPメタデータを一元管理」をご覧ください。</p> </li> </ul><br><br>現在、DSO自体のフィールドのみを抽出できます。ナビゲーション属性の抽出はサポートされていません。 |