Skip Navigation

Configure the Workday Sync Module for WSDL

Complete this task to build a SOAP-based web service integration using WSDL to access Workday custom reports.
The
BlackBerry AtHoc
Workday Sync Module supports WSDL, but REST is preferred.
  1. Open the
    WorkdayIWS.config
    file.
  2. Get the value of the <isEncrypted> attribute to
    false
    .
  3. Update the value of the <ReportServiceType> attribute to
    WSDL
    .
  4. Update the following values in the
    Web service endpoint and credential
    section:
    • WDURL: Endpoint URL.
    • WDusername: Username
    • WDpassword: Password
    <!--Web service endpoint and credential--> <add key="WDURL" value="https://wd3-impl-services1.workday.com/ccx/service/customreport2/bb_preview/AthocAlert_ISU/Athoc_Alert_Test?wsdl" /> <add key="WDusername" value="
    workday-username
    " /> <add key="WDpassword" value="
    workday-password
    " />
    If present in the WDURL, escape characters (&, <, >,",') must be rewritten as follows:
    • Replace
      &
      (ampersand) with
      &amp;
    • Replace
      <
      (less than) with
      &lt;
    • Replace
      >
      (greater than) with
      &gt;
    • Replace
      "
      (quotes) with
      &quots;
    • Replace
      '
      (apostrophe) with
      &apos;
  5. In the
    CSV folder path
    section, update the CsvFilePath value with the location where you want to store the .csv file.
    <!--CSV folder path--> <add key="CsvFilePath" value="C:\tmp\"
    The value of the CsvFilePath in the
    WorkdayIWS.config
    file must match the value in the <readFolder> attribute in the
    AtHocDataIntegration.config
    file.
  6. Set the value of the TriggerUserSyncTool key to "true" or "false."
    If the value is set to "true" the Workday Sync Module imports data from Workday to a .csv file and then triggers the
    BlackBerry AtHoc
    User Sync Client to synchronize the data from the .csv file into
    BlackBerry AtHoc
    . If the value is set to "false" the Workday Sync Module imports the user data from Workday into a .csv file but does not trigger the
    BlackBerry AtHoc
    User Sync Client.
    <!-- SET TriggerUserSyncTool Value as "true" to trigger User Sync Tool --> <!-- SET TriggerUserSyncTool Value as "false" to disable automatic trigger and check if CSV is getting created --> <add key="TriggerUserSyncTool" value="true" />
  7. In the
    Import only selected fields
    section, enter the Workday fields whose data you want to import into a .csv file. Separate each field with a comma.
    <!--Import only selected fields--> <add key="SyncConfiguredFields" value="PublicEmailAddresses,FirstName,LastName" />
  8. In the
    CSV "Username" column mapping with workday field
    section, enter the name of a column in the .csv file that you want to map to a Workday data field. In the following example, the "PublicEmailAddresses" data field in Workday is mapped to the "username" column in the .csv file:
    <!--CSV "Username" column mapping with workday field --> <add key="UsernameMapping" value="PublicEmailAddresses" />
    The .csv file must have a "username" column in order for the
    BlackBerry AtHoc
    User Sync Client to synchronize Workday user data to
    BlackBerry AtHoc
    .
    BlackBerry AtHoc
    requires a minimum of 4 characters in the username. The data in the username column must have a minimum of 4 characters for the
    BlackBerry AtHoc
    User Sync Client to synchronize user data to
    BlackBerry AtHoc
    .
  9. Optionally, in the
    Specify date fields and format workday field
    section, update the values of the "DateTypeFields" and "DateFormatSupported" keys to specify the date fields and date format for the .csv file.
    <!--Specify date fields and format workday field --> <add key="DateTypeFields" value="Last_Hire_Date,Term_Date" /> <add key="DateFormatSupported" value="dd-MM-yyyy" />
  10. Save and close the file.