> ## 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.

# Installation - Employees

## Employees datasource specification

This page describes the SAP SuccessFactors exports for syncing **Employees**
into TechWolf: the Employee baseline, internal and external working history,
education, certificates, Courses and resumes. TechWolf provides a templated
definition for each export. You import them into the Integration Center (or the
Report Center) and point them at the TechWolf SFTP server.

The Employee to Job export, which links each Employee to their Job, is part of
the
[Jobs](/integrations/datasource-integrations/sap-standard-input-integration/installation-jobs)
exports.

For the broader picture of how file-based integrations work and how they compare
to API-based connectors, see
[Key concepts](/integrations/datasource-integrations/datasources-key-concepts).

### Prerequisites

Before starting, ensure you have the following:

* A valid TechWolf contract and access to a **live TechWolf tenant**.
* Credentials to the TechWolf
  [SFTP server <Icon icon="link" iconType="solid" />](/integrations/reference/sftp/sftp)
  to host the integration files, with a password or an SSH key. See
  [How To: Add an SSH Key to the Integration Center <Icon icon="link" iconType="solid" />](/integrations/datasource-integrations/sap-standard-input-integration/how-to-add-ssh-key-integration-center).
* An SAP support case to
  [whitelist the TechWolf SFTP server <Icon icon="link" iconType="solid" />](/integrations/datasource-integrations/sap-standard-input-integration/how-to-whitelist-sap-sftp-server).
* Access to either the **Integration Center** or the **Report Center** in your
  SAP SuccessFactors tenant, depending on the integration.

<Note>
  Integration Center and Report Center schedules run under the account of the
  user that creates them. We recommend setting up the schedules with a
  dedicated technical user rather than a named administrator account.
  Schedules created by a named account break when that account is deactivated.
  An administrator creates the technical user, grants it the permissions
  needed for the schedules, and proxies as it while creating them.
</Note>

## Configuration

To allow data to flow from SAP to TechWolf, all report schedules or integration
definitions must be configured in the SAP SuccessFactors tenant. All definitions
have already been templated by TechWolf, and can be imported into the SAP
SuccessFactors environment by uploading those files.

<Tip>
  We recommend using the Integration Center if available in your SAP
  environment. Not all integrations support report-based data extraction.
</Tip>

### Integration Center

Follow the steps in
[How To: Load Export Integration Definitions <Icon icon="link" iconType="solid" />](/integrations/datasource-integrations/sap-standard-input-integration/how-to-load-export-integration-definitions)
to create a new integration definition with the correct values for each export.
The integration definition files to start from are contained in the zip archive
below. SFTP credentials will be provided by TechWolf. SFTP details can be found
at
[SFTP details <Icon icon="link" iconType="solid" />](/integrations/reference/sftp/sftp#server-details).

<AccordionGroup>
  <Accordion title="Employee Baseline Export" icon="users">
    | **Configuration Item** | **Value** |
    | - | - |
    | **Integration Definition** | `techwolf_employee_baseline_export_definition.icd` |
    | **File Name Prefix** | `TechWolfEmployeeBaselineExport` |
    | **File Folder** | `/datasource/employee_baseline` |
    | **Date Suffix Format** | `yyMMddHHmmssZ` |
  </Accordion>

  <Accordion title="Employee Internal Working History Export" icon="clock-rotate-left">
    | **Configuration Item** | **Value** |
    | - | - |
    | **Integration Definition** | `techwolf_employee_internal_working_history_export_definition.icd` |
    | **File Name Prefix** | `TechWolfEmployeeInternalWorkingHistoryExport` |
    | **File Folder** | `/datasource/employee_internal_working_history` |
    | **Date Suffix Format** | `yyMMddHHmmssZ` |
  </Accordion>

  <Accordion title="Employee External Working History Export" icon="clock-rotate-left">
    | **Configuration Item** | **Value** |
    | - | - |
    | **Integration Definition** | `techwolf_employee_external_working_history_export_definition.icd` |
    | **File Name Prefix** | `TechWolfEmployeeExternalWorkingHistoryExport` |
    | **File Folder** | `/datasource/employee_external_working_history` |
    | **Date Suffix Format** | `yyMMddHHmmssZ` |
  </Accordion>

  <Accordion title="Employee Education History Export" icon="graduation-cap">
    | **Configuration Item** | **Value** |
    | - | - |
    | **Integration Definition** | `techwolf_employee_education_history_export_definition.icd` |
    | **File Name Prefix** | `TechWolfEmployeeEducationHistoryExport` |
    | **File Folder** | `/datasource/employee_education_history` |
    | **Date Suffix Format** | `yyMMddHHmmssZ` |
  </Accordion>

  <Accordion title="Employee Certificates Export" icon="certificate">
    | **Configuration Item** | **Value** |
    | - | - |
    | **Integration Definition** | `techwolf_employee_certificates_export_definition.icd` |
    | **File Name Prefix** | `TechWolfEmployeeCertificatesExport` |
    | **File Folder** | `/datasource/employee_certificates` |
    | **Date Suffix Format** | `yyMMddHHmmssZ` |
  </Accordion>

  <Accordion title="Employee Courses Export" icon="book-open">
    | **Configuration Item** | **Value** |
    | - | - |
    | **Integration Definition** | `techwolf_employee_courses_export_definition.icd` |
    | **File Name Prefix** | `TechWolfEmployeeCoursesExport` |
    | **File Folder** | `/datasource/employee_courses` |
    | **Date Suffix Format** | `yyMMddHHmmssZ` |
  </Accordion>

  <Accordion title="Employee Resume Export" icon="file-lines">
    | **Configuration Item** | **Value** |
    | - | - |
    | **Integration Definition** | `techwolf_resume_export_definition.icd` |
    | **File Folder** | `/datasource/resumes` |
  </Accordion>

  <Accordion title="Employee To Resume Link Export" icon="file-lines">
    | **Configuration Item** | **Value** |
    | - | - |
    | **Integration Definition** | `techwolf_employee_to_resume_link_export_definition.icd` |
    | **File Name Prefix** | `TechWolfEmployeeResumeLinkExport` |
    | **File Folder** | `/datasource/employee_resume_link` |
    | **Date Suffix Format** | `yyMMddHHmmssZ` |
  </Accordion>
</AccordionGroup>

<Card title="Integration definitions" icon="download" href="https://techwolf-docs-public-access.s3.eu-west-3.amazonaws.com/integrations/datasource-integrations/sap-employee-datasource-integration-definitions.zip" horizontal="true">
  Required integration definitions for the SAP Employee Data Input Integration.
</Card>

### Report Center

Follow the steps in
[How To: Set Up a Report Schedule <Icon icon="link" iconType="solid" />](./how-to-set-up-report-schedule)
to create a new report schedule with the values for each report. Files for these
reports are contained in the zip archive below. SFTP credentials will be
provided by TechWolf, SFTP details can be found at
[SFTP details <Icon icon="link" iconType="solid" />](/integrations/reference/sftp/sftp#server-details).

Use the following values when setting up the report schedules:

<AccordionGroup>
  <Accordion title="Employee Information Report" icon="users">
    | **Configuration Item** | **Value** |
    | - | - |
    | **Report Name** | `TechWolf Employee Information Report` |
    | **Report Definition** | `techwolf_employee_information_report.sfr` |
    | **Schedule Name** | `TechWolf Employee Information Report Schedule` |
    | **File Name** | `EmployeeInformationExport.csv` |
    | **File Path** | `/datasource/employee_information` |
    | **Date Format** | `yyyyMMdd` |
  </Accordion>

  <Accordion title="Job History" icon="clock-rotate-left">
    | **Configuration Item** | **Value** |
    | - | - |
    | **Report Name** | `TechWolf Employee Job History Report` |
    | **Report Definition** | `techwolf_employee_job_history_report.sfr` |
    | **Schedule Name** | `TechWolf Employee Job History Report Schedule` |
    | **File Name** | `EmployeeJobHistoryExport.csv` |
    | **File Path** | `/datasource/job_history` |
    | **Date Format** | `yyyyMMdd` |
  </Accordion>

  <Accordion title="Learning History" icon="book-open">
    | **Configuration Item** | **Value** |
    | - | - |
    | **Report Name** | `TechWolf Employee Learning History Report` |
    | **Report Definition** | `techwolf_employee_learning_history_report.sfr` |
    | **Schedule Name** | `TechWolf Employee Learning History Report Schedule` |
    | **File Name** | `EmployeeLearningHistoryExport.csv` |
    | **File Path** | `/datasource/learning_history` |
    | **Date Format** | `yyyyMMdd` |
  </Accordion>

  <Accordion title="Education History" icon="graduation-cap">
    This information is already included in the Employee Information Report.
  </Accordion>
</AccordionGroup>

<Card title="Report definitions" icon="download" href="https://techwolf-docs-public-access.s3.eu-west-3.amazonaws.com/integrations/datasource-integrations/sap-employee-datasource-report-definitions.zip" horizontal="true">
  Required report definitions for the SAP Employee Data Input Integration.
</Card>


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