Skip to main content

Dismissing a Citrix logon window automatically

Required information for window dismissal

Before you can set up dismissing a logon window, you must first identify the following information about the window:

Property Description
Class Name The class name for the window.
Window Title The name of the window as displayed by Windows.
X Position The x-coordinate, relative to the application window, of a pixel inside the button to be clicked in the window to be dismissed.
Y Position The y-coordinate, relative to the application window, of a pixel inside the button to be clicked in the window to be dismissed.

There are several ways to retrieve this information, such as Spy++, or you can use Robot Studio to gather this information. The process that follows uses Robot Studio and Paint to locate the needed information.

Identifying the window to be dismissed

To identify the necessary information using Robot Studio, follow these steps:

  1. In Solution Explore, right-click on the project and choose Add > New Windows Application.
    Screenshot showing menu to add a new windows application to a robotic solution
  2. On the Add New Item Window, enter a temporary name for the application. Click Add.
    Note: This adapter will be deleted, so the specific name is not important
  3. In the properties window for the adapter you just added, set the ResolvePath property to false.
  4. In the Path property, enter the name of the executable for the ICA receiver. This is likely wfica32.exe.
  5. In the StartMethod property, select MonitorAll.
    Screenshot showing all the properties for the temporary windows adapter
  6. Save the project. Click on the Start Interrogation button.
    Screenshot showing the location of the start interrogation button
  7. Log-in to your Citrix access point and launch the published PegaRuntime application.
  8. When the window to be dismissed appears, click the Bullseye icon to interrogate the window.
  9. Click on the displayed window. Robot Studio will interrogate the Windows form.
    Screenshot showing interrogation of a windows logon form
  10. Using the Window Text Match Rule and the Window Class Name Match Rule found in the match rules frame of the adapter design window, note the text of the window and the window class name.
    Note: Save this information outside robot studio as it will be needed to dismiss the window
    Screenshot showing windows match rules
  11. Take a screenshot of the application window you wish to dismiss.
  12. Open the screenshot in Paint or a tool like Snagit and hover your cursor over the button that needs be clicked. 
    Note: The (x,y) coordinates are in the same place you saved the window title and window class name.

    The following image is from Paint. 

    Screenshot from Paint of the x-y coordinate location of a pixel inside the OK button of a windows logon form
  13. In Robot Studio, stop the interrogation by clicking on the Bullseye icon again.
  14. In Solution Explorer, right click on the temporary Windows adapter you previously added. Select Delete. This adapter is no longer needed for your project.
  15. Click OK to confirm the deletion.

Dismissing a Windows Logon form

Once you have identified the window class name, window title, and the (x,y) coordinates inside the OO button, follow these steps to configure Citrix context to automatically dismiss a logon window.

  1. In Solution Explorer, click on the Citrix Context project item.
  2. In the Properties window, in the Misc section, click the Dialog Dismissal List property, and then click on the More icon.
    Screenshot showing the Dialog Dismissal properties
  3. On the DismissalSpecificationListEditorForm window, enter the information that you previously gathered:
    • Class Name – The class name for the window.
    • Window Title – The name of the window.
    • Click X Position – The x coordinate when the mouse was over the OK button.
    • Click Y Position – The y coordinate when the mouse was over the OK button.
      Screenshot showing the DismissalSpecificationListEditorForm window
  4. Click Apply. 
  5. Click OK.
  6. In the Properties toolbar, in the Misc section, set the value of the Dismiss Dialog property to true.
  7. Save the solution and create the deployment package.
  8. Copy both the .manifest and .openspan files to the Citrix server.
  9. In Robot Studio, run the solution to test the result.
    Note: Testing of the solution is dependent on the Citrix environment being configured properly for mixed-mode solution development.

This Topic is available in the following Module:

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