Environments Manager User Guide
Overview
This document describes the functionality and usage peculiarities of Environments Manager.
The Environments Manager is a part of OCP® and it allows to manipulate Orchestrator Applications. It provides actions which can do the following:
A user must have an Applications Manager role to access the Environments Manager.
Access Environments Manager
To enter Environments Manager, proceed as follows:
Navigate to Home | Omilia Cloud Platform and click Console, which is a unified entry point for managing all OCP® services.
Select the regional OCP Console URL that you are using.
Enter your email or OCP® username and click Sign In.
Enter your password and click Sign In.
If the credentials are correct, you are forwarded to the OCP Console® landing page.
If you have entered the correct credentials but are still unable to log in, it's possible that your account has been suspended. For further details and steps to resolve this issue, please refer to the Account suspension section.
Click Environments Manager on the left pane.
Once on the Environments Manager page, the list of the Orchestrator Applications is available to you.
If you currently have no Orchestrator Applications, click the Import button. Navigate to the Import Application section to read more about it.
Manage Applications
In this section you will find information on how to import, export and promote an Application or Application Tag.
Export Application
To export the application, proceed as follows:
Select the application, click the options menu button on the right, and click the Export button.
In the opened form, you can select to export an Application or Application Tag.
To export an Application, click Application. Here you may mark the Export with NLU box to also export NLU model references in the export files.
b. To export an Application Tag, click Tag and select an Application Tag from the available ones in the dropdown menu.
Click Download when completed.
The ZIP file which contains the Application with its miniApps and Flows in JSON format will be downloaded to the targeted folder. Unpack ZIP to view the content.
Import an Application
You can import either an Application as is, or an Application Tag which is the application’s instance. You can read more about Application Tags.
Importing an Application
To import the application, follow the next steps:
Click the Import Application button.
In the Import Application form, click Application.
Select the application you want to import, and place it onto the drop zone, or click the Browse button to manually select the application.
Select the Group for which the application will be available from the dropdown menu. It is also possible to enter a new application name in the Rename App field if you want to change the application’s name.
Renaming is only available for application. Flows and miniApps can’t be renamed!
You can optionally check the Include imported NLU model references box. It allows to reuse the NLU models within the same environment.
For example, if you export the application, and then import it to the same environment under the new name, checking the Include imported NLU model references box allows to use already existing NLU models without creating the new ones. If you import the application to the new environment, the new NLU models will be created automatically.
Note that if the box is enabled, then selecting Production/Testing NLU Deployments is not available!
Select the NLU Deployment type:
Production (default) - this type complies with Production Grade SLAs. Use with your Production applications handling live traffic!
Testing - this type is cost efficient and used for Testing purposes only.
Click Import when finished.
A toast message will appear in the upper-right corner of the screen, indicating that the import is in progress.
Once the process is complete, a service notification will display the import status. To see the service notification, click the Bell icon.
Importing an Application Tag
To import an Application Tag, follow the next steps:
Click the Import Application button.
In the Import Application form, click Tag.
Select an Application Tag you want to import, and place it onto the drop zone, or click the Browse button to manually select an Application Tag.
Select the Application from the dropdown list of the available applications.
Choose the Deployment type:
Production (default) - this type complies with Production Grade SLAs. Use with your Production applications handling live traffic!
Testing - this type is cost efficient and used for Testing purposes only.
Click Import when finished.
A toast message will appear in the upper-right corner of the screen, indicating that the import is in progress.
Once the process is complete, a service notification will display the import status. To see the service notification, click the Bell icon.
Promote Application
Promoting application requires a user to have deployment access to the PRD application which can be provided by the Omilia Care team.
Promoting the application allows to detach application traffic from different clusters.
Originally, if you want to deploy the application, it is deployed to the DiaManT Sandbox cluster (SND) where, for example, you can use the chat simulator to check the application. Promoting the application allows to create the copy of the deployed application which will be placed to the DiaManT Production cluster (PRD) with the real traffic, so that traffic for testing the application does not affect real calls.
To promote the application:
Select the application, open the Options menu on the right and click the Promote button.
You may select an Application Tag from the dropdown list of the available ones (optional). Otherwise, you can promote the application by not selecting any tag.
Confirm by clicking Promote.
A toast message will appear in the upper-right corner of the screen, indicating that promoting is in progress.
Once the process is complete, a service notification will display the import status. To see the service notification, click the Bell icon.
Navigate to Dashboard or miniApps in order to check the created clusters.
Application Tags
An Application Tag is an application’s instance. You can read more about Application Tags in Orchestrator User Guide. In the Environments Manager, you can find the list of all the Application Tags available for a particular Application.
List Application Tags
To find the list of Application Tags, click on a selected Application. This will open a page with SND (Sandbox) and PRD (Production) Application Tags available for the selected Application.
Delete an Application Tag
To delete an Application Tag, proceed as follows:
Click the Delete icon next to the selected Application Tag.
The following dialog box opens.
Type CONFIRM DELETE and confirm by clicking Delete. The Application Tag is deleted.
Variable Collections
Variable Collections provide a way to store information such as numbers, or text. By using OCP variables, you can make your job scripts more dynamic and adaptable, as they enable you to change the stored data or perform calculations based on the values stored in the variable.
Create a Variable Collection
Navigate to Environment Manager → Variable Collections.
Click the +Variable Collection button.
Select the Application from the dropdown list and provide a name for the Variables Collection you wish to create for it.
Click Create Collection button and the new collection will be added to the Variables Collection list.
You can create only one Variable Collection per Application.
Alway redeploy the Application in Orchestrator after a Variables Collection has been added.
Create Variables
Once you have created a Variables Collection for a specific application, you can start creating variables within that collection, that can be used in your application and the related miniApps.
Navigate to Environment Manager → Variable Collections.
Click on the collection you wish to add variables.
Click the +Variable button.
Add the Key name, optionally a description, a Sandbox (SND) value and a Production (PRD) value if different from SND.
Click Save to add the new Variable to your Collection list.
If you check the Enable Masking option the value will be masked and treated as sensitive information throughout the application even if the miniApp or application is not marked as sensitive.
After a Variable is added to a collection or edited, it can take up to 5 minutes before it is applied. To work around this, redeploy the application.
You can add as many Variables to a collection as required.
Edit Variables
To edit or delete a Variable from the list, click the Menu icon on the right of each variable and select the desired option.
Rename a Variable Collection
To rename a Variable Collection:
Click the three dots menu on the right and select the Rename Collection.
Edit the name of the collection in the Variable Collection window and click the Update button.
Use of Variables
Variables are JavaScript objects and can be used anywhere in OCP miniApps and Orchestrator as per below.
miniApps
As a dynamic value in prompts →
{{ocpvars:myKeyValue}}
As a JS object in functions →
if (ocpvars.myKeyValue == "Test") { ... }
Orchestrator
In Orchestrator variables can be used to create conditions in Condition blocks. Open the condition setting and enter the variable name in the Field as #V_{name}
and the required value.