Search Employees(従業員の検索)

特定の条件に一致する従業員のリストをSmartHRから取得します。

オプション

フィールド 定義 タイプ 必須
Result Set(結果セット) 検索結果を表示するために次のオプションのいずれかを選択します。
  • [First Matching Record(最初の一致レコード)]:一致する最初のレコードが返されます。

  • [First 100 Matching Record(最初に一致する100レコード)]:最初に一致する100レコードを返します。

  • [Stream Matching Records(一致レコードのストリーミング)]:一致するすべてのレコードが親フローからヘルパーフローに渡されます。ヘルパーフローを選択し、カスタム拡張可能フィールドを追加できる[Streaming(ストリーミング)]入力セクションをカードに追加します。

ドロップダウン

TRUE

多数のレコードを返す方法については、「ヘルパーフローを使ったレコードのストリーミング一致」を参照してください。

入力

フィールド 定義 タイプ 必須
Employee number(社員番号) 社員番号。

テキスト

FALSE

Employee Type IDs(雇用形態ID) 雇用形態のID。

テキストのリスト

FALSE

Employment Status(在籍状況)

従業員の在籍状況。

  • Employed(在職中)

  • Absent (休職中)

  • Retired(退職済)

ドロップダウン

FALSE

Gender(戸籍上の性別)

従業員の戸籍上の性別:

  • Male(男)

  • Female(女)

ドロップダウン

Sort Order(並び順) パラメーターの並べ替えにより、並べ替えの鍵となる従業員プロパティを指定できます。プロパティの先頭にハイフンを追加すると、並び順を降順にできます。たとえば、updated_atまたは-updated_atのように指定します。

テキスト

FALSE

Joined After(指定した日以降に入社した従業員に絞り込みます) 指定した日以降に入社した従業員。

日時

FALSE

Joined Before(指定した日以前に入社した従業員に絞り込みます) 指定した日以前に入社した従業員。

日時

FALSE

Resigned After(指定した日以降に退職した従業員に絞り込みます) 指定した日以降に退職した従業員。

日時

FALSE

Resigned Before(指定した日以前に退職した従業員に絞り込みます) 指定した日以前に退職した従業員。

日時

FALSE

User ID (指定したユーザーIDで絞り込みます) ユーザーの一意のID。

テキスト

FALSE

Query (氏名・ビジネスネーム・部署名・役職名でフリーワード検索をします) 従業員名ビジネスネーム部署名役職名でフリーワードを検索します。

テキスト

FALSE

Employee IDs (取得したい従業員のID) IDを指定して従業員を取得します。

テキストのリスト

FALSE

Fields (取得する項目名) 取得するフィールド名。指定したフィールドのみが返されます。たとえば、iduser_idfirst_namelast_nameのように指定します。フィールドを指定しない場合、従業員オブジェクトのすべてのフィールドが返されます。

テキストのリスト

FALSE

Streaming(ストリーミング)

FALSE

Flow(フロー) [Choose Flow(フローの選択)]をクリックし、検索結果がストリーミングされるヘルパーフローを参照および選択して、[Choose(選択)]をクリックして確定します。

任意で、[Click or drop here to create(クリックまたはここにドロップして作成)]の下の空のフィールドをクリックし、データをヘルパーフローに渡すカスタム拡張可能フィールドを追加します。これらのフィールドは、ヘルパーフロー内の[State(状態)]出力オブジェクトの下にキーと値のペアとして追加されます。

このフィールドは、[Result Set(結果セット)]フィールドで[Stream Matching Records(一致レコードのストリーミング)] が選択されている場合に表示されます。

ストリーミングヘルパーフロー内のヘルパーカードの入力フィールドは、ストリーミングレコードを取得するために、キーRecord(レコード)(タイプオブジェクト)を参照する必要があります。状態入力値を得るには、Record(レコード)オブジェクトのキーState(状態)(typeオブジェクト)を参照します。

Flow(フロー)

TRUE

Record Limit(レコード制限)

ストリーミングするレコードの数を指定します。

  • [Record Limit(レコード制限)]フィールドに0を設定すると、レコードは返されません。

  • [Record Limit(レコード制限)]フィールドを0より大きい値に設定すると、0より大きい値から指定された最大レコード数までのレコードが返されます。

  • [Record Limit(レコード制限)]フィールドが空、null、または未選択の場合、すべてのレコードが返されます。

  • デフォルト値は500000です。

  • 有効な範囲は0500000です。

このフィールドは、[Result Set(結果セット)]オプションで[Stream Matching Records(一致レコードのストリーミング)]を選択した場合に表示されます。

数値

出力

フィールド 定義 Type(タイプ)
Employee ID(従業員ID) 従業員の一意のID。

テキスト

User ID (指定したユーザーIDで絞り込みます) ユーザーの一意識別子。

テキスト

Last Name(姓) 従業員の姓。

テキスト

First Name(名) 従業員の名。

テキスト

Last Name Yomi(姓(ヨミガナ)) 従業員の姓のヨミガナ

テキスト

First Name Yomi(名(ヨミガナ)) 従業員の名のヨミガナ

テキスト

Business Last Name(ビジネスネーム:姓) ビジネスネームの姓。

テキスト

Business First Name(ビジネスネーム:名) ビジネスネームの名。

テキスト

Business Last Name Yomi(ビジネスネーム:姓(ヨミガナ)) ビジネスネームの姓のヨミガナ

テキスト

Business First Name Yomi(ビジネスネーム:名(ヨミガナ)) ビジネスネームの名のヨミガナ

テキスト

Birth Date(生年月日) 従業員の生年月日。

日時

Gender(戸籍上の性別) 従業員の戸籍上の性別。

テキスト

Email(メールアドレス) 従業員のメールアドレス。

テキスト

Profile Images(プロフィール画像) 従業員のプロフィール画像。

オブジェクト

Identity Card Image 1(本人確認書類1) 従業員の本人検証用文書1。

オブジェクト

Identity Card Image 2(本人確認書類2) 従業員の本人検証用文書2。

オブジェクト

Created At(作成日) 作成日。

日時

Updated At(最終更新日) 最終更新日。

日時

Employment Status(在籍状況) 従業員の在籍状況。有効な値は、employed(在職中)on leave(休職中)retired(退職済)です。

テキスト

Start Date(入社年月日) 従業員の入社年月日。

日時

Resigned Date(退職年月日) 従業員の退職年月日。

日時

Resignation Reason(退職事由) 退職の理由。

テキスト

Employee number(社員番号) 社員番号。

テキスト

Business Establishment ID(事業所ID) 事業所のID。

テキスト

Employment Type(雇用形態) 従業員の雇用形態。

オブジェクト

Position(役職) 従業員の役職。

テキスト

Occupation(業務内容) 従業員の業務内容。

テキスト

Payment Period(給与支給形態) 従業員の給与支給形態。

オブジェクト

Department(部署) 部署の名称。最初に登録済みの部署名のみが返されます。

テキスト

Departments(部署情報) 登録済みの部署。カードは、このフィールドの最大100の選択肢を表示します。

オブジェクト

Address(現住所) 従業員の現在の住所。

オブジェクト

Address Image(現住所を確認できる書類) 現住所を確認できる文書。

オブジェクト

Telephone Number(電話番号) 従業員の電話番号。

テキスト

Head of Household Name(世帯主) 世帯主。

テキスト

Head of Household Relationship(世帯主の続柄) 世帯主との続柄。

テキスト

Resident Card Address(住民票住所) 住民票住所。

オブジェクト

Resident Card Address Head of Family(住民票住所の世帯主) 住民票住所の世帯主。

テキスト

Resident Card Address Relation Name(続柄(住民票住所の世帯主)) 住民票住所の世帯主との続柄。

テキスト

Resume 1(履歴書・職務経歴書1) 従業員の職務経歴書1。

オブジェクト

Resume 2(履歴書・職務経歴書2) 従業員の職務経歴書2。

オブジェクト

Commute Route(通勤経路) 通勤経路。

テキスト

Commuter Expense 1 (通勤手当1の定期券代) 通勤手当1の定期券代。

数値

Commuter Expense Period 1(通勤手当1の期間) 通勤手当1の期間。

テキスト

Commuter One-way Fare 1(通勤手当1の片道運賃) 通勤手当1の片道運賃。

数値

Commuter Expense 2 (通勤手当2の定期券代) 通勤手当2の定期券代。

数値

Commuter Expense Period 2(通勤手当2の期間) 通勤手当2の期間。

テキスト

Commuter One-way Fare 2(通勤手当2の片道運賃) 通勤手当2の片道運賃。

数値

Emergency Contact Last Name(緊急連絡先の姓) 緊急連絡先の姓。

テキスト

Emergency Contact First Name(緊急連絡先の名) 緊急連絡先の名。

テキスト

Emergency Contact Last Name Yomi(緊急連絡先の姓(ヨミガナ)) 緊急連絡先の姓のヨミガナ

テキスト

Emergency Contact First Name Yomi(緊急連絡先の名(ヨミガナ)) 緊急連絡先の名のヨミガナ

テキスト

Emergency Contact Relationship(緊急連絡先の続柄) 緊急連絡先との続柄。

テキスト

Emergency Contact Telephone Number(緊急連絡先の電話番号) 緊急連絡先の電話番号。

テキスト

Emergency Contact Address(緊急連絡先の住所) 緊急連絡先の住所。

オブジェクト

Bank Accounts(給与振込口座) 銀行口座情報。

オブジェクト

Monthly Income Currency(報酬月額(通貨)) 報酬月額。

数値

Monthly Income Goods(報酬月額(現物)) 報酬月額。

数値

Contract Type(契約種別) 雇用契約の種別。有効な値は、unlimited(無期)またはfixed_term(有期)です。

テキスト

Contract Start Date(契約開始日) 雇用契約の開始日。

日時

Contract End Date(契約終了日) 雇用契約の終了日。

日時

Contract Renewal Type(契約更新の有無) 従業員の契約更新の種別。有効な値は、renewal(有)none(無)auto_renewal(自動更新)です。

テキスト

Foreign Resident Last Name(在留資格情報:姓) 在留資格情報の姓。

テキスト

Foreign Resident First Name(在留資格情報:名) 在留資格情報の名。

テキスト

Foreign Resident Middle Name(在留資格情報:ミドルネーム) 在留資格情報のミドルネーム。

テキスト

Foreign Resident Card Number(在留カード番号) 在留カード番号。

テキスト

Nationality Code(国籍/国籍コード) 国籍コード。

テキスト

Resident Status Type(在留資格) 在留資格

テキスト

Unknown Status of Residence Reason (在留資格不明理由) 在留資格が不明の理由。

テキスト

Period of Stay(在留期日) 外国人の在留期間。

日時

Additional Activity Permission(資格外活動許可の有無) 以前に付与された在留資格で許可された活動以外の活動を行うための許可。有効な値は、permitted(有)またはnone(なし)です。

テキスト

Dispatch/Contract Work Category(派遣・請負就労区分) 派遣または請負就労区分。有効な値は、other_be_workable(派遣・請負労働者として主として当該事業所以外で就労する)またはothers(その他)です。

テキスト

Foreign Resident Card Image 1(在留カードの画像1) 在留カードの画像1。

オブジェクト

Foreign Resident Card Image 2(在留カードの画像2) 在留カードの画像2。

オブジェクト

Employment Insurance Insured Number(雇用保険の被保険者番号) 雇用保険の被保険者番号。

テキスト

Employment Insurance Insured Number Image(雇用保険被保険者番号添付画像)。 雇用保険被保険者番号の画像。

オブジェクト

Employment Insurance Insured Number Unknown Reason(雇用保険の被保険者番号がない場合の理由) 雇用保険の被保険者番号がない場合の理由。

テキスト

Name of Company Enrolled in Employment Insurance(雇用保険に加入していた会社名) 雇用保険に加入していた会社名。

テキスト

Enrollment Start Date(雇用保険に加入していた会社の在籍開始日) 雇用保険に加入していた会社の在籍開始日。

日時

Enrollment End Date(雇用保険に加入していた会社の在籍終了日) 雇用保険に加入していた会社の在籍終了日。

日時

Employment Insurance Eligibility Start Date(雇用保険の資格取得年月日) 雇用保険の資格取得年月日。

日時

Employment Insurance Eligibility End Date(雇用保険の資格喪失年月日) 雇用保険の資格喪失年月日。

日時

Welfare Pension Insurance Insured Person Reference Number(厚生年金保険の被保険者整理番号) 厚生年金保険の被保険者整理番号。

数値

Health Insurance Insured Reference Number(健康保険の被保険者整理番号) 健康保険の被保険者整理番号。

数値

Basic Pension Number(基礎年金番号) 基礎年金番号。

数値

Basic Pension Number Image(基礎年金番号添付画像) 基礎年金番号の画像。

オブジェクト

First Time Employees Pension Plan Enrollment(厚生年金初加入フラグ) 厚生年金初加入フラグ。

True/False

Unknown Basic Pension Number Reason(基礎年金番号が不明な場合の理由) 基礎年金番号が不明な理由。

テキスト

First Employee Pension Plan Company Name(最初に厚生年金へ加入した会社名) 最初に厚生年金へ加入した会社の名前。

テキスト

First Employee Pension Plan Company Address(最初に厚生年金へ加入した会社の住所文字列) 最初に厚生年金へ加入した会社の住所。

テキスト

First Employee Pension Plan Company Start Date(最初に厚生年金へ加入した会社の在籍開始日) 最初に厚生年金へ加入した会社の在籍開始日。

日時

First Employee Pension Plan Company End Date(最初に厚生年金へ加入した会社の在籍終了日) 最初に厚生年金へ加入した会社の在籍終了日。

日時

Last Employee Pension Plan Company Name(最後に厚生年金へ加入した会社名) 最後に厚生年金へ加入した会社の名前。

テキスト

Last Employee Pension Plan Company Address(最後に厚生年金へ加入した会社の住所文字列) 最後に厚生年金へ加入した会社の住所。

テキスト

Last Employee Pension Plan Company Start Date(最後に厚生年金へ加入した会社の在籍開始日) 最後に厚生年金へ加入した会社の在籍開始日。

日時

Last Employee Pension Plan Company End Date(最後に厚生年金へ加入した会社の在籍終了日) 最後に厚生年金へ加入した会社の在籍終了日。

日時

Social Insurance Qualification Start Date(社会保険の資格取得年月日) 社会保険の資格取得年月日。

日時

Social Insurance Qualification End Date(社会保険の資格喪失年月日) 社会保険の資格喪失年月日。

日時

Monthly Standard Income Revision Date(標準報酬月額の改定年月) 標準報酬月額の改定年月。

日時

Standard Monthly Income for Health Insurance(健康保険の標準報酬月額) 健康保険の標準報酬月額。

数値

Standard Monthly Income for Employee Pension(厚生年金の標準報酬月額) 厚生年金の標準報酬月額。

数値

Marital Status(配偶者の有無) 配偶者の有無。

True/False

Spouse Annual Income(配偶者の年収) 配偶者の年収。

数値

Tax Classification(課税区分) 課税区分。

テキスト

Disability Type(障害者区分) 障害者区分。

テキスト

Disability Certificate Type(障害者手帳の種類) 障害者手帳の種類。

テキスト

Disability Certificate Issuance Date(障害者手帳の交付年月日) 障害者手帳の交付年月日。

日時

Disability Image(障害者手帳の画像) 障害者手帳の画像。

オブジェクト

Working Student Flag(勤労学生フラグ) 勤労学生フラグ。

True/False

School Name(学校名) 勤労学生の学校名。

テキスト

Student Card Image(学生証の画像) 学生証の画像

オブジェクト

Date of Admission(入学年月日) 勤労学生の入学年月日。

日時

Student Income (所得の見積額) 勤労学生の所得の見積額。

数値

Employment Income Flag(給与所得フラグ) 給与所得フラグ。

True/False

Business Income Flag(事業所得フラグ) 事業所得フラグ。

True/False

Dividend Income Flag(配当所得フラグ) 配当所得フラグ。

True/False

Business Income Flag(事業所得フラグ) 事業所得フラグ。

True/False

Real Estate Income Flag(不動産所得フラグ) 不動産所得フラグ。

True/False

Widow/Single Parent Type(寡婦・ひとり親) 寡婦・ひとり親。

テキスト

Widow/Single Parent Reason(寡婦・ひとり親の理由) 寡婦・ひとり親の理由。

テキスト

Notes for Widows and Single Parents(寡婦・ひとり親の備考) 寡婦・ひとり親の備考。

テキスト

Custom Field Group Name(カスタムフィールドグループ名) 名前でグループ化されたユーザー定義の従業員フィールド。カードは、このフィールドの最大100の選択肢を表示します。

オブジェクト

Result(結果)
Records Streamed(ストリーミングされたレコード)

ストリーミングフロー内でストリーミングされたレコードの数。

このフィールドは、[Result Set(結果セット)]オプションで[一致レコードのストリーミング]を選択した場合に表示されます。

数値

関連項目

SmartHRコネクター

Workflows要素

SmartHR APIのドキュメント