Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

On this Page

Table of Contents
maxLevel2
excludeOlder Versions|Additional Resources|Related Links|Related Information

Insert excerpt
DEPRECATED | Microsoft Dynamics CRM Snap Pack
DEPRECATED | Microsoft Dynamics CRM Snap Pack
nameDynamics CRM SP-Deprecation Note
nopaneltrue

Snap type:Write
Description:

This Snap provides functionality to add new records in Microsoft Dynamics CRM based on the input document field values that match the Dynamics CRM object schema field names.


ETL Transformations & Data Flow

This Snap enables the following ETL operations/flows:

  • Extract data from the upstream Snap containing the data for creating the Dynamics CRM object(s)
  • Transform the input document into a SnapLogic friendly JSON Document
  • Load the data into the Dynamics CRM Create Snap to create the CRM object(s)

Input & Output

  • Input: The ID of the Dynamics CRM Object to be Read. The information can either be provided directly in the Snap or in the upstream Snaps.
  • Output: A document with the result set. If the Read is successful, then the output document will contain all the fields of the provided CRM object(s)
  • Expected upstream Snaps: Mapper Snap
  • Expected downstream Snaps: None


Prerequisites:[None]
Limitations and Known Issues:
  • Works in Ultra Task Pipelines.
  • When reading more than one CRM Object in batches, the Batch Size ranges from 1 to 1000. This is a limitation set by Microsoft Dynamics CRM.
Account:

This Snap uses account references created on the Accounts page of SnapLogic Manager to handle access to this endpoint. See Dynamics CRM Account for information on setting up this type of account.

Configurations:

Account and Access

This Snap uses account references created on the Accounts page of SnapLogic Manager to handle access to this endpoint. See Dynamics CRM Account for information on setting up this type of account.


Views

InputThis Snap has exactly one document input view.
OutputThis Snap has exactly one document output view.
ErrorThis Snap has at most one document error view and produces zero or more documents in the view.


Troubleshooting:

For trouble shooting purpose, try performing a similar operation directly on the Dynamics CRM User Interface and collect the necessary data. Compare the data used in the User Interface with the SnapLogic pipelines to see if there are any inconsistencies.

In order to view the Object ID of the Dynamics CRM Object from the User Interface, the recommended approach is to install a browser plug-in. The plug-in will be available in the browser's Developer tools console. Contact your administrator for the preferred plug-in.

Settings

Label

Required. The name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your pipeline.

Object type

Required. Microsoft Dynamics CRM Object Type.

Example: account

Default Value: account

Note
titleImp. for adding activity type entity

When configuring activity type entities, such as Task, PhoneCall, Fax, etc., if the parameter regardingobjectid is also being added then map a logical name as well, this can be done by adding the parameter regardingobjectname. If this is not done, the Snap will throw an exception.


Related object type

Microsoft Dynamics CRM Object Type of the Object to be related to.

Default Value: None

Related object relationship

Relationship Schema between the Microsoft Dynamics Object to be created with the related Object.

Default Value: None

Related object ID

Guid of the related Microsoft Dynamics CRM Object.

Default Value: None

Batch Size

Required. Number of records processed in each request. Batch size range is from 1 to 1000.

Default Value: 200

Multiexcerpt include macro
nameSnap Execution
pageSOAP Execute


Multiexcerpt include macro
nameExecution_Detail_Write
pageSOAP Execute


Basic Use Case



Expand
titleCRM Create object with Related Object relationship and ID

In this pipeline, the entities are created for the Object type, account, using the related object type and ID.

The Mapper Snap passes the value for the entity to be created in the object type, account.


The CRM Create Snap creates the object, contact, under the Object type, account. The Related object relationship and the object ID are provided for the object created.


The output preview from the Create Snap:




Expand
titleCRM Create and Delete entities using an ID

In this pipeline, the Dynamics CRM Create Snap creates the entity by taking the upstream values, and the CRM Delete Snap deletes the records with the IDs provided.

Image Modified

The Mapper Snap passes the values for the entity created, $name, under the Object type, account.

Image Modified

The CRM Create Snap creates the entity under the Object type, account.

The output preview from the CRM Create Snap:

Image Modified

The CRM Delete Snap deletes the entities by passing the respective ID passed from the upstream,

The output preview from the CRM Delete Snap:

Image Modified


Typical Snap Configurations


The Key Snap configurations are:

  • Without Expression: The values are passed directly into the Snap.

  • With Expression
    •  Pipeline Parameters


 

  


Advanced Use Case


The following describes a pipeline, with a broader business logic involving multiple ETL transformations, that shows how typically in an enterprise environment, CRM Create functionality is used. Download the pipeline from the link below. 

This pipeline reads and moves files from the ServiceNow instance to the CRM instance. 

 

  1. Extract: The ServiceNow Query Snap runs a query and Extracts the documents from the ServiceNow platform.

  2. Transform: The Head Snap retrieves the first 10 records to be updated to the CRM Object.

  3. Transform: The Mapper Snap maps the documents to be updated on a CRM Object.
  4. Load: The CRM Create Snap loads the documents into the CRM Object.


Downloads

Multiexcerpt include macro
namedownload_instructions
pageOpenAPI

Attachments
oldfalse
patterns*slp, *zip,


Insert excerpt
DEPRECATED | Microsoft Dynamics CRM Snap Pack
DEPRECATED | Microsoft Dynamics CRM Snap Pack
nopaneltrue