【Zoho People】カスタム関数：SmartHRに従業員データを送信して招待する

【Zoho People】カスタム関数：SmartHRに従業員データを送信して招待する

Zoho Peopleの設定→自動化→カスタム関数のメニューからカスタム関数を作成し、以下の内容を設定してください。
設定後、カスタム関数の呼び出しの処理を、ワークフローでの起動、または、独自の処理のボタンとして配置して起動する設定を行ってください。

事前準備
  • Zoho Peopleの従業員フォームにおいてSmartHRの従業員IDを保存するための項目の作成
    ※以下のスクリプトをそのまま利用する場合、項目の作成時にラベル名を「SmartHRID」と指定してください。別のラベル名にした場合、スクリプト中の「SmartHRID」をそのラベル名を置き換えてください。

関数の引数名：引数の内容
  • lastName：姓
  • firstName：名
  • email：招待するメールアドレス
  • employeeNo：従業員番号
  • recordid：Zoho Peopleの従業員データのID
設定イメージ

関数の内容
  1. accessToken = "xxxxxxxxxxxxxxxxxxxxxx";//SmartHRのアクセストークン
  2. tenantID = "xxxxxxxxxxxxxxxxxxxxxx";//SmartHRのテナントID
  3. //リクエスト先URL
  4. u = "https://" + tenantID + ".smarthr.jp/api/v1/crews/?access_token=" + accessToken;
  5. //パラメーター
  6. p = Map();
  7. p.put("first_name",firstName);
  8. p.put("last_name",lastName);
  9. p.put("email",email);
  10. p.put("emp_code",employeeNo);
  11. pString = p.toString();
  12. //リクエストヘッダー
  13. h = {"Content-Type":"application/json"};
  14. //従業員データの追加のAPIの呼び出し
  15. r = invokeurl
  16. [
  17. url :u
  18. type :POST
  19. parameters:pString
  20. headers:h
  21. ];
  22. //結果の処理
  23. m = r.toMap();
  24. //IDの取得
  25. id = m.get("id");
  26. //IDをZoho Peopleに更新
  27. employeeUpdateR = zoho.people.update("employee",{"recordid":recordid,"SmartHRID":id});
  28. //招待の処理
  29. inviteURL = "https://" + tenantID + ".smarthr.jp/api/v1/crews/" + id + "/invite?access_token=" + accessToken;
  30. inviteParams = Map();
  31. inviteParams.put("inviter_user_id","xxxxxxxxxxxxxxxxxxxxxx");//SmartHRの招待者のユーザID
  32. inviteParams.put("crew_input_form_id","xxxxxxxxxxxxxxxxxxxxxx");//SmartHRの従業員情報収集フォームID
  33. //招待のAPIの呼び出し
  34. inviteResponse = invokeurl
  35. [
  36. url :inviteURL
  37. type :PUT
  38. parameters:inviteParams
  39. ];

※「xxxxxxxxxxxxxxxxxxxxxx」という文字で示してある箇所は、利用するSmartHRのアカウントで取得した情報で置き換えてください。具体的には以下の4箇所です。
  • アクセストークン
  • テナントID
  • 招待者のユーザID
  • 従業員情報収集フォームID

※上記はスクリプトのサンプルです。処理内容に関しては、利用される方に合わせてカスタマイズが必要です。動作の保証や動作しない場合の個別の確認やサポートは行っておりませんのでご了承ください。



      • Related Articles

      • 【Zoho CRM】カスタム関数の作成

        カスタム関数はエンタープライズプランの機能です。 ［設定］ > ［自動化］ > ［アクション］ > ［カスタム関数］に移動してください。 表示された画面で「自分で作成する」をクリックしてください。 カスタム関数の作成画が表示されます。 カスタム関数についての詳細は以下をご参照ください。 https://www.zoho.com/jp/crm/help/automation/custom-functions-programming-dre.html

      • 【Zoho CRM】カスタム関数：1年分の商談の金額を月別に分割して計上する

        サンプルの設定内容は以下です。 タブ 商談 引数 Deal_Name=  商談.商談名 accountID =  商談.取引先のID Closing_Date=  商談.完了予定日 amount =  商談.総額 stage =  商談.ステージ 関数の内容 //登録用のマップ m=map(); //繰り返し処理用のリスト monthIndex={0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11}; //月あたりの金額 monthlyAmount=(amount  / ...

      • 【Zoho CRM】複数のレコードに対してカスタム関数を実行したい

        Q. データの一覧から、複数のデータを選択してカスタム関数をボタンから実行したいです。 このとき、関数にデータのIDを引数として渡しますが、各データのIDはどう扱うべきでしょうか？ A. 複数のデータを選択してカスタム関数を実行する場合、 引数として渡されるデータのIDは、「|||」で 繋ぐ形で 下記のように、一つの文字列で扱われます。 1000000001|||1000000002|||1000000003|||1000000004 ...

      • 【Zoho CRM】Sansanの名刺データを取得して見込み客データを更新する

        引数 SansanAPIKey = カスタム値（SansanのAPIキー） leadID =  「見込み客」の「見込み客のID」 email = 「見込み客」の「メール」 関数の内容 //認証用ヘッダー h={ "X-Sansan-Api-Key" : input.SansanAPIKey }; //リクエストURL u="https://api.sansan.com/v2.7/bizCards/search"; //範囲(me|all) range="all"; //パラメーターのエンコード ...

      • 【Zoho CRM】Call Intelligence（コール・インテリジェンス）の情報をZoho CRMへ連携する

        概要 「Call Intelligence（以下コール・インテリジェンス）」とZoho CRMを連携させる方法です。Call Intelligence（コール・インテリジェンス）の通話情報をZoho CRMのスケジュール処理で定期的に取り込み、キャンペーン、見込み客/連絡先、商談と関連付けます。 コール・インテリジェンスとは？ 楽天コミュニケーションズ株式会社が提供する電話の効果測定ツールです。電話でお問い合わせの受付をする広告施策や広告価値の見える化が可能です。 設定 Zoho ...

      Zoho Community

      Zoho ユーザーが集うオンラインフォーラムでは、サービスの使いこなしに関する活発な議論や情報交換が行われています。