接続の理解

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

1. このページの目的は何ですか？

このページでは、外部連携とZoho Developer ConsoleがあなたのアプリケーションをZohoや他のサードパーティサービスと統合するためにサポートするタイプについて情報を提供しています。

2. この機能にアクセスできるのは誰ですか？

この機能は、スーパー管理者と開発者のみが作成・管理することができます。他のユーザー（クライアント）は、Creatorアカウントを通じて認証・アクセスすることができます。

3. 一般的なアイデアは何ですか？

外部連携は、スーパー管理者と開発者がアプリケーションを外部サービスと連携し、クラウドベースのリソースを分散アプリケーションで利用可能にするためのものです。外部連携は、異なるシステム間で通信を認証・許可するために用いられ、外部のツールやサービスを統合することでアプリケーションの機能を強化します。

4. Developer Console での外部連携の使用方法については？

Developer Consoleでは、外部連携はスーパー管理者または開発者により確立され、Zohoマーケットプレイスからインストールされたアプリケーションまたは非公開シェアリング経由でアクセスされたアプリケーションで共有されます。これらの外部連携は、スーパー管理者または開発者により管理され、接続設定のためのユーザー介入を必要とせずにサードパーティーサービスとのシームレスな通信を容易にします。これらは開発環境またはステージング環境でテストでき、配布中にバンドルされて、アプリケーションがクライアントやマーケットプレイスユーザーに展開されたときに安全でカスタマイズされたアクセスを確保します。

接続は一つのアプリケーションに関連付けされており、一度に接続に対して有効化できるアプリケーションは一つだけです。接続のアクセス権がアプリケーションに有効化され、参照された一度は、その接続を無効化することはできません。参照が削除されたとしても、アプリケーションと接続がアプリケーションと一緒に公開されている場合、接続は依然として有効です。この制限により、外部連携はユーザーに分配されるパッケージとして配布されたときに、そのそれぞれのアプリケーションに外税されたまま保持されます。

外部連携の種類、Developer Consoleで対応しているものです：

System 外部連携: これらはスーパー管理者または開発者によって自動的に作成・認証済みです。
Admin接続: これらはスーパー管理者または開発者によって作成・認証されます。
ログインユーザーの外部連携: これらはログインユーザーによって手動で認証され、個々の接続が提供されます。

注：: System外部連携は、特定の接続へのアクセスを一つ以上のアプリケーションに許可し、ユーザー外部連携とは異なり、アプリケーションの公開プロセスの一部ではありません。クライアントアカウント内で既に利用可能でない場合にのみ作成することができます。利用可能であれば、同じものが再利用されます。

外部連携は次の範囲で利用できます：

SMS処理
フォームワークフローのインテグレーション操作を使用して、データを第三者のサービスにプッシュします
Delugeのインテグレーションタスク
DelugeのinvokeUrlタスク
ページパネル

注：: 開発者コンソールは組み込みのコネクタのみをサポートしています。カスタムコネクタはこのバージョンではサポートされていません。

5. 何の外部連携がサポートされていますか？

注：: 全ての外部連携の種類は、開発者コンソール内のスーパー管理者および開発者によって開発とステージング環境の有効な方法で認証できます。クライアントは、インストールしたアプリケーションでそれらの外部連携が機能するためにこれらを認証する必要があります。

5.1 システム外部連携とは何ですか？

システムの外部連携は、アプリ内のワークフローなどのタスクが開発者コンソール内のサービスに接続を必要とするときに自動的に作成されます。このような外部連携は、クライアントの端末でもシステムによって作成され、開発者コンソールでのアプリ公開時には含まれません。ユーザーのアカウント内で既に必要なサービスへのシステム連携が存在する場合は、それが再利用されます。それ以外の場合、タスクが実行されたときに新しい外部連携が自動的に作成されます。このように、システムの外部連携は複数のアプリをサポートし、必要なときにのみ作成されるため、柔軟性を提供します。

たとえば、Zoho CRMデータを更新するワークフローを備えたアプリの作成を考えてみましょう。開発中、開発者は開発者コンソールで自動的に作成されたZoho CRMへの接続を使用してこの機能をテストできます。ただし、この接続はマーケットプレイスまたはプライベートクライアントへの配布プロセスに含まれません。クライアントがアプリをインストールし、ワークフロールールをトリガーすると、システムはCreatorアカウント内の既存のZoho CRMシステム連携を確認します。存在しない場合、新しいシステム接続が自動的に作成されます。存在する場合、手動設定の必要なく再利用されます。

5.2 管理者の外部連携

管理者の外部連携は、クライアントアカウントのスーパー管理者または開発者によって認証され、通常のユーザーに個別の認証を要求せずに利用されます。これらの外部連携は1つの認証にリンクされ、利用可能なサービスを使用して管理者によって設定されます。たとえば、Zoho CRMへの管理者接続(開発者コンソールで作成し、クライアントに配布)は、顧客データを同期させ、ワークフローを自動的にデータを更新するときのように、注文が作成された場合などの動きを有効にします。これにより、アプリケーションの全ユーザーがワークフローをトリガーできます。

開発者コンソールを通じて配布された場合、クライアント向けの管理者外部連携は管理者外部連携のままとなります。クライアントアプリのスーパー管理者と管理者が認証を管理し、接続が機能的で安全に保たれることを確認します。

5.3 ログイン済みユーザーの外部連携

ログイン済みユーザーの外部連携（開発者コンソールで作成し、クライアントに配布）は、ログイン済みのユーザーによって個別に認証されます。これらの外部連携により、サードパーティサービスが個別に統合され、ユーザーが特定のデータや機能にアクセスできます。例えば、Salesforceのワークフローでは、各ユーザーが個人の認証情報を用いて接続を認証する必要があります。実行済みの場合、データはユーザーのSalesforceアカウントにプッシュされます。

開発者コンソールでは、これらの外部連携は発行ライフサイクル中に定義され、バンドル化されます。配布後、クライアント環境のユーザーがそれぞれ認証します。

ログイン済みのユーザーの外部連携は次の組み込みコネクタ向けにのみ作成可能です：

Quickbooks
Salesforce
Zoho CRM
Zoho Recruit
Clickatell
Hoiio
Clockwork SMS
SMS-Magic
Twilio
Zoho OAuth
Zoho プロジェクト
Zoho 表計算シート

6. 使用例

開発者は開発者コンソールを用いて、不動産管理アプリをプライベートな配布やマーケットプレイスの公開用に作成する際に、外部連携を作成します。開発者側では、Zoho Booksとの管理者接続を用いてワークフローを自動化し、例えば、売却された不動産のデータをプッシュして請求書を生成します。さらに、Zoho 表計算シートとのログイン済みユーザー接続を用いて、パネル内に表示される販売済み不動産の数のような個人データビューを有効化します。

公開後、クライアントはアプリをインストールし、外部連携を認証します。スーパー管理者または管理者がZoho Booksとの接続を認証し、個々のユーザーが自分のアカウントでZoho 表計算シートを認証します。

7. 外部連携へのナビゲーションガイド

開発者コンソール内の外部連携にアクセスするには、Microservices セクションに移動します。

注釈 : 現時点では、Microservices セクションで利用可能なのは外部連携のみです。

8. 注記

外部連携は一つのアプリケーションにのみ関連付けることができます。
システム外部連携は、クライアントアカウントのスーパー管理者、管理者、開発者のみが認証できます。これらは公開回数には含まれず、サービスとの接続が存在しない場合、クライアントがアプリケーションを使用する際に作成されます。
すべての外部連携を開発環境またはステージ環境で徹底的にテストし、アプリの機能を確認してから配布します。