スタンドアロン機能 - Zoho People

スタンドアロン機能 - Zoho People

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

Zoho People の Standalone Function は、カスタム Deluge ベースのスクリプトであり、API 通話を通じて独立して実行できます。これらの関数は外部パラメーターを受け入れることができ、Zoho People 内で動的なデータ処理やロジック実行を可能にします。ユニークなメソッド名とカスタム入力変数を使用することで、Standalone Function は Zoho People とサードパーティシステム間のシームレスな連携を実現し、タスクの自動化、データ同期、標準ワークフローを超えた機能拡張に最適です。

Zoho People で Standalone Function を設定する

Standalone Function を設定するには:
  1. 設定 > 開発者向け情報 > Standalone Function に移動します。


  2. Standalone Function を追加をクリックします。


  3. Standalone Function の名前を入力します。
  4. パラメーターを編集をクリックし、メソッド引数とそのデータ型を定義します。
    Idea
    最大15個までパラメーターを設定できます。
    Info
    引数（Arguments）は関数やメソッドを呼び出す際に渡される値であり、データ型は変数や関数引数が保持できるデータの種類を指定します。

  5. メソッド名の欄に、Standalone Function 用のユニークなメソッド名を入力します。
    Info
    Standalone Function を API 通話で呼び出す際、Zoho People はどのメソッドや操作を実行するか正確に識別する必要があります。同じ名前のメソッドが複数存在すると、関数の実行時に曖昧さやエラーが発生し、システムが区別できなくなります。
  6. deluge セクションに Standalone Function の Deluge コードを入力します。詳細はDeluge Script - 参照ガイドをご覧ください。
  7. 保存して実行をクリックして、関数を実行・テストします。
  8. 保存をクリックして、Standalone Function を保存します。

OAuth 2。+10、-10 アクセス

OAuth 2。+10、-10 プロトコルを利用して、スタンドアロン関数を他のアプリケーションからアクセス可能にできます。これにより、ユーザー名やパスワードを共有することなく、Zoho Peopleへの接続が可能です。アクセスできるデータを制御するスコープ機能により、特定の認証済み処理のみが許可されます。これにより、Zoho Peopleとサードパーティシステムの連携が簡単かつ安全に行え、データやプライバシーも保護されます。

OAuth 2。+10、-10 メソッドで関数を利用可能にするには、まずクライアントをZoho Peopleに登録する必要があります。OAuthトークンを生成する手順をご参照ください。

Zoho People API によるスタンドアロン関数の呼び出し

Zoho People API を使用して、外部アプリケーションやシステムからスタンドアロン関数を呼び出します。API の詳細は、スタンドアロン関数呼び出しAPIをご参照ください。

  • POSTリクエストを使用して、スタンドアロン関数を呼び出します。

  • スタンドアロンカスタム関数実行用のAPIエンドポイントは以下の通りです：

    
          Quote
    
          https://people.Zoho.com/api/v3/function/(\w+)/実行する

    Info
    (\w+) を、スタンドアロン関数の作成時にZoho Peopleで設定した一意のメソッド名に置き換えてください。

  • リクエスト本文では、

    • 関数が必要とする入力パラメーターを指定してください。

    • オプションのパラメーターは、JSON形式で arguments キーの下に記載します。

    本文の例：

    json
    {
  'arguments': {
    'parameter1': 'value1',
    'parameter2': 'value2'
  }
}

Postmanでテスト Standalone Function

Postmanを使用してStandalone Functionをテストする方法:

  1. Postmanを開き、新規リクエストを作成します。

  2. 以下の詳細を使用して、Standalone FunctionのREST APIへ接続します:

    1. リクエストメソッド: POST

    2. 認証: OAuth 2。+10、-10

    3. コールバックURL: https://oauth。pstmn。io/v1/callback

    4. 認証URL: https://取引先.Zoho.com/oauth/v2/auth

    5. アクセストークンURL: https://取引先.Zoho.com/oauth/v2/token

    6. スコープ: ZOHOPEOPLE.自動化.すべて

    7. 作成済みのクライアントIDとClientシークレットを入力します。

    8. APIRequestオブジェクトのparamsプロパティに引数を渡し、POSTメソッドを使用して関数を実行します。