従業員に関連づくサービスと役割の照会

リクエスト

エンドポイント

実行先のURLについて詳しくは、「APIエンドポイント」をご覧ください。

HTTPメソッド	APIパス	用途	マスタ管理プラスオプション必須
GET	/api/v22.10/memberAuthorities	特定従業員に関連づく業務アセットと権限セットの取得	ー

クエリパラメータ

項目名	必須	データ形式	デフォルト値	説明
employeeNumber	〇	整数値	ー	対象従業員の社員番号
date	ー	文字列（YYYY-MM-DD形式）	実行日を表す文字列	情報取得日

リクエストヘッダ

「APIリクエストヘッダ」をご覧ください。

リクエストボディ

不要

レスポンス

レスポンスボディ

項目名	データ形式	説明
members	membersオブジェクトの配列 ※各要素の属性は、「membersオブジェクト」をご覧ください	検索結果

membersオブジェクト

項目名	データ形式	説明
member	memberオブジェクトの配列 ※各要素の属性は、「memberオブジェクト」をご覧ください	検索対象の従業員情報
authorities	authoritiesオブジェクトの配列 ※各要素の属性は、「authoritiesオブジェクト」をご覧ください	対象従業員に割り当てられている業務アセットの情報
expectedRoles	expectedRoleオブジェクトの配列 ※各要素の属性は、「expectedRoleオブジェクト」をご覧ください	対象従業員に割り当てられるサービス権限情報

memberオブジェクト

項目名	データ形式	説明
date	文字列（YYYY-MM-DD形式）	従業員情報の情報取得日
id	文字列	従業員のID
type	文字列	従業員であることを示す値「member」が設定
name	文字列	従業員の名前
email	文字列	従業員のメールアドレス
identificationNumber	文字列	従業員の個人ID (顧客が設定可能)
companies	companyオブジェクトの配列 ※各要素の属性は、「companyオブジェクト」をご覧ください	従業員が所属している会社の情報

companyオブジェクト

項目名	データ形式	説明
id	文字列	所属会社のID
type	文字列	会社であることを示す値「company」が設定
name	文字列	所属会社の名前
depth	整数値	所属会社が作成されている深さ
employeeNumber	文字列	所属会社内での社員番号（顧客が設定可能）

authoritiesオブジェクト

項目名	データ形式	説明
authority	authorityオブジェクト ※項目は、「authorityオブジェクト」をご覧ください	対象従業員が割り当てられている権限セットの情報
relations	relationオブジェクトの配列 ※各要素の項目は、「relationオブジェクト」をご覧ください	対象従業員が権限セットに割り当てられている原因となる設定の情報
connections	connectionsオブジェクトの配列 ※各要素の項目は、「connectionsオブジェクト」をご覧ください	権限セットで設定されている業務アセットの情報

authorityオブジェクト

項目名	データ形式	説明
id	文字列	権限セットのID
type	文字列	権限セットであることを示す値「authority」が設定
name	文字列	権限セットの名称
code	文字列	権限セットコード (顧客が設定可能)
generateTasks	boolean (true / false)	権限セットでのタスク生成設定
checkAttributeAvailabilities	文字列の配列	タスク生成の前提となる属性原則「TYJ5hHDZSnugN4Lv6e45kw」（「メールアドレス」属性）のみが設定されている

relationオブジェクト

項目名	データ形式	説明
id	文字列	権限セットが直接関連付けされており、対象従業員が関連するオブジェクト
type	以下のいずれかの文字列 member organization company office project	取得したオブジェクトの種別
name	文字列	取得したオブジェクトの名称
code	文字列	取得したオブジェクトのコード (顧客が設定可能)
depth	整数値	取得したオブジェクトが作成されている階層の深さ「type」が「member」の時、削除される

connectionsオブジェクト

項目名	データ形式	説明
connection	connectionオブジェクト ※項目は、「connectionオブジェクト」をご覧ください	業務アセットの情報
roles	roleオブジェクトの配列 ※各要素の項目は、「roleオブジェクト」をご覧ください	権限セットで設定されている役割の情報

expectedRoleオブジェクト

項目名	データ形式	説明
connection	connectionオブジェクト ※項目は、「connectionオブジェクト」をご覧ください	業務アセットの情報
roles	roleオブジェクトの配列 ※各要素の項目は、「roleオブジェクト」をご覧ください	役割の優先順位に従い、実際に適用される役割の情報

共通オブジェクト

connectionオブジェクト

項目名	データ形式	説明
id	文字列	業務アセットのID
type	文字列	業務アセットであることを示す値「connection」が設定
name	文字列	業務アセットの名称
code	文字列	業務アセットコード
staffs	文字列の配列	業務アセットの担当者情報
generateTasks	boolean（true / false）	業務アセットでのタスク生成設定
shiftAuthority	shiftAuthorityオブジェクト ※項目は、「shiftAuthorityオブジェクト」をご覧ください	業務アセットでのタスク生成日の前倒し、後ろ倒し設定
roleIntegrationType	文字列	役割の優先順を決定する設定値原則は「priority」が設定されている

shiftAuthorityオブジェクト

項目名

データ形式

説明

start

文字列

タスク生成日の前倒し期間

ISO8601での継続時間表記で記載

end

文字列

タスク生成日の後ろ倒し期間