Dynamics 365 Business Central Create

Owned by Kalpana Malladi, created
Last updated: Apr 04, 2024 by Gouri Bhagchandani
6 min read

In this article

Overview

You can use the Dynamics 365 Business Central Create Snap to create records in the Business Central application for a specific entity.

The Business Central Create Snap does not allow upstream values for any fields (Company, Entity, etc.).

Dynamics 365 Business Central Create_Overview.png

Snap Type

The Dynamics 365 Business Central Create Snap is a Write-type Snap that creates a user in the application.

Prerequisites

None

Support for Ultra Pipelines

 Works in Ultra Pipelines. 

Limitations

  • The Business Central Create Snap supports a maximum Batch size of 100.

  • The Business Central Create, Update, and Delete Snaps do not support the respective operations for a few entities, such as Account, and display an exception when creating, updating, or deleting operations. Learn more about the API limitations: API documentation for Business Central.

Known Issues

  • Business Central metadata does not contain information about required fields. Therefore, the Mapper Snap upstream to the Business Central Create Snap does not display the mandatory fields (showing *) in the Target Schema, which is the expected behavior.

  • The Company field in the Business Central Create 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 mandatory entities.

  • The Microsoft Dynamics 365 Business Central Create Snap displays the following errors when you run the batch process with the error view enabled.

    • 500 ( Internal Server Error)

    • Socket timeout error

    • Read timed out error

    Workaround: Increase the Timeout value to 500 or more and decrease the batch size while keeping the default retry properties.

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: 1

  • Max: 1

  • Mapper

Requires user data as a JSON document.

Output

Document

 

  • Min: 1

  • Max: 1

  • Mapper

  • Copy

  • Union

Writes the new user information for an 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 to the field set.

  • Remove icon ( ): Indicates that you can remove fields from the field set.

  • Upload icon ( ): Indicates that you can upload files.

Field Name

Field Type

Description