0 votes

Dynamics 365: Umbraco CMS Integration

A form picker and rendering component for forms managed within a Microsoft Dynamics 365 Marketing instance.

The package uses the 0Auth protocol for authentication; connect to your Dynamics 365 instance by adding the following settings to `Web.config`:

<add key="Umbraco.Cms.Integrations.Crm.Dynamics.HostUrl" value="https://[INSTANCE]/api.crm4.dynamics.com/" />

<add key="Umbraco.Cms.Integrations.Crm.Dynamics.ApiPath" value="api/data/v9.2/" />

Backoffice usage

To use the form picker, a new data type should be created based on the Dynamics Form Picker property editor.

The Connect button prompts the user with the Microsoft authorization window, which after a successful authentication will send the authorization code back. The retrieved access token will be saved in the database and used for future requests.

Revoke action will remove the access token from the database and the authorization process will need to be repeated.

Front-end rendering

A strongly typed model will be generated by the property value converter, and an HTML helper is available to easily render the form on the front-end.

Ensure your template has a reference to the following using statement:

@using Umbraco.Cms.Integrations.Crm.Dynamics.Helpers;

And render the form using (assuming a property based on the created data type, with alias dynamicsForm has been created):

@Html.RenderDynamicsForm(Model.DynamicsForm)

The selected form is embedded either through an iframe or using JS scripts.

Changes

1.3.6 (August 14th 2024)

  • Correct package.manifest references and version

1.3.5 (July 31st 2024)

  • Added support for manually exchanging authorization codes for access tokens

1.3.4 (July 3rd 2024)

  • Fix NULL reference issue when no forms are retrieved

1.3.3 (March 28th 2024)

  • Added support for Dynamics 365 Real-Time forms

1.3.2 (February 14th 2024)

  • Increased length for AccessToken column
1.3.1 (December 14th 2023)
  • Update Umbraco CMS dependencies
1.3.0 (July 15th 2023)
  • Updated target frameworks
1.2.1 (March 24th 2023)
  • Set default Umbraco Authorization
1.2.0 (March 21st 2023)
  • Self-hosted authorization
1.1.3 (February 9th 2023)
  • Updated OAuth handling

1.1.2 (November 22nd 2022)

  • Package icon

1.1.1 (November 4th 2022)

  • Marketplace updates and tags
  • Telemetry elements

1.1.0 (October 6th 2022)

  • Authorization for users outside an organization
  • Revoke action Bad Request issue

1.0.0 (September 13th 2022)

  • Initial release

Screenshots

Package files

Archived files

Documentation

Source code

 Download package
version 1.3.6

NuGet install instructions for Umbraco 8.5.0-9+

Install-Package Umbraco.Cms.Integrations.Crm.Dynamics

NuGet install instructions for Umbraco 9+

dotnet add package Umbraco.Cms.Integrations.Crm.Dynamics

Package owner

Umbraco HQ

Umbraco HQ

Umbraco has 7882 karma points
hq

Package Compatibility

This package is compatible with the following versions as reported by community members who have downloaded this package:
Untested or doesn't work on Umbraco Cloud
Version 8.18.x (100%)

You must login before you can report on package compatibility.

Previously reported to work on versions:

Package Information

  • Package owner: Umbraco HQ
  • Created: 13/09/2022
  • Current version 1.3.6
  • .NET version 4.7.2
  • License MIT
  • Downloads on Our: 192
  • Downloads on NuGet: 4.5K
  • Total downloads : 4.7K