Overview

You can use this Snap to read the user details for a specific entity.

The Business Central Read Snap works as expected when passing values from upstream Snaps for fields such as Entity, Start page number and Max page number, and does not support upstream values for Timeout, Number of retries, and Retry interval fields.

Dynamics 365 Business Central Read__Overview.png

Snap Type

The Dynamics 365 Business Central Read Snap is a Read-type Snap.

Prerequisites

A valid Business Central Access Token or Business Central OAuth2 account.

Support for Ultra Pipelines

Works in Ultra Pipelines.

Limitations

None.

Known Issues

The Company field in the Business Central Read Snap is optional for a few entities, such as Subscriptions, and it is mandatory for the remaining entities. Therefore, if the field is left blank, the Snap displays the following error:

Workaround: Specify the Company name for entities where it is mandatory.

When fetching Read related entities for a specific entity with selected output fields, the Snap displays an error if you do not specify all the key fields in the Output fields section.
Error: Unexpected end-of-input: an expected close marker for an Object.

Workaround: Ensure you provide all the key fields in the Output fields.

The Business Central Read Snap does not support the following entities. The Snap displays an error when you configure with these entities.

Entity

Entity
applyVendorEntries, attachments, contactsInformation, dimensionSetLines, pdfDocument, pictures

Error:
Failure: Error when executing the request. Reason: (Application_DialogException) You must specify a parentId in the request body. CorrelationId: 5480ad2c-11b9-4f5e-9079-ac18ba9e13e0. [HTTP/1.1 400 Bad Request], Resolution: Verify the details provided.

Snap Views

Type	Format	Number of Views	Examples of Upstream and Downstream Snaps	Description

Type

Format

Number of Views

Examples of Upstream and Downstream Snaps

Description

Input

Binary

Min: 0
Max: 1

Mapper
Head
Assert Equals

The entity from which you want to read the objects.

Output

Binary

Min: 1
Max: 1

Mapper
Head
Assert Equals

The output contain records from the specified entity.

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 when 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 if 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

Asterisk ( * ): Indicates a mandatory field.
Suggestion icon (): Indicates a list that is dynamically populated based on the configuration.
Expression icon ( ): Indicates the value is an expression (if enabled) or a static value (if disabled). Learn more about Using Expressions in SnapLogic.
Add icon ( ): Indicates that you can add fields in the field set.
Remove icon ( ): Indicates that you can remove fields from the field set.
Upload icon (