> ## Documentation Index
> Fetch the complete documentation index at: https://developers.techwolf.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Employees

## Employees datasource specification

This page describes the Workday EIB files for syncing **Employees** into
TechWolf: the Employee baseline, the organisational structure, and every
skill-relevant signal attached to an Employee. For each file it gives the S3
location, the fields TechWolf expects, and the Workday field each one comes
from.

The Employee Baseline file is required and establishes each Employee; every
other file on this page references it through `employee_id`. Two files link out
to other entities: the Employee Baseline points to a Job through
`assigned_position`, and Learning History points to a Course through
`course_id`. The
[Jobs](/integrations/datasource-integrations/workday-datasource/jobs) and
[Courses](/integrations/datasource-integrations/workday-datasource/courses)
specifications must be synced as well for those links to resolve.

The rules shared by every Workday file (full dumps, dependencies,
transformations and how to read the field tables) are described in the
[EIB Specification](/integrations/datasource-integrations/workday-datasource/eib-specification).

The files from Learning History onwards carry no identifier from Workday.
TechWolf generates an `external_id` for each row as a hash of its content, so
the EIB does not need to export one.

<AccordionGroup>
  <Accordion title="Employee Baseline" icon="users">
    The baseline Employee file. **Required.** Establishes the existence of each
    Employee; every other file on this page references it.

    File on S3:
    `.../file_based/TechWolf_Employee_Information/TechWolf_Employee_Information_[yyyy][MM][dd]_[HH][mm][ss].csv`

    | TechWolf field | Primary Business Object | Business Object | Workday field | Required | Key | Max chars | Notes |
    | - | - | - | - | - | - | - | - |
    | employee\_id | Worker | Worker | Employee ID | Required | Primary key | 100 | External ID of the file. Slugified. |
    | assigned\_position | Worker | Job Profile | Reference ID | Recommended | Foreign key | 100 | The Employee's current Job. Points to job\_id in Job Information. This is the Job Profile in Workday, not the Position. |
    | organisational\_unit\_id | Worker | Supervisory Organization | Reference ID | Recommended | Foreign key | 100 | Points to organisational\_unit\_id in Organisational Information. If given, an Organisational Unit with that id must exist. |
  </Accordion>

  <Accordion title="Organisational Information" icon="sitemap">
    The supervisory organisation structure. **Highly recommended.**

    File on S3:
    `.../file_based/TechWolf_Supervisory_Organization/TechWolf_Supervisory_Organization_[yyyy][MM][dd]_[HH][mm][ss].csv`

    | TechWolf field | Primary Business Object | Business Object | Workday field | Required | Key | Max chars | Notes |
    | - | - | - | - | - | - | - | - |
    | organisational\_unit\_id | Supervisory Organization | Supervisory Organization | Reference ID | Required | Primary key | 100 | External ID of the file. Slugified. |
    | organisational\_unit\_name | Supervisory Organization | Supervisory Organization | Supervisory Organization | Required | | 100 | |
    | organisational\_unit\_active | Supervisory Organization | Supervisory Organization | Active | Recommended | | n/a | The Organisational Unit is assumed to be active if no value is given. |
    | parent\_organisational\_unit\_id | Supervisory Organization | Superior Organization | Reference ID | Recommended | Foreign key | 100 | Points to the organisational\_unit\_id of the parent unit. |
    | parent\_organisational\_unit\_name | Supervisory Organization | Superior Organization | Superior Organization | Recommended | | 100 | |
  </Accordion>

  <Accordion title="Learning History" icon="book-open">
    Courses an Employee has completed. **Highly recommended.**

    File on S3:
    `.../file_based/TechWolf_Learning_History/TechWolf_Learning_History_[yyyy][MM][dd]_[HH][mm][ss].csv`

    | TechWolf field | Primary Business Object | Business Object | Workday field | Required | Key | Max chars | Notes |
    | - | - | - | - | - | - | - | - |
    | employee\_id | Learning Enrollment | Worker | Employee ID | Required | Foreign key | 100 | Points to employee\_id in Employee Baseline. |
    | course\_id | Learning Enrollment | Enrolled Content | CF EE Learning Content ID based on type | Required | Foreign key | 100 | Points to course\_id in Course Information. Use the same calculated field as the Course file. |
    | timestamp | Learning Enrollment | Learning Enrollment | Completion Date | Recommended | | n/a | Defaults to the creation time of the related Skill Event within TechWolf. |

    <Note>
      TechWolf recommends applying these filters to the Learning History export in
      Workday, so the file only carries completed, skill-relevant learning:

      * **Completion Status** in the selection list: `Completed`
      * **Learning Content Type** in the selection list: `Blended Course`,
        `Digital Course`, `Lesson`

      Mandatory learning should be removed as well.
    </Note>
  </Accordion>

  <Accordion title="Internal Work History" icon="clock-rotate-left">
    The Employee's history of internal Jobs. **Highly recommended.** Should include
    the current assigned position and its start date.

    File on S3:
    `.../file_based/TechWolf_Internal_Work_History/TechWolf_Internal_Work_History_[yyyy][MM][dd]_[HH][mm][ss].csv`

    | TechWolf field | Primary Business Object | Business Object | Workday field | Required | Key | Max chars | Notes |
    | - | - | - | - | - | - | - | - |
    | employee\_id | Worker | Worker | Employee ID | Required | Foreign key | 100 | Points to employee\_id in Employee Baseline. |
    | job\_id | Worker | Job Profile History | CF LRV Reference ID from Job Profile History | Required | Foreign key | 100 | Points to job\_id in Job Information. A calculated field you may still have to create: type Lookup Reference Value, on the Job Profile Snapshot Interface business object, for the field Reference ID. |
    | start\_date | Worker | Job Profile History | Job Profile Change Start Date | Recommended | | n/a | Also used as the timestamp. |
    | end\_date | Worker | Job Profile History | Job Profile Change End Date | Recommended | | n/a | Leave empty while the Job is ongoing. |
  </Accordion>

  <Accordion title="External Work History" icon="building">
    The Employee's work experience outside the organisation. **Highly recommended.**

    File on S3:
    `.../file_based/TechWolf_External_Work_History/TechWolf_External_Work_History_[yyyy][MM][dd]_[HH][mm][ss].csv`

    | TechWolf field | Primary Business Object | Business Object | Workday field | Required | Key | Max chars | Notes |
    | - | - | - | - | - | - | - | - |
    | employee\_id | Worker | Worker | Employee ID | Required | Foreign key | 100 | Points to employee\_id in Employee Baseline. |
    | job\_title | Worker | Job History - Skills and Experience | External Job | Required | | 256 | |
    | job\_description | Worker | Job History - Skills and Experience | Responsibility and Achievements | Recommended | | No limit | |
    | company | Worker | Job History - Skills and Experience | Company | Recommended | | 256 | |
    | start\_date | Worker | Job History - Skills and Experience | Start Date | Recommended | | n/a | |
    | end\_date | Worker | Job History - Skills and Experience | End Date | Recommended | | n/a | Leave empty while the Job is ongoing. |
  </Accordion>

  <Accordion title="Certification History" icon="certificate">
    Certifications held by the Employee. **Recommended.**

    File on S3:
    `.../file_based/TechWolf_Certification/TechWolf_Certification_[yyyy][MM][dd]_[HH][mm][ss].csv`

    | TechWolf field | Primary Business Object | Business Object | Workday field | Required | Key | Max chars | Notes |
    | - | - | - | - | - | - | - | - |
    | employee\_id | Worker | Worker | Employee ID | Required | Foreign key | 100 | Points to employee\_id in Employee Baseline. |
    | certification\_name | Worker | Certifications | Certification Name | Required\* | | 255 | |
    | certificate\_description | n/a | n/a | n/a | Required\* | | No limit | Workday Certifications carry no description, so this field normally needs a default value agreed with TechWolf. |
    | timestamp | Worker | Certifications | Issued Date | Recommended | | n/a | |
  </Accordion>

  <Accordion title="Education History" icon="graduation-cap">
    The Employee's formal education. **Recommended.**

    File on S3:
    `.../file_based/TechWolf_Education/TechWolf_Education_[yyyy][MM][dd]_[HH][mm][ss].csv`

    | TechWolf field | Primary Business Object | Business Object | Workday field | Required | Key | Max chars | Notes |
    | - | - | - | - | - | - | - | - |
    | employee\_id | Worker | Worker | Employee ID | Required | Foreign key | 100 | Points to employee\_id in Employee Baseline. |
    | degree\_name | Worker | Education | Degree | Required | | No limit | Joined with Field of Study into one value. |
    | degree\_name | Worker | Education | Field of Study | Required | | No limit | |
    | school | Worker | Education | School | Recommended | | No limit | |
    | start\_date | Worker | Education | First Day Attended | Recommended | | n/a | |
    | end\_date | Worker | Education | Last Day Attended | Recommended | | n/a | Also used as the timestamp. |
  </Accordion>

  <Accordion title="Feedback" icon="comments">
    Feedback given to the Employee. **Recommended.**

    File on S3:
    `.../file_based/TechWolf_Feedback/TechWolf_Feedback_[yyyy][MM][dd]_[HH][mm][ss].csv`

    | TechWolf field | Primary Business Object | Business Object | Workday field | Required | Key | Max chars | Notes |
    | - | - | - | - | - | - | - | - |
    | employee\_id | Worker | Worker | Employee ID | Required | Foreign key | 100 | Points to employee\_id in Employee Baseline. |
    | timestamp | Worker | Feedback | Date | Recommended | | n/a | |
    | source | Worker | Feedback | Feedback Type | Recommended | | No limit | |
    | description | Worker | Feedback | Question | Required | | No limit | Joined with Comment into one value. |
    | description | Worker | Feedback | Comment | Required | | No limit | |
  </Accordion>

  <Accordion title="Goals" icon="bullseye">
    Goals set for the Employee. **Recommended.**

    File on S3:
    `.../file_based/TechWolf_Goal/TechWolf_Goal_[yyyy][MM][dd]_[HH][mm][ss].csv`

    | TechWolf field | Primary Business Object | Business Object | Workday field | Required | Key | Max chars | Notes |
    | - | - | - | - | - | - | - | - |
    | employee\_id | Worker | Worker | Employee ID | Required | Foreign key | 100 | Points to employee\_id in Employee Baseline. |
    | description | Worker | Goals | Goal | Required | | No limit | Joined with Goal Description into one value. |
    | description | Worker | Goals | Goal Description | Required | | No limit | |
    | timestamp | Worker | Goals | Completed on | Recommended | | n/a | |

    <Note>
      Only send Goals that carry a relevant **Status** in Workday, for example
      `Completed` and `On Track`.
    </Note>
  </Accordion>

  <Accordion title="Performance Data" icon="chart-line">
    Performance records for the Employee. **Recommended.**

    File on S3:
    `.../file_based/TechWolf_Performance/TechWolf_Performance_[yyyy][MM][dd]_[HH][mm][ss].csv`

    | TechWolf field | Primary Business Object | Business Object | Workday field | Required | Key | Max chars | Notes |
    | - | - | - | - | - | - | - | - |
    | employee\_id | Worker | Worker | Employee ID | Required | Foreign key | 100 | Points to employee\_id in Employee Baseline. |
    | title | Worker | Performance Review - Most Recent for Worker | Performance Review Name | Required | | 255 | |
    | description | Worker | Performance Review - Most Recent for Worker | Content - Feedback Responses Overall Comment - Manager | Required | | No limit | |
    | status | Worker | Performance Review - Most Recent for Worker | Status | Recommended | | No limit | Only send entries perceived as relevant (e.g. "Completed", "On Track"). |
    | type | n/a | n/a | n/a | Recommended | | No limit | |
    | timestamp | Worker | Performance Review - Most Recent for Worker | Date and Time Completed | Recommended | | n/a | |
  </Accordion>

  <Accordion title="Resume" icon="file-lines">
    The Employee's resume document. **Recommended.**

    File on S3:
    `.../file_based/TechWolf_Resume_Attachment/TechWolf_Resume_Attachment_[yyyy][MM][dd]_[HH][mm][ss].csv`

    | TechWolf field | Primary Business Object | Business Object | Workday field | Required | Key | Max chars | Notes |
    | - | - | - | - | - | - | - | - |
    | employee\_id | Worker | Worker | Employee ID | Required | Foreign key | 100 | Points to employee\_id in Employee Baseline. |
    | mimeType | Worker | Resume Attachments | Content Type | Required | | n/a | Only application/pdf, application/msword, application/vnd.openxmlformats-officedocument.wordprocessingml.document, and text/plain are supported; other types are ignored. |
    | base64Content | Worker | Resume Attachments | Attachment | Required | | No limit | The document encoded as a base64 string. |
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.