HRIS S3 コネクタのフィールドリファレンス

Talent で利用するために Teamwork Graph とデータを正常に同期するには、このガイドに記載されている仕様に従って CSV をフォーマットする必要があります。このリファレンスでは、positions.csv、workers.csv、および organizations.csv ファイルで利用可能なフィールドについて説明します。

Position レポートのフィールド

positions.csv ファイルは、組織内のロールを定義します。

Position レポートの必須フィールド

S3 コネクタフィールド	タイプ	説明
ポジション ID	文字列	一意の識別子
createdAt	タイムスタンプ	ISO 8601 形式 (例: `2023-06-09T00:54:04.016-07:00`)
isActive	数値	`isActive=1`: アクティブなポジション `isActive=0`: 非アクティブなポジション
organizationId (組織 ID)	文字列	organizations.csv ファイル内の、`isActive` が `1` に設定されている既存の `organizationId` と一致していることが必要
労働者 ID	文字列	workers.csv レポート内の、`isActive` が `1` に設定されている既存の `workerId` と一致していることが必要

Position レポートの任意フィールド

positionTitle フィールドは、Talent アプリで表示されるポジション名が適切なコンテキストを提供できるようにするために推奨されます。

S3 コネクタフィールド	タイプ	説明
役職	文字列	Talent でコンテキストを提供するために推奨
役職	文字列	社内の役職名
status	文字列	`Filled` または `Unfilled` に設定できますフィールドを空白のままにすると、`Unfilled` に設定されますフィールドに `Unfilled` 以外の値を入力すると、`Filled` に設定されます `Unfilled` の入力では、大文字と小文字が区別されません (`unfilled` や `unFilled` も許容されます)
inactiveDate	ISO 8601 形式の日付	例: `2023-06-09` `isActive` が `0` に設定されている場合にのみ必要です過去 30 日以内であることが必要です
雇用の種類	enum	値: `Employee`、`Contingent`、または `Contractor`
タイムゾーン	文字列	ポジションのローカルタイムゾーン
職種	文字列	職種ファミリーの社内分類
国	文字列	ポジションの所在地の国
レベル	文字列	職位レベルまたは等級
externalPositionKey	文字列	外部システム識別子
lastUpdatedAt	ISO 8601 形式のタイムスタンプ	例: `2023-06-09T00:54:04.016-07:00` 最終更新日時

Worker レポートのフィールド

workers.csv ファイルには、組織内の従業員に関する情報が含まれています。

Worker レポートの必須フィールド

S3 コネクタフィールド	タイプ	説明
労働者 ID	文字列	一意の識別子
createdAt	ISO 8601 形式のタイムスタンプ	例: `2023-06-09T00:54:04.016-07:00`
name	文字列	従業員の氏名
isActive	数値	`isActive=1`: アクティブなポジション `isActive=0`: 非アクティブなポジション

Worker レポートの任意フィールド

S3 コネクタフィールド	タイプ	説明
emailAddress	文字列	Talent 機能のロックを解除することを強く推奨一意でなければなりません
タイムゾーン	文字列	従業員のローカルタイムゾーン
hireDate	ISO 8601 形式の日付	例: `2023-06-09`
inactiveDate	ISO 8601 形式の日付	例: `2023-06-09` `isActive` が `0` に設定されている場合にのみ必要です。過去 30 日以内であることが必要です。
title	文字列	従業員の役職名
職種	文字列	社内の職種
レベル	文字列	職位レベルまたは等級
国	文字列	居住国
lastUpdatedAt	ISO 8601 形式のタイムスタンプ	例: `2023-06-09T00:54:04.016-07:00` 最終更新日時

Organization レポートのフィールド

organizations.csv ファイルは、報告系統と管理階層を定義します。

Organization レポートの必須フィールド

S3 コネクタフィールド	タイプ	説明
organizationId (組織 ID)	文字列	一意の識別子
Organization Name	文字列	部署またはチームの名前
マネージャーのポジション ID	文字列	`organizationId` のマネージャーの割り当てが positions.csv ファイル内の 1 つ以上の `positionId` に関連付けられている場合に必須 `organizationId` の manager 割り当てがいずれの `positionId` にも関連付けられていない場合は不要。この場合、その組織は管理対象外であり、空の組織です。
superiorOrganizationId	文字列	組織階層を示すため、最上位の組織を除くすべての組織で必須 `isActive` が `1` に設定されている既存の `organizationId` と一致していることが必要
createdAt	ISO 8601 形式のタイムスタンプ	例: `2023-06-09T00:54:04.016-07:00`
isActive	数値	`isActive=1`: アクティブな組織 `isActive=0`: 非アクティブな組織

Organization レポートの任意フィールド

S3 コネクタフィールド	タイプ	説明
inactiveDate	ISO 8601 形式の日付	例: `2023-06-09` `isActive` が `0` に設定されている場合にのみ必要です過去 30 日以内であることが必要です
lastUpdatedAt	ISO 8601 形式のタイムスタンプ	例: `2023-06-09T00:54:04.016-07:00` 最終更新日時

S3 コネクタフィールド

タイプ

説明

inactiveDate

ISO 8601 形式の日付

例: 2023-06-09

isActive が 0 に設定されている場合にのみ必要です
過去 30 日以内であることが必要です

lastUpdatedAt

ISO 8601 形式のタイムスタンプ

例: 2023-06-09T00:54:04.016-07:00

最終更新日時

この内容はお役に立ちましたか?

正確ではなかった明確ではなかった関係なかった

さらにヘルプが必要ですか?

アトラシアンコミュニティをご利用ください。

コミュニティに質問

HRIS S3 コネクタのフィールド リファレンス