関数の設定

操作方法

• 関数の設定
• REST APIを使用した関数の呼び出し
• ワークフローへの関数の適用
• エラーコードの参照
  • HTTPステータスコード
  • カスタムエラー
• よく使用される関数の例
  ​関連項目

関数の設定

次の5つの方法で関数を設定できます。

• スタンドアロン関数を作成してください。
• 関数をワークフローに関連付けます。
• 関数をスケジュールに含めることにより、後で関数を使用します。
• カスタムボタンをクリックしたときに実行されるように関数を設定してください。
• 関数を関連リストに関連付けます。

関数を作成するには

1. ［設定］ > ［開発者向け情報］ > ［関数］に移動してください。
2. ［関数］ページで、［+新しい関数の作成］をクリックしてください。
3. 関数を追加する場所を選択してください。
   
4. ［次へ］をクリックしてください。
5. ［関数の作成］ページで、次の操作を行います。
   • 関数の名前と説明（オプション）を指定します。
   • ［引数の編集］をクリックしてください。
   • CRMタブの項目名またはカスタム値を使用して、スクリプトで使用する引数を設定してください。
     
   • Delugeスクリプトエディターで必要な関数を記述してください。
     
   • ［スクリプトの保存と実行］をクリックして、コードを検証してください。
   • ［保存］をクリックしてください。
6. ［保存］をクリックしてください。
   関数は、［関数］ページのリストビューに一覧表示されます。
   特定の場所で使用するように指定された関数は、他の場所では使用できないことに注意してください。たとえば、ワークフロー用に設定された関数をスケジュールで使用することはできません。

REST APIを使用した関数の呼び出し

関数を使用すると、従来の関数とは別に、CRMの追加の機能性や機能を使用できます。関数を呼び出すにはトリガーが必要です。トリガーは、ワークフロー、ブループリント、関連リストの形式で、またはボタンのクリックで行うことができます。

これらのメソッドを使用せずに、または外部ソースから関数をトリガーする必要がある場合は、スタンドアロン関数を作成して、API呼び出しとして使用できるようにします。REST APIを通じて関数をトリガーすることで、Zoho CRM内の任意の場所や外部サービスのアプリケーションから柔軟にトリガーできます。

API呼び出しとしてのサンプル関数：

フォームへの入力で指定された情報を使用して、自動的にCRMの見込み客を作成するフォーム。

ステップ1：

次のコードを使用してスタンドアロン関数を作成してください。

ステップ2：

関数をAPIとして使用できるようにするには

1. ［設定］ > ［開発者向け情報］ > ［関数］に移動してください。
2. APIの作成が必要な、対応する関数の［設定］アイコンをクリックしてください。
3. ［REST API］をクリックしてください。
   
4. カスタム関数のAPI名を設定してください。
5. OAuth2.0とAPIキースライダーを有効にします。
6. ［保存］をクリックしてください。
   

ステップ3：

ここでのサンプルは、Zoho Creatorを使用して作成したフォームとして表示されています。「FirstName」、「LastName」、「Company」、「Mobile」という項目が含まれるようにフォームを作成してください。［送信］ボタンのクリックで実行されるように関数をプログラムできます。

結果：

［送信］ボタンをクリックすると、関数が実行され、CRMに見込み客が作成されます。見込み客には、フォーム内で指定された詳細情報が含まれます。

Postmanの関数：

API呼び出しとして提供される関数は、POSTMANアプリケーションを使用してテストできます。ただし、そのアプリで関数を実行する場合は、いくつかの点に注意する必要があります。

• 関数をAPIとして使用するために現在サポートされているメソッドは、GETとPOSTです。
• POSTリクエストで、［ボディー］セクションの下の［フォームデータ］を選択してください。
• 「arguments」という名前のキーと値を入力JSONオブジェクトとして作成してください。
• 引数は、URLにarguments={encoded_arguments}として指定することもできます。
• POSTリクエスト - 引数の制限
  • リクエストURL - 5,000行
  • ボディー - 95,000行（JSONオブジェクトとして）

「ボディー」内のサンプル引数：

ワークフローへ関数を適用する

関数をワークフローに関連付けるには

1. ［設定］ > ［自動化］ > ［ワークフロー自動化］ > ［ルール］に移動してください。
2. ［ワークフロー］ページで、［ルールの作成］をクリックしてください。
3. ［新規ルールの作成］タブで、ワークフローのパラメーターを指定します。
4. ［すぐに実行する処理］の下の［関数］を選択してください。
   
5. ［関数の設定］ページで、［ギャラリー］、［関数］（組織内のユーザーが作成した関数）、またはDelugeスクリプトを使用した［独自に記述］から関数を選択してください。
6. ［関数］（組織内のユーザーが作成した関数）をクリックしてください。
   
7. 実行する関数を選択し、［構成］をクリックしてください。
   
8. ［カスタム関数の構成］ページで、以下の手順を実行してください。
   • 関連付けるタブを選択してください。
   • ［引数の関連付け］セクションで、CRMタブの項目名で引数を関連付けします。
     
   • ［保存して関連付ける］をクリックしてください。
     これで、カスタム関数をワークフローに関連付けることができます。
9. ［ワークフロー］ページで、［保存］をクリックしてください。
   これで、カスタマイズされた関数がワークフローに関連付けられました。ワークフローが実行されると、カスタム関数が自動的に実行されます。