お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

1. 概要 

連携項目は、データの送信時に、Creatorのフォーム内で外部サービスのデータを直接参照し、関連付けられるフォーム項目です。接続先サービスからリアルタイムで情報を取得する動的なルックアップとして機能します。手動でデータを入力する代わりに、連携項目を使用すると、接続先サービスにある既存のデータを検索してフォーム送信データに関連付けることができ、システム間の一貫性を維持し、Creatorアプリケーション内の重複データを防ぐのに役立ちます。

メモ：

この項目は読み取り専用であり、ユーザーはデータの一覧から選択することのみ可能です。

連携項目は、外部サービスで選択したタブからデータを取得し、フォーム内に表示します。この項目は、接続とデータソースを使用して機能します。項目の設定時に、既存の接続／データソースを選択することも、新しく作成することもできます。

連携項目を使用するタイミング

連携項目は、次の目的で使用できます。

1. 外部サービスのデータを参照して、Creatorアプリケーション内のタブを拡張する
   
2. 両方の製品で同じデータを再入力しないようにする
   
3. 接続先サービスで選択された値に基づいて、ワークフローを実行する。
   

情報：Creator内のアプリケーションの関連データを関連付けるには、ルックアップ項目を使用できます。

1.1 対象サービスでサポートされている項目

連携項目では、次を除く対象サービスのすべての種類の項目のデータを表示できます。

1. 複数行のテキスト、URL、メディア（画像、ファイルなど）を含む項目
   
2. ドロップダウンメニュー、ラジオボタン、チェックボックスで選択肢を表示する項目

連携項目でサポートされているサービスの一覧を確認してください。   

2. 利用例    

ある組織が、顧客サポート依頼を処理するためにZoho Creatorでサービス管理アプリケーションを構築しているとします。顧客情報は、Zoho Creatorの外部にあるCRM、ERP、HRMSプラットフォーム（例：Zoho CRM）などの外部システムで管理されています。

1. 両方のシステムで重複データを管理する必要があります
   
2. サポート担当者は、サポートチケットの作成時に顧客の詳細を手動で入力する必要があります
   
3. 一方のシステムが更新されたときに、もう一方のシステムの情報が古くなる可能性があります
   

連携項目を使用する場合：

1. これらの課題に対応するために、サポートチケットフォームに連携項目を追加し、接続先サービスから顧客データを取得できます。チケットを作成する際、担当者は詳細を手動で入力する代わりに、適切な顧客を検索して選択できます。連携項目には設定されたフィルターに基づいて関連する顧客のみが表示されるため、各チケットが有効な顧客データに関連付けられ、複数のシステム間でデータの一貫性を維持できます。
   

3. フォームへの連携項目の追加方法      

前提条件：フォームに連携項目を追加する前に、フォームを作成しておく必要があります。

1. アプリケーションの編集モードに移動し、左ペインで必要なフォームを選択します。
2. ［フォームビルダーを開く］ボタンをクリックします。
   
3. 左ペインの［特殊項目］にある［連携］項目を、中央にドラッグ＆ドロップするかダブルクリックします。
   
4. 連携ポップアップで、以下の詳細を選択します。
   
1. ［サービス］：データを取得する外部サービスを選択します。
   
2. ［データソース］：既存のデータソースがある場合はそれを使用し、手順cに進みます。ない場合は、［データソースを追加］をクリックして新しいデータソースを作成します。
   データソースを追加ポップアップで、以下を選択します。
1. ［接続］：既存の接続から選択するか、［新しい接続］
   を作成します。メモ：新しい接続を作成する場合、またはまだ認証されていない既存の接続を選択した場合、認証のために選択したサービスのアカウントにログインする画面にリダイレクトされます。
   
   
   
   メモ：表示されるデータは接続の種類によって異なります。管理者認証済みの接続では、管理者の認証を使用して外部サービスからデータが取得されます。ログインユーザー接続では、各ユーザーの認証を使用してデータが取得されます。
   
   
2. ［タブ］：データを取得するサービスの対象タブを選択します。
3. ［データソース名］：データソースの名前が自動入力されます。必要に応じて編集できます。［作成］をクリックします。
   
3. 連携ポップアップで必要な項目を選択します。
   
5. ［完了］をクリックします。
   
   連携項目を追加した後、項目名の設定、表示項目のカスタマイズ、必須項目への設定、フィルター条件の定義、説明の追加など、さまざまなプロパティを設定できます。
   

メモ：同じデータソースを複数の連携項目で使用できます。

4. 表示項目のカスタマイズ    

連携項目では、対象タブから複数の項目を同時に表示でき、最大3項目まで表示できます。

1. 表示される項目値の間に区切り文字を追加できます。
   
2. 区切り文字には書式なしテキストまたは特殊文字を使用でき、最大長は10文字です。
   
3. ハイフン（-）が初期設定の区切り文字です。
   
4. 選択した項目は、1つの結合された値としてまとめて表示されます。
   

たとえば、以下の連携項目では、Zoho CRMの連絡先タブから、名、姓、メールの3つの項目を取得します。項目値は区切り文字でカスタマイズされ、レポートには次の形式で表示されます：名 姓／メール。

メモ：表示項目を変更すると、既存のレコードは新しい表示形式を反映するよう更新されます。ただし、以前に保存された値は自動では更新されません。更新するには、ライブモードで連携項目のデータ同期を実行します。 

表示項目をカスタマイズする手順 

1. フォームビルダーで必要な連携項目を選択します。項目のプロパティが右ペインに表示されます。
2. 表示項目セクションで、必要な項目（連携サービスの対象タブの項目）を選択します。
3. 別の表示項目を追加するには、追加アイコンをクリックします。新しい表示項目が追加され、ドロップダウンから必要な項目を選択できます。
   
4. 表示項目の前にあるテキストボックスに区切り文字を追加します（必要な場合）。値が保存される形式は、［プレビュー］セクションで確認できます。区切り文字には、最大10文字の書式なしテキスト／特殊文字を使用できます。
5. 選択した表示項目を削除するには、削除アイコンをクリックします。選択した項目の順序を変更するには、並べ替えアイコンをクリックします。変更は自動保存されます。
   
   

5. 連携項目におけるレコードの絞り込み     

連携項目にフィルター条件を定義して、表示されるレコードを制御できます。その結果、アプリユーザーには、定義した条件を満たすレコードのみが表示され、選択できます。接続先サービスのすべてのレコードを表示するのではなく、指定した条件を満たすレコードのみを表示するように項目を設定できます。

フィルターにより、次のことが可能になります。

1. レコード一覧を絞り込む
   
2. 選択に関連するデータのみを表示する
   
3. 不要な表示を減らしてユーザー体験を向上する
   
4. ユーザーが適切で許可されたレコードを選択できるようにする
   

このフィルターは編集モードで設定する必要があり、ライブモードでは連携項目のデータに適用されます。

フィルター条件の種類     

フィルター条件は、次の2通りの方法で定義できます。

メモ：現在、フィルターは一部のQuickBooksサービスでのみサポートされています。今後、対応サービスを追加する予定です。

フィルターの設定手順 

1. フォームビルダーで必要な統合項目を選択します。右側のペインに項目のプロパティが表示されます。
2. 選択肢セクションにある［フィルターを設定］チェックボックスをクリックします。［フィルターを設定］ポップアップが表示されます。
3. ポップアップで、ドロップダウンから対象モジュールの項目、演算子、値を選択して条件を設定します。たとえば、フィルターをステータス 次の値と等しい 有効のように設定できます。各種条件の設定方法を確認してください。［+新しく追加］をクリックすると、複数の条件を追加できます。
   
   

   メモ：条件の演算子と条件演算子（AND、OR）は、選択したサービスに基づきます。
   
   
   現在のフォームの項目を使用して、動的な条件を設定できます。例：input.product_name。また、システム変数やグローバル変数を使用して動的な条件を設定することもできます。
4. ［完了］をクリックします。フィルターの概要が右側のペインに表示されます。ライブモードの統合項目には、条件を満たす項目のみが表示されるようになります。
   
   

6. 統合項目の設定方法 

以下の動画では、フォームに統合項目を追加する方法と、ライブモードでの動作を紹介しています。

7. 統合項目の動作 

アプリケーションのライブモードでは、統合項目は次のように動作します。

ユーザーは、接続済みサービスから取得されたデータの一覧から値を検索して選択できます。選択できる値は1つのみで、ユーザーは項目内で値を追加または編集することはできません。

表示されるデータは、使用する接続の種類によって異なります。たとえば、管理者認証の接続では管理者の認証情報を使用してデータを取得し、ユーザー固有の接続ではログイン中のユーザーの認証情報に基づいてデータを取得します。

値の表示  

この項目には、設定した表示項目に基づいて値が表示されます。複数の項目（最大3項目）をまとめて表示できます。

フォーム送信とレポート内のデータ  

選択した値はフォーム送信後に保存され、他のフォームデータとともにレポートで確認できます。この値は、フォームルール、承認、連携などのワークフローでも使用でき、選択されたデータに基づいて処理を実行できます。

フィルター使用時の動作  

フィルターが設定されている場合、定義された条件（静的または動的）を満たすデータのみが表示されるため、ユーザーは関連するデータだけを選択できます。

データの表示順  

データは、接続サービスから返される既定の順序で表示され、通常は最新のデータが最初に表示されます。

ソースデータ更新時の動作  

接続サービスでデータが更新されると、統合項目では新しく選択する際に更新後の値が反映されます。変更後に作成または更新されたデータには、最新の値が取り込まれます。ただし、既存のデータには以前に保存された値が保持され、自動では更新されません。これらのデータを更新するには、統合項目データの同期を実行できます。

データの検索  

統合項目の検索については、次のとおりです。

1. ユーザーは、設定したすべての表示項目で検索できます
   
2. 検索を開始するには、2文字以上入力する必要があります
   
3. 複数の表示項目を対象に検索できます。すべての表示項目の入力内容に一致するデータが表示されます。
   
4. 実行される検索の種類は、対象サービスと、項目に保存されているデータの種類によって異なります。
   

以下の画像は、Zoho CRMからデータを取得し、3つの項目の値を表示する統合項目を示しています。

8. 統合項目でサポートされているプロパティ 

統合項目には、以下のプロパティを設定できます。

9. 注意点  

1. 連携項目は読み取り専用で、ユーザーは一覧表示されたデータから値を選択することのみ可能です。データの追加や編集には対応していません。
   
2. データは、接続されている外部サービスから取得されたデータに基づいて表示されます。
   
3. ドロップダウンに表示される値は任意の順序で並べ替えることはできず、接続先サービスから返される初期設定の順序に従います。通常は最近のデータが先に表示されます。
   
4. フィルターが設定されている場合、定義された条件に一致するデータのみが表示されます。
   
5. 接続先サービスでデータが更新された場合、変更後に作成または編集されたデータにのみ更新後の値が反映されます。データ同期を実行しない限り、既存のデータには以前に保存された値が保持されます。
   
6. データの利用可否や構造は、接続先サービスの設定と権限によって異なります。
   
7. 項目内の検索結果は、外部サービスから取得されたデータと、設定された表示項目に基づきます。
   
8. 連携項目にデータが表示されるのは、対象サービス（例：Zoho CRM）のサブスクリプションで対象タブへのアクセスが許可されている場合のみです。たとえば、Zoho CRMのスタンダードプランを契約していて、Zoho CRMの発注書タブのデータを表示する連携項目を追加したとします。この場合、Zoho CRMのスタンダードプランでは発注書タブを利用できないため、この連携項目にはデータが表示されません。
   
   

10. 関連トピック    

1. 項目の追加と管理
   
2. ルックアップ項目