Written by Volker Konrad at Thursday, 01 June 2006
The „Personal Support Center“ was created to give Users faster support in an Citrix environment. The user should be able to find easily information like the session name, Client IP address, Client name and so on to answer support personal questions faster.
This article describes how a simple Personal Support Center can be created using Visual Basic. If needed, the user starts the script on the Presentation Server to get an overview of the user environment information.
Before explaining how the Support Center was created , have a look at a screen shot of the launched script.
Concept
The Personal Support Center is programmed in Visual Basic Script (VBS) where the Internet Explorer is used to display the information. To get the user environment information, the free library “eolwtscom.dll” from Emergent OnLine is registered on the system. Additionally the Personal Support Center supports multilanguage (MUI) installation of Windows 2003.
EOLWTSCOM.DLL
EOL WTSCOM is Emergent OnLine’s (EOL) COM-Implementation of Microsoft Terminal Server API, Citrix Server API and many other useful Microsoft network functions. To be able to use the EOL functions, the eolwtscom.dll file is copied to the system32 folder of the Citrix Server and registered with the command “regsrv32 eolwtscom.dll”
The following vbs commands are creating the Internet Explorer output window, where the navigation, tool- and statusbar are deactivated. In addition the size of the window is passed to the Internet Explorer as well.
loop while MSIE.Busy width=MSIE.Document.ParentWindow.Screen.AvailWidth height=MSIE.Document.ParentWindow.Screen.AvailHeight MSIE.Width=640 MSIE.Height=height*0.75 MSIE.Left=(breite-MSIE.Width)/2 MSIE.Top=(hoehe-MSIE.Height)/2 MSIE.Visible=True
After those lines an empty Internet Explorer window exists. Now we can write HTML-Code directly into to window using the command MSIE.Document.Write. To create the HTML header we need to write the following lines:
All other output data are generated through a procedure, as well as the automatic down scrolling for the display area.
sub MSIEAusgabe(s) MSIE.Document.Write s MSIE.Document.ParentWindow.ScrollTo 0,MSIE.Document.Body.ScrollHeight end sub
Personal Support Centers & MUI
To make the Support Center multilingual, several string constants are defined at the beginning of the vbs script. The constants include the different languages, that are separated though an perpendicularly line “|” The following shows one of the constant definition
const TXTMUI_CLIENTDISPLAY="Bildschirm|Display"
The Personal Support Center was created for English and German but it’s easy to add other languages. A registry value needs to be read to find out what language was set by the user or through group policy.
Enumerating the following user registry value „HKCU\Control Panel\Desktop\MultiUILanguageID“ (and the value from the group policy key) will return the current GUI language for the user on a Windows 2003 Server. If the value is not set or empty then English is used as default. The function muitxt() uses the retrieved language to return the strings in the right language.
All the included image files within the HTML-Code are defined though the functions BestimmeHTMLGFX() and ErzeugeImgTag().
Summary
When every user get’s a link to the Personal Support Center, he or she has easy access to the session environment information. Question from the support personal like, “On which server are you working”, “How is your client name” or “Where is the Citrix client locally installed?” can now easily answered with the help of the Support Center.
In this example only a view options are used from the eolwtscom.dll library. You can also use the functions of the DLL within the login script to get for example dynamically the launched publish application. This way different action per publish application can be used.
Geht nicht Written by Gast on 2007-05-07 13:41:12Hallo, Ich habe die DLL auf einen Citrix Server kopiert und dort registriert. Nun habe ich das install Skript auf meinem XP Client ausgeführt. Leider erhalte ich nur die Meldung "undefined" im Fenster des Support Centers. Was ist zu tun?
Geht nicht Written by thomas koetzing on 2007-05-07 20:24:44>Nun habe ich das install Skript auf >meinem XP Client ausgeführt. Das Skript wird auf dem Citrix Server installiert und Ausgeführt!
eolwtscom.zip
Comments
