Process Maps Category
The process maps category contains the Manage Process Maps, Edit Process Maps, Import Process Maps, and the Export Process Maps app
- Manage Process Maps: Use the process maps manager to create, edit and delete process maps.
- Edit Process Maps: Use the process maps editor to update process maps.
- Import Process Maps: Use the process map import to add or replace process maps with updated process maps for another system.
- Export Process Maps: Use the process map export to export one or more process maps to .json files for import in another system.
Manage Process Maps
Manage Process Maps allows you to create, edit, delete, and rename process maps in your system.
To access manage process maps:
- Select the Design module
- Select the Process Maps category.
- Click Mange Process Maps.
- The Manage Process Maps table appears.
Managing process maps
The existing process maps display in a table with a toolbar to perform actions.
Standard toolbar actions are covered in the working with Longview tables section in the Longview Solutions Framework User Guide.
The toolbar contains the following additional actions:
- Submit: Click to submit the changes to the process maps.
- Refresh: Click to refresh the list of process maps. If there are any unsaved changes you will be prompted to save or discard them.
The table includes the following columns:
Column | Notes |
---|---|
ID | The row ID used in validation messages. |
Published | Indicates whether the process map has been published.
|
Process ID | The ID of the process map. This field is editable only for new process maps. Note: Process ID’s must be unique. You can not have two process maps in one system with the same process ID. |
Process Name | The name of the process map that is displayed in the navigation pane of Longview Client. |
Process Title | The title of the process map that is displayed when the process map is rendered.
|
Edit Process Map
The Edit Process Map app allows you to edit a selected process map in your system.
Accessing edit process maps
- Select the Design module
- Select the Process Maps category.
- Click Edit Process Map. The Edit Process Map selection dialog appears
Note: You can also access the edit process maps app through the Manage Process Maps app by right clicking on the row containing the process map you would like to edit and selecting the edit option.
Editing Process Maps
To edit a process map:
- The Select Process Map dialog appears. Select the Process Map you would like to edit.
- Click OK. The Edit Process Map table appears.
Adding a process step
Click Add to add a new step to your process map. Steps are not added until you click Apply.
Note: You can add a new process map step that has similar settings by selecting an existing row and clicking duplicate.
For each process map step, fill in the following fields:
Field | Description |
---|---|
Step ID | Enter an ID for the process step. Note: Step ID can not be left blank. |
Step Name | Enter a name for the process step. Note: Step name can not be left blank. |
Description | Optionally enter a description for the process step. The description appears as a tooltip on the process map step and can be up to 1,024 characters. If no description is provided the tooltip will display the step name. |
Action Type | Select the action type for the process step. This, in conjunction with the Action Link, defines what will be launched clicking on the process map step. The following Action Types are available:
|
Action Link | Select the Action Link that will occur when you click on the process step. The Action Link will depend on the Action Type selected |
Icon | Select the icon that will display on your process map step. Depending on the Action Type and Action Link selected, a default icon will be selected for you. This can be changed if required. |
Color | Select the color that will display for your process map step. Depending on the Action Type and Action Link selected, a default color will be selected for you. This can be changed if required. |
Next Steps | Next steps allow you to create a structured process map, with dependencies between steps. Select the step(s) that will come directly after the step being edited. Note: If no next steps are selected within a process map, the process map will remain unstructured. Note: If a recursive cycle is created when setting up a process map, the process map may not render when being displayed. |
Excel File Name | Select an excel file to launch if action type is Longview Component and Action Link is Longview Add-In for Office. Note: This field is optional. If no file is defined, the Longview Add-In for office will launch without opening a specific file. |
Action Link Options
The following action link options are available, depending on the action type selected:
Action Type | Action Link |
---|---|
App | A list of apps that are published in your system are available for selection. |
File | A file browser that allows you to select the file to launch when clicking on the process step is available. |
Longview Component | The following components can be selected:
|
Process Map | A list of published process maps (except for the current process map being edited) are available for selected. |
Report | A list of reports that are published in your system are available for selection. |
System App | The following system apps can be selected: Global system apps (will be available in all systems)
Tax system apps: Note: These system apps will only be available in a Longview Tax system. Not all apps may be available, this depends on the configuration of your Longview Tax application (for example, if your tax application contains multi-regional provision or task management, additional system apps will be available).
|
Web | Enter a URL that will be launched when clicking on the process map step. |
Workflow | Select a workflow process and associated workflow step. When the step is launched, the user will be able to change the status of the associated process step, depending on their level of workflow access (reviewer, owner, or approver). |
Default icons and colors
The following icons and colors are defaulted depending on the action type and action link selected:
Action Type | Action Link | Default Icon | Default Color | Preview |
---|---|---|---|---|
App | Selected App | data_collection | #1173CB | |
File | Any File | folder_file | #7A8791 | |
Longview Component | Longview Add-In for Office | export_excel | #1AAC35 | |
Longview Component | Longview Application Administrator | cog | #EA3B93 | |
Longview Component | Longview Analysis and Reporting | note | #EE7B23 | |
Longview Component | Longview Dashboard Designer | edit | #A91C3C | |
Longview Component | Longview Journal Entries | journal_entries | #2A588A | |
Longview Component | Longview Server Manager | server_manager | #696A6C | |
Longview Component | Longview Workflow Designer | itemize | #696A6C | |
Process Map | Selected Process Map | process_maps_1 | #FEC53E | |
Report | Selected Report | note | #EE7B23 | |
System App |
| monitoring | #902C8B | |
System App |
| collaborate | #21CCC3 | |
System App |
| Thumbs | #EA3B93 | |
Web | Entered URL | global | #6ABB5E | |
Workflow | Selected workflow process and workflow step | itemize | #425363 |
Deleting a process step
Delete a process step by selecting the row and clicking delete. The process step is not deleted until you click Apply.
Note: Deleting a process step will automatically delete it from any next steps where it was listed.
Editing a process step
You can change the properties of a process step by selecting different values in edit process map table. No changes are applied until you click Apply.
Applying changes
To apply changes to the process map steps, click Apply.
Note: Step ID’s and Step Names cannot be left blank.
Refreshing the process maps
Click Refresh to refresh the list of process maps.
Import Process Maps
The import process maps app allows an administrator to import one or more process maps from the a .json file. This file can be used to copy the selected process maps to another system. Import process maps is found in the Process Maps category of the Design module.
To access import process maps:
- Select the Design module
- Select the Process Maps category.
- Click Import Process Maps.
Importing process maps
The import process maps process allows you to import new and/or replace existing process maps.
To import process maps:
- Select the file to import.
- The export process maps app stores exported process maps files in
Documents\Longview\<LVID>\data\Process Maps
.
- The export process maps app stores exported process maps files in
- Click OK.
- If any process maps in the selected file will replace process maps already in the system a confirmation dialog will appear.
- Click OK
- The process map file will be validated.
- If there are any validation errors, a table listing the errors will appear. No process maps are imported.
- Otherwise, a process complete message will appear.
Reviewing validation errors
In normal cases validation errors occur only if the file imported was manually modified, which is not recommended. If there are validation errors the following table is displayed:
Column | Notes |
---|---|
Process Map # | This indicates the process map in the source file that the validation error is related to. It is provided specifically to help the process map when the id is not specified. |
ID | This is the ID of the process map (“id” in the source file). |
Validation Message | The issue detected by the validation. If the issue is related to a node property, the node number and id are included in the message. If the issue is related to a cycle the node and next node that cause the cycle are identified by the node id. |
Export Process Maps
The export process maps app allows an administrator to export one or more process maps from the system to a .json file. This file can be used to copy the selected process maps to another system. Export process maps is found in the Import and Export folder of the Administration category.
Accessing export process maps
- Select the Design module
- Select the Process Maps category.
- Click Export Process Maps.
Exporting process maps
When the export process maps app is selected the user is shown a datatable listing the process maps in the system.
Select the one or more of the process maps to include in the file and click Export. Once the export has been run selected process map definitions are downloaded to the \Documents\Longview\<LID>\data\Process
Maps folder with a file name of Process Maps_<TimePeriod>_YYYMMDD_HHMMSS.json
The export process maps app display includes a table with a toolbar to perform actions.
Standard toolbar actions are covered in the working with Longview tables section in the Longview Solutions Framework User Guide.
The toolbar contains the following additional actions:
- Export: Click to export the selected process map definitions to a .json file.
- Select All Processes: Click to select all available processes for export.
The table includes the following columns:
Column | Notes |
---|---|
Export | Check boxes allowing the user to select which process maps to include in the export. |
ID | The unique IDs of the individual process maps in the system. |
Process | The process map name as seen in the navigation pane of the system. |