カスタム関数

カスタム関数

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

Zoho Recruitのカスタム機能により、シンプルなプログラムスクリプトを実行して、関連するRecruitタブやサードパーティの アプリケーション内のデータを更新することができます。データが ワークフローの基準を満たすと、ワークフローエンジンが自動的にカスタム関数をトリガーし、Recruitのデータが更新されます。 Deluge Script（Zoho Creatorによるパワープロビジョニング）でプログラムされたカスタム関数は、 採用プロセスを自動化するためのワークフロールールに関連付けられることができます。参照してくださいDeluge Script - 参照ガイド。

ビジネスシナリオ

候補者のスクリーニングは長期のプロセスになることがあります。これを簡単にするために、Zoho Recruitでカスタム関数を作成できます。これにより、リクルーターはフォローアップや候補者との他のやり取りを優先することが可能になります。

対象ユーザー

  1. ユーザーのためのワークフロールールを設定するRecruit管理者
  2. REST APIとDeluge Scriptの専門知識を持つプログラマー
Info

利用可能性

許可が必要です:この機能にアクセスが可能なワークフロー管理の許可が付与されたユーザー。

カスタム機能の設定

カスタム関数は 以下の 3つのステップで設定できます:
  1. カスタム関数を作成します。
  2. カスタム関数をワークフロールールに関連付けます。
  3. カスタム関数の統合をテストします。
カスタム関数の作り方
  1. 以下に移動します 設定 > 自動化 > 処理 > カスタム関数.
  2. ワークフローカスタム関数ページで、 カスタム関数を設定するを選択します.
  3. Galleryから関数を選択するか、既存の関数を選択するか、Deluge Scriptを使用して新しいものを記述します。
  4. 保存をクリックします.
カスタム関数をワークフロールールにリンクする方法
  1. 設定 > 自動化 > 処理 > Rulesを選択します。
  2. ワークフロー Rulesページで、Ruleを作成をクリックします。
  3. 新しいルールを作成するタブで、ワークフローruleのプラメーターを定義します。
  4. インスタント処理の下でカスタム関数を選択します。
  5. 実行するカスタム関数を選択します。
  6. 保存をクリックします。
カスタム関数の統合をテストする
  1. Zoho Recruitに、ワークフロールールの条件に合うテストデータを追加します。
  2. あなたのアプリケーションで、Zoho Recruitからカスタム関数経由でデータを確認します。
  3. データが受け取られないか、データの不一致がある場合は、Zoho Recruitでカスタム関数のコードを調整します。
  4. Zoho Recruitからアプリケーションに必要なデータを受け取るまでテストを続けます。

重要な点

  1. ワークフローのルールごとに6つ（1つのインスタント操作と5つの時間ベースの処理）までのカスタム関数をリンクすることができます。
  2. 一度のカスタム関数コールで実行できる行数は5000行（取引明細）までです。
  3. カスタム関数を使用して、最大10件のRecruit項目をZoho Recruitから第三者のアプリケーションに移動することができます。
  4. データはカスタム関数を使用して他のアプリからZoho Recruitに取り込むことができます。
  5. APIチケットは、第三者アプリケーションの制限に応じて定期的に更新する必要があります。
  6. 第三者のAPIの問題でカスタム関数の統合が機能しなくなった場合、メール通知は受け取られません。
  7. Zoho Creatorのサービスとの接続が失敗した際には、カスタム関数が15分後に2回目の通知を送信します。これ以降、その特定のワークフロートリガーについてはさらに通知は送信されません。Zoho Creatorから返されるエラーは、失敗の理由のセクションに表示されます。
  8. 一日に最大送信可能数を超えた場合、システムは残りのカスタム関数通知を第三者のアプリケーションに送信せず、管理者に失敗を通知します。
  9. Zoho Recruitは日付と日付-時間の項目を以下の標準フォーマットで第三者アプリケーションに送信します:
    1. 日付: yyyy-MM-dd
    2. 日付-時間: yyyy-MM-dd hh:mm
  10. カスタム関数の制限:
    1. 月あたりのコール数 - 200000コール
    2. Integrationタスク - 1日あたり25000のZoho APIコール/delugeを使用。
    3. URL APIを呼び出す - 1日あたり500コール
    4. メールを送信する - 1日あたり1500件

例のシナリオ

候補者の選考の概要:

候補者はカスタムの設定基準に従って選考することができます。候補者をランク付けするためのカスタム関数の引数をマッピングします。電話番号、E-メールアドレス、求人内容、スキルセット、候補者の業界詳細を考慮に入れております。
  1. id: 'Candidate Id' 列をリストから選択します。
  2. 電話番号: '電話番号' 列をリストから選択します。
  3. メール: 'メール' 列をリストから選択します。
  4. 件名:'Job 件名' 列をリストから選択します。
  5. Skillset:'Skill set' 列をリストから選択します。
  6. 再開する:'Is 添付ファイル Present' 列をリストから選択します。
  7. Authtoken:（カスタム値）API 通話であなたのZoho Recruit アカウントにアクセスするために必要な認証トークンを入力します。
特定の基準を満たしたときにJunk Candidate、Unqualified、却下済み、Evaluation待ちなどの候補者のステータスが割り当てられます。
Idea
提案されたシナリオのDeluge Script

if (電話番号。length() == 10 && メール。length() == 10 && 件名。length() == 10 && skillSet。length() == 10 && 再開する == '無効') {
ステータス = 'Junk Candidate';
} else if (電話番号。length() == 10 || メール。length() == 10) {
ステータス = 'Unqualified';
} else if (件名。length() == 10 && skillSet。length() == 10 || 再開する == '無効') {
ステータス = '却下済み';
} else {
ステータス = 'Waiting-for-Evaluation';
}
updateMap = Map();
updateMap。put('candidateStatus', ステータス);
updateMap。put('authtoken', authtoken);
updateMap。put('candidateIds', id。toString());
updateMap。put('scope', 'recruitapi');
updateMap。put('バージョン', '2');
response = postUrl('http://recruit。Zoho。com/recruit/非公開/json/Candidates/changeStatus%22,updateMap);
このカスタム関数を設定するには:
  1. Zoho Recruitにログインします。
  2. 設定 > 自動化 > 処理 > Rules > 作成 Ruleに移動します。
    タブとルール名を指定して新しいルールを作成します。
  3. 次をクリックします。
  4. このルールが実行されるタイミングを決定します。今すぐに実行するために作成か編集のオプションを選択し、データ操作を基に実行します。
  5. 次をクリックします。
  6. このルールが適用されるデータを決定します。条件に一致するデータオプションを選択し、基準を設定します。
  7. 次をクリックします。
  8. 即時操作としてカスタム関数を選択します。
  9. 通話カスタム関数のポップアップ内で、+新規 Delugeをクリックしカスタム関数を作成または追加します。
  10. 事前定義済みのカスタム関数を使用するためにギャラリーをクリックします。
  11. カスタム関数名 - Screen Candidatesに対して設定するをクリックします。
  12. 件名、説明、そしてDeluge Scriptを必要に応じて編集します。
  13. 編集パラメーターをクリックし、ドロップダウンリストから差出人を選択して引数をマップします。
  14. 保存をクリックします。
  15. 関数の編集が完了したら、保存をクリックし、機能を保存する前に スクリプト を保存をクリックしてください。
  16. 保存して続行 をクリックすると、作成したフローにカスタム関数が追加されたワークフローページに遷移します。
      
  17. あなたが応募者のデータを作成または編集すると、カスタム関数の作成が活性化されます。

エラーコード

カスタム関数の実行に失敗した場合、以下のエラーメッセージのいずれかがZoho Recruitに表示されます:

HTTP ステータスコード

  1. 400 Bad Request - 必要なパラメーターがしばしば欠落しています。
  2. 401 Unauthorized - 有効なAPIキーが提供されていません。
  3. 402 Request 失敗 - パラメーターは有効ですが、リクエストが失敗しました。
  4. 404 Not Found - 要求された商品は存在しません。
  5. 500, 502, 503, 504 Server errors - サードパーティアプリケーションでのエラー。
  6. エラーコード 1 - 一時的にAPIサーバーに接続できません。Recruitから送信されたリクエストのAPIサーバーログ、ファイアウォール設定を確認してください。

カスタムエラー

  1. 内部プロセスの失敗 - スクリプトの処理中のエラーにより、カスタム関数の実行に失敗した場合。
  2. Day limit reached - 企業が一日の最大限度に達した場合。
  3. Deluge Script - ワークフロートリガーの実行がDeluge Scriptのエラーにより失敗する場合。