Syndigo Create

Overview

You can use this Snap to create entity records based on certain input information for an entity. Use any of the following combinations in the JSON input (simplfied JSON format or the advanced RSJSON format):

Without any attributes
With attributes
With UOM attributes
With nested attributes
With reference attribute
With nelationship
With mltiple relationships
With relationship and relationship attributes
Entity linked to a single context
Entity with relationship in a specific context
Entity with relationship and relationship attributes linked to a specific context
Entity with nested attributes having multiple rows
Entity linked to multiple contexts
Country with allowed locales
Locale with fallback locales
Set attribute(s) value as null

Important: Snaps in Syndigo Snap Pack automatically cache and refresh model information and match configurations once in every 24 hours. Make sure to reflect any changes to the model in your Snap inputs before restarting the Snaplex.

Write-type Snap
Works in Ultra Tasks

Limitations and known issues

None.

Snap views


View	Description	Examples of upstream and downstream Snaps
Input	This Snap has exactly one document input view. The input must contain the entity information in a simplified/flattened JSON or RSJSON format.	JSON Generator Mapper
Output	This Snap has at the most one document output view. This Snap displays the details of the entity/entities added to Syndigo.	Syndigo Read Mapper
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. The available options are: Stop Pipeline Execution Stops the current pipeline execution when an error occurs. 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

Legend:

Expression icon (): Allows using 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 icon (): Populates a list of values dynamically based on your Snap configuration. You can select only one attribute at a time using the icon. Type into the field if it supports a comma-separated list of values.
Upload : Uploads files. Learn more.

Learn more about the icons in the Snap settings dialog.


Field / Field set	Type	Description
Label	String	Required. Specify a unique name for the Snap. Modify this to be more appropriate, especially if more than one of the same Snaps is in the pipeline. Default value: `Syndigo Create` Example: `New product entry`
Domain	String/Expression/ Suggestion	A (data) domain in Syndigo refers to a large data set that covers a specific area of importance like Product data, Customer data, Asset data, or Suppplier data. Specify the domain in which to create the entity information record. See the list of permitted domains. Default value: None. Example: `thing`
Entity	String/Expression/ Suggestion	Required. Specify the entity type (category) under the chosen domains to add the entity information. The list of suggested entities is based on the specified domain. If no Domain is specified, this field suggests all entities that the Snap account can access. Default value: None. Example: `product`
Validate input	Checkbox	Select this checkbox for the Snap to validate the input data against the expected schema for the selected Domain-Entity combination. Note: If this checkbox is selected, the Snap verifies whether: All attributes, relationships, and contexts specified in the input pertain to the entity model. The input matches with atleast one of the following attributes: Entity identifier External Name One matching configuration Default status: Selected
RSJSON input	Checkbox	Select this checkbox to indicate that the input is in the RSJSON format. The Snap does not validate the input data for RSJSON format compliance. Selecting this checkbox disables the Global locale, Global source, and UOM seprator fields. Default status: Deselected
Global locale	String/Expression	Specify the global locale to be used, in the xx-XX language identifier format, while formatting this simplified/flattened JSON input data to RSJSON format. Default value: `en-US` Example: `fr-FR`
Global source	String/Expression	Specify the source to be used while formatting this simplified/flattened JSON input data to RSJSON format. Default value: `internal`
UOM separator	String/Expression	Specify the separator character/string that separates a value from its unit of measure (UOM) in the simplified/flattened JSON input. Default value: `##` Example: `@$%`, `^$*`
Snap execution	Dropdown list	Choose one of the three modes in which the Snap executes. Available options are: 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. Default value: `Execute only` Example: `Validate & Execute`

Troubleshooting

Error while validating the input. Invalid RSJSON format.

The Syndigo Create Snap expects input data in a valid RSJSON format schema when the RSJSON input checkbox is selected.

Restructure your input (if it follows simplified JSON schema or otherwise) to match the schema expectations of the RSJSON format.

Error while generating schema

The schema of the input data does not match with that of the specified Domain and Entity combination. Syndigo Create Snap expects input data in a valid RSJSON format schema.

Either restructure your input to follow the simplified JSON schema or RSJSON (OR) choose a valid combination of Domain and Entity that matches with the input data's schema.

Error while validating the input. No matching attributes found in the input data.

The Snap did not find atleast one matching configuration in the input for the specified Domain and Entity combination. Syndigo Create Snap expects atleast one matching configuration in the input data.

Either modify your input to include atleast one matching configuration (OR) choose a valid combination of Domain and Entity that matches with the input data's schema.