Converter

This shape is used to perform these conversions on the Main Entity:

Navigation

  1. In AgilePoint Envision, open a process template.
  2. Navigate to the XRM Automatic Activities 2011 or XRM Automatic Activities 4 stencil.
  3. On the XRM Automatic Activities 2011 or XRM Automatic Activities 4 stencil, drag the Converter AgileShape, and drop it on the process template.
  4. To view the entire list of properties, in the Design Tasks pane, click Show Properties.

Properties for This AgileShape

Field Name Definition

SaveStatusTo

Definition:
Default value: Success

Specifies the name of a process variable that should be updated when the AgileShape is exited. Depending if the shape executed correctly or if an error occurred, then the values true or false will be stored (as a String) in the process variable specified by this property. It is common to use a Single Condition shape directly afterwards, bound to the process variable

ConversionType

Definition:

This can be one of the following:

  • KitToProduct
  • ProductToKit
  • QuoteToSales (i.e. Quote To Order)
  • OrderToInvoice

EntityId

Definition:
This should be the ID of the desired entity record. This value is usually a dynamic value.

SaveEntityIdTo

Definition:
Set the name of the process variable that will hold the ID of the entity that is going to be created. The process variable can then be used elsewhere in the process

Common AgilePart Properties

This AgilePart inherits the following common properties. For more information, see AgilePart - Common Setup. Note that only the relevant properties are available in AgilePoint Envision. Unneeded properties are hidden.

Name, (UID), Description, Debug, Audit Level, SessionMode, Wait All Incoming, AssemblyName, ClassName, Method, Optimizing, Activity Entry Message (Email), Task Completed Message (Email), ConfigureAttachments, Reference URL, ExceptionHandlerScope, SaveErrorMessageTo, SaveStatusTo, Configure Yammer Credentials, Retries, HandleException

BPMN Properties

Each AgileShape includes a set of BPMN properties. For more information, see Adding or Modifying BPMN Properties for an AgileShape.

Common AgilePart Tasks

Collapse/Expand Shape

Right-clicking the shape brings up the Collapse menu action. Clicking it collapses the shape to a small circle. Right-clicking a collapsed shape shows the Expand menu item, restoring the shape to its original form.

Use Collapse shape to minimize the visual effect of steps in the process which are not of any interest to the Business User.

Add/Remove Timer

Right-clicking the shape brings up the Add Timer menu action. Clicking it adds a timer to the shape, allowing the process modeler to add an alternative route out of the shape when the configured Time Span times out.

Right-clicking a shape with a Timer shows a Remove Timer menu action, which would remove the timer from the shape.