HRIS S3 connector field reference

To successfully sync your data with the Teamwork Graph for use in Talent, you must format your CSV files according to the specifications in this guide. This reference covers fields available for the positions.csv, workers.csv, and organizations.csv files.

Position fields

The positions.csv file defines the roles within your organization.

Required position fields

S3 connector field	タイプ	説明
ポジション ID	文字列	Unique identifier
createdAt	タイムスタンプ	ISO 8601 format (e.g., `2023-06-09T00:54:04.016-07:00`)
isActive	数値	`isActive=1` for active positions `isActive=0` for inactive positions
organizationId (組織 ID)	文字列	Must match an existing `organizationId` from the organizations.csv file with `isActive` set to `1`
労働者 ID	文字列	Must match an existing `workerId` from the workers.csv report with `isActive` set to `1`

Optional position fields

The positionTitle field is recommended to ensure displayed position names provide relevant context in the Talent app.

S3 connector field	タイプ	説明
positionTitle	文字列	Recommended to provide context in Talent
役職	文字列	Internal job title
status	文字列	Can be set to `Filled` or `Unfilled` Leaving the field blank will set it to `Unfilled` Entering any value other than `Unfilled` will set the field to `Filled` Entries of `Unfilled` are not case-sensitive, e.g. `unfilled`or `unFilled`are also acceptable
inactiveDate	ISO 8601 date	Example: `2023-06-09` Required only if `isActive` is set to `0` Must be within the past 30 days
雇用の種類	Enum	Values: `Employee`, `Contingent`, or `Contractor`
タイムゾーン	文字列	Local timezone for the position
職種	文字列	Internal job family classification
国	文字列	Country where the position is located
レベル	文字列	Job level or grade
externalPositionKey	文字列	External system identifier
lastUpdatedAt	ISO 8601 timestamp	Example: `2023-06-09T00:54:04.016-07:00` Timestamp of the last update

Worker fields

The workers.csv file contains information about the people in your organization.

Required worker fields

S3 connector field	タイプ	説明
労働者 ID	文字列	Unique identifier
createdAt	ISO 8601 timestamp	Example: `2023-06-09T00:54:04.016-07:00`
name	文字列	The worker's full name
isActive	数値	`isActive=1` for active positions `isActive=0` for inactive positions

Optional worker fields

S3 connector field	タイプ	説明
emailAddress	文字列	Highly recommended to unlock Talent features Must be unique
タイムゾーン	文字列	Local timezone for the worker
hireDate	ISO 8601 date	Example: `2023-06-09`
inactiveDate	ISO 8601 date	Example: `2023-06-09` Required only if `isActive` is set to `0`. Must be within the past 30 days.
title	文字列	The worker's professional title
職種	文字列	Internal job family
レベル	文字列	Job level or grade
国	文字列	Country of residence
lastUpdatedAt	ISO 8601 timestamp	Example: `2023-06-09T00:54:04.016-07:00` Timestamp of the last update

Organization fields

The organizations.csv file defines your reporting and managerial hierarchy.

Required organization fields

S3 connector field	タイプ	説明
organizationId (組織 ID)	文字列	Unique identifier
Organization Name	文字列	Name of the department or team
managerPositionId	文字列	Required when the `organizationId`’s manager assignment is associated with at least one `positionId`from the positions.csv file Not required when the `organizationId`’s manager assignment is not associated with any `positionId`. This is an unmanaged and empty organization.
superiorOrganizationId	文字列	Required for all except the top-most organization to indicate org hierarchy Must match an existing `organizationId` with `isActive` set to `1`
createdAt	ISO 8601 timestamp	Example: `2023-06-09T00:54:04.016-07:00`
isActive	数値	`isActive=1` for active organizations `isActive=0` for inactive organizations

Optional organization fields

S3 connector field	タイプ	説明
inactiveDate	ISO 8601 date	Example: `2023-06-09` Required only if `isActive` is set to `0` Must be within the past 30 days
lastUpdatedAt	ISO 8601 timestamp	Example: `2023-06-09T00:54:04.016-07:00` Timestamp of the last update

S3 connector field

タイプ

説明

inactiveDate

ISO 8601 date

Example: 2023-06-09

Required only if isActive is set to 0
Must be within the past 30 days

lastUpdatedAt

ISO 8601 timestamp

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

Timestamp of the last update

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

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

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

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

コミュニティに質問