AX1539

Configuring process web pages for plan file processes

Users can manage their plan file tasks in the Web Client by using the built-in process web pages. These pages provide a means for users to review and complete their active tasks, and view details about a plan file in the process.

The process web pages are most commonly used when your plan files are form-enabled and the Web Client is the primary means of access for your end users. For more information on using plan file processes with form-enabled plan files, see Working with plan file process tasks in Axiom forms and the Web Client.

Several properties of the process web pages are configurable to meet the needs of your plan file process.

To configure the process web pages:

  1. In the Explorer task pane, expand the file group and then expand the Process Definitions item. Double-click the plan file process definition to open it.

    TIP: If the file group is present on the Axiom ribbon tab, you can also open the process definition using the file group menu.

  2. In the Edit Plan File Process dialog, select the Web Configuration tab.

  3. Complete the available properties as desired (see below), and then click OK.

Tasks Page

Using this tab, you can configure the number of days that a process task is considered new or due soon.

Page Title

This setting relates to the deprecated Process Tasks page. If you want to customize the name of the Process Directory page, this customization can be made in the file group settings, on the Web Configuration tab, Process Directory sub-tab. See Configuring display settings for the Process Directory web page.

Task Status Configuration

The task status configuration affects the following areas:

  • The Process Summary component for Axiom forms uses these settings to determine which tasks display in the New Tasks and Tasks Due Soon sections of the component.
  • The Process Directory page uses these settings to determine how tasks display when using the My Tasks view.

By default, both items are set to 2 days. To change this, edit the number of days in the applicable setting.

Item Description

A task is considered 'new' for X day(s) after a step is started

If this is set to 2 days and the step is started on 7/1/2021, then the task will be considered new on 7/1 and 7/2.

A task is considered 'due soon' for X day(s) before the due date

If this is set to 2 days and the task is due on 7/5/2021, then the task will be considered due soon for the 2 days before the due date (7/3 and 7/4), as well as the due date itself (7/5). On 7/6 it will be considered overdue.

Routing Page

Web Client users can use the Process Routing page to view the process status of the plan file and to open the plan file. Step owners, administrators, and process owners can also complete the current task for the plan file from this page. You can control the visibility of the routing page, and you can optionally customize some of the text used on the page. For more information about how the routing page is used, see Using the Process Routing page.

Item Description

Make routing page visible to anyone with read access to the plan file

Specifies whether a user with read-only access to a plan file can access the Process Routing page. By default this option is enabled, which means that a user with read-only access to the plan file can view the routing page for that plan file at any time.

Step ownership in and of itself does not grant a user access to this page. However, step ownership can "elevate" a user to having at least read-only access to the plan file and therefore gain access to the page while the user is step owner.

If this option is disabled, then the Process Routing page is only available to administrators and process owners.

Open Plan File Link Text

Defines the link text for the hyperlink that displays in the top right-hand corner of the Process Routing page. Users can open the related plan file from the page using this hyperlink.

By default, the text for this hyperlink is open plan file. If desired, you can customize this text using Open Plan File Link Text box. Whatever you type into this field will display as the hyperlink text.

Page Subheader

Defines the subheader text for the Process Routing page. You can use the default text or optionally customize it. See the following section for more details.

Customizing the page subheader

The description of the plan code / plan file always displays as the header text at the very top of the page. However, the subheader text underneath it can be customized. By default, the subheader text displays the following information.

  • The name of the user who initiated the process for the plan file, with the label Requester: UserName
  • The plan code, with the label ColumnName: Code

The following screenshot shows example header and subheader text for the routing page:

You can customize this text as desired using the Page Subheader box. Note that you cannot edit the default text—you must define the full subheader text if you want to customize any part of it. The following variables can be used in the subheader text:

(missing or bad snippet)

As you type into the Page Subheader box, the Preview box shows a preview of how the content will look in the routing page subheader. Variable values will display in the preview as <ColumnName value>. These variables cannot be resolved until they have a plan code to look up the values for.

Information Panel

You can configure an information panel for plan files, which users can view when looking at the Process Routing page for the plan file. The panel can contain information about the plan file, as well as information from the plan code table and related tables. It can also contain a link to open the plan file. The intended purpose of the panel is to provide users with a snapshot of the information they may need to decide what to do with the plan file task. For more information about how the routing page is used, see Using the Process Routing page.

You can configure the information panel contents by typing into the Panel Contents box. You can use special tags to format the content, and you can insert process variables to retrieve information from the process and from the plan code table (and related tables).

  • To create a link to the plan file, use the link tag as follows: <link>LinkText</link>. This text will automatically be resolved as a hyperlink to the current plan file when the panel is viewed. For example:

    <link>Open request</link>

    This will render as a hyperlink using the text Open request.

    If the plan file is forms-enabled, then it will open in the Web Client. Otherwise, the link will launch the Desktop Client (to the client that was last-used by the user, Excel or Windows) and open the spreadsheet plan file.

  • To apply bold text, use the b tag as follows: <b>Text</b>.

The following variables are available for use in the information panel. To insert a variable, you can type the variable in the text directly, or use the Insert variable menu.

(missing or bad snippet)

As you type into the Panel Contents box, the Preview box shows a preview of how the content will look in the information panel. Variable values will display in the preview as <ColumnName value>. These variables cannot be resolved until they have a plan code to look up the values for.

The following screenshot shows an example configured information panel:

This panel would display as follows in the Process Routing page:

Time in Step Page

The Time in Step page of the Web Client provides reporting on the average time plan files spent in each step of the process. If desired, you can set up refresh variables to filter this report, so that you can see the time in step filtered by groupings in the plan code table. For more information about this report, see Reporting on average time in step for plan files.

To enable filtering, create a file group utility or a report file with a RefreshVariables data source, and define the variables to be used with the Time in Step report. Then, select this file as the Time in Step Variables Report.

When the Time in Step page is accessed, Axiom Budgeting and Forecasting for Higher Education will read the variables from the designated file, and present them in the Filters panel (just like when using refresh variables with Axiom forms). The user's selected values for the variables will be applied as filters to the Time in Step report.

(missing or bad snippet)