Environment And Session Variables Blue Prism Guide

Environment And Session Variables Blue Prism Guide

Blue%20Prism%20Guide%20-%20Environment%20and%20Session%20Variables

User Manual:

Open the PDF directly: View PDF .Page Count: 6

Download
Open PDF In Browser	View PDF

DATA SHEET Environment and Session Variables Introduction Environment and Session variables are product features that provide easy and centralised configuration and control of Blue Prism solutions within an environment. It is expected that every Blue Prism solution created will utilise Environment and Session variables. Environment Variables Environment variables should be used to store any process or application information required to work the business process that may be subject to change either between environments (development/test/production) or over time. The reason to use environment variables is so that minor changes to the configuration of a solution can be made without the need make development changes to the objects or processes. Examples of Environment Variables include: • The URL for a browser based application • A file path to use to collect a file • A file path to save reports to • A profile name to use for an email interface • Global timeout numbers for an application so they can be amended easily • The System or Environment Name to select when logging into an application • Email addresses for who email alerts should be emailed to • A Whitelist of email addresses that are valid for receiving an email from • A process variable that may need amending in future, such as a maximum transaction limit Environment Variable naming It is important to name environment variables so that the process or system they are related to is obvious. This will make searching for and amending an environment variable easier. The correct naming convention to use should be part of your own organisations best practices, but usually the name of an environment variable is prefixed with the name of the process or application the variable is related to. For better organisation, the name might also be prefixed with the organisation department or global region to which the variable belongs. If an environment variable is named 'Excel File Path' it will be meaningless in the wider context of an environment containing hundreds of completed processes across a large organisation. Some examples of Environment Variable names: • "Fraud Account Closures File Path" – this variable name includes the department name • "SAP System Name" – this variable name includes the application name • "CRM System URL" – this variable includes the application name • "NA_HR Holiday Requests File Path" – this variable name includes region, department, process name Commercial in Confidence ®Blue Prism is a registered trademark of Blue Prism Limited Page 1 of 6 DATA SHEET Creating an Environment Variable To create an Environment Variable simply do the following: • Go to the System – Processes – Environment Variables area of the product. • Click on the Add Variable link • Type in the name, data item type, description, and value of you environment variable The Lifecycle Orientation solution includes a number of Environment Variables, importing that solution into your own training environment and evaluating it is part of the developer training path. Using an Environment Variable Once an environment variable has been created it is available for use in Object or Process Studio. To use an environment variable: • Add a new data item to your Process or Object • Open the Data Properties form • In the 'Exposure' combo box select the 'Environment' option • The 'Name' edit box at the top of the screen will become a combo box. Select the Environment Variable you want to use from the combo list • Click OK An Environment Variable can be used in your flow just like any other data item, the difference being: 1. The Initial Value will be set based upon value of the variable on the System-Processes screen when the Process or Object started. 2. The Current Value of an Environment Variable cannot be amended in a Calculation stage. Commercial in Confidence ®Blue Prism is a registered trademark of Blue Prism Limited Page 2 of 6 DATA SHEET Release Manager Environment Variables are copied between environments along with all other solution components using Release Manager. Please refer to the Release Manager tutorials on the portal for instructions about how that feature works. Environment Variable Security Environment Variables are stored centrally and securely in the Blue Prism database. Access to the database should be secured by your organisations database administrators. Access to configure or view Environment Variables within the product is governed by the Roles and Permissions given to each role in an environment. To be able to add or amend an Environment Variable a Blue Prism user needs to be given the 'Processes – Configure Environment Variables ' permission. Commercial in Confidence ®Blue Prism is a registered trademark of Blue Prism Limited Page 3 of 6 DATA SHEET Session Variables Session variables are data items that can be modified at run time from Control Room. Any configuration that may need changing whist a process session is running can be exposed as a Session variable. Template Session Variables The standard Process Template that should be the basis for all Blue Prism processes includes a Stop? decision that after each work item is completed decides if the process should stop. The Stop? decision includes the following Session Variables: Data Item Name Data Item Type Description Stop After Time Session Variable The initial value should be set the time the process should stop running. It might be set to a time before a system used by the process is no longer available, or a time when another process needs to be started instead. This session variable can be changed by a Blue Prism Controller at run time if there is an operational reason that a running session should finish at a different time to the default. Stop After Items Session Variable This data items allows the developer to configure the process to only work a pre-defined number of cases. The template has the initial value set to 9999999999, which effectively means that the process will work all items. This session variable can be changed by a Blue Prism Controller at run time if here is an operational reason to only work a set number of cases before completing. Stop ASAP Session Variable This session variable can be changed from False to True by a Blue Prism Controller to stop the process. If set to True the process will stop cleanly, if a case is currently being worked it will be completed before stopping. NOTE: The Stop ASAP Session Variable has been superseded in Version 5 of Blue Prism with the Request Stop control room functionality and IsStopRequested function. A session variable should be considered as an option if you have a solution where communication is required from the Controller team to the running process session. If there is a configuration that may need changing during the working day whist the solution is in use the Session Variable allows it to be done without the need to stop, change, and restart the running session or having multiple versions of the same process. Creating a Session Variable A Session Variable is created by simply changing the Exposure option for a data item in the Data Properties window from None to Session. Commercial in Confidence ®Blue Prism is a registered trademark of Blue Prism Limited Page 4 of 6 DATA SHEET To amend a Session Variable whist a process session is running simply select the session in Control Room and click on the 'Show Session Variables' link. The Session Variables available in the Process will be displayed. Right click on the Session Variable you want to modify and click on Edit Value. Commercial in Confidence ®Blue Prism is a registered trademark of Blue Prism Limited Page 5 of 6 DATA SHEET A Session Variable screen will be shown where the value of the variable can be changed. Click the Modify button to update the Session Variable with a new value. Commercial in Confidence ®Blue Prism is a registered trademark of Blue Prism Limited Page 6 of 6 Source Exif Data: File Type : PDF File Type Extension : pdf MIME Type : application/pdf PDF Version : 1.7 Linearized : No Page Count : 6 Language : en-GB Tagged PDF : Yes XMP Toolkit : 3.1-701 Producer : Microsoft® Word 2016 Title : Environment and Session Variables Creator : Kevin Whittingham Creator Tool : Microsoft® Word 2016 Create Date : 2017:09:15 09:02:19+01:00 Modify Date : 2017:09:15 09:02:19+01:00 Document ID : uuid:69462E31-A896-439F-BAEE-6B5051F8F766 Instance ID : uuid:69462E31-A896-439F-BAEE-6B5051F8F766 Author : Kevin Whittingham EXIF Metadata provided by EXIF.tools

Navigation menu

• Upload a User Manual

Versions of this User Manual:

• Wiki Guide
• PDF
• HTML
• Mobile
• Download & Help

Views

• User Manual
• Discussion / Help

Navigation

• © 2025 UserManual.wiki

• Contact Us
• DMCA