tWorkdayInput Standard properties - Cloud - 8.0

Workday

Version
Cloud
8.0
Language
English
Product
Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Real-Time Big Data Platform
Module
Talend Studio
Content
Data Governance > Third-party systems > Business applications > Workday components
Data Quality and Preparation > Third-party systems > Business applications > Workday components
Design and Development > Third-party systems > Business applications > Workday components
Last publication date
2024-02-20

These properties are used to configure tWorkdayInput running in the Standard Job framework.

The Standard tWorkdayInput component belongs to the Business and the Cloud families.

The component in this framework is available in all subscription-based Talend products.

Basic settings

Property Type

Select the way the properties will be set.

Two options are provided: Built-In and Repository.

  • Built-In: Use the properties set for the current component in the Basic settings and Advanced settings views.
  • Repository: Use the properties stored in the repository.

Schema and Edit schema

A schema is a row description. It defines the number of fields (columns) to be processed and passed on to the next component. When you create a Spark Job, avoid the reserved word line when naming the fields.

  • Built-In: You create and store the schema locally for this component only.

  • Repository: You have already created the schema and stored it in the Repository. You can reuse it in various projects and Job designs.

Click Edit schema to make changes to the schema. If you make changes, the schema automatically becomes built-in.

  • View schema: choose this option to view the schema only.

  • Change to built-in property: choose this option to change the schema to Built-in for local changes.

  • Update repository connection: choose this option to change the schema stored in the repository and decide whether to propagate the changes to all the Jobs upon completion.

    If you just want to propagate the changes to the current Job, you can select No upon completion and choose this schema metadata again in the Repository Content window.

Guess schema

Click this button to generate the schema based on the client data retrieved or Workday client report.

Click this button after you have provided all the necessary information, such as information for connecting the Workday server, data to retrieved, operations to be carried out, and so on.

Authentication mode

Select an authentication mode among OAuth JWT authentication (the default), REST - Client ID authentication mode (deprecated), SOAP - Login authentication mode, and SOAP - WS-Security authentication mode.

Communications with Workday clients are carried out using the HTTPS protocol. For SOAP - WS-Security authentication mode, the authentication information is included in the messages. See WS Security for related information.

Note: The OAuth JWT authentication item is available only when you have installed the 8.0.1-R2022-12 Talend Studio Monthly update or a later one delivered by Talend. For more information, check with your administrator.
Client Identifier

Enter the Client ID of the API Client used to connect to Workday.

This field is available when you select REST - Client id authentication mode (deprecated) from the Authentication mode drop-down list.

Client Secret

Click […] and enter the Client secret key of the API Client used to connect to Workday in double quotation marks.

To enter the client secret, click the [...] button next to the Client secret field to bring out the Enter a new password dialog box, enter the client secret in the text field, and click OK. Note that you can enter the client secret either in a JSON string in the pure password mode or as a Java expression in the Java mode. You can toggle between the two modes by clicking switch to Java mode or switch to pure password mode on the top of the text field.
Note:
  • The two password modes are available only when you have installed the 8.0.1-R2022-05 Talend Studio Monthly update or a later one delivered by Talend. For more information, check with your administrator.
  • If the 8.0.1-R2022-05 Talend Studio Monthly update or a later one delivered by Talend is not installed, you can enter client secrets in the Java mode only.

This field is available when you select REST - Client ID authentication mode (deprecated) from the Authentication mode drop-down list.

User login

Enter the username for the SOAP login authentication mode.

This field is available when you select SOAP - Login authentication mode from the Authentication mode drop-down list.

User password

Click […] and enter the password for the SOAP login authentication mode.

To enter the user password, click the [...] button next to the User password field to bring out the Enter a new password dialog box, enter the user password in the text field, and click OK. Note that you can enter the user password either in a JSON string in the pure password mode or as a Java expression in the Java mode. You can toggle between the two modes by clicking switch to Java mode or switch to pure password mode on the top of the text field.
Note:
  • The two password modes are available only when you have installed the 8.0.1-R2022-05 Talend Studio Monthly update or a later one delivered by Talend. For more information, check with your administrator.
  • If the 8.0.1-R2022-05 Talend Studio Monthly update or a later one delivered by Talend is not installed, you can enter user passwords in the Java mode only.

This field is available when you select SOAP - Login authentication mode from the Authentication mode drop-down list.

Tenant Alias

Enter the Tenant ID that allows you to connect to Workday. The tenant alias is provided by your Workday administrator. The following gives an example: tenant_alias.

Mode

Select the mode for retrieving client data. You can select Workday query language, Report as a service, or Workday web services from the list.

Whether a mode can take effect is determined by the authentication mode you select from the Authentication mode drop-down list. The following gives the detail.

  • If you select OAuth JWT authentication from the Authentication mode drop-down list, all the three modes take effect.
  • If you select REST - Client ID authentication from the Authentication mode drop-down list, the Workday query language and Report as a service modes take effect.
  • If you select SOAP - Login authentication mode from the Authentication mode drop-down list, the Report as a service mode takes effect.
  • If you select SOAP - WS-Security authentication mode from the Authentication mode drop-down list, the Report as a service and Workday web services modes take effect.
Note:
  • In the OAuth JWT authentication mode, you need to set a specific endpoint in the Endpoint pattern field in the Advanced settings view for the mode selected in the Mode drop-down list.
  • The Workday web services item is available only when you have installed the 8.0.1-R2022-08 Talend Studio Monthly update or a later one delivered by Talend. For more information, check with your administrator.

WS-Security type

Select the WS Security type from the drop-down list: WS Security with basic authentication or WS Security with certificate authentication.

The WS-Security type drop-down list is available if you select SOAP - WS-Security authentication mode option from the Authentication mode drop-down list.

Note: The WS Security with JWT authentication security type is implemented by the OAuth JWT authentication mode if you have installed the 8.0.1-R2022-12 Talend Studio Monthly update or a later one delivered by Talend. You can enable OAuth JWT authentication by selecting OAuth JWT authentication from the Authentication mode. For more information, check with your administrator.

Login and Password

Enter the username and password for the SOAP - WS-Security authentication mode.

To enter the password, click the [...] button next to the Password field to bring out the Enter a new password dialog box, enter the password in the text field, and click OK. Note that you can enter the password either in a JSON string in the pure password mode or as a Java expression in the Java mode. You can toggle between the two modes by clicking switch to Java mode or switch to pure password mode on the top of the text field.
Note:
  • The two password modes are available only when you have installed the 8.0.1-R2022-05 Talend Studio Monthly update or a later one delivered by Talend. For more information, check with your administrator.
  • If the 8.0.1-R2022-05 Talend Studio Monthly update or a later one delivered by Talend is not installed, you can enter passwords in the Java mode only.

These two options are available when you select SOAP - WS-Security authentication mode from the Authentication mode drop-down list and select WS Security with basic authentication from the WS-Security type drop-down list.

Integration system user

Enter the integration system user.

Creating an integration system user is the first step to build an SOAP request with x509 certificate. You can create an integration system user by carrying out the Create Integration System User task in Workday.

Note: This field is available when you select WS Security with certificate authentication from the WS -Security type drop-down list.

X509 certificate

Enter your X.509 certificate content.

You can create an X.509 certificate by carrying out the Create x509 public key task in Workday.

Note: This field is available when you select WS Security with certificate authentication from the WS-Security type drop-down list.

Private key

Enter the private key.

To enter the private key, click the [...] button next to the Private key field to bring out the Enter a new password dialog box, enter the private key in the text field, and click OK. Note that you can enter the private key either in a JSON string in the pure password mode or as a Java expression in the Java mode. You can toggle between the two modes by clicking switch to Java mode or switch to pure password mode on the top of the text field.
Note:
  • The two password modes are available only when you have installed the 8.0.1-R2022-05 Talend Studio Monthly update or a later one delivered by Talend. For more information, check with your administrator.
  • If the 8.0.1-R2022-05 Talend Studio Monthly update or a later one delivered by Talend is not installed, you can enter private keys in the Java mode only.

This field is available when you select OAuth JWT authentication from the Authentication mode drop-down list or select SOAP - WS Security authentication mode from the Authentication mode drop-down list and select WS Security with certificate authentication from the WS-Security type drop-down list.

WQL Query

Enter Workday query language statements for retrieving client data.

This field is available when Workday query language is selected from the Mode list.

Report Owner

Enter the report owner for the client data retrieved.

This field is available when Report as a service is selected from the Mode list.

Report Name

Enter the report name for the client data retrieved.

This field is available when Report as a service is selected from the Mode list.

Service

Enter the names of the Workday services to retrieve data from.

You can also fill the service names in this field by clicking [...] next to this field and select a part or all of these five most frequently used services from the list box in the dialog box: Compensation, Financial_Management, Human_Resources, Payroll, and Staffing. To select services that are not in the list box, select the Use custom value option and enter the desired service names in the Custom value field.

Note: This field is available when you select Workday web services from the Mode drop-down list.

Operation

Enter the names of the operations to be carried out to the retrieved data.

You can also enter the operation names by clicking the [...] next to this field and select the desired operations from the list box in the dialog box that appears. Note that operations appear in the list box only when all the information that is necessary to connect to the Workday server is provided.

Currently, only the operations with their names beginning with Get_ can be carried out.

Note: This field is available when you select Workday web services from the Mode drop-down list.

Use references

Select this option to set filters for the retrieved data.

To set a filter, add a row in the References table by clicking the plus button on the bottom of the table, click the Reference name column and select a field from the drop-down list, click the Type column and select a type from the drop-down list, and then enter a value in the Value column. Note that the items appear in the drop-down lists in the Reference name column and the Type column only when all the information that is necessary to connect to the Workday server is provided.

Note: This field is available when you select Workday web services from the Mode drop-down list.

Use criteria

Select this option to set criteria for the retrieved data.

To set a criterion, add a row in the Criteria table by clicking the plus button on the bottom of the table. Click the Name column and select a field from the drop-down list. Click the Compound type column and select a type from the drop-down list. Then, enter a value in the Value column and the Group ID column if needed. The Group ID column can be used if you need to group rows with the same name. Note that the items appear in the drop-down lists in the Name column and the Compound type column only when all the information that is necessary to connect to the Workday server is provided.

Advanced settings

tStatCatcher Statistics

Select this check box to gather the Job processing metadata at the Job level as well as at each component level.

Endpoint pattern

Enter the endpoint pattern.

In the OAuth JWT authentication mode, the component can work properly only when you set the endpoint pattern as the following.
  • Set the endpoint pattern to https://wd2-impl-services1.workday.com/ccx/api/wql/v1/${tenant}/data if you select Workday query language from the Mode drop-down list.
  • Set the endpoint pattern to https://wd2-impl-services1.workday.com/ccx/service/customreport2/${tenant} if you select Report as a service from the Mode drop-down list.
  • Set the endpoint pattern to https://wd2-impl-services1.workday.com/ccx/service/${tenant} if you select Workday web services from the Mode drop-down list.
In the OAuth JWT authentication mode, the three endpoint patterns are preset in a list box. So, in addition to entering the endpoint address manually in the Endpoint pattern field, you can also access the list box and select a preset endpoint pattern from the list box. You can access the list box by clicking [...] next to the field.
  • This field is available only when you select OAuth JWT authentication from the Authentication mode drop-down list.
  • The actual endpoint pattern needs to adapt to the customer endpoint based on the above endpoint patterns. For example, if you connect to Workday using https://wd5-impl-services1.workday.com/ccx/service/customreport2/{tenant_alias}/{report_owner}/{report_name}, you need to change the first part of the endpoint pattern from wd2-impl-services1.workday.com to wd5-impl-services1.workday.com accordingly. You can modify the endpoint pattern manually in the Endpoint pattern field.
  • This field is available when you have installed the 8.0.1-R2022-12 Talend Studio Monthly update or a later one delivered by Talend. For more information, check with your administrator.
Authentication endpoint

Enter the authentication endpoint.

This field is available when you select REST - Client ID authentication mode from the Authentication mode in the Basic settings view.

Service endpoint

Enter the Web service endpoint.

In the SOAP - WS-Security authentication mode, the component can work properly only when you set the service endpoint as the following.
  • Set the service endpoint to https://wd2-impl-services1.workday.com/ccx/service/customreport2/${tenant} if you select Report as a service from the Mode drop-down list.
  • Set the service endpoint to https://wd2-impl-services1.workday.com/ccx/service/${tenant} if you select Workday web services from the Mode drop-down list.
In the SOAP - WS-Security authentication mode, the two endpoint addresses are preset in a list box. So, in addition to entering the endpoint address manually in the Service endpoint field, you can also access the list box and select a preset endpoint address from the list box. You can access the list box by clicking [...] next to the field.
Note:
  • The actual service endpoint needs to adapt to the customer endpoint based on the above two service endpoints. For example, if you connect to Workday using https://wd5-impl-services1.workday.com/ccx/service/customreport2/{tenant_alias}/{report_owner}/{report_name}, you need to change the first part of the service endpoint from wd2-impl-services1 to wd5-impl-services1 accordingly. You can modify the service endpoint manually in the Service endpoint field.
  • The two preset endpoint addresses and the [...] button are available only when you select SOAP - WS-Security authentication mode from the Authentication mode drop-down list.
  • This field defaults to https://wd2-impl-services1.workday.com/ccx/service/customreport2/${tenant}. You need to change it explicitly if you select Workday web services from the Mode drop-down list.

API version

Set the version of the API you want to use.

This field is available when you select the Workday web services item from the Mode drop-down list in the Basic settings view.

Note: This option is available only when you have installed the 8.0.1-R2022-08 Talend Studio Monthly update or a later one delivered by Talend. For more information, check with your administrator.

Global Variables

ERROR_MESSAGE

The error message generated by the component when an error occurs. This is an After variable and it returns a string.

NB_LINE

The number of rows processed. This is an After variable and it returns an integer.

Usage

Usage rule

This component is usually used as a start component of a Job or subJob and it always needs an output link.