Create or Update Custom Attribute Window

Associates custom attributes with C# code snippets to update the custom attribute values.

Note: The Create or Update Custom Attributes configuration dialog is not intended as a complete replacement for Visual Studio.NET. It is recommend that you create a C# project that you can use as a "scratch pad" so that you have full access to Intellisense and other built-in tools while constructing your snippets. This will help in avoiding simple syntax mistakes and other errors.


Navigation

  1. In AgilePoint Envision, open a process template.
  2. Navigate to the Premier Extension stencil.
  3. On the Premier Extension stencil, drag the Update Custom Attributes AgileShape, and drop it on the process template.
  4. To view the entire list of properties, in the Design Tasks pane, click Show Properties.
  5. On the Configuration field, click the Ellipses button.

Field Definitions

Field Name Definition

Add

Function:
Adds a new custom attribute.

Schema

Opens the Following Window:
Select XPath from Attributes Window
Purpose of this Window:
Enables you to select a schema node from the XML schema for your process.

AttributeName

Definition:
The name of the custom attribute that stores the return value of a code snippet at runtime.
Allowed Values:
The name of custom attribute to be updated.

You can also use the XML metadata associated with the process.

Default Value:
None
Custom Attributes:
Yes
Example:
  • A custom attribute - EmployeeName
  • An XPath to a schema element - /pd:myFields/pd:empName

Expression

Definition:
Specifies a value that is assigned to the custom attribute at runtime by a code snippet.
Allowed Values:
A C# code snippet. The following rules apply:
  • You can specify simple expressions only. For example, assignment, call, increment, decrement, and new object expressions.
  • The string value must be enclosed within the quotation marks. For example, "Name".
  • You cannot leave the Expression field empty.
Default Value:
None
Custom Attributes:
Yes
Example:
  • "True"
  • @"AP5\John; AP5\Bob; AP5\Lily; AP5\Fred";

Remove

Function:
Deletes the selected row from the Custom Attributes list.

Remove All

Function:
Deletes all rows from the Custom Attributes list.

View Code

Function:
Displays a snippet of the C# code created for the custom attributes in the Message field.

Message

Definition:
Displays a snippet of the C# code that is associated with custom attributes, or error messages during code compilation.
Allowed Values:
Read only.

Verify

Function:
Compiles the code snippet to check the custom attributes and corresponding expression values and displays the error message if an error occurs.

Common Configuration Tasks