/
Oracle HCM Read

Oracle HCM Read

In this article

Overview

You can use this Snap to execute read requests from the Oracle HCM instance.

oracle-hcm-read.png

Snap Type

Oracle HCM - Read Snap is a Read-type Snap that reads records from the Oracle HCM instance

Prerequisites

  • Valid account with the required permissions.

Support for Ultra Pipelines

Snap Views

View Type

View Format

Number of Views

Examples of Upstream and Downstream Snaps

Description

View Type

View Format

Number of Views

Examples of Upstream and Downstream Snaps

Description

Input 

Document

  • Min: 0

  • Max: 1

  • Mapper

  • Script

  • Router

Each input document offers details associated with the data required from the target Oracle HCM instance.

Output

Document

  • Min: 0

  • Max: 1

  • JSON Splitter

  • JSON Formatter

  • Join

Each output document contains data retrieved from the Oracle HCM instance.

If the Snap fails during the operation, it sends an error document to the error view containing the fields error, reason, resolution, and stacktrace. However, you must enable the Error view to view the error document.

Error

Error handling is a generic way to handle errors without losing data or failing the Snap execution. You can handle the errors that the Snap might encounter while running the Pipeline by choosing one of the following options from the When errors occur list under the Views tab:

  • Stop Pipeline Execution: Stops the current pipeline execution when the Snap encounters an error.

  • Discard Error Data and Continue: Ignores the error, discards that record, and continues with the remaining records.

  • Route Error Data to Error View: Routes the error data to an error view without stopping the Snap execution.

Learn more about Error handling in Pipelines.

Snap Settings

  • Expression : JavaScript syntax to access SnapLogic Expressions to set field values dynamically (if enabled). If disabled, you can provide a static value. Learn more.

  • SnapGPT : Generates SnapLogic Expressions based on natural language using SnapGPT. Learn more.

  • Suggestion : Populates a list of values dynamically based on your Account configuration.

  • Upload : Uploads files. Learn more.

Learn more about the icons in the Snap Settings dialog.

Field Name

Field Type

Description

Label*

 

Default Value: Oracle HCM Read
ExampleGet Details

String

Specify a unique name for the Snap.

 

Version*

 

Default Value: N/A
Example11.13.18.05

String/Expression/Suggestions

Specify the Oracle HCM instance version. The suggestions list retrieves all available versions.

 

Resources name

 

Default Value: N/A
Exampleabsences, elementEntries, workers

String/Expression/Suggestions

Specify or select the Oracle HCM resources (Tasks). The suggestions list retrieves all available resources based on the selected version.

 

Endpoint*

 

Default Value: N/A
Example: /workers

String/Expression/Suggestions

Specify or select the Oracle HCM endpoint. The suggestions list retrieves all available endpoints based on the selected resources. For example if “worker” resource is selected, the suggestions that populate are:

  • /workers

  • /workers/{id}

  • /workers/{id}/child/addresses/{id}

For expressions, the strings must be enclosed in double quotes, {id} should be replaced with valid variable names.

  • “/workers”

  • “/workers/” + $id

  • “/workers/” + $worker_id + “/child/addresses/” + $address_id

For variable names passed from pipeline parameter:

  • “/workers/” + _id

  • “/workers/” + _worker_id + “/child/addresses/” + _address_id

Query parameters

Use this field set to add query parameters to your request.

 

Query parameter

 

Default ValueN/A
Example: id

String

Specify the name of the query parameter.

Query parameter value

 

Default Value: N/A
Example$widget.id

String/Expression

Specify the value that you want to assign to the parameter.

Header parameters

Use this field set to create the HTTP header key-value pairs.

Header parameter

 

Default ValueN/A
Example: content-type

String

Specify the name of the HTTP header.

Header parameter value

 

Default Value: N/A
Exampleapplication/json

String/Expression

Specify the value to assign to the HTTP header.

Use pagination

 

Default ValueDeselected

Checkbox

Select this checkbox to enable pagination. If you deselect this checkbox the pagination settings are hidden.

Start page

 

Default Value: 1
Example5

Integer

Appears when you select the Use pagination checkbox.

Specify the value of the page from which the pagination must start.

Records per page

 

Default Value: 100
Example50

Integer

Appears when you select the Use pagination checkbox.

Specify the number of records you want on a page.

Number of pages

 

Default Value: 0
Example50

Integer

Appears when you select the Use pagination checkbox.

Specify the number of pages you want to retrieve.

  • If this value is 0, then all records are retrieved from the starting page.

  • if this value is greater than 0, then it retrieves all consecutive pages from the starting page to the entered value. Records per page are controlled by the Records per page field.

Negative values are not allowed.

Snap Execution

 

Default ValueValidate & Execute
ExampleValidate & Execute

Dropdown list

Select one of the following three modes in which the Snap executes:

  • Validate & Execute: Performs limited execution of the Snap, and generates a data preview during Pipeline validation. Subsequently, performs full execution of the Snap (unlimited records) during Pipeline runtime.

  • Execute only: Performs full execution of the Snap during Pipeline execution without generating preview data.

  • Disabled: Disables the Snap and all Snaps that are downstream from it.

Snap Pack History

Oracle HCM

Related Content