Skip to end of banner
Go to start of banner

Dynamics 365 OAuth2 Account for Online

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 41 Current »

In this article

Overview

You can use this account type to connect the MS Dynamics 365 for Sales Snap Pack with data sources that use OAuth2 with Dynamics 365. This account supports both on-premise and cloud instances.

Prerequisites

  • Valid application with all the required API permissions.

  • Valid client ID and client secret.

Limitations and Known Issues

None.

Account Settings

Settings for a Dynamics 365 for Sales OAuth2 account
  • Asterisk ( * ): Indicates a mandatory field.

  • Suggestion icon (): Indicates a list that is dynamically populated based on the configuration.

  • Expression icon ( ): Indicates whether 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 fieldset.

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

Field Name

Field Type

Description

Label*

Default Value: N/A
Example: MS Dynamics 365 For Sales

String

Specify a unique user-provided label for the account.


Dynamics Organization URL*

Default Value: N/A
Example: https://abcxyzcompany.api.crm.dynamics.com/api/data/v8.2/


String/Expression

Specify the URL for the MS Dynamics 365 For Sales WebAPI endpoint.  Although the URL is editable, query parameters should not be placed within the URL, as that will not work with the supporting libraries. The Query Parameter fields must be explicitly used, such as search filters.

Client ID*

Default Value: N/A
Example: 9ee09921-7b72-432d-b552-a21e8a1ab143

String

Specify the client ID associated with your Azure application. You can create the client ID as advised by your application provider.


Client secret

Default Value: N/A
Examplebec1f9242f9nsh67f2276b9ws4cadd14

String

Specify the client secret associated with your account. You can create the client secret as advised by your application provider.


Access token

Default ValueN/A
Example: 768901

String

Auto-generated after authorization. 

Specify the access token associated with the Azure portal application is used to make API requests on behalf of the user associated with the client ID.


Refresh token

Default Value: N/A
Example: 87566779

String

Auto-generated after authorization. 

Specify the refresh token is associated with your account. If the refresh token is stored, then the access token can be refreshed automatically before it expires.


Access token expiration

Default Value: N/A
Example:20

Integer

Specify the access token expiration value.


Header authenticated

Default Value: Not selected
Example: Selected

Checkbox

Select this checkbox to indicate that the endpoint uses bearer header authentication.


OAuth2 Endpoint*

Default Valuehttps://login.microsoftonline.com/<tenant>/oauth2/authorize
Example: 
https://login.microsoftonline.com/yourcompany.onmicrosoft.com/oauth2/authorize

String

Specify the URL of the endpoint that authorizes the application. 


OAuth2 Token*

Default Valuehttps://login.microsoftonline.com/<tenant>/oauth2/token
Example:
https://login.microsoftonline.com/yourcompany.onmicrosoft.com/oauth2/token

String

Specify the URL of the endpoint that retrieves the token for an authenticated account.


Grant Type

Default Valueauthorization_code
Exampleclient_credentials

Dropdown list

Select the grant type for authorization. Available options are:

  • authorization_code: Authenticates using credentials (username and password), which return to the client through a redirect URL. The application then receives the authorization code from the URL and uses it to request an access token.

  • client_credentials: Obtains an access token for the client ID and client secret through the token endpoint URL.

Token endpoint config



Use this field set to provide custom properties for the OAuth2 token endpoint. 

Token endpoint parameter*

Default Value: N/A
Example: response-type

String

Specify the token endpoint parameter.


Token endpoint parameter value*

Default Value: N/A
Example: code

String

Specify the value associated with the endpoint parameter defined above.


Auth endpoint config





Use this field set to provide custom properties for the OAuth2 auth endpoint.

Authentication parameter*

Default Value: N/A
Example: scope


String

Specify the authorization endpoint parameter.


Authentication parameter value*

Default Value: N/A
Exampleoffline_access app.Read.All

String

Specify the value associated with the authorization endpoint parameter defined above.


Auto-refresh token


Default Value: Not Selected
Example: N/A

Checkbox

Select this checkbox to refresh the token automatically, using the refresh token, when the token is due for expiry. The token refresh does not happen automatically if this checkbox is not selected.


How to video

Configure a Microsoft Dynamics 365 OAuth2 Account in the SnapLogic IIP Designer

Configure Dynamics 365 for Sales.mp4

Learn how to Configure an Application in the Azure Portal for OAuth2 Account

Snap Pack History

 Click here to expand...

Release

Snap Pack Version

Date

Type

Updates

May 2024

main26341

Stable

Updated and certified against the current SnapLogic Platform release.

February 2024

main25112

Stable

Updated and certified against the current SnapLogic Platform release.

November 2023

main23721

Stable

Updated and certified against the current SnapLogic Platform release.

August 2023

main22460

Stable

Updated and certified against the current SnapLogic Platform release.

May 2023

433patches21467

Latest

  • The Dynamics365 for Sales Update Snap performs the update operation as expected when the Batch size is more than 1, and the Snap does not fail when the batch size is 1.

  • The Dynamics 365 for Sales Snaps include a new Enable continue on error checkbox to allow the Snap to continue executing the remaining batch requests even if the previous request fails.

May 2023

main21015

Stable

Upgraded with the latest SnapLogic Platform release.

February 2023

432patches20134

 

Latest

  • The Dynamics 365 for Sales Upsert Snap works as expected and processes all the documents without getting stuck after fixing the stalled thread issue.

  • The Dynamics 365 for Sales Delete Snap that earlier displayed an Index Out of Bounds error when the Batch size was more than 1, deletes the records without displaying any error.

February 2023

432patches19938

 

Latest

The Dynamics 365 for Sales Upsert and Dynamics 365 for Sales Update Snaps work as expected without an error when you assign a null value for the lookup field.

February 2023

main19844

 

Stable

Added a Retry Policy to the Microsoft Dynamics 365 for Sales Snaps. This feature enables the Snaps to automatically retry when encountering the 429 error.

November 2022

main18944

 

Stable

Upgraded with the latest SnapLogic Platform release.

October 2022

430patches18719

 

Latest

The Dynamics 365 for Sales Create, Dynamics 365 for Sales Update, Dynamics 365 for Sales Upsert, and Dynamics 365 for Sales Delete Snaps now do not fail with the lineage issue for Ultra Pipelines.

September 2022

430patches18305

 

Latest

August 2022

430patches17665

 

Latest

The Microsoft Dynamics 365 for Sales Read Snap can now read up to five million records without hanging. 

August 2022

430patches17054

 

Latest

The Dynamic 365 for Sales Update and Dynamic 365 for Sales Upsert Snaps now support expressions for the Key Columns field when you pass the alternate keys from Pipeline parameters and upstream Snaps.

August 2022

main17386

 

Stable

The Alternate Keys fieldset in the Dynamics 365 For Sales Update and Dynamics 365 For Sales Upsert Snaps now enable you to refer to entities by unique or nonunique combinations of columns.

4.29 Patch

429patches17123

 

Stable

  • Dynamics 365 OAuth2 Account For Online now supports on-premise usage that allows you to access the latest version of the APIs supported in the MS Dynamics 365 suite.

  • Fixed an issue with Dynamics 365 For Sales Read Snap where the Snap displayed a Null Pointer error instead of the actual 429 HTTP status code - Too Many Requests error from the endpoint, and the Pipeline failed. Now Snap does not display a Null Pointer error if the Snap encountered a 429 error and the pipeline goes to the completed state.

  • Fixed an issue with Dynamics 365 For Sales Upsert Snap where the Snap displayed a different error message in the error view when the batch size is greater than 1.

  • Fixed an issue with Dynamics 365 For Sales Update and Dynamics 365 For Sales Upsert Snaps where the Snaps wrote to both output view and error view when the update fails and batch size is equal to 1. Now, the Snap writes only to the error when the update fails.

  • Fixed an issue with Dynamics 365 For Sales Update and Dynamics 365 For Sales Upsert Snaps where the Snaps did not write to the output view when the response is null. Now the Snaps correctly write to the output view when the response is null.

  • Enhanced the Dynamics 365 For Sales Update and Dynamics 365 For Sales Upsert Snaps with Alternate Keys fieldset that enables you to refer to entities by unique or nonunique combinations of columns.

4.29

main15993

 

Stable

  • MS Dynamics 365 For Sales Snaps now supports on-premise installations of MS Dynamics 365.

  • Added a new account type Dynamics 365 NTLM Account that enables to connect to MS Dynamics 365 Snaps through NTLM authentication.

4.28 Patch

428patches15219

 

Latest

Updates in the MS Dynamics 365 for Sales Create and MS Dynamics 365 for Sales Upsert Snaps:

  • Improved performance by streamlining the process of creating new entities.

  • Fixed an issue where the Content-Length header was incorrectly set when Unicode characters were present in the request.

4.28

main14627

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.27

main12833

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.26

main11181

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.25 Patch

425patches10303

 

Latest

Fixed an error in Dynamics 365 for Sales Create Snap where the Snap does not send the original documents to the error view in the output when the batch size property is set to greater than 1.

4.25

main9554

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.24

main8556

Stable

Upgraded with the latest SnapLogic Platform release.

4.23

main7430

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.22

main6403

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.21 Patch 

dynamics365forsales8856

 

Latest

Fixes Pipeline validation error that occurs when writing data from Dynamics 365 for Sales Update Snap to output documents.

4.21

snapsmrc542

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.20

snapsmrc535

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.19 Patch

expensify8335

 

Latest

Fixed the broken doc link for the Expensify Export Report Snap.

4.19

snaprsmrc528

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.18 Patch 

dynamics365forsales7957

 

Latest

  • Fixed a NullPointerException issue with the Dynamics 365 for Sales Delete Snap wherein the Object ID is invalid.

  • Fixed a concurrency issue with multiple Dynamics 365 for Sales Snaps when running in parallel.

4.18 Patch 

dynamics365forsales7952

 

Latest

Added support for lookup type in the input document to be formatted per MS Dynamics 365 for Sales syntax.

4.18

snapsmrc523

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.17

ALL7402

 

Latest

Pushed automatic rebuild of the latest version of each Snap Pack to SnapLogic UAT and Elastic servers.

4.17

snapsmrc515

 

Latest

Added the Snap Execution field to all Standard-mode Snaps. In some Snaps, this field replaces the existing Execute during preview check box.

4.16 Patch

dynamics365forsales7232

 

Latest

Dynamics 365 for Sales Read Snap now supports custom object types. 

4.16

snapsmrc508

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.15

snapsmrc500

 

Stable

Upgraded with the latest SnapLogic Platform release.

4.14

snapsmrc490

 

Stable

  • New Snap Pack: MS Dynamics 365 for Sales Snap Pack introduced in this release with the following Snaps:

    • Create

    • Delete

    • Execute

    • Read

    • Search

    • Update

    • Upsert


  • No labels