【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】カスタム関数:1年分の商談の金額を月別に分割して計上する

      下記はサンプルコードです。カスタム関数のカスタマイズ・デバッグ・テストについてはお客様自身にて行っていただく必要がございます。 ゾーホージャパンサポート窓口では承りかねますので予めご了承ください。 タブ 商談 引数 Deal_Name= 商談.商談名 accountID = 商談.取引先のID Closing_Date= 商談.完了予定日 amount = 商談.総額 stage = 商談.ステージ 関数の内容 //登録用のマップ m=map(); //繰り返し処理用のリスト ...
    • 【Zoho CRM】複数のレコードに対してカスタム関数を実行したい

      Q. データの一覧から、複数のデータを選択してカスタム関数をボタンから実行したいです。 このとき、関数にデータのIDを引数として渡しますが、各データのIDはどう扱うべきでしょうか? A. 複数のデータを選択してカスタム関数を実行する場合、 引数として渡されるデータのIDは、「|||」で 繋ぐ形で 下記のように、一つの文字列で扱われます。 1000000001|||1000000002|||1000000003|||1000000004 ...
    • 【Zoho CRM】筆まめクラウド住所録に連絡先データを登録する

      下記はサンプルコードです。カスタマイズ・デバッグ・テストについてはお客様自身にて行っていただく必要がございます。 ゾーホージャパンサポート窓口では承りかねますので予めご了承ください。 引数 access_token = 筆まめアプリケーション認証で取得した「アクセストークン」(カスタム値) refresh_token = 筆まめアプリケーション認証で取得した「リフレッシュトークン」(カスタム値) group_id = 筆まめクラウド住所録の住所録ID(カスタム値) lastname = ...
    • 【Zoho CRM】Sansanの名刺データを取得して見込み客データを更新する

      下記はサンプルコードです。カスタマイズ・デバッグ・テストについてはお客様自身にて行っていただく必要がございます。 ゾーホージャパンサポート窓口では承りかねますので予めご了承ください。 引数 SansanAPIKey = カスタム値(SansanのAPIキー) leadID = 「見込み客」の「見込み客のID」 email = 「見込み客」の「メール」 関数の内容 //認証用ヘッダー h={ "X-Sansan-Api-Key" : input.SansanAPIKey }; //リクエストURL ...
    • 【Zoho CRM】商談の項目に自動的に取引先の項目を反映させることはできますか

      Q. 商談の項目に自動的に取引先の項目を反映させることはできますか? A. ルックアップ項目の連動項目で反映可能です。 詳細は、こちらのヘルプをご確認ください。

    Zoho Community

    オンライン掲示板やユーザー交流会など、Zoho活用に役立つコンテンツが満載!


      Zoho CRM 管理者向けオンライントレーニング

      Zoho CRM 導入後の動き出しをスムーズに。初期設定から操作方法、便利機能まで… Zoho の講師がデモを交えて解説。CRM管理者の必須スキルを短期間で習得しましょう。


        ウェビナー情報はこちら!

        さまざまな企業で業務改善にあたるエキスパートたちの事例セミナーをご提供しております。最新の予定や、配信済みのウェビナー動画はこちらをご確認ください。