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

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）は、選択したサービスによって異なります。
   
   
1. 現在のフォームの項目を使用して、動的な条件を設定できます。例：input.product_name。また、システム変数やグローバル変数を使用して動的な条件を設定することもできます。
   
2. 現在のフォームにある別の連携項目で選択された値も使用できます。たとえば、選択した取引先の連絡先だけを［連絡先］項目に表示するには、「取引先名がinput.account.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. ルックアップ項目