Skip to main content

Manage a project

Manage a project using various options available in the Process Studio. The Process Studio allows you to compare your projects, run or debug or verify a project. In addition, you can also edit the project and view the unit consumption detail.

Note

To manage a project, it must have workflows and / or processes. For more details on workflow and process, see Work with workflows and processes.

You can manage a project in the following ways:

Compare a project with...​

You can compare the current project with any server workflow or a local project or a shared workflow and view the differences between the two versions. The differences can occur at project or workflow or process or resource level.

Note

You can also compare processes using the appropriate menu.

Compare with a server workflow​

Use the Server Workflow option if you want to compare the project and workflows on the AutomationEdge server to confirm the files added or removed before publishing or updating a workflow on server.

To compare the project with a server workflow:

  1. In the Project Explorer, select the project you want to compare, and right-click on it. The contextual menu appears.

    Figure 36: Compare with – Server Workflow

    Note

    You can also compare the workflows at the workflow-level.

  2. Select Compare with, and then select Server Workflow. The Select Workflow dialog appears.

    Figure 37: Select Workflow dialog

  3. In Workflow, select the server workflow, and then click Select. The Project Difference dialog appears.

    Figure 38: Project Difference dialog

    The project from the Process Studio appears in the Source pane and projects from the AutomationEdge server or the selected local project appear in the Target pane.

    • : Indicates newly added files.

    • : Indicates removed or deleted files.

    • : Indicates that the workflow or process or files with differences are available in both source and target projects. However, if the workflow or process or files with no differences, then the icon appears greyed out.

  4. The Project Difference dialog has three tabs: Files, Parameters, and PS Variables.

    • Files tab: Lists the various workflows and processes, and other resource files available in the projects.

    • Parameters tab: Displays the configuration and runtime parameters of the main workflow or process. You will see the configuration and runtime parameters only if the main file is same in the source and target projects.

    • The Configuration Parameters and Runtime Parameters listed are:

      • Parameter

      • Display Name

      • Type

      • Secret

      • Optional (seen only in the Runtime Parameters)

    • PS Variables tab: Displays the Process Studio variables of the main workflow or process. You will see the Process Studio variables only if the main file is the same in the source and target projects.

    • The PS variables listed are:

      • Name

      • Description

      • Scope

      • Default Value

Note
  • Click Expand All to expand the project view.
  • Click Collapse All to close the expanded project view.

If you click the workflow in the Source project pane, click View Diff in the contextual menu. The Workflow Difference dialog appears.
alt text

Figure: Workflow Difference

  • Steps: The tab lists the steps added or deleted or common in the two workflows.
  • Hops: The tab lists the step connectivity added or deleted or common in the two workflows.
  • Parameters: The tab lists the parameters added or deleted or common in the two workflows. You will see the configuration and runtime parameters only if the main file is same in the source and target projects.
  • PS Variables: The tab lists the Process Studio variables added or deleted or common in the two workflows. You will see the Process Studio variables only if the main file is the same in the source and target projects.
  • Click View Diff to open the target workflow, Status_bar.psw, in the canvas.
  • Click Close Visual Diff to close the open workflow.

Compare with a local project​

Use the Local Project option if you want to compare the project with another local project.

To compare the project with a local project:

  1. In the Project Explorer, select the project you want to compare, and right-click on it. The contextual menu appears.

  2. Select Compare with, and then select Local Project. The Select Project dialog appears.

    Figure: Select Project dialog

  3. In Project, select the local project, and then click Select. The Project Difference dialog appears.

    Note

    For the Project Difference dialog details, see Server Workflow.

Compare with a shared workflow​

Use the Shared Workflow option if you want to compare the project with a shared workflow.

To compare the project with a shared workflow:

  1. In the Project Explorer, select the project you want to compare, and right-click on it. The contextual menu appears.

  2. Select Compare with, and then select Server Workflow. The Select Workflow dialog appears.

    alt text

    Figure: Select Workflow dialog

  3. In Workflow, select the shared workflow, and then click Select. The Project Difference dialog appears.

    Note

    For the Project Difference dialog details, see Server Workflow.

Delete a project​

You can delete a project and supporting resources permanently from the file system.

To delete a project:

  1. In the Project Explorer, select the project that you want to delete, and right-click on it. The contextual menu appears.
  2. Select Delete from file system, a confirmation dialog appears. Click Yes to delete the project folder and supporting resources permanently from the file system.

Edit a project​

You can modify a project that you created or imported to your workspace.

Note

Modify the project details through the Process Studio only.

To edit a project:

  1. In the Project Explorer, select the project you want to edit, and right-click on it. The contextual menu appears.

  2. Select Edit Project. The Edit Project dialog appears.

    Figure: Edit Project dialog

  3. In the Project tab, modify the project details and select the main workflow or process for the project.

    Note

    It is recommended not to modify the name of the project after it is created in a workspace, as the change can render the project unusable.

  4. In the Others tab, specify the following field details:

    FieldDescription
    Associated Process NameSpecify the name of the process that you want to associate with the project.
    After publishing the workflow successfully, you can see the associated process name in the Update Workflow page in AE server. For more information, see the Workflows 🡪 Workflow List section in the AutomationEdge User’s guide.
    Associated Process CodeSpecify a process code based on which the user must name the step or entry in the workflow or process.
    For more information on how to configure a process code rule, see the Workflows 🡪 Inspection section in the AutomationEdge User’s guide.
    Tags tableNOTES:
    - You can specify a maximum of five tags.
    - Tags can contain alphanumeric characters, hyphens, and underscore. However, spaces in tag names are not supported.
    For example:
    Supported tag name: google-1.
    Unsupported tag name: google 1.
    - The tags added through the Process Studio are at project level and are available in the AE server after the workflow is published.

    Important:
    Tags on the AE server will not be updated during a workflow update.
    Therefore, if you need to modify the tag details, then you can do so through AE server only. The tags are updated at the workflow level. For details, see Work with Workflows in the AutomationEdge User’s guide.
    Tags edited directly on the AE server will not be synchronized with the Process Studio project.
    TagsSpecify tags for the project. Providing tags can help with faster search of a project or workflow.

  5. Click OK. The details are saved.

Metering Units​

Use Metering Units to view the units of steps or entries consumed in a workflow or process. You can view the details at the project level or at the workflow or process level.

tip
  • Ensure you set the main workflow or process for the project before using the feature.
  • The feature is available depending on the type of license you are using.

To view the metering units of a workflow or process:

  1. Select the project in the workspace and right-click. The contextual menu appears.

    Figure: Edit Project dialog – Others tab

  2. In the contextual menu, select Metering Units. A pop up, displaying the total units consumed in the main (parent) workflow and all child workflows and / or processes appears.

    Note

    To view the units consumed in individual workflows or processes, click on the status bar, and select Metering Units from the menu.

Run or debug or verify a project​

Run or debug or verify a project to ensure that the workflow or process works as expected.

Note

Debug Project is unavailable for processes.

To run or debug or verify a project:

  1. In Process Studio, click Actions, and select Run Project or Debug Project or Verify Project.

  2. If you select:

    • Run Project or SHIFT + F9 or click alt text and select Run project, then you can view the details in the Execution Results section.

    OR

    • Debug Project, then you can view the details in the pop-up.

    OR

    • Verify Project, then you can view the stepwise result of a workflow or process.
Note

You can also run a project or debug or verify a project using the contextual menu.
alt text

Inspect Project​

Use Inspect Project feature to validate if the project or workflow rules configured in the AE server are applied as required. If rules are defined for a project, then you will either see a warning or error icon against the project.

Note
  • Sync all inspection rules to ensure that all rules are available in Process Studio.
  • For more information about configuring rules, see Workflows 🡪 Inspection section in the AutomationEdge User’s Guide.

To view the inspection rule report:

  1. Select the project in the workspace and right-click. The contextual menu appears.

    alt text

    Figure: Workspace – Project – Contextual menu

  2. In the contextual menu, select Inspect Project. The Inspection Report dialog appears.

    Figure: Inspection Report dialog

  3. View the following field details:

    FieldDescription
    RuleDisplays the configured workflow rule.
    RemediationDisplays a brief description of the rule.
    View Entity ListView the list of entities attached with the rule.

  4. Click OK. The Inspection Report dialog closes.

    Note

    To expand or collapse the view, click Expand All or Collapse All, respectively. If there is only one rule, then the option to expand or collapse the view is unavailable. However, you can expand or collapse the view using .

    alt text

    Figure: Inspection Report dialog: Expand All / Collapse All

  5. You can perform the following additional activities, if required:

    • Click View Rules. The Workflow Inspection Rules dialog appears.

      The dialog displays the rule details, including the description, remediation message, where the rule is applied, the entity, and the definition.

      alt text

      Figure: Workflow Inspection Rules dialog

    • Click Export To Pdf. Saves the inspection report as a PDF file on your machine.

      alt text

      Figure: Workflow Inspection Report PDF view

Note

If a workflow violates any inspection rule, then you will see either a warning or an error icon against the project. The following screenshot displays the project workflow rules are violated and have errors:

If an inspection rule is violated, you will see either of the following:

  • : Indicates a warning. The project is published, but with warnings.
  • : Indicates an error. The project is not published. You need to modify and republish the workflow.
    For more information about inspection rules, see Workflows 🡪 Inspection in the AutomationEdge User’s Guide.

Additional actions to manage a project​

You can perform additional actions on the project, such as copy the path of a folder or file and open in the File explorer, or close or open a project, load or unload a project. In addition, you can sort the list of projects using different options.

You can perform the following actions:

Copy Path​

You can copy the path of the workspace, workflow or process, or resource file in the Process Studio, which allows you to easily navigate to the file location in the File explorer.

In the Process Studio's Project Explorer, select the file or folder you want to open in the File explorer, and right-click on the selection. In the contextual menu, click Copy Path. The path is copied, and you can paste the same in the path box in the File explorer. Press Enter and you can view the folder or file.

Figure 47: Copy Path: File path in the File explorer

Open in Explorer​

You can directly open the folder or go to the file in the File explorer using the Open in Explorer option. In the Process Studio’s Project Explorer, select the file or folder you want to open in the File explorer, and right-click on the selection. In the contextual menu, click Open in Explorer. The selected folder or file appears in the File explorer.

Figure 48: Open in Explorer

Close or open a project​

You can close all open workflows, processes, and files in the selected project through the contextual menu. The closed project appears greyed out in the Project Explorer. On closing the project, you can open it again, using the Open Project menu that appears on selecting the same project again.

Figure 49: Workspace – Project – Contextual menu

Note

To open or close multiple projects, right-click on the workspace and select Open Project or Close Project in the contextual menu. The Open Project or Close Project dialog appears. In the dialog, select all or multiple projects to open or close, and then click Open or Close.
For example, the following screenshot shows the Close Project dialog with multiple projects selected. After clicking Close, the selected projects appear faded out in the Process Studio’s Project Explorer.

Unload or load a project​

You can remove the project from the workspace list. However, the project is still available on your system, and you can load the project again to the Process Studio.

Figure 50: Workspace – Contextual menu – Unload Project

To reload the removed project, use the Load Project menu that appears when you select the workspace.

Figure 51: Workspace – Contextual menu – Load Project

Note

You can also load and unload multiple projects through the workspace contextual menu.

Sort projects​

Sorting a project list allows you to keep the projects that you may require frequently at the top of the list, thus making them easily accessible.

To sort projects:

  1. In the Project Explorer, click Sort Projects on the Search toolbar. The sorting options appear.

Figure 52: Workspace – Sort Projects – Sorting options

  1. Select the sorting option with which you want the projects to be listed.

    • Name [A-Z]: Sorts the project list in an ascending order.

    • Name [Z-A]: Sorts the project list in a descending order.

    • Newest First: Sorts the project based on the project creation date and time, with the newest project listed first.

    • Oldest First: Sorts the project based on the project creation date and time, with the oldest project listed first.

Last updated on