Version 25.3.9414

• Kintone コネクタを追加
• Kintone への認証
  • Password
  • API Token
  • OAuth
• 接続を完了する
• kintone 同期先へのデータ転送
• Kintone をリバースETL 同期先として使用する際の制限事項
  • サポートされていないテーブル
  • リクエスト内のテーブルデータの処理
• 詳細情報

CData Sync アプリケーションからKintone コネクタを使用して、Kintone からデータを取得してサポートされている任意の同期先に移動できます。これを行うには、コネクタを追加し、コネクタへの認証を行い、接続を完了する必要があります。

Kintone コネクタを追加

Sync でKintone のデータを使用できるようにするには、まず以下の手順でコネクタを追加する必要があります。

1. Sync のダッシュボードから接続ページを開きます。

2. 接続を追加をクリックしてコネクタを選択ページを開きます。

3. データソースタブをクリックしてKintone 行に移動します。

4. 行末にある接続を設定アイコンをクリックして、新しい接続ページを開きます。接続を設定アイコンが利用できない場合は、コネクタをダウンロードアイコンをクリックしてKintone コネクタをインストールします。新規コネクタのインストールについて詳しくは、接続を参照してください。

Kintone への認証

コネクタを追加したら、必須プロパティを設定する必要があります。

• 接続名 - 任意の接続名を入力します。

• URL - Kintone アカウントのURL を入力します。

CData Sync は、いくつかの方法でKintone への認証をサポートしています。以下から認証方法を選択し、認証の詳細を含む該当セクションに進みます。

• Password（デフォルト）

• API Token

• OAuth

Password

ユーザー資格情報で接続するには、次のプロパティを設定します。

• Auth Scheme：Password を選択。

• User：Kintone アカウントへの認証に使用するユーザー名を入力。

• Password：Kintone アカウントへの認証に使用するパスワードを入力。

API Token

API トークンで接続するには、以下を指定します：

• Auth Scheme - APIToken を選択。

• App Id - アプリのID を入力。これは、Kintone UI ダッシュボードのアプリの下にある一覧内の特定のアプリの番号です。

• API Token - API トークンを入力。トークンを取得するには：

  1. トークンを生成するアプリにアクセスして、設定アイコンをクリックします。

  2. アプリ設定タブでAPI トークンをクリックします。

  3. 生成するをクリックしてAPI トークンを生成します。

OAuth

OAuth カスタムクレデンシャルで接続するには、次のプロパティを指定します。

• Auth Scheme：OAuth を選択。

• OAuth Client Id：OAuth 認証サーバーにアプリケーションを登録した際に割り当てられたクライアントId を入力。

• OAuth Client Secret：OAuth 認証サーバーにアプリケーションを登録した際に割り当てられたクライアントシークレットを入力。

接続を完了する

接続を完了するには：

1. スキーマに、次のスキーマオプションのいずれか1つを選択します：

   • REST（デフォルト）- Kintone REST API に接続するにはこのオプションを選択。Kintone REST API は、3つの認証スキーム（Password、API Token、およびOAuth）をすべてサポートしています。

   • USER - Kintone USER API に接続するにはこのオプションを選択。Kintone USER API は、Password 認証スキームのみをサポートしています。

2. 高度な設定タブで接続の高度な設定を定義します。（ただし、ほとんどの場合これらの設定は必要ありません。）

3. 作成およびテストをクリックして接続を作成します。

kintone 同期先へのデータ転送

リバースETL では、以下のいずれかのモードを使用してデータをKintone に転送できます：

• Insert：このモードでは、ターゲットテーブルに新しいレコードを挿入できます。唯一の必要条件は、ソーステーブルに主キー（PK）が存在することです。

• Update：このモードは、Kintone アプリ内の複数のレコードの詳細を更新します。レコードは、レコード識別子（Id）またはユニークキー（値の重複を禁止する設定が有効になっているフィールド）を使用して識別できます。

  ユニークキーを有効にする方法については、Prevent users from entering duplicate values with Prohibit Duplicate Values Fields’ Settings を参照してください。

• Upsert：このモードは、既存のレコードを更新し、存在しない場合は新しいレコードを挿入します。レコードを更新するか挿入するかを決定するには、ユニークキーを使用する必要があります。

Kintone をリバースETL 同期先として使用する際の制限事項

Kintone 同期先はリバースETL に対応していますが、特定の制限事項があります。

サポートされていないテーブル

Sync は、ユーザーが入力したレコードを保存するテーブルに対してのみデータ転送をサポートします。アプリ設定、権限、自動化、および通知に関連するテーブルは、サポートされていません。

次のテーブルはサポートされていません：

• Permissions テーブル - FieldPermissionsEntities、RecordPermissionsEntities、ActionSettingsEntities

• Automation テーブル - ActionSettingsMappings、ProcessManagementActions、ReminderNotificationsTargets

• Notifications テーブル - PerRecordNotificationsTargets、ReminderNotificationsTargets

リクエスト内のテーブルデータの処理

テーブルデータがリクエストに含まれていない場合、テーブル内の既存のデータは変更されません。

テーブルデータがリクエストに含まれている場合：

• リクエストに含まれていないテーブル内のフィールドはすべて削除されます。

• 特定のフィールドを保持するには、その値がリクエストに明示的に含まれていることを確認してください。

詳細情報

CData Sync とKintone の連携について、詳しくはKintone Connector for CData Sync を参照してください。