コマンドの設定を行うための準備作業として、CData Conenct Cloudにログインして以下を実施してください。

1. Conenctionの作成
   レコードデータを入力する接続先へのConnectionを作成してください。Connectionの作成手順は、CData Connect Cloudの製品ヘルプを参照してください。
   
   
2. Personal Access Token (PAT) の作成
   CData Connect Cloudのアカウント情報としてコマンドに設定するPersonal Access Tokenを作成してください。Personal Access Tokenの作成手順は、CData Connect Cloudの製品ヘルプを参照してください。

CData Connect Cloud入力コマンドは以下の手順で設定を行います。これらの設定は、CData Connect Cloud入力コマンドの設定タブで行います。

1. CData Connect Cloudのアカウント情報の登録
   コマンドの設定、およびデータ編集フローの実行時に使用するCData Connect Cloudのアカウント情報を保存する「外部サービス情報アプリ」の作成と、アカウント情報の登録を行います。登録したアカウント情報は「外部サービス設定一覧ページ」で参照することができます。
   
   
2. 読み込み対象データの設定
   コマンドで読み込むデータソースの選択、読み込むレコードの絞り込み条件、データ編集フローで使用するフィールドの選択など、読み込み対象データの設定を行います。
   

1. CData Connect Cloudのアカウント情報の登録

コマンドの設定を行うためには、連携するクラウドサービスのアカウント情報の登録とサインインを行う必要があります。

(1) アカウント情報を保存するkintoneアプリ（外部サービス情報アプリ）の作成

a. 「外部サービス情報アプリ」の［アプリを選択］ボタンをクリック

b. アプリ選択ダイアログで［新しい外部サービス情報アプリを作成する］をクリックし、任意のアプリ名を入力して［OK］ボタンをクリックし、外部サービス情報アプリを作成

c. アプリ選択ダイアログで作成した外部サービス情報アプリが選択されていることを確認し、［OK］ボタンをクリック

(2) CData Connect Cloudへサインインし、krewDataが接続することを許可

a. 「アカウント名」の［サインイン］ボタンをクリック

b. アカウントを選択ダイアログで［アカウントを追加］ボタンをクリック

c. CData Connect Cloudアカウント設定ダイアログでCData Connect CloudアカウントとPersonal Access Tokenを入力し、［OK］をクリック

2. 読み込み対象データの設定

コマンドで読み込むデータソースの選択、読み込むレコードの絞り込み条件、データ編集フローで使用するフィールドの選択など、読み込み対象データの設定を行います。設定項目の詳細は「設定項目」を参照してください。

1. レコードを読み込むデータソースを選択してください。

設定項目	説明
データソース	［データソースを選択］ボタンをクリックし、データソースを選択ダイアログでレコードを読み込むテーブルを選択します。 データソースを選択ダイアログの設定項目は以下の通りです。 CData Connect Cloudで作成したConnectionを選択 ドロップダウンリストから読み込み対象データのConnectionを選択します。 ※ドロップダウンリストにはCData Connect Cloudで作成済みのConnectionが表示されます。 レコードを読み込むテーブルを選択 一覧からレコードを読み込むテーブルを選択します。

2. データソースから読み込むレコードの絞り込み条件を設定してください。

設定項目	説明
標準フィルタ	外部入力ファイルから読み込むレコードの絞り込み条件を指定します。 標準フィルタの設定項目は、kintoneの標準フィルタと同様です。設定の詳細については、kintoneのヘルプの「一覧に表示するレコードを絞り込む」を参照してください。 指定済みの条件は「すべてクリア」ボタンで一括削除することができます。

3. データ編集フローで使用するフィールドを選択してください。

設定項目	説明
1. 使用するデータソースのフィールドを選択	データ編集フローで加工／集計に使用するフィールドを選択します。
2. kintoneアプリのフィールドタイプを選択	各フィールドのkintoneアプリのフィールドタイプを選択します。
3. 新しいフィールド名を入力（オプション）	選択したフィールドの名前を変更する場合は、新しいフィールド名を入力します。

コマンドの処理結果は、実行ログの「ログメッセージ」フィールドに以下の形式で出力されます。処理結果が「エラー」の場合は、CData Connect Cloud入力コマンドのエラー詳細を参照して対処を行ってください。

処理結果が「成功」の出力例

CData Connect Cloudからのデータ入力が完了しました。 - コマンド名: Connection1.DB1.Table1 - アカウント: user1@example.com - 処理結果: 成功 - CData Connect Cloudからのレスポンスデータ: ---------- Query ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx ----------

処理結果が「エラー」（SQLクエリの実行に失敗した場合）の出力例

CData Connect Cloud APIでエラーが発生しました。 SQLクエリの実行に失敗しました。 データソースのテーブルが変更されたなどの理由によりCData Connect Cloud入力コマンドで設定したデータが取得できません。エラーが発生したCData Connect Cloud入力コマンドでデータソース、使用するフィールドを再設定してください。 - コマンド名: Connection1.DB1.Table1 - アカウント: user1@example.com - 処理結果: エラー - CData Connect Cloudからのレスポンスデータ: ---------- Query ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx Error Code: QUERY_FAILED Error Message: The query failed with the following error: [500] Could not execute the specified command: Cannot obtain connection for 'Connection1': Failed to open connection for 'Connection1'. ----------

ログメッセージの出力項目

項目	説明
（ログメッセージ）	処理結果が「成功」の場合： CData Connect Cloudからのデータ入力が完了しました。 処理結果が「エラー」の場合： CData Connect Cloud APIでエラーが発生しました。 ｛エラー詳細メッセージ｝
コマンド名	ログメッセージを出力したデータ編集フロー内のコマンド名
アカウント	CData Connect Cloudのアカウント名
処理結果	成功／エラー
CData Connect Cloudからのレスポンスデータ	CData Connect Cloudから受信したレスポンスデータを出力します。 Query ID Error Code（処理結果が「エラー」の場合のみ） Error Message（処理結果が「エラー」の場合のみ） Query IDはCData Connect CloudのLogsページに出力されるログのQuery IDと同一です。CData Connect CloudのLogsページでkrewDataが行った処理結果を参照する際は、Query IDをキーに検索を行ってください。 エラー原因などについてCData社へお問い合わせを行う際は、「CData Connect Cloudからのレスポンスデータ」の内容を含めてお問い合わせください。

データ編集フローの実行時にCData Connect Cloudから読み込み可能なレコード数には上限があります。詳細については「上限設定」を参照してください。