tZendeskOutputの標準プロパティ
これらのプロパティは、標準ジョブのフレームワークで実行されているtZendeskOutputを設定するために使われます。
標準のtZendeskOutputコンポーネントは、Cloudファミリーに属しています。
このフレームワーク内のコンポーネントは、すべてのサブスクリプションベースのTalend製品で使用できます。
基本設定
|
[Property type] (プロパティタイプ) |
[Built-in] (組み込み)と[Repository] (リポジトリー)のいずれかです。
|
|
[Schema] (スキーマ)と[Edit Schema] (スキーマを編集) |
スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。 このコンポーネントは、ダイナミックスキーマ機能の利点を備えているので、ソースファイルから不明なカラムを取得したり、各カラムを個別にマッピングしなくてもソースからカラムを一括してコピーしたりできます。ダイナミックスキーマの詳細は、ダイナミックスキーマをご覧ください。 ダイナミックスキーマ機能は、テーブルの不明なカラムを取得するしくみになっており、その他の目的には使用しないことをお勧めします。テーブルの作成には推奨しません。
スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを利用できます。
デフォルトでは、このコンポーネントは入力されたデータを使ってHTTPリクエストを生成します。独自のHTTPリクエストをZendeskサーバーに送信するためには、JSON_Stringという名前のカラムを作成し、JSON形式のHTTPリクエストボディをこのカラムに送信します。このコンポーネントがJSON形式の既存のチケットやリクエストを使ってHTTPリクエストを生成するようにしたい場合は、 ticketsまたはrequestという名前のカラムを作成し、チケットやリクエストをこのカラムに渡します。 カラム名では大文字と小文字が区別されます。 |
|
[Server URL] (サーバーURL) |
https://<your-account>.zendesk.comの形式でサーバーURL(すなわち、サブドメインURL)を入力します。 |
|
[Username] (ユーザー名) |
ユーザー名を入力します。 |
|
[Token] (トークン) |
Zendeskの管理ページで生成されたトークンを入力します。 トークンを入力するためには、[Token] (トークン)フィールドの横にある[...]ボタンをクリックし、[Enter a new password] (新しいパスワードを入力)ダイアログボックスを表示させ、テキストフィールドにトークンを入力してOKをクリックします。トークンは、[pure password] (純粋なパスワード)モードではJSON文字列で、[Java mode] (Javaモード)ではJava式として入力できます。テキストフィールドの上部にある[switch to Java mode] (Javaモードに切り替え)または[switch to pure password mode] (純粋なパスワードに切り替え)をクリックすることで、2つのモードの間で切り替えられます。
情報メモ注:
このコンポーネントには、[API Token access] (APIトークンアクセス)が有効化されており、有効なAPIトークンがあることが必要です。[API Token access] (APIトークンアクセス)の有効化やAPIトークンの生成に関する詳細は、新しいAPIトークンを生成をご覧ください。 |
|
[Selection type] (選択タイプ) |
書き込むデータのタイプをTicketsまたはRequestsから選択します。 |
|
データのアクション |
Zendeskサーバーのデータに行うアクションを、Create、Update、Deleteのいずれかから選択します。 |
詳細設定
|
[tStatCatcher Statistics] (tStatCatcher統計) |
このチェックボックスをオンにすると、コンポーネントレベルでログデータを収集できます。 |
|
[Max batch size] (最大バッチサイズ) |
バッチで処理できるチケットやリクエストの最大数を指定します。 |
グローバル変数
|
グローバル変数 |
NB_LINE: 処理された行の数。これはAfter変数で、整数を返します。 ERROR_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、[Die on error] (エラー発生時に強制終了)がオフになっている場合のみ機能します。 Flow変数はのコンポーネントの実行中に機能し、After変数はコンポーネントの実行後に機能します。 フィールドまたは式に変数を入力する場合は、Ctrl + スペースを押して変数リストにアクセスし、使用する変数を選択します。 変数の詳細は、コンテキストと変数を使用をご覧ください。 |
使用方法
|
使用ルール |
このコンポーネントは出力コンポーネントとして使用する必要があります。これによってZendeskサーバーのデータに対してアクションを実行できるようになります。 |
|
[Dynamic settings] (ダイナミック設定) |
[+]ボタンをクリックしてテーブルに行を追加し、[Code] (コード)フィールドにコンテキスト変数を入力して、ジョブ内で計画した複数の接続からデータベース接続をダイナミックに選択します。この機能は、データストラクチャーが同じでデータベースが異なるデータベーステーブルにアクセスする必要がある場合、特に、Talend Studioを介さずにジョブをデプロイおよび実行する必要がある時など、ジョブの設定を変更できない環境で作業している場合に役立ちます。 [Dynamic settings] (ダイナミック設定)テーブルは、[Basic settings] (基本設定)ビューで[Use an existing connection] (既存の接続を使用)チェックボックスがオンになっている場合のみ利用できます。ダイナミックパラメーターを定義すると、[Basic settings] (基本設定)ビューの[Component List] (コンポーネントリスト)ボックスは利用できなくなります。 ダイナミックパラメーターの定義法を示すユースケースについては、コンテキストベースのダイナミック接続によってデータベースからデータを読み取りと、ダイナミックにロードされた接続パラメーターを使って異なるMySQLデータベースからデータを読み取りをご覧ください。ダイナミック設定とコンテキスト変数の詳細は、ダイナミックスキーマとコンテキストグループを作成し、その中でコンテキスト変数を定義をご覧ください。 |