Skip to main content

Testing a mixed-mode robotic solution for Citrix

4 Tasks

20 mins

Pega Robotic Automation 19.1
Visible to: All users
Intermediate Pega Robotic Automation 19.1 Robotic Process Automation English


ABC Enterprises requests that your development team finish the testing to verify the Citrix automation architecture. You must test the connectivity and communication of the solution within the mixed-mode environment to find any issues with the configuration or settings. The Citrix server environment uses Citrix StoreFront as the access point, and your team has all administrative privileges. The mock development and Citrix environments demonstrate the relationship between updated Citrix context properties and the resulting solution.

Perform the following actions for this connectivity test:

  • Update the Citrix context with valid Citrix server values
  • Build and deploy the test solution to both the local and Citrix environments

For this solution deployment, the following prerequisites are configured and installed:

  • Pega Robot Runtime is installed and configured as a published application in the Citrix StoreFront.
  • The Citrix server deployment directory is  //2002R2DTCTR/Citrix Solutions.
  • The runtime parameters have already been passed in using the "%*" designation.
  • The runtime configuration file on both the Citrix server and the client machine is set to suppress deserialization errors when running locally.
  • The client machine has installed The Virtual channel Driver.

This client uses Citrix server version Citrix XenApp 7 and uses the following Citrix StoreFront URL, Citrix server network folder name, published application name, Citrix server username, and Citrix server password. The client does not use Pass-thru authentication for their Citrix environment.

  • //2002R2DTCTR
  • PegaRuntime
  • citrixuser
  • P4ssW0rd
Note: Because of the technical limitations in providing a real training environment, these challenges guide you to think through testing the Citrix configuration before actual robotic solution development. The values and configuration settings provided in the steps do not connect to servers and act only as examples in the challenges.

You must initiate your own Pega instance to complete this Challenge.

Initialization may take up to 5 minutes so please be patient.

Challenge Walkthrough

Detailed Tasks

1 Change context settings

  1. On the Windows Taskbar of your Client Machine, click the Start button, and then select Pega Robot Studio to launch your development environment.
  2. On the menu bar of Pega Robot Studio, click File > Open > Project/Solutions to begin opening the CitrixCommunicationTest Project.
    open citrix project
  3. In the Open Project window, click the CitrixCommunicationTest folder to open the solution folder.
  4. Click the CitrixCommunicationTest.sln file to open the solution.
  5. Under the All Projects Files drop-down list, click the Open button to load the solution into Robot Studio.
  6. In the Solution Explorer, click CitrixContext1 to open the Citrix Context object.
  7. In Robot Studio, click the Properties tab to open properties for the CitrixContex1 object. 
    select citrix context
  8. In the Debug section of the Properties tab, to the right of Run Local, select False to indicate the deployment is not local.
    run local false
  9. In the ICA File section of the Properties tab, update the following fields:
    • In the Project to Load field, enter C:\Citrixsolutions\CitrixCommunicationTest.openspan.
    • In the Published Application Name field, enter PegaRuntime.
      ica file section
  10. In the Login section of the Properties tab, update the following fields to set the login information for the Citrix environment in this example:
    • In the Domain field, enter citrixdom.
    • In the Login field, enter citrixuser.
    • In the Password field, enter P4ssW0rd!.
      login section
  11. In the XenApp 7x section of the Properties tab, update the following fields:
    • In the Storefront Web URL  field, enter
    • Update the Use Passthrough Authentication field to False.
    • Update the Use Storefront Web field to True.
      xenapp 7 section
  12. In the upper-left corner of Robot Studio, click File > Save All to save your changes.

2 Deploy solution from client machine

  1. On the menu bar of Pega Robot Studio, click Build > Build Solution to begin the build process.
    build solution
  2. On the menu bar of Pega Robot Studio, click Project > Deploy Project to begin deployment.
    deploy project from menu
  3. In the Deployment window, click OK to confirm that you want to deploy the solution.
    deployment popup
  4. In the Deployment Status dialog box, click OK to dismiss the confirmation message.
    deployment status popup
  5. On the Windows Taskbar of the Client Machine, click the Start button to open the start menu.
  6. Click the File Explorer icon to open the File Explorer window.
  7. In the top file path area, paste the file path
    to locate the deployed file.
  8. On your keyboard, hold down the Ctrl or Cmd key, and in the folder, click both the .openspan and .manifest files to select them. 
  9. Right-click the files, and then select Copy to add both files to your computer clipboard.
    deployment files
  10. In the File Explorer of the client machine, double-click the 2002R2DTCTR network folder to open the mock Citrix server deployment directory.
  11. Open the Citrix Solutions folder. 
  12. Inside the Citrix Solutions folder, right-click and select Paste to add the two solution files.
    network files copied

3 Verify deployed files on Citrix server

  1. Open the Citrix Server environment.
  2. On the Windows Taskbar of the Citrix Server Machine, click the File Explorer icon to open the File Explorer window.
    file explorer icon
  3. In the File path section, enter C:\\Citrix Solutions to open the deployment directory in the Citrix server.
  4. In the file area, verify that both the .openspan and .manifest CitrixCommunicationTest files are present.
    solution files on citrix server
  5. Close the server machine environment.
  6. Navigate to the client machine.

4 Verify Citrix server connectivity from robotic solution

  1. In the toolbar of Robot Studio, click Start to begin the debugging process.
    debug button robot studio
  2. Click OK to dismiss the Windows Logon screen to continue the debugging process.
    dismiss logon window
  3. On the taskbar, hover over the labels and verify that the Server.os form has //remote to denote that the form is running within the Citrix environment.
    remote server form
  4. Once the solution begins running, in the Local Form dialog box, click Red to verify that the background color on the Server form label changes to red.
    red button form
  5. Repeat step 3 to verify that the background color changes to blue when you click Blue in the Local Form dialog box.
    blue button form

Available in the following mission:

If you are having problems with your training, please review the Pega Academy Support FAQs.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega Academy has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice