Edit App
You can edit an app from the app details page. You can edit a Cyware-published app after cloning the app. You can also edit a custom app.
The categories of apps that can be edited are:
Ready-to-use or In Progress apps can be edited.
Apps that are not associated with any Playbook can be edited. If you need to edit an app that is associated with a Playbook, then you should unlink the app from a Playbook.
Note
Toggle the Active button to mark the app as active or inactive in the top right corner.
Before you Start:
Ensure you have the Create/Update App Config permission.
Steps:
To edit an app:
Click Main Menu, and click Apps.
On the Apps listing page, you can edit an app by clicking the ellipses on an app, and selecting Edit App.
Under App Details, enter the following details:
App Information : Configure the basic app information.
App Configuration Parameters : Configure the field parameters.
Actions: Configure the parameters for app actions.
Click Save.
App Information
You can provide an overview of the app by entering the basic details listed below:
Fields | Editable/Non-Editable | Details |
App Name | Editable | Enter the name of the app. Example: CTIX Custom App |
Python Class Name | Non-editable | The Python class name is built-in and cannot be modified. |
App Versions | Non-editable | App Version defines the release version of the app. The app version in the config.json file is reflected in this field when editing an imported app. However, the version of a newly generated app that is being edited is always 1.0.0. |
Supported API Version | Editable | Enter the API version of the app. |
App Logo | Editable | Upload the app logo. You can also delete the logo after it is uploaded. |
App Description | Editable | Enter a few lines describing the app features and the usage of the app. |
Categories | Editable | From the dropdown, choose one or more categories to which the app belongs. The categories supported by Orchestrate are available for selection here. |
Link to Documentation | Editable | Enter the website URL of the documentation if required. The link will have the prefix https://. |
Agent Compatibility | Editable | Toggle the Active button to enable agent compatibility for the app. |
App Configuration Parameters
You can define the app action configurations that are required while launching the app. You can view, edit and delete the app parameters.
To view the fields, you can hover over the parameter and click View Parameter.
To delete the fields, you can hover over the parameter and click Delete Parameter .
To edit the fields, you can hover over the parameter and click Edit Parameter, and enter the following details.
Fields | Editable/ Non-Editable | Details |
Field Identifier | Non-editable | The field identifier uniquely identifies the app field. |
Field Title | Editable | Enter the title of the field. |
Field Type | Editable | Choose the field type from the dropdown. The following field types are as follows: • Text • Textarea • Password • Boolean • File • Any The supported file types for the file field type are PEM, PFX, CER, CRT, and JSON. The max char length for the textarea field type is 200,000. |
Field Description | Editable | Enter the description for the app parameter. |
Mandatory Parameter | Editable | Click the box to make the parameter mandatory. |
Actions
You can define the app actions that are required for the app. You can view, create, and edit the app parameters.
To create a new action, click the +Action button.
To view the actions, hover over the action and click View Action.
To edit the action, you can hover over the parameter and click Edit Action.
The details required to create and edit the app actions are as follows:
Fields | Editable/ Non-editable | Details |
Action Identifier | Non-editable | The field identifier uniquely identifies the app action. This cannot be edited. |
Action Name | Editable | Enter the title for the app action. |
Action Description | Editable | Enter a description for the app action. |
Accepted Parameters | Editable | Enter the following details:
|
Return Values | Editable | Click +Value and enter the following details:
|