Overview

You can use the Dynamics 365 Business Central Search Snap to search for the required data for a specific entity.

The Business Central Search 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 the Timeout, Number of retries, and Retry interval fields.

Dynamics 365 Business Central Search__Overview.png

Snap Type

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

Prerequisites

None.

Support for Ultra Pipelines

Works in Ultra Pipelines.

Limitations

None.

Known Issues

The Company field in the Business Central Search Snap is optional for specific 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: Error while executing the request.

Workaround: Specify the Company name for entities where it is mandatory.
When fetching Read related entities in the Business Central Search Snap 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: expected close marker for Object.
Workaround: Ensure you provide all the key fields in the Output fields.
The Business Central Search 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 provided details.

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

Document

Min: 0
Max: 1

Mapper
File Writer
JSON Generator

The entity in which you want to search for objects.

Output

Document

Min: 1
Max: 1

Union
Copy
Join

The output contains searched records for 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.

Dynamics 365 Business Central Search