CLIENT Send and Receive

The PROIV Client when running on Microsoft Windows allows a PROIV application to upload files directly from your workstation. Due to browser security, this is not possible in the Open Client, and therefore the Client object methods of CLIENT.Send() and CLIENT.Receive() work differently in Open Client, as it does not have direct access your computer's hard drive. Therefore, all Open Client file reads and writes require you to browse the disk and select the file.

CLIENT.Send()

CLIENT.Send() transfers the file to the Open Client where the browser treats it as a download, and attempts to open an appropriate application for the file based on the file extension. You can choose to open the file with a local program, or save the file to the file system. If the downloaded file is one that the browser can display (e.g. HTML or text), it appears without showing any further user dialogues.

Note: This behaviour is different from the PROIV Windows Client in two ways: it is not a transparent process, and you must decide what to do with the file.

Note: When using the Open Client, if a file is sent to the client machine, the action may be prevented if the pop-ups are blocked by your browser. Ensure that pop-up blockers are configured to include Open Client in the exceptions list or disabled completely. Refer to your browser's documentation for more information about pop-up blockers.

CLIENT.Receive()

When using CLIENT.Receive (), a PROIV application requests a specific file from the Open Client and a window displays prompting you to select the appropriate file to upload. Any file and folder information supplied by the application is ignored, you must select the file from the file system, and the file is uploaded when the Upload is clicked.

Note: This behaviour is different from the PROIV Windows Client in two ways: it is not transparent process, and you must locate the correct file and authorise the upload

Open Client saves the upload status, the file name and the file folder as properties 101, 102 and 103 in the Client. The Client Management ActiveX control can then be used to retrieve this information using the GetPropertyValue method with a target session of 99.

An example of this is shown below:

#A = CLIENT.Receive("c:\myfile.txt","c:\mfile.txt")

#session = 99

#resource = 101

$status = ClientManagementControl.GetPropertyValue(GetPropertyValue)

#resource = 102

$name = ClientManagementControl.GetPropertyValue(GetPropertyValue)

#resource = 103

$path = ClientManagementControl.GetPropertyValue(GetPropertyValue)

UMSG($status + ", " + $name + ", " + $path, -1)

If you click on the Cancel, as the file is not sent to the server PROIV regards it as an empty file, and the status is set to Cancel.

Comment on this topic

Topic ID: 800040