Share this page

# Teradici PCoIP protocol

The PCoIP (PC over IP) protocol supports testing on the Teradici Pervasive Computing Platform and Omnissa Horizon.

The server passes images only, so the relevant actions that the user can perform are connect, disconnect, mouse click, and key press.

In this topic:

## Using the PCoIP client

The PCoIP client is shipped with VuGen, but must be manually copied to your product installation. This is due to security considerations created by several third-party libraries used by the client, such as qt5 and ssl.

To use the client, copy the PCoIP folder from one of these locations:

- DVD\lrunner\Common\PCoIP

- DVD_PC\Setup\Common\PCoIP

Paste the PCoIP folder into the relevant <installdir>\bin folder for the components that will work with the protocol. For example:

< OneLG root>\bin

Note:

- The PCoIP client does not support connections to application pools (published applications). You can connect only to desktop pools.
- The client supports only 64-bit recording and replay.

## Record a PCoIP test

1. Click the Start Recording button.

2. In the Start Recording dialog, select Windows Application under Recording mode and enter the PCoIP client path name in the Application field. For example,

   <VuGen root>\bin\pcoip\pcoip_client.exe

3. Enter other information as appropriate to your test and click Start Recording.
4. Follow the directions on the Teradici client screens to connect to the server.
5. Record your business process from within the client.

Note: A call to Copy image to the clipboard from the snapshot context menu may throw an OpenClipboard Failed exception. In that event, close all open PCoIP clients.

## Enhance the recorded script

During recording, strings (alphanumeric keyboard presses) are recorded until some other type of activity occurs, such as mouse clicks or non-alphanumeric key presses.

When typing is slow, VuGen may break up a typing session into a number of invocations of pcoip_type() interleaved with lr_think_time(). By manually editing the script, these calls can be concatenated. This facilitates parameterization, if you need the string to be substituted with a parameter.

## Add a timeout for finding an area of a snapshot

Use the pcoip_sync_on_bitmap_ex function to add a timeout period for finding the required area (hash) of a snapshot.

1. Click the pcoip_mouse_click function that contains snapshot.

2. In the Snapshot panel, right-click the snapshot and select Insert sync on bitmap.

3. Using the mouse, select the required zone.

4. In the dialog box that opens, define a timeout period (in seconds), and click OK.

   The pcoip_sync_on_bitmap_ex is inserted before the pcoip_mouse_click function.

   Note: The hash value is automatically generated.

## Sample Script

This script enters "Hello World" in an open application.

    Action()
    {

    	pcoip_set_auth("alex-qa", "mydomain", lr_unmask("56ec1f82347be574b867f74a72"));

    	pcoip_connect("MYD-SERVER", "123.456.789.abc", "MYD-SERVER", "4172", 1);

    	pcoip_set_display(980, 556);

    	pcoip_key("NUM_LOCK_KEY", 0);

    	pcoip_mouse_click(18, 537, LEFT_BUTTON, 0, "snapshot3");

    	pcoip_key("ENTER_KEY", 0);

    	pcoip_key("h", MODIF_SHIFT);

    	pcoip_type("ello", 0);

    	pcoip_key("w", MODIF_SHIFT);

    	pcoip_type("orlx", 0);

    	pcoip_key("BACKSPACE_KEY", 0);

    	pcoip_key("d", 0);

    	pcoip_key("ENTER_KEY", 0);

    	pcoip_key("TAB_KEY", 0);

    	pcoip_disconnect();

    	return 0;
    }

https://admhelp.microfocus.com VuGen,Professional Performance Engineering,Performance Engineering for Developers 8942
Tips to improve your search results... OpenText™ Virtual User Generator Help Center OpenText™ VuGen Help 26.1-26.3 All View Local Help Center View Online Help Center Version: