# tZendeskInput チケットやリクエストをZendeskサーバーから読み取ります。 情報メモ注: デフォルトで、このコンポーネントはTalend Studioと共には出荷されていません。機能マネージャーを使ってインストールする必要があります。 詳細は、[機能マネージャーを使って機能をインストール](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/install-features-to-talend-studio)をご覧ください。 ## tZendeskInputの標準プロパティ これらのプロパティは、標準ジョブのフレームワークで実行されているtZendeskInputを設定するために使われます。 標準のtZendeskInputコンポーネントは、Cloudファミリーに属しています。 このフレームワーク内のコンポーネントは、すべてのサブスクリプションベースのTalend製品で利用できます。 ## 基本設定 | プロパティ | 説明 | | --- | --- | | [Property type] (プロパティタイプ) | [Built-in] (組み込み)と[Repository] (リポジトリー)のいずれかです。

| | [Schema] (スキーマ)と[Edit Schema] (スキーマを編集) | スキーマとは行の説明のことです。処理して次のコンポーネントに渡すフィールド(カラム)数を定義します。Sparkジョブを作成する場合、フィールドの命名時は予約語のlineを避けます。

このコンポーネントは、ダイナミックスキーマ機能の利点を備えているので、ソースファイルから不明なカラムを取得したり、各カラムを個別にマッピングしなくてもソースからカラムを一括してコピーしたりできます。ダイナミックスキーマの詳細は、[ダイナミックスキーマ](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/dynamic-schema)をご覧ください。

ダイナミックスキーマ機能は、テーブルの不明なカラムを取得するしくみになっており、その他の目的には使用しないことをお勧めします。テーブルの作成には推奨しません。



スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。現在のスキーマがリポジトリータイプの場合は、3つのオプションを利用できます。

| | [Guess Schema] (推測スキーマ) | [Guess Schema] (推測スキーマ)ボタンをクリックしてテーブルスキーマを取得します。 | | [Server URL] (サーバーURL) | https://<your-account>.zendesk.comの形式でサーバーURL(すなわち、サブドメインURL)を入力します。 | | [Username] (ユーザー名) | ユーザー名を入力します。 | | [Token] (トークン) | Zendeskの管理ページで生成されるAPIトークンを入力します。

トークンを入力するためには、[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トークンを生成](https://support.zendesk.com/hc/en-us/articles/4408889192858-Generating-a-new-API-token)をご覧ください。 | | [Selection type] (選択タイプ) | 取得するデータのタイプをTicketsまたはRequestsから選択します。 | | [Query string] (クエリー文字列) | クエリーステートメントを入力します。関連情報は、[Search](https://developer.zendesk.com/api-reference/ticketing/ticket-management/search/#query-basics)をご覧ください。 | ## 詳細設定 | プロパティ | 説明 | | --- | --- | | [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスを選択すると、コンポーネントレベルでログデータを収集できます。 | ## グローバル変数 | 変数 | 説明 | | --- | --- | | グローバル変数 | NB\_LINE: 処理された行の数。これはAfter変数で、整数を返します。

ERROR\_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、[Die on error] (エラー発生時に強制終了)がオフになっている場合のみ機能します。

Flow変数はのコンポーネントの実行中に機能し、After変数はコンポーネントの実行後に機能します。

フィールドまたは式に変数を入力する場合は、Ctrl + スペースを押して変数リストにアクセスし、使用する変数を選択します。

変数の詳細は、[コンテキストと変数を使用](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/contexts-and-variables)をご覧ください。 | ## 使用方法 | 使用方法のガイダンス | 説明 | | --- | --- | | **使用ルール** | このコンポーネントは、通常、ジョブまたはサブジョブの開始コンポーネントとして使われ、出力リンクが必要です。 | | [Dynamic settings] (ダイナミック設定) | [+]ボタンをクリックしてテーブルに行を追加し、[Code] (コード)フィールドにコンテキスト変数を入力して、ジョブ内で計画した複数の接続からデータベース接続をダイナミックに選択します。この機能は、データストラクチャーが同じでデータベースが異なるデータベーステーブルにアクセスする必要がある場合、特に、Talend Studioを介さずにジョブをデプロイおよび実行する必要がある時など、ジョブの設定を変更できない環境で作業している場合に役立ちます。

[Dynamic settings] (ダイナミック設定)テーブルは、[Basic settings] (基本設定)ビューで[Use an existing connection] (既存の接続を使用)チェックボックスがオンになっている時のみ利用可能です。ダイナミックパラメーターを定義すると、[Basic settings] (基本設定)ビューの[Component List] (コンポーネントリスト)ボックスは利用できなくなります。

ダイナミックパラメーターの定義法を示すユースケースについては、[コンテキストベースのダイナミック接続によってデータベースからデータを読み取り](https://help.qlik.com/talend/r/ja-JP/8.0/components/defining-context-groups/reading-data-from-databases-through-context-based-dynamic-connections)と、[ダイナミックにロードされた接続パラメーターを使って異なるMySQLデータベースからデータを読み取り](https://help.qlik.com/talend/r/ja-JP/8.0/components/context/reading-data-from-different-mysql-databases-using-dynamically-loaded-connection-parameters)をご覧ください。ダイナミック設定とコンテキスト変数の詳細は、[ダイナミックスキーマ](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/dynamic-schema)と[コンテキストグループを作成し、その中でコンテキスト変数を定義](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/creating-context-group-and-define-context-variables-in-it)をご覧ください。 | **関連概念** [Zendeskチケットを作成](https://help.qlik.com/talend/ja-JP/components/8.0/zendesk/creating-a-zendesk-ticket "このシナリオでは、Zendeskサーバー上にZendeskチケットを作成して、コンソールにチケットの指定されたフィールドを表示します。このシナリオでは、Zendeskユーザーアカウントがあり、[API Token access] (APIトークンアクセス)が有効化されていて、有効なAPIトークンがあることを前提としています。[API Token access] (APIトークンアクセス)を有効化やAPIトークンの生成に関する詳細は、新しいAPIトークンを生成をご覧ください。") [Zendeskチケットをアップデートまたは削除](https://help.qlik.com/talend/ja-JP/components/8.0/zendesk/maintaining-zendesk-tickets "このシナリオでは、チケットで一部のフィールドをアップデートおよびチケットを削除する方法を説明します。Zendeskチケットをアップデートまたは削除するには、チケットIDを入力し、実行する操作(すなわち、updateまたはdelete)を指定して、アップデート操作の場合は、目的のフィールドと新しいフィールド値を指定する必要があります。このシナリオでは、Zendeskユーザーアカウントがあり、[API Token access] (APIトークンアクセス)が有効化されていて、有効なAPIトークンがあることを前提としています。[API Token access] (APIトークンアクセス)を有効化やAPIトークンの生成に関する詳細は、新しいAPIトークンを生成をご覧ください。")