外部連携

外部連携とは、Zoho Inventoryが認証処理を経て、外部サービスのデータにアクセスするための機能です。外部連携を設定するには、外部連携名、認証の種類などの詳細情報を入力する必要があります。
Zoho Inventoryでは、複数データ元から情報にアクセスできる外部連携を作成することが可能です。

外部連携の設定

Zoho Inventoryで外部連携を設定するには：

［設定］→ ［自動化］ →［カスタム関数］に移動します。
Delugeエディタ画面右上の［外部連携］リンクをクリックします。

次のポップアップ画面で、［外部連携に移動］ボタンをクリックします。
［外部連携の作成］ページに移動します。
外部連携を作成済みの場合、次のページで、その外部連携の一覧が表示されます。新しい外部連携を作成するには、画面右上の［+ ］アイコンをクリックし、［外部連携の追加］をクリックします。
対象の外部連携の種類を選択します。

ヒント: 現在、Zoho Inventoryの［外部連携］では、カスタム関数のみ利用可能です。

外部連携の種類

［外部連携を作成する］ページには、次の2種類の外部連携があります。

標準の外部連携
独自の外部連携

標準の外部連携

標準の外部連携は、［サービスを選択する］タブで確認できます。標準の外部連携では、Zoho Inventoryであらかじめ用意されている外部サービスの連携機能です。連携に関する基本的な情報を入力するだけで、外部連携を設定することができます。

標準の外部連携を設定するには：

［設定］→ ［自動化］ → ［カスタム関数］に移動します。
Delugeエディタ画面の右上にある［外部連携］リンクをクリックします。
表示されるポップアップ画面で、［外部連携に移動する］ボタンをクリックします。
外部連携するアプリケーションを、［サービスを選択する］タブから選択します。

［外部連携名］を入力します。
アプリの設定に応じて、［スコープ］を選択します（必要な場合）。
各ユーザーが自分のログイン認証情報を使用して、外部アプリと連携する場合、［ログイン中のユーザーの認証情報を使用する］選択肢を有効にします。また、すべてのユーザーが共通（連携を設定したユーザーの認証情報）の認証情報を使用して、外部アプリと連携する場合、この選択肢を無効にします。
［作成して連携する］をクリックしてください。

ログインページや詳細情報を入力するページが表示されます。
外部連携を行うためにアクセスを許可します。

独自の外部連携

独自の外部連携を作成するには、次の手順を行う必要があります（以下の手順の場合、認証プロトコルはOAuth 2と想定します）：

ZohoアカウントでOAuthクライアントを登録します。
新しく登録したクライアントの詳細を使用して、外部連携を作成します。

1.OAuthクライアントの登録

以下のヘルプ記事に記載されている手順に従って、開発者コンソールから新しいOAuthクライアントを登録できます。クライアントの登録時に求められるリダイレクトURLには下記のURLを入力してください。https://deluge.zoho.com/delugeauth/callback

2.外部連携の作成

クライアントの登録完了後、カスタムサービスタブに移動し、外部連携を作成するための詳細を入力します。

項目	説明
サービス名	連携対象のサービス名です。
認証の種類	認証処理に使用されるプロトコルです。
パラメーターの種類	外部連携ときにAPIコールに追加される認証パラメータです。
クライアントID	クライアントの一意のIDです。クライアントの登録時に取得できます。
クライアントシークレット	OAuthクライアントが認証サーバーへの認証で使用するシークレットです。クライアントの登録時に取得できます。
認証URL	認証URLでは、連携に設定したスコープの一覧が表示されます。このページでは、ユーザーにスコープ（外部アプリのデータをアクセスする権限）を割り当てることができます。
アクセストークンのURL	リフレッシュトークンからアクセストークンを作成するために使用されるURLです。
リフレッシュトークンURL	リフレッシュトークン作成するために使用されるURLです。
外部連携名	外部連携の名前です。リンク名は、外部連携名を基づいて生成し、カスタムスクリプトに使用されます。
スコープ	スコープとは、外部サービスのデータをアクセスする際に依頼したアクセス権限です。外部アプリのOAuthスコープのCSVリストを提供する必要があります。このCSVリストは、外部サービスのデータへのアクセス権限のリストです。

各ユーザーが自分のログイン認証情報を使用して、外部アプリと連携する場合、［ログイン中のユーザーの認証情報を使用する］選択肢を有効にします。また、すべてのユーザーが共通（連携を設定したユーザーの認証情報）の認証情報を使用して、外部アプリと接続する場合、この選択肢を無効にします。
［作成して連携する］をクリックします。

次のポップアップ画面には、外部サービスに依頼するアクセス権限あるいは認証URLが表示されます。
承認するには［許可する］をクリックします。

外部連携の認証設定が完了します。

カスタムスクリプトでの外部連携の使用

管理者に認証された外部連携はカスタムスクリプトに使用できます。作成済みの外部連携の詳細ページには、外部連携との通信を可能にするコードスニペットが表示されます。

このコードスニペットを、Zoho Inventory内のカスタムスクリプトに使用することで、外部サービスと連携することができます。