ライブモードと編集モードの接続
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。
利用条件
接続の利用条件。
- Creatorの有料プランでのみ利用できます
- 作成と管理は特権管理者、管理者、開発者のみが行えますが、その他のユーザーも認証してアクセスできます
- すべてのデータセンターで利用できます
1. 接続の表示方法
ライブモード。
編集モード。
2. 接続の表示
接続は［マイクロサービス］セクションに一覧表示されるほか、アプリケーション内のライブモードと編集モードの両方で表示、アクセスできます。この機能はすべてのユーザーが利用できますが、個々の接続の表示設定は、ログインしているユーザーの種類、アプリケーションコンポーネントに対するユーザーの権限、および接続の種類に基づいて決まります。管理者と開発者は、システム接続を含むすべての種類の接続を表示できます。その他のアプリケーションユーザーは、ログインユーザー種別の接続のみ表示できます。アプリケーション内でこの接続パネルが配置される場所については、こちらをご参照ください。
メモ。
- 異なるデータセンターでホストされているサービスへの接続では、国境を越えたデータ転送が発生する場合があります。Zoho Creatorはデータを安全に処理しますが、続行する前に、組織のデータ所在地とコンプライアンス要件に合致していることを確認してください。
- ローカルでホストされているコネクターを使用して作成された接続は、設定済みのdatabridgeに依存します。これらの接続を使用または管理するには、Qntrlが［システム連携］で設定され、有効なdatabridgeに関連付けられていることを確認してください。databridgeが利用できない、または停止している場合、ローカルでホストされているコネクターを使用する接続は機能しません。
［連携］をクリックするとスライダーが開き、ライブモードでアプリケーション内で使用されているすべての接続と決済ゲートウェイが表示されます。編集モードでは、［接続］タブに、特定のコンポーネントで使用されている接続のみが表示され、各接続について次のような基本情報も表示されます。
- ［サービス名］：接続の作成対象となったサービスの名前です。
- ［認証済みアカウント］：接続を認証したアカウントに関連付けられた名前です。この自動生成された名前は、認証済みアカウント名の横にある［編集］アイコンをクリックして編集できます。
- ［ステータス］：接続済みか未接続かなど、接続の現在のステータスを示します。
- ［認証］ボタン：接続がまだ認証されていない場合に、接続を認証するためのボタンが表示されます。
- ［接続の種類］：接続の種類は、下表のように異なるアイコンで示されます。
|
アイコン |
種類 |
|
|
管理者接続 |
|
|
システム接続 |
|
|
ユーザー接続 |
2.1. 接続パネルの配置
アクセスしやすく使いやすくするため、ユーザーはライブモードと編集モードのどちらでも、アプリケーション内から接続を直接表示、管理できます。
本番モードで接続を表示するには、次の手順を実行します。
- アプリケーションで、ユーザー名の横にある設定アイコン（
）をクリックします。
- ［接続］をクリックします。
メモ：設定アイコン（
編集モードで接続を表示するには、次の手順を実行します。
- ビルダーの右上にある連携アイコン（
）をクリックします。
メモ：Delugeエディターから接続を直接表示するには、エディター上部のバーで［連携］を選択します。
2.2. インストール済み接続
インストール済みアプリケーションに追加された接続は、インストール済み接続として表示されます。アプリケーションでシステム接続が使用され、同じサービスの接続がアカウント内にすでに存在する場合、アプリケーションは既存の接続を参照します。これにより、一貫性を保ち、重複を避けることができます。
3. 本番モードと編集モードでの接続の認証
ユーザーは、アプリケーションの各コンポーネントから接続を直接認証して使用できます。本番モードで接続を認証するには、次の手順を実行します。
- アプリケーションの本番モードまたは編集モードから接続に移動します。アプリケーション内のすべての接続がこちらに表示されます。
- ［認証］をクリックします。
- 認証を使用する環境を選択します。これは、［環境ごとに異なる認証を使用する］が選択されている場合にのみ必要です。詳しくはこちら
- 90秒の制限時間が切れる前に、認証情報を入力し、アクセス権限を承認します。
メモ：OAuth2タイプの接続では、［認証］をクリックすると90秒のタイマーが開始されます。サービスの認証ページにリダイレクトされるので、アクセスを許可する必要があります。
3.1. 未認証の接続を含むアプリケーションコンポーネントの動作
アプリケーション内のコンポーネント、ワークフロー、関数、またはブループリントで未認証の接続が使用されている場合、そのコンポーネントへのアクセス時、またはワークフローの実行時に認証プロンプトが表示されます。
- 管理者接続の場合、接続の認証を求めるプロンプトは管理者と特権管理者にのみ表示されます。他のユーザーは、管理者が認証するまでこれらのリソースにアクセスできず、管理者に連絡するよう促すメッセージが表示されます。ユーザーがフォームにアクセスできるようにするには、管理者が接続を認証する必要があります。
- システム接続の場合、接続の認証を求めるプロンプトは特権管理者、管理者、開発者にのみ表示されます。他のユーザーは、特権管理者が認証するまでこれらのリソースにアクセスできず、管理者／特権管理者に連絡するよう促すメッセージが表示されます。ユーザーがフォームにアクセスできるようにするには、特権管理者が接続を認証する必要があります。
- ログインユーザー接続の場合、どの種類のユーザーにも接続の認証を求めるプロンプトが表示されます。
本番モードで認証プロンプトが表示されるケースの例は次のとおりです。
- フォームの読み込み時に実行するように設定された、未認証の接続を含むワークフローがあるフォーム。
- 未認証の接続を含むパネルがあるページ。
- 未認証の接続を含む連携レポート。
- 未認証の管理者接続またはシステム接続があるフォームに、本番ユーザーがアクセスした場合。
メモ：同じ動作は、無効な接続またはアプリケーションへの接続アクセスが無効になっているアプリケーションコンポーネントにアクセスする場合にも適用されます。このような場合、ユーザーがアクセスできるようにするには、管理者がマイクロサービスから有効にする必要があります。
4. 認証の切り替え
メモ：
- システム接続の認証を切り替えられるのは、特権管理者、管理者、開発者のみです。
- 管理者接続の認証は、すべての管理者が切り替えられます。
- ログインユーザー接続の認証を切り替えられるのは、認証の所有者のみです。
接続の切り替えでは、接続に新しい認証を付与します。次のような場合にも必要です。
- 接続に関連付けられた認証情報の有効期限が切れた場合
- 外部サービスで認証トークンが無効化または削除された場合
メモ：接続の認証を切り替えると、その認証を利用しているすべてのアプリケーションで、以後は新しい認証が使用されます。
アプリケーションのライブモードまたは編集モードで接続の認証を切り替えるには：
- アプリケーションのライブモードまたは編集モードから接続に移動し、目的の接続をクリックします。
- ［切り替え］をクリックします。
- 認証アカウント名を選択し、［認証］をクリックします。
- 90秒の制限時間内に認証情報を入力し、アクセス権限を承認します。
メモ：OAuth2形式の接続では、［認証］をクリックすると90秒のタイマーが開始されます。サービスの認証ページにリダイレクトされるので、アクセスを許可する必要があります。
5. 認証の取り消し
接続の認証を取り消すと、外部サービスへの権限とアクセスが削除され、その接続認証を使用しているコンポーネントは意図したとおりに機能しなくなります。
メモ：
- システム接続の認証を取り消せるのは、特権管理者、管理者、開発者のみです。
- 管理者接続の認証は、すべての管理者が取り消せます。
- ログインユーザー接続の認証を取り消せるのは、認証の所有者のみです。ログインユーザー接続に関連付けられているメインアカウントが取り消された場合、管理者は別の管理者のアカウントをメインとして設定し、ユーザーが接続を認証できるようにする必要があります。
- 接続の認証を取り消しても、同じ認証を使用している他の接続には影響しません。
アプリケーションのライブモードまたは編集モードで接続の認証を取り消すには：
- アプリケーションのライブモードまたは編集モードから接続に移動し、目的の接続をクリックします。
- ［取り消し］をクリックします。
6. クライアント認証情報の更新
接続で使用するカスタムOAuthクライアント認証情報は、編集モードとライブモードのどちらでも、接続スライダーから更新できます。
情報：クライアント認証情報を更新すると、その接続を参照している既存の認証はすべて取り消されます。認証情報が1件以上の接続で参照されている場合、それらはすべて取り消されます。接続が再認証されるまで、アプリケーションの動作に一時的に影響する場合があります。接続に設定されている処理が、登録済みOAuthアプリで定義されたスコープ内に収まっていることを確認してください。
クライアント認証情報を更新するには
-
アプリケーションのライブモードに移動します。接続スライダーで、対象の接続をクリックします。
-
［クライアント認証情報］で、一覧に表示されている認証情報名の横にある［更新］ボタンをクリックします。
-
表示されたポップアップで、新しいクライアント認証情報名と、外部OAuthアプリの更新後の新しいクライアントシークレットを選択します。新しいクライアントIDとクライアントシークレットを追加することもできます。既存のクライアントシークレットは表示されず、再利用できません。
-
接続の機能を復元するには、［更新して認証］をクリックします。
クライアント認証情報名の編集。
カスタム認証情報で接続を作成すると、クライアント認証情報名は自動生成されます。クライアント認証情報名を編集するには、接続スライダーで編集アイコンをクリックします。
メモ：
- 認証情報を更新できるのは、認証情報の所有者（認証情報を追加したユーザー）のみです。その他の権限では［更新］オプションは無効になり、カーソルを合わせるとツールチップが表示されます。
- 開発者の場合、認証情報の再利用は関連付けられたアプリケーション内でのみ可能です。
- 共有ユーザーはクライアント認証情報を設定できないため、管理者に連絡する必要があります。
- 接続が別のアプリケーションで参照されている場合、ライブモードから更新することはできません。
- インポートしたアプリケーションにカスタムモードが設定された接続が含まれている場合、関連するクライアント認証情報は引き継がれません。接続は、接続の詳細ページで［設定］をクリックして再設定し、その後認証する必要があります。
7. 関連データソース
接続に関連付けられているデータソースが1件以上ある場合、接続スライダーに［関連データソース］セクションが表示されます。このセクションには、接続している外部サービスに関連付けられた、該当アプリケーション内のデータソースが一覧表示されます（特権管理者、管理者、開発者が対象です）。このセクションでは、各データソースの基本情報を表示し、未設定の場合は設定または再設定するためのオプションや、該当する連携項目の同期を開始するためのオプションを利用できます。
各データソースには、次の情報を表示するブロックが表示されます。
- データソース名
- タブ名
これらに加えて、データソースに設定可能な項目がある場合、または連携項目に関連付けられている場合は、次のセクションも表示されます。
- データソース設定
- 連携項目の同期
メモ：アプリケーションのライブモードと編集モードのどちらでも、このスライダーからデータソースにアクセスして管理できます。
データソース設定
関連付けられているデータソースのタブに固有の設定項目がある場合、ライブモードの接続スライダーから追加または変更できます。初期設定が完了した後も、［再設定］ボタンを使用していつでもこれらの項目を見直して更新できます。設定の詳細
データソースをインポートした場合は、接続スライダーから設定できます。
1. 接続スライダーで、該当するデータソースのデータソース設定セクションにある［設定］ボタンをクリックします。データソース設定がまだ完了しておらず、データソースに設定が必要な項目がある場合にのみ、［設定］オプションが表示されます。
以前にデータソース項目を設定済みの場合は、［再設定］ボタンを使用して編集できます。
メモ：［設定］オプションは、次の条件を満たす場合にのみ表示されます。
- 接続が認証されている
- 接続またはデータソースが有効になっている
- 接続のアプリへのアクセスが有効になっている
接続が廃止されている場合、設定はできません。この場合は、続行する前に、接続を更新または置き換えるために必要な対応を行ってください。
連携項目の同期
フォームに連携項目が含まれている場合、同期を開始して、接続されている外部サービスから最新データを取得できます。これにより、フォームデータ内の連携項目の値を最新の状態に保ち、これらの項目が使用されているアプリケーション内の他の箇所も更新されます。
たとえば、フォームに Zoho CRM の［商談］タブにリンクされた連携項目が含まれている場合、同期によって最新の商談名が関連するデータに取得されます。
場合によっては、データソース設定が必要です。同期オプションはデータソースが設定されている場合にのみ機能し、そのデータソースに基づいて連携項目を更新します。この同期は、設定済みのデータソースにリンクされた連携項目に限定されます。
接続スライダーからデータソースのデータを同期するには、
1. 同期を開始するには、［開始］ボタンをクリックします。
a. 同期ステータスには、「進行中」、「完了」、「失敗」のいずれかが表示されます。同期に失敗した場合は、再度開始できます。
b. 正常に完了すると、データに反映され、ユーザーはスライダーで前回の同期完了時刻を確認できます。
メモ：関連付けられている Creator フォームデータ内の連携項目データのみが更新されます。接続先サービスへデータが送信されることはありません。
- ［開始］ボタンは、データソースが設定済み（該当する場合）で、接続が認証され、アプリへのアクセスが有効になっている場合にのみ表示されます。
- 同期は、ユーザーごと、データソースごとに24時間に1回開始できます。
- 連携項目データの同期を一度に開始できる最大数は10件です。
- この期間内に複数のユーザーが同じデータソースの連携項目データを同期しようとした場合、最初の要求のみが実行されます。他のユーザーには、直近の同期のタイムスタンプが表示されます。
- 同期に失敗した場合は、［操作］のログを確認できます。
- ユーザーが同期を開始すると、最新データを取得するために外部サービスのAPIを呼び出します。これらのAPI呼び出しは、ユーザーの外部アカウントの使用制限にカウントされる場合があります。
8. 注意事項
- ライブモードと編集モードでは、特権管理者、管理者、開発者がアプリケーション内のすべての種類の接続を表示できます。他のユーザーは、アプリケーションコンポーネントに関連付けられた権限に応じて、ログイン中のユーザーの種類に固有の接続のみを表示できます。
- ログインユーザー接続が、メインアカウントの認証なしでデータソースやスケジュールで使用されている場合、管理者が認証してメインアカウントを設定するまで、アプリケーションユーザーはその接続を認証できません。
- 管理者と開発者はいずれも、アプリケーション内で使用されているすべての種類の接続を表示できます。ただし、システム接続については、特権管理者、管理者、開発者のみが認証できます。
9. 関連トピック
次のステップ
前の項目
次のステップ
前の項目