Jobs

Jobs datasource specification

This page describes the file-based datasource specification for syncing Jobs and their Vacancies into TechWolf when no standardized connector (such as Workday or SAP SuccessFactors) is available. It defines the files TechWolf expects, the fields within each file, and which fields are required.

Use this specification when a customer exports Job data from any source system to flat files. As long as the data can be shaped into the files below, TechWolf can ingest it.

Jobs are referenced by Employees: the Employee Baseline points to a Job through assigned_position, and Internal Work History points to a Job through job_id (see the Employees specification). A Job referenced there must be synced through the Job Information file below.

For the broader picture of how file-based integrations work and how they compare to API-based connectors, see Key concepts.

The delivery flow over SFTP and S3, the file locations, and how to read the field tables below are described in Technical data flow.

Job Information

The baseline Job file. Required. Contains the Jobs (and their architecture hierarchy) that TechWolf infers skills for.

File on S3: .../file_based/TechWolf_Job_Information/TechWolf_Job_Information_[yyyy][MM][dd]_[HH][mm][ss].csv

TechWolf field	Required	Key	Max chars	Notes
job_id	Required	Primary key	100	External ID of the file. ID of the Job.
job_title	Required		255
job_description	Recommended		No limit
skill_requirements	Recommended		No limit
job_hierarchy_level_1	Recommended		255	Top level of the Job architecture.
job_hierarchy_level_2	Recommended		255
job_hierarchy_level_2_ID	Recommended		100
job_hierarchy_level_2_description	Recommended		No limit
active	Recommended		n/a	Job assumed to be active if no value is given.

Job Vacancies

Open Vacancies (Job Requisitions) linked to Jobs. Highly recommended. Vacancy text is a strong signal for skill inference.

File on S3: .../file_based/TechWolf_Job_Requisition/TechWolf_Job_Requisition_[yyyy][MM][dd]_[HH][mm][ss].csv

TechWolf field	Required	Key	Max chars	Notes
requisition_id	Required	Primary key	100	External ID of the file. ID of the Vacancy.
job_id	Recommended	Foreign key	100	Job linked to the Vacancy, used for skill inference.
job_title	Required		255
job_description	Required		No limit
job_requisition_inactive	Recommended		n/a