Dynamics 365 Integration
The easiest way to connect Dynamics 365 and Dynamics CRM with WordPress.
Forms
Dynamics CRM Integration allows you to work with Dynamics CRM data using forms. Forms perform basic operations such as Create, Update, and Read.
Form shortcode uses entity forms that are defined in Dynamics CRM. Records that define the forms bear systemform
as entity type.
You can create and adjust forms in Dynamics CRM and then use them in WordPress in posts, pages and other kinds of post types. The shortcode for that is [msdyncrm_form]
.
Shortcode syntax:
[msdyncrm_form entity="lead" name="Contact Us" mode="create" captcha="true" message="Thanks!" hide_form="true"]
Shortcode attributes
- entity
- Required String Entity name, e.g.
contact
orlead
. - name
- Required String Form name of the specified entity, e.g.
Contact Quick Form
orLead Quick Create
. - mode
- Required String Form mode. Can be one of the following:
readonly
,create
,edit
,upsert
. - parameter_name
- String Name of the query string parameter that contains the ID of the record.
- captcha
- Boolean Add reCaptcha to the form.
- message
- String A message that is displayed after the form is submitted successfully.
- hide_form
- Boolean Hide the form after the form is submitted successfully.
- redirect_url
- String URL to redirect to after the form is submitted successfully. If set,
message
andhide_form
arguments are ignored. Should be a relative or absolute URL. - default
- String Set default values for form fields.
Example:default="{firstname:John}{lastname:querystring.lastname}"
- default_mode
- String Constrain
default
fields substitution to the specified modes.
Example:default_mode="{upsert},{create}"
allows a default value forfirstname
to be set only in upsert mode, andlastname
only in create mode. - required
- String Set required fields. Allows overriding Dynamics CRM form settings for the field.
- optional
- String Set optional fields. Allows overriding Dynamics CRM form settings for the field.
- lookuptypes
- String Restrict lookup controls to specified entities.
- lookupviews
- String Display a dropdown instead of a lookup dialog for the specified field with records from the specified view.
Example:lookupviews="{parentcustomerid:Active Contacts}"
- validation_error
- String Error message displayed if the form contains invalid data.
- submit_error
- String Error message displayed if data could not be submitted to Dynamics CRM.
- force_https
- Boolean When set to true, https protocol is used during the form submission. If undefined, form submission follows the page protocol.
- enable_layout
- Boolean When set to
true
, columns and label alignment and position will follow the form definition. Default value isfalse
, i.e. simplified form layout with a single column and labels on the left. - attachment
- Boolean When set to
true
and entity supports annotations, file upload control is added to the form. - attachment_label
- String Label text for the attachment upload control. Note: top label placement is not currently supported but css can be used to achieve the same effect.
- ignore_nonce
- Boolean When set to
true
, nonce check is disabled during form submitting.
Using default values
default
argument receives a list of fields using a following notation: {fieldname:fieldvalue}{fieldname:fieldvalue}
. Key and value are separated using a colon, and every field-value pair is enclosed in curly brackets.
For fieldname
you can use any field name that is present in the form. fieldvalue
may be of several different flavours which are covered below.
Simple value
You can set a static default value for a given field, e.g. {topic:Contact form submission}
.
Query string parameter value
You can fill a field with a value from the query string. For instance, if you have a URL like http://example.com/?score=42
, then {score:querystring.score}
will fill the field score
with value “42” right from the query string. As you can see, query string values follow the next notation: querystring.parameterName
.
Currentuser value
When a user marked as CRM user logs in to WordPress, they’re mapped to a linked record in Dynamics CRM – usually a contact or an account. By using currentuser
as a value you can put that record’s ID into the field. E.g. {parentcustomerid:currentuser}
will put the current user’s record ID into parentcustomerid
.
Currentuser field value
Similar to currentuser
, you can put any record field value into the form field by using dot notation. E.g., {firstname:currentuser.firstname}{lastname:currentuser.lastname}
will set firstname
and lastname
in the form to the values of the current user record’s firstname
and lastname
.