AgileExtender Project Template screen

Use the AgileExtender project template to create a custom AgileExtender. The default project template of the AgileExtender contains these structures. You can use this template structure as a guideline to organize your project items.

Screen



How to Start

  1. Create a new project in AgilePoint NX Developer for an AgileExtender.

Fields

Field NameDefinition

DeployTime

Description:
This folder contains the AgileExtender.Deploy.cs class file of a custom AgileExtender.
Type
Folder

AgileExtender.Deploy.cs

Description:
Deployment Time behavior is useful when you want to perform a custom action when you publish a process to AgilePoint Server. Deployment Time behavior runs on AgilePoint Server when process models are created, checked in, checked out, published, or deleted.

For more information, refer to AgileExtender Project Template > Deployment Time.

Type
File

DesignTime

Description:
All the design time files are organized in this folder. This folder contains AgileExtender.Design.cs, ActivityGroup folder, and WebUI folder by default.
Type
Folder

ActivityGroup

Description:
A folder to contain the activity group (AgilePoint Group) files.
Type
Folder

Activity.en-US.group

Description:
This is a locale specific file that defines the properties of the custom activity. The file name is appended by ".[locale].group" that shows the group is specific to that country. The default file supports en-US. You can add activity group file for the languages that AgilePoint NX support.

AgilePoint NX uses the information in this file such as title and label for the custom activity to show on the Process Builder.

Note: Use the Properties screen in Visual Studio to change the information in this file. Do not change the information in this file with a text editor.
Type
Activity Group property file

WebUI

Description:
This folder contains the subfolders such as Assets, DefaultAssets, Preview, HTML, Locale, Scripts and configuration files.

All the UI files such as HTML pages and its supporting files like JavaScript, localization text, and images for the custom activity. The files for the preview of custom activity are organized in this folder.

Type
Folder

Assets/DefaultAssets/Preview

Description:
This folder contains the files and subfolders that are mandatory for preview the custom activity from Microsoft Visual Studio.

These items let you preview the custom activity configuration screens and debug the JavaScript required for the configuration screen before the custom activity is deployed in your environment.

Type
Folder

HTML

Description:
This folder contains the HTML files for the configuration screens of your custom activity. By default, this folder contains the files AdvancedSample.html and BasicSample.html.
Type
Folder

AdvanceSample.html

Description:
This is an HTML file of AgilePoint that contains the sample code to design the configuration screens of your custom activity. Copy the code sample from this file and use on your screens such as an HTML page.

This HTML file contains the code sample for grid control and combo box control.

Note: This file is an example, but should not be changed. AgilePoint recommends to create your HTML, JS, and JSON file for your project.
Type
AgilePoint HTML file.

BasicSample.html

Description:
This is an HTML file of AgilePoint that contains the sample code to design the configuration screens of your custom activity. Copy the code sample from this file and use on your screens such as an HTML page.

This HTML file contains the code sample for basic controls like text box, radio button, and drop down controls.

Note: This file is an example, but should not be changed. AgilePoint recommends to create your HTML, JS, and JSON file for your project.
Type
AgilePoint HTML file.

Locale

Description:
This folder contains the subfolders of each locale that AgilePoint NX support.
Type
Folder

Localization Folder

Description:
This folder contains the localization text files in the applicable locale folder.

These are example folder names:

  • en-US
  • ja-JP
  • zh-CN
  • zh-TW
Type
Folder

AdvanceSample.en-US.json

Description:
This is an AgilePoint JSON file that contains the localized text for languages that AgilePoint NX support. The localized text is shown on the configuration screens of the custom activity when it is deployed in AgilePoint NX.

Lets you use this file for localizing the text in label and headings of a custom activity configuration screen. Each file of different locale must be added to its locale folder.

The AgilePoint JSON file name must be suffixed by ".[locale].json". For each AgilePoint HTML file, there must be an AgilePoint JSON localization file of your country.

Note: This file is an example, but should not be changed. AgilePoint recommends to create your HTML, JS, and JSON file for your project.
Type
AgilePoint JSON file.

BasicSample.en-US.json

Description:
This is an AgilePoint JSON file that contains the localized text for languages that AgilePoint NX support. The localized text is shown on the configuration screens of the custom activity when it is deployed in AgilePoint NX.

Lets you use this file for localizing the text in label and headings of a custom activity configuration screen. Each file of different locale must be added to its locale folder.

The AgilePoint JSON file name must be suffixed by ".[locale].json". For each AgilePoint HTML file, there must be an AgilePoint JSON localization file of your country.

Note: This file is an example, but should not be changed. AgilePoint recommends to create your HTML, JS, and JSON file for your project.
Type
AgilePoint JSON file.

Scripts

Description:
This folder contains JavaScript files that are necessary for the custom activity configuration screen.
Type
Folder

AdvanceSample.js

Description:
Lets you use functions and event blocks of this JavaScript file to your custom activity JavaScript files.
Note: This file is an example, but should not be changed. AgilePoint recommends to create your HTML, JS, and JSON file for your project.
Type
AgilePoint JavaScript file.

BasicSample.js

Description:
Lets you use functions and event blocks of this JavaScript file to your custom activity JavaScript files.
Note: This file is an example, but should not be changed. AgilePoint recommends to create your HTML, JS, and JSON file for your project.
Type
AgilePoint JavaScript file.

AgileExtender.Design.cs

Description:
This file contains the AgileExtender descriptor class that inherits the WFProcessPluggableAdapterDescriptor.

For more information, refer to AgileExtender Project Template > Design Time.

Type
File

Resources\Images

Description:
Lets you store the icons and images for your custom activities in its folders.

The images and icons show the custom activities graphically in the Process Builder.

Type
Folder

Runtime

Description:
This folder contains the AgileExtender.cs class file of a custom AgileExtender.
Type
Folder

AgileExtender.cs

Description:
The business logic of the custom AgileExtender is implemented in this file. Runtime behavior occurs on the AgilePoint Server as the custom activity executes.

For more information, refer to AgileExtender Project Template > Runtime.

Type
File

Activity.manifest

Description:
This is a metadata file of a custom activity. It contains the reference to the activity group, HTML, JS, JSON, and image resource files.

The BasicSample.html, BasicSample.js, and BasicSample.en-US.json are referenced in this file by default.

AgilePoint NX Developer uses the information in the Activity.manifest file to create the deployment package.

Note: Use the Properties screen in Visual Studio to change the information in this file. Do not change the information in this file with a text editor.
Type
File

AgileExtender.snk

Description:
This file is mandatory to create the custom AgileExtender dll a strong name assembly. The custom AgileExtender dll must be deployed into the AgilePoint Server's GAC.

You must not modify this file.

Type
File

AgilePoint.License

Description:
This is AgilePoint license file. You must not modify this file.
Type
File

Web.config

Description:
This is a web configuration file. The preview configuration for the custom activities are specified in this file.
Type
File