ライブモードと編集モードの接続

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

1. このページの内容

Zoho Creatorアプリケーションにおける外部連携の表示および管理、さらに有効化と編集方法について説明します。外部連携の詳細については、こちらをクリックしてください。

2. 利用可能範囲

外部連携について:

Creatorの有料プランのみで利用可能です。
スーパー管理者、管理者、開発者のみが作成および管理できます。他のユーザーは認証および利用が可能です。
United States (.com)、Europe (.eu)、India (.in)、Australia (.au)のデータセンターで利用できます。

3. 外部連携の表示方法

有効モードでの手順:

編集モードでの手順:

4. 外部連携の表示

外部連携はマイクロサービスセクションに一覧表示されるほか、アプリケーション内でも有効モードおよび編集モードの両方で表示・利用できます。この機能は全ユーザーが利用可能ですが、個々の外部連携の表示設定は、ログイン中のユーザー種別、アプリケーションコンポーネントに対するユーザー権限、および連携種別によって異なります。管理者および開発者は、システム外部連携も含めてすべての外部連携を表示できますが、他のアプリケーションユーザーは、ログイン中のユーザー種別の外部連携のみが表示されます。アプリケーション内でこの連携パネルが表示される位置については、こちらをご参照ください。

統合をクリックすると、スライダーが開き、アプリケーション内で有効な外部連携および決済サービスの使用状況が表示されます。編集モードの外部連携タブでは、該当コンポーネントで使用中の外部連携のみが表示され、各接続の基本詳細が確認できます。例：

サービス名前：接続が作成されたサービスの名前。
認証済みアカウント：接続を認証したアカウント名。自動生成されたこの名前は、認証済み勘定名の横にある編集アイコンをクリックすることで編集できます。
ステータス：接続の現在のステータスを示し、接続済みか未接続かが表示されます。
認証ボタン：まだ認証されていない場合、認証ボタンから接続の認証が可能です。
Connection 種類：接続の種類は、下記表のように異なるアイコンで表されます。

アイコン	種類
	管理者接続
	システム接続
	ユーザー接続

接続をクリックすると、権限、参照、設定などの詳細情報、および切り替えや取り消しの認可操作を表示できます。

4.1. 連携の配置

アクセス性と使いやすさを最適化するために、ユーザーはアプリケーション内で直接、外部連携を表示および管理できます（有効モードと編集モードの両方に対応）。

有効方法で外部連携を表示するには:

アプリケーション内でユーザー名の隣にある設定アイコン（）をクリックします。

メモ: 設定アイコン（

）の配置は、ご利用のアプリケーションテーマによって異なる場合がありますが、通常はユーザー名付近にあります。

外部連携をクリックします。

編集方法で外部連携を表示するには:

ビルダー画面右上のintegrationsアイコン（）をクリックします。

メモ: Delugeエディタから直接外部連携を表示するには、エディタ上部のIntegrationsを選択してください。

4.2. インストール済み外部連携

インストール済みアプリケーションに追加された外部連携はインストール済み外部連携として表示されます。アプリケーションがシステム連携と、同じサービスの連携がアカウント内に既に存在する場合、アプリケーションは既存の連携を参照し、一貫性を維持し重複を防ぎます。

5. 有効方法および編集方法での外部連携の認可

ユーザーは、アプリケーションの各コンポーネントから直接外部連携を認証し、利用できます。連携を認証するには、以下の手順に従ってください。

有効または編集モードでアプリケーションの連携画面に移動します。アプリ内のすべての外部連携がここに一覧表示されます。
「認証」をクリックします。
認証を利用する環境を選択します。この操作は、各環境ごとに異なる認証を利用するオプションが選択されている場合のみ必須です。詳細はこちら

メモ:OAuth2 種類の連携の場合、「認証」をクリックすると90秒間のタイマーが作動します。サービスの認証ページへリダイレクトされるので、アクセス権の許可を行ってください。

認証情報を入力し、90秒の制限時間内にアクセス権限を承認してください。

5.1. 未認証の連携を使用した場合のアプリケーションコンポーネントの挙動

未認証の連携がアプリケーション内のコンポーネント、ワークフロー、関数、またはブループリントで利用された場合、該当コンポーネントのアクセス時またはワークフローの実行時に認証を求めるプロンプトが表示されます。

admin 外部連携の場合、adminおよびsuper adminのみが接続の認証プロンプトを表示されます。他のユーザーは、adminが認証を完了するまで該当リソースへアクセスできません。表示されるメッセージではadminへ連絡するよう案内されます。adminが接続を認証することで、ユーザーはフォームにアクセスできるようになります。
system 外部連携の場合、super admin、admin、developerのみが接続の認証プロンプトを表示されます。他のユーザーは、super adminが認証を完了するまで該当リソースへアクセスできません。表示されるメッセージではadminまたはsuper adminへ連絡するよう案内されます。super adminが接続を認証することで、ユーザーはフォームにアクセスできるようになります。
logged-in ユーザー外部連携の場合、どの種類のユーザーにも接続認証のプロンプトが表示されます。

有効な方法での認証プロンプトが表示されるケース例：

ワークフローに未認証の外部連携が設定されているフォームを開いたとき。
パネル内に未認証の接続が含まれるページの場合。
未認証の接続を利用した連携レポートの場合。
有効なユーザーが、未認証のadmin外部連携またはsystem外部連携を持つフォームへアクセスした場合。

メモ:無効な connection や無効な connection を利用してアプリケーションコンポーネントへアクセスする場合も同様の動作となります。その場合、管理者がマイクロサービスから有効化し、ユーザーのアクセスを許可する必要があります。

6. Authorization の切り替え

メモ:

システム connectionの authorization 切り替えは、スーパー管理者、管理者、開発者のみが行えます。
管理者 connectionの authorization 切り替えは、すべての管理者が実施できます。
ログインユーザー connectionの authorization 切り替えは、認証担当者のみが実施可能です。

コネクションの切り替えは、新規に authorization を付与するプロセスです。次のような場合にも必要となります:

コネクションに紐づく認証情報の有効期限切れ
サードパーティサービスから認証トークンが無効化・削除された場合

メモ:コネクションの authorization を切り替えると、それを利用しているすべてのアプリケーションが今後は新しい authorization を使用します。

有効または編集モードのアプリケーションでコネクションの authorization を切り替えるには:

有効または編集モードでアプリケーションの外部連携に移動し、目的の接続をクリックします。
切り替えるをクリックします。
認証アカウントの名前を選択し、認証をクリックします。

メモ: OAuth2 種類の接続の場合、認証をクリックすると90秒のタイマーが開始されます。サービスの認可ページにリダイレクトされますので、アクセス許可を付与してください。

認証情報を入力し、90秒の制限時間内にアクセス権限を承認します。

7. 認証の取り消し

接続認証を取り消すと、その権限およびサードパーティサービスへのアクセスが削除され、この接続認証を利用しているコンポーネントは正常に動作しなくなります。

メモ:

システム接続の認証取り消しは、スーパ管理者・管理者・開発者のみが実行可能です。
管理者接続の認証は、すべての管理者が取り消すことができます。
ログインユーザー接続の認証取り消しは、認証担当者のみ実行できます。ログインユーザー接続に紐づく主要アカウントが取り消された場合、管理者は他の管理者のアカウントを主要として設定し、ユーザーが外部連携を認証できるようにしてください。
接続認証を取り消しても、同じ認証を利用する他の外部連携には影響しません。

アプリケーションの有効または編集モードで接続認証を取り消すには：

外部連携に移動し、有効または編集モードで目的の接続をクリックします。
取り消すをクリックします。

8. 関連付け済み Datasources

1つ以上のデータソースが接続されている場合、外部連携スライダーに「関連付け済み Datasources」セクションが表示されます。このセクションには、アプリケーション内でサードパーティサービスと連携済みのデータソースが一覧表示されます（対象：スーパ管理者、管理者、開発者）。それぞれのデータソースの基本情報が表示され、未設定の場合は「設定する」または「再設定」、または該当する統合項目の同期を開始するオプションを利用できます。

各データソースごとに、以下の情報がブロックで表示されます：

データソース名
タブ名

さらに、データソースに設定可能な項目や統合項目が関連付けられている場合、以下のセクションも表示されます：

データソース設定
統合項目の同期

メモ：このスライダーから、アプリケーションの有効モード・編集モードの両方でデータソースのアクセスおよび管理が可能です。

データソース設定

関連付け済みデータソースタブに特有の設定項目がある場合は、有効モードの外部連携スライダーから追加や変更が行えます。初期設定が完了した後でも、「再設定」ボタンを使っていつでもこれらの項目を更新できます。設定の詳細はこちら

データソースをインポート済みの場合は、外部連携スライダーから設定が行えます。

1. 該当データソースのデータソース設定セクション内にある設定するボタンをクリックしてください。データソース設定がまだ行われておらず、設定が必要な項目がある場合のみ、「設定する」オプションが表示されます。

すでにデータソース項目を設定済みの場合は、再設定ボタンから項目の編集が可能です。

メモ: 「設定する」オプションは、次の場合にのみ表示されます。

接続が認証済みであること
接続またはデータソースが有効であること
接続に対してAppアクセスが有効であること

接続がサポート終了となっている場合、設定はできません。その際は、必要な操作を行い、接続を更新するか置き換えてから続行してください。

Integration項目の同期

フォームにintegration項目が含まれている場合、同期をトリガーして接続済みのサードパーティサービスから最新データを取得できます。これにより、フォームデータ内のintegration項目の値が最新に保たれ、他の関連箇所も更新されます。

例えば、フォームにZoho CRMの商談タブと連携したintegration項目が含まれている場合、同期を行うことで最新の商談名が該当データに反映されます。

一部の場合、データソースの設定が必須です。同期オプションはデータソースが設定されている場合のみ機能し、そのデータソースに基づきintegration項目が更新されます。この同期は設定済みデータソースに紐づくintegration項目に限定されます。

外部連携スライダーからデータソース内のデータを同期するには、

1. Initiateボタンをクリックして同期を開始します。

a. 同期ステータスは「Ongoing」「完了」「失敗」のいずれかで表示されます。同期が失敗した場合は、再度実行できます。

b. 正常に完了すると、そのデータが反映され、ユーザーはスライダーで最終同期完了時間を確認できます。

メモ: 関連付け済みのCreatorフォームデータ内のintegration項目データのみが更新されます。接続済みサービスへはデータがプッシュバックされません。

[Initiate]ボタンは、データソースが設定されていて（該当する場合）、接続が認証済み、アプリのアクセスが有効な場合のみ表示されます。
同期は、各ユーザーごとにデータソースごとに24時間に1回実行できます。
integration項目データの同期を一度に開始できる最大数は10件です。
複数のユーザーが同じデータソースのintegration項目データをこの期間内に同期しようとした場合、最初のリクエストのみが実行され、他のユーザーは最新の同期タイムスタンプが表示されます。
同期に失敗した場合は、Operationsのログを確認できます。
ユーザーが同期を開始すると、外部サービスのAPIが呼び出され、最新データが取得されます。これらのAPI呼び出しは、ユーザーのサードパーティアカウントの使用制限にカウントされる場合があります。

9. 注意点

有効および編集方法では、スーパー管理者、管理者、開発者がアプリケーション内のすべての外部連携の種類を表示できます。その他のユーザーは、ログインユーザー種別に応じて、関連付け済みの権限に基づき、特定の外部連携のみ表示できます。
ログインユーザー外部連携が、プライマリアカウントの認証なしでデータソースやスケジュールで使用されている場合、管理者が認証しプライマリアカウントを設定するまで、アプリケーションユーザーは認証できません。
管理者および開発者は、アプリケーション内で使用中のすべての外部連携の種類を表示できます。ただし、システム外部連携については、スーパー管理者、管理者、開発者のみが認証できます。