Symantec WISESCRIPT EDITOR 8.0 Reference Download Page 1

Page: 1 / 174

WiseScript Editor Reference

Summary of Contents for WISESCRIPT EDITOR 8.0

Page 1: ...WiseScript Editor Reference ...

Page 2: ...IONS REPRESENTATIONS AND WARRANTIES INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE OR NON INFRINGEMENT ARE DISCLAIMED EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID SYMANTEC CORPORATION SHALL NOT BE LIABLE FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES IN CONNECTION WITH THE FURNISHING PERFORMANCE OR USE OF THIS DOCUMENTATION THE INFORMATION ...

Page 3: ...livers automatic software upgrade protection z Advanced features including Account Management Services For information about Symantec s Maintenance Programs you can visit our Web site at the following URL www symantec com techsupp Contacting Technical Support Customers with a current maintenance agreement may access Technical Support information at the following URL www symantec com techsupp Befor...

Page 4: ...hat are related to CD ROMs or manuals Maintenance agreement resources If you want to contact Symantec regarding an existing maintenance agreement please contact the maintenance agreement administration team for your region as follows Additional enterprise services Symantec offers a comprehensive set of services that allow you to maximize your investment in Symantec products and to develop your kno...

Page 5: ...ertise from Symantec and its trusted partners Symantec Consulting Services offer a variety of prepackaged and customizable options that include assessment design implementation monitoring and management capabilities Each is focused on establishing and maintaining the integrity and availability of your IT resources Educational Services Educational Services provide a full array of technical training...

Page 6: ...ipt Editor 21 The Script Editor Window 21 Customizing the List of Actions 23 Types of Scripts 24 Adding an Action to a Script 25 Editing Scripts 25 Finding and Replacing Text in a Script 26 About User Defined Actions 27 Creating a User Defined Action 28 Creating a User Defined Action Tutorial 29 Basic Scripting Concepts 31 Conditions and Loops 32 Variables and Expressions 33 Compiler Variables and...

Page 7: ...ustom Dialog 66 Deactivate SVS Layer 66 Delete File from SVS Layer 66 Delete File s 67 Delete SVS Layer 67 Display Billboard 68 Display Message 69 Display Progress Message 70 Display Text File 70 Edit INI File 71 Edit Registry 71 Registry Key Settings Dialog Box 72 Edit Registry for SVS Layer 74 Else Statement 75 ElseIf Statement 75 End Statement 76 Evaluate Windows Installer Condition 76 Execute ...

Page 8: ...io Button Dialog 103 Read INI Value 104 Read Update Text File 104 Read Write Binary File 105 Reboot System 106 Register Font 106 Remark 106 Remove SVS Exclude Entry 107 Rename File Directory 107 Rename File or Directory in SVS Layer 108 Rename SVS Layer 108 Search for File 109 Self Register OCXs DLLs 110 Set Activate SVS Layer on Startup 110 Set Control Attributes 110 Set Control Text 111 Set Curr...

Page 9: ...m Dialog Box Sets 142 Creating a Dialog Box Set 142 Configuring Dialog Box Set Properties 142 Creating a Custom Dialog Box Script 143 Dialog Box Script Actions 144 Dialog Box Script Examples 144 Chapter 6 Creating Custom Billboards 146 About Billboards 146 Accessing the Custom Billboard Editor 146 About the Custom Billboard Editor 147 Opening and Saving Custom Billboards 148 Adding Objects to a Bi...

Page 10: ...WiseScript Editor Reference 10 Command Line Options 165 WiseScript Command Line Options 165 WiseScript Installations Command Line Options 166 Uninstall Command Line Options 166 Index 168 ...

Page 11: ...hen you create a custom action that calls a WiseScript WiseScript Benefits WiseScript is a high level scripting language that consolidates dozens or hundreds of lines of code into predefined script actions What Makes WiseScript Unique z Easy to learn WiseScript supports a point and click method of scripting The script author is prompted for the parameters needed by each script action so a script c...

Page 12: ...few of the tasks you can accomplish with WiseScript For samples of some of these scripts see the article Performing System Administration Tasks With WiseScripts in the Altiris Knowledgebase Article 27374 z Move files and directories z Modify a machine resource example registry key or INI file z Locate and delete a file and its directory example to remove a spyware program z Free disk space by clea...

Page 13: ...the main window Using WiseScripts in a Windows Installer Installation Windows Installer Editor compiles installations into Windows Installer MSI format Therefore it can provide only those capabilities that are provided by the Windows Installer SDK environment WiseScript Editor provides an additional authoring environment that has a larger selection of more versatile script actions than those provi...

Page 14: ...d a second script line tries to open ReadMe the second script line fails because the ReadMe is not in the Temp directory z Run Click Run to execute the installation just as it would execute on the destination computer Files are installed on your computer and your system is modified Creating a Portable Project You can create a portable WiseScript project that contains all of the files in a WiseScri...

Page 15: ... instructions for performing common tasks Access help in the following ways z To display context sensitive help for the active window or dialog box press F1 z To select a help topic from a table of contents index or search select Help menu Help Topics Reference Manual All the material in the online help is also available in a PDF format reference manual which you can access by selecting Help menu ...

Page 16: ...tor The Project Settings view provides pages on which you can define that information See About the Project Settings View on page 16 See also Compiler Variables on page 17 Digital Signature on page 19 General Information on page 20 About the Project Settings View The Project Settings view contains several pages that provide information that is required by certain script actions Example The Compile...

Page 17: ...nu Reset Page View Navigation Click these tabs to change views Compiling and Testing Compile Test Debug and Run buttons test and compile the WiseScript Compiler Variables Use the Compiler Variables page to set compiler variables that change the WiseScript during compile You can use compiler variables to include or exclude portions of script from the compiled EXE or to build a debug version of the ...

Page 18: ... valid values each on a separate line Data Entry Type Select the method to use to enter data for the compiler variable Do Not Prompt for Value If this is marked you are not prompted for the value of this variable when compiling even if Prompt for Compiler Variables is marked on the Compiler Variables page Mark this for variables that you do not expect to change frequently 4 Click OK 5 On the Compi...

Page 19: ...gn For a list of certificate authorities search for Microsoft Root Certificate Program Members in the MSDN Library msdn microsoft com library z You must have the signtool exe or signcode exe tool on your computer z Signtool exe requires the CAPICOM 2 0 redistributable to be installed and registered on your computer CAPICOM provides services for digitally signing applications and is available from ...

Page 20: ...FX to use Signcode exe with public private key pair files Mark this to use signcode exe and then specify the credentials file SPC or CER that contains your Digital ID and your private key file PVK General Information Use the General Information page to set the summary information for the compiled EXE file End users can see the summary information by right clicking the compiled EXE in Windows Explo...

Page 21: ...ment The Script Editor scripting environment consolidates numerous lines of code into predefined script actions You don t need to memorize commands because Script Editor supports a point and click method of scripting The script you create is displayed in clear English like statements You compile the script along with files and other resources into an EXE When the EXE is run the script runs executi...

Page 22: ...the end user select each language in the Language drop down list and edit that script line so it contains the translated text Example You set an installation to support French and English on the Languages page While in the English script you add a Display Message script line that states Do you want to view the ReadMe file now You should then select French from the Language drop down list and edit ...

Page 23: ...lation script To show tabs for Wise include scripts mark the Show Tabs for Wise Include Scripts check box in Preferences Script Line Numbering z To show or hide script line numbers select View menu Line Numbers z Connection lines connect the beginning and end of an If block or a loop To show or hide connection lines select View menu Connection Lines Customizing the List of Actions Script Editor co...

Page 24: ...en an Exit Installation script command is executed If you create a user defined action you store its custom dialog box here See Creating a User Defined Action on page 28 z Cancel The script that s executed when the end user cancels the installation Because some files might already be installed when the end user cancels the Cancel script contains the include script rollback wse which returns the de...

Page 25: ...e current line becomes a drop down list with all the action names and the action that most closely matches the letters you typed is the current item in the list When the action you want is the current item in the list press Enter When you add an action a dialog box appears that lets you set the parameters for the action unless it does not require parameters When you add a Custom Dialog or Custom B...

Page 26: ...cript Lines You can temporarily comment out certain script lines to help with the debug process Commented out lines remain in the script but are skipped when the script is executed 1 Select one or more lines 2 Select Edit menu Comment The commented out lines appear in green and begin with To reactivate commented out lines select the lines and select Edit menu Comment Saving a Script to a Text File...

Page 27: ...er defined action by creating a separate WiseScript and saving it in the Actions subdirectory of this product s installation directory or in the shared directory that is specified in Preferences See Creating a User Defined Action on page 28 When you create a user defined action specify the following in the script Action Name The file name of the script Dialog Box Include a dialog box only if your ...

Page 28: ...bles 3 From Event select Mainline The main script reappears 4 Add script lines that perform the function of your user defined script action This might be something as simple as a single line that calls a DLL or it could be a complex set of script lines that perform an advanced function 5 In Title enter a combination of text and variables to define the format of the script line Example Your user de...

Page 29: ... directory or in the shared directory that is specified in Preferences Name the file Wait Your new action appears in the Actions list in Script Editor after you close and re open WiseScript Editor To create a dialog box for the action 1 From Event select Exit To write a script action that interacts with the developer who uses it you must add a Custom Dialog script line which you must store in the ...

Page 30: ...ait action you write a very simple script The script calls kernel32 dll a Windows system DLL that contains a function that stops execution of the current application for the specified number of milliseconds To learn more about calling Windows system DLLs see the Microsoft Developer Network msdn microsoft com 1 From Event select Mainline to return to the main part of your script The script should b...

Page 31: ...appears 5 Enter 9000 and click OK A new script line appears in your script that looks like this Wait 9000 Milliseconds 9000 milliseconds equals nine seconds 6 Save the script 7 Click Test to test your script After the blue screen appears there should be a nine second delay before the Welcome dialog box appears If the action does not work check the options you entered for the Call DLL statement If ...

Page 32: ... for beginning a loop is the While action The end of both conditions and loops is marked using the End action Script Editor indents everything inside a condition or loop so you can see which actions are affected Else and ElseIf Actions Conditions can use the Else and ElseIf actions which mark the beginning of actions to be executed when the condition described by the If action or other condition s...

Page 33: ...llowed by Examples WIN refers to the contents of the WIN variable which is the path to the Windows system directory and WIN Fonts refers to the path to the Windows font directory The character is not part of the variable name but rather a marker that tells WiseScript to replace the variable s name with its value before executing the command To include an actual character in the script use You can ...

Page 34: ...riables all the script actions required by the condition are included in the installation EXE WiseScript Editor doesn t know which part of the condition will be executed until the installation EXE is run because it depends on variables whose values are not known until run time The values of compiler variables on the other hand are known when the installation EXE is built Therefore WiseScript Edito...

Page 35: ...ly Initialization In this section default values for an installation are set including the default directory standard components and Start menu Information that is needed later in the installation is read from INI files or the registry Files that are displayed to the end user ReadMe txt License txt etc are installed A search can also be performed for a previous version of an application to use its...

Page 36: ...on on page 46 z Capture Application to SVS Layer on page 50 z Change SVS Layer GUID on page 51 z Check Configuration on page 51 z Check Disk Space on page 52 z Check HTTP Connection on page 54 z Check If File Dir Exists on page 55 z Check In use File on page 56 z Check Service on page 56 z Compiler Variable Actions on page 57 z Config ODBC Data Source on page 58 z Copy Local File s on page 58 z Cr...

Page 37: ... page 76 z Evaluate Windows Installer Condition on page 76 z Execute Program on page 77 z Execute VBScript on page 77 z Exit Installation on page 81 z Export SVS Layer on page 82 z Find File in Path on page 82 z Find First SVS Layer on page 83 z Find Next SVS Layer on page 83 z Find SVS Layer GUID on page 84 z Get Environment Variable on page 84 z Get Name Serial Number on page 85 z Get Registry K...

Page 38: ... page 104 z Read Update Text File on page 104 z Read Write Binary File on page 105 z Reboot System on page 106 z Register Font on page 106 z Remark on page 106 z Remove SVS Exclude Entry on page 107 z Rename File or Directory in SVS Layer on page 108 z Rename File Directory on page 107 z Rename SVS Layer on page 108 z Search for File on page 109 z Self Register OCXs DLLs on page 110 z Set Activate...

Page 39: ...or on page 21 About SVS Script Actions on page 39 About SVS Script Actions Script Editor has a set of script actions that you can use to manage edit find and create virtual software layers Each of these script actions has SVS Software Virtualization Solution in its name For your convenience these script actions are grouped by default under the SVS Items title bar For more information about Softwar...

Page 40: ...e SVS script actions that manage or update a layer Use the find first and find next actions to iterate through all the layers on a computer z Find First SVS Layer z Find Next SVS Layer z Find SVS Layer GUID Script Action for Creating a Layer Use the Create SVS Layer script action to create an empty layer You can then use the Capture Application to SVS script action to add an application to the lay...

Page 41: ...R z Location of New Directory Select to add to the beginning or end of the PATH z Path Selection Some destination computers have several PATH variables Use this list to add the directory to all PATH variables Add File to SVS Layer This SVS script action adds a file to a virtual software layer This can be an existing layer or a layer that the WiseScript creates The file is added to the read only su...

Page 42: ...location of the text in the log depends on where in the script you place the Add Text to Install log script line Note When a WiseScript is called by a Windows Installer installation the Windows Installer installation does not recognize changes that the WiseScript makes to the destination computer and will not uninstall them Therefore you must provide a way to uninstall or repair such changes See U...

Page 43: ... or in place of the existing line The destination computer is restarted after installation to force the new commands to take effect To complete the dialog box z Text to Insert Enter the line to add to Autoexec bat If the line refers to an application file use a path example MAINDIR Application Application exe The PATH variable might not be set when the command is executed so always use a path z Li...

Page 44: ...pend the command to the end of the file The Search for Existing Text area in this dialog box overrides the line number specified here The line number applies only when the text is not found or when you do not specify any text z Search for Text Enter the text to search for here The installation scans Config sys looking for a line that begins with ends with or contains the text depending on the sett...

Page 45: ...em ini If you add a device entry with the same device name but a different driver path the old entry is commented out and the new entry is added Browse for Directory This action displays a dialog box asking the end user to select a directory It is included to provide backward compatibility for older WiseScripts In new scripts use custom dialog boxes instead To complete the dialog box z Window Name...

Page 46: ...e Enter the name of the function to call The function should be exported when creating the DLL The function s parameters and return value must exactly match those specified below case sensitive z Call a function written specifically for WiseScript When calling functions developed specifically for WiseScript mark this option and fill in Variables Added Parameter String and Action below Each DLL fun...

Page 47: ... GetLastError function to report errors select a variable to hold the return value of that function Doing so ensures that GetLastError is called immediately following your function to prevent problems that can occur when you debug the WiseScript z Keep DLL loaded in memory after returning from function By default the Call DLL Function action loads a DLL calls a function in that DLL and then unload...

Page 48: ...WORD Use this for any parameter type that begins with an H or ends with the word HANDLE such as HWND HANDLE HPEN HFONT and LPHANDLE Long 32 bit unsigned integer data type string pointer Use for any parameter that ends in STR such as LPSTR and LPTSTR Long 32 bit pointer to an ANSI character type null terminated string short pointer Pointer to SHORT or SHORT use for PSHORT or LPSHORT Long 32 bit poi...

Page 49: ...ers select Normal from Passing Type in the DLL Parameter Settings dialog box However for structure elements also referred to as members select First element of structure for the first item in the structure or Contained within structure for subsequent items A structure ends if there are no more parameters or if the next parameter is set to Normal or First element of a structure Note The following c...

Page 50: ...XE you specify and captures its installation You can use this script action to capture an MSI by running msiexec exe To complete the dialog box z Layer GUID Enter the layer s GUID globally unique identifier or a variable that represents the layer s GUID If you enter the layer s GUID do not include the brackets For information on creating a variable for a layer s GUID see Create SVS Layer on page 6...

Page 51: ... a copy of the original archive file To complete the dialog box z Layer GUID Enter the layer s GUID globally unique identifier or a variable that represents the layer s GUID If you enter the layer s GUID do not include the brackets For information on creating a variable for a layer s GUID see Create SVS Layer on page 65 and Find SVS Layer GUID on page 84 z New Layer GUID Enter a new GUID for the l...

Page 52: ...ows NT 2000 XP 2003 Vista 2008 7 and Windows 95 98 Checking for VGA or better graphics ensures that display resolution is at least 640x480 Checking for free memory tests the amount of memory including virtual memory available at installation time The sample script CheckVGA wse uses this action For details on sample scripts see ScriptHelp htm in the Samples subdirectory of this product s installati...

Page 53: ... is written to Install log Otherwise if the disk space check fails the installation is halted with no message to the end user For information on how to create an installation log see Open Close Install log on page 99 Using Check Disk Space Within a Windows Installer Installation When a WiseScript is called by a Windows Installer installation the Check Disk Space action only checks disk space for f...

Page 54: ... exe Append End Check free disk space If COMPONENTS Contains Plus exe then Install File C Installation Files PlusLicense exe to MAINDIR PlusLicense exe End Check HTTP Connection This action determines whether a given URL is valid by using WinSock dll to try to download the HTML page If the installation is not true 32 bit specify both Win16 and Win32 error variables Then the Win32 WinSock dll is us...

Page 55: ...e or if a DLL is loaded into memory It can perform different actions based on the result of the check To complete the dialog box z If Select the condition to check To check if a DLL is loaded select Module loaded in memory z Pathname To check a file or directory enter its path Wildcard characters such as are not valid Use variables example WIN rather than hardcoding a path To check if a DLL is loa...

Page 56: ...y in use files cannot be moved deleted or opened by other processes To complete the dialog box z Variable Select or enter a variable to store the result of this test After this action runs the variable contains one of the following values In Use Not In Use or Non Existent which means the file could not be found z Pathname Enter the path of the file to check You can use variables to build the path ...

Page 57: ... it to Y The Add Text to INSTALL LOG action within the Compiler Variable If block is added to the final script The debug information you requested then appears in the installation log To create a compiler variable If block 1 Add a Compiler Variable If action and complete the dialog box If Variable Build an If statement by selecting a compiler variable and a comparison The first list shows compiler...

Page 58: ...o display standard data source configuration dialog boxes to the end user Otherwise the data source is configured with default settings z System DSN Mark this check box to make the data source available to all user accounts on the destination computer Copy Local File s This action copies uncompressed files from a floppy disk CD the destination computer or a network drive Note When a WiseScript is ...

Page 59: ...Require Password Not applicable in this product If you entered a password on the Password page and you mark this the end user is prompted for the password before this file is installed The password prompt appears only once for the first password protected file in an installation regardless of the number of password protected files If no password protected files are slated for installation the prom...

Page 60: ...at is older than the new file If the existing file lacks a version resource it is not replaced For File Date Time this replaces the existing file if its modification date and time are older than the new file z Retain Duplicates in Path By default version checking removes existing copies of DLLs that are found in the path list To suppress this feature mark this check box The sample script FTPCopy w...

Page 61: ...ctory to create You can use SVS variables or WiseScript variables that resolve to a valid SVS path See SVS Variables on page 161 z Return variable Optional Enter a name for the return variable When this script action runs successfully either 0 or 1 is placed in this variable See also About SVS Script Actions on page 39 Create Service This action installs a Windows service on operating systems wher...

Page 62: ... good configuration z Group Enter the name of the load ordering group to which this service belongs Leave this empty if the service does not belong to a group z Dependencies Enter a list of semicolon separated names of services or load ordering groups that must start before this service Leave this empty if there are no dependencies If a service is dependent on a group at least one member of the gr...

Page 63: ...tup directory use DESKTOPDIR STARTMENUDIR or STARTUPDIR For the All Users equivalents use CDESKTOPDIR CSTARTMENUDIR or CSTARTUPDIR z Command Options Optional If the shortcut is for an EXE enter command line options z Default Directory Specify the default directory that should be set when running the target file if different from the target file s location In Windows Explorer this field is referred...

Page 64: ...on Path Enter the path to the shortcut to be created example DESKTOP For the current user s desktop Start menu or Startup directory use DESKTOP STARTMENU or STARTUP For the All Users equivalents use COMMONDESKTOP COMMONSTARTMENU or COMMONSTARTUP z Arguments Optional If the shortcut is for an EXE enter command line options z Default Directory Specify the default directory that should be set when ru...

Page 65: ...riable Optional Enter a name for the return variable When this script action runs successfully either 0 or 1 is placed in this variable See also About SVS Script Actions on page 39 Create Virtual Directory This script action creates a new IIS Web site or virtual directory To set permissions for this Web site also use the Set Web Permissions script action See Set Web Permissions on page 115 To comp...

Page 66: ... Find SVS Layer GUID on page 84 z Return variable Optional Enter a name for the return variable When this script action runs successfully either 0 or 1 is placed in this variable z Force running processes to terminate Optional Mark this to force all processes that are associated with the layer to terminate when the layer is deactivated See also About SVS Script Actions on page 39 Delete File from ...

Page 67: ... root directories Click Browse to display and select files in the current WiseScript that are installed into the MAINDIR SYS32 SYS OR FONTS directories When you select a path in the Browse for File dialog box you must select a file z Include Sub Directories If you entered the path to a directory or used a wildcard mark this to delete matching files in all subdirectories as well z Remove Directory ...

Page 68: ...ustom Billboard Editor See About Billboards on page 146 You can use up to 16 Display Billboard actions in the script To complete the dialog box z Pathname Specify the full path to the graphic file on your computer To use variables in this field you must mark the Local Graphic option below z X Position Y Position Indicate the location on a 640 x 480 screen to place graphics On larger screens the bi...

Page 69: ...e EXE Display Message This action displays a message dialog box and can optionally branch the script based on the end user response Without the branching option this dialog box has an OK button which continues and a Cancel button which halts installation To complete the dialog box z Message Title Enter the title for the dialog box z Message Text This is displayed in the dialog box Press Ctrl Enter...

Page 70: ...sage add another Display Progress Message action z Display a new progress message Message Title Enter the title for the dialog box Message Text Enter text to display in the dialog box You can use variables in this text X Position Y Position In pixels enter the location of the upper left corner of the dialog box Height Width In pixels enter the dimensions of the dialog box Center Horizontally Mark ...

Page 71: ...type the section name in brackets then type new lines for that section If the INI file already contains a name value pair that you type the existing line is replaced by the new one Example SECTIONNAME Color Blue To delete a section and its contents type a section name with no lines after it Example SECTIONNAME To delete a name value pair type the name with an equals sign followed by nothing Exampl...

Page 72: ...o do that you must change the Operation field in the key s details dialog box z New Value To add a new value select the parent key in Registry Keys then click the New Value button A dialog box appears where you enter information about the new value z Delete Value Removes the selected value from the current installation This does not remove it from the destination computer To do that you must chang...

Page 73: ...ich is created inside the NewDocument key Any keys in the path that do not exist are automatically created z Value Name Enter the name of a new named value z Data Value The data for the value If the Data Type below is Double Word DWORD the data should be in decimal notation To insert multiple lines of data here press Ctrl Enter to begin a new line z Data Type Select the type of data contained in t...

Page 74: ...port a registry file REG Note Use this action on a deactivated SVS layer only To complete the dialog box z Registry Keys This field shows root registry keys and the keys added by this action Select a root before adding or importing a key z Value Names This field shows values being added or changed that reside under the key selected on the left z New Key To add a new key select the parent key in Re...

Page 75: ...SVS Layer GUID on page 84 See also About SVS Script Actions on page 39 Else Statement This action marks the beginning of a section of instructions to be executed when the condition specified in the matching If action is false It takes no parameters and selecting it from the Actions list inserts it directly into the script with no further dialog boxes or prompts See also If Statement on page 90 Els...

Page 76: ...log boxes or prompts Note This is different from the End Statement action that is in MSI Script in a Windows Installer installation See also If Statement on page 90 Evaluate Windows Installer Condition This action evaluates a condition in the currently running Windows Installer installation You enter a Windows Installer condition and select a WiseScript variable to store the result It puts the val...

Page 77: ...select a directory from your installation You can select from directories that you created using the Create Directory action See Create Directory on page 60 z Variables Added List any variables created in the EXE that are not present in the calling script z Window Size You can force the EXE file to run in a maximized or a minimized window or you can let it run in its default window Select Hidden t...

Page 78: ... file You can use compiler variables in the path z Command Line If the VBscript requires a command line enter it here A command line is probably required if The VBScript required a command line when it ran stand alone The WScript object with the Arguments property WScript Arguments is in the VBScript You can use WiseScript variables in the command line The sample script MakeWebDir wse uses WiseScr...

Page 79: ...library z Quick Info Displays help text when possible for a selected item This help text can also appear as a pop up Example when you select an item in a drop down list z Check Syntax Checks the script for basic syntax and displays a Syntax Error message A syntax error message also appear as a pop up when a syntax error is detected z Revert to Saved Reverts the current script to the last saved ver...

Page 80: ...roperly See Calling a COM Object in a VBScript on page 80 Get WiseScript Variable Use this action to create script code that gets a WiseScript variable You must set the variable in the WiseScript or another VBScript prior to the Execute VBScript action See Set Variable on page 113 In the VBScript you put the name of the variable in the Get Variable function that appears when you double click this ...

Page 81: ...the following For an object that is registered on your computer select the TypeLib information for the object For an object that is not registered on your computer click Browse and locate the file that contains the TypeLib information TypeLib information for an unregistered object does not help you identify the object s ProgID but it does display a list of objects in the Objects field for the file...

Page 82: ...R_RTN does not override the Application Exit Code but is written to the installation log See Run time Variables on page 159 Export SVS Layer To complete the dialog box z Layer GUID Enter the layer s GUID globally unique identifier or a variable that represents the layer s GUID If you enter the layer s GUID do not include the brackets For information on creating a variable for a layer s GUID see Cr...

Page 83: ...s Enter a semicolon delimited list of directories to search You can use variables If this field is blank only directories in the PATH environment variable are searched z Remove File Name Mark this to remove the file name from the end of a returned path leaving only the directory name This operation is not performed on the Default Value Find First SVS Layer This SVS script action starts a search fo...

Page 84: ...onal Enter a name for the return variable When this script action runs successfully either 0 or 1 is placed in this variable See also About SVS Script Actions on page 39 Get Environment Variable This action puts the value of a Windows environment variable into a WiseScript variable To complete the dialog box z Env Variable Enter a Windows environment variable z Variable Name Enter a variable to st...

Page 85: ...mber field z Variable In the three Variable fields enter the variables to store the Name Company and Serial Number z Confirm Text Optional Enter text to be displayed in a separate dialog box to confirm registration If this is blank no confirmation dialog box appears Get Registry Key Value This action puts the value of a registry key into a variable Multi line MULTI_SZ registry values are read into...

Page 86: ... for a layer s GUID see Create SVS Layer on page 65 and Find SVS Layer GUID on page 84 z Return variable Optional Enter a name for the return variable When this script action runs successfully either 0 or 1 is placed in this variable z Active Variable If the layer is deactivated 1 is placed in this variable If the layer is activated 2 is placed in this variable z Active On Start Variable If the la...

Page 87: ...t Date Time The time is in 24 hour format Example 07 14 05 11 18 10 Windows Version Example 5 2 3790 Windows 2003 Professional DOS Version Example 6 22 K Bytes Physical Memory The amount of physical RAM File Date Time Modified The time and date on which the file that is specified in Pathname was modified File Version Number The version of the file that is specified in Pathname Example 2 5 4 0 If t...

Page 88: ...perating system if one exists Current Date Time four digit year Same as Current Date Time above except a different format Example 07 14 2005 11 18 10 File Date Time Modified four digit year Same as File Date Time Modified above except a different format Example 07 14 2005 11 18 10 Disk Free Space KBytes Free disk space of the drive that is specified in Pathname In Pathname enter a drive C or a pat...

Page 89: ...alog box z Variable Specify a variable in which to store the temporary file name Only a file name is generated To refer to this file prefix it with the TEMP variable extension Example If the variable is HELPFILE the full path of the file would be TEMP HELPFILE Get Windows Installer Property This action gets the value of a Windows Installer property in the currently running Windows Installer instal...

Page 90: ... installation To create an If block 1 Add an If Statement and complete the dialog box If Variable Select a variable from the first drop down list and a comparison method from the second drop down list Expression True means the expression in the Value field below is evaluated according to the rules outlined in Variables and Expressions on page 33 The variable is ignored and can be left blank The re...

Page 91: ...rary of WiseScripts that perform specific functions like subroutines You can re use include scripts and share them with colleagues They typically contain just a few lines of code such as calling an EXE or displaying a particular dialog box Include scripts can be any size with the limitation that the calling script plus include scripts cannot be more than 32 000 lines Include scripts are displayed ...

Page 92: ... found Either complete the Line Number field or the Search for Existing Text section Do not complete both because you can only do one or the other To complete the dialog box z File to Edit Specify the path of the text file to edit example SYS32 File txt z Text to Insert Enter the text to add to the file If the line refers to a directory or file start the path with a variable example MAINDIR Applic...

Page 93: ...g files permanently on the destination computer using the Install File s script action you might also want to make sure that the destination computer has enough disk space available for these files Do this using the Check Disk Space script action See Check Disk Space on page 52 The results from an Install File s action are put into a variable INSTALL_RESULT See its description in Automatic Run tim...

Page 94: ...r the file See Self Register OCXs DLLs on page 110 z Replace Existing File Select when to replace existing files on the destination computer Always The new file always replaces the old file Never The file never overwrites an existing file Select this for files that should be installed if they are not present but which might be customized by the end user and should therefore not be replaced on re i...

Page 95: ...ate the layer when it is imported on the end user s computer z Bind this WiseScript to the WVP release When you check this the name of the current WiseScript file appears by default in Release Name and this WiseScript is added as a release to the WVP file s Releases page in Virtual Package Editor If you then edit and recompile the WVP file in Virtual Package Editor this WSE file is also recompiled...

Page 96: ...o Startup Group check box see below Enter the number of days between update reminders for the end user z Alternate Web Page Enter the location of a Web page to display if the WiseUpdate client cannot check for updates or download the installation Examples A page with technical support upgrade information or troubleshooting z Start Menu Icon Enter a name for a shortcut to the WiseUpdate Client whic...

Page 97: ... installs the mobile device application on the device z The end user copies the CAB file to the mobile device and opens it The CAB file extracts its contents to the directories that were specified in the INF file Uninstall of the mobile device application is controlled by the mobile device and ActiveSync Uninstalling the mobile device installation from the desktop computer does not affect the appl...

Page 98: ...ation onto the mobile device will not take place immediately following the desktop installation then use the following fields to create a shortcut on the desktop computer This shortcut starts the installation onto the mobile device by calling the Application Manager Name Enter the name for the shortcut on the mobile device Icon File To use a custom icon enter the path to the ICO EXE or DLL file th...

Page 99: ...gging you must also use it to resume logging or no log file is created Note When a WiseScript is called by a Windows Installer installation the Windows Installer installation does not recognize changes that the WiseScript makes to the destination computer and will not uninstall them Therefore you must provide a way to uninstall or repair such changes See Uninstalling Changes Made by a WiseScript i...

Page 100: ...racter position at which to split Character patterns are case sensitive unless you mark Ignore Case To split at a pattern enter any number of characters including numbers and select one of the pattern options in Operation To split a string based on character position enter the character position where 1 is the first character and select one of the position options in Operation z Destination Variab...

Page 101: ...n the destination computer z Loop Continuously Post to HTTP Server This action posts information over the Internet to a Web server Example Use it to record user registration information or other data You must set up a CGI program or Active Server Page ASP on the server that accepts data sent by an HTTP POST operation and deciphers encoded characters The destination computer must have a valid Inter...

Page 102: ...nction This action requires an End Statement because it begins a block of statements similar to an If Statement To complete the dialog box z Dialog Type Select Open File or Save As z Dialog Title Enter the title for the dialog box z Dest Variable Select or enter a variable to store the path of the file or directory the end user selects z Default Extension Enter the extension to append to the file ...

Page 103: ...box z Window Name Enter the title for the dialog box z Description Enter brief instructions here z Prompt Name Enter the label to be displayed next to the text input field z Default Value Enter the text to be displayed in the text input field by default z Variable Name Enter a variable to store the text entered by the end user z Directory Mark this to delete trailing backslashes from the text so y...

Page 104: ...rackets example DIRECTORIES z INI Item Enter the name of the entry to read from the INI file z Default Value Enter the value to store in the variable below if the specified entry is not found z Variable Name Enter a variable to store the value of the INI item z Remove File Name Mark this to remove a file name from the end of a returned path leaving only the directory name This operation is not per...

Page 105: ... Samples subdirectory of this product s installation directory See also End Statement on page 76 Read Write Binary File This action reads from a binary file to a variable or writes from a variable to a binary file If you write to the file the existing information in the file is not moved it is overwritten This action does not support reading or writing non ASCII characters characters with codes ab...

Page 106: ...oes not have administrator privileges this option only logs the end user out Register Font This action registers a new TrueType font TTF file that has been copied into the Windows font directory To complete the dialog box z Font File Name Specify the file name of the TTF font file not the path to be registered The drop down list contains font files that you have added to this installation The file...

Page 107: ... Create SVS Layer on page 65 and Find SVS Layer GUID on page 84 z Exclude entry text Enter the text used to set the exclude If the exclude entry type is an extension enter the file extension If the exclude entry type is a directory or a directory with its subdirectories enter the directory For a directory you can use a WiseScript variable that resolves to a valid path For example PROGRAM_FILES z R...

Page 108: ...in the virtual software layer You can use SVS variables or WiseScript variables that resolve to a valid SVS path See SVS Variables on page 161 z Destination path Enter the new path or file name or both Any new path you enter must exist in the layer You can use SVS variables or WiseScript variables that resolve to a valid SVS path See SVS Variables on page 161 z Return variable Optional Enter a nam...

Page 109: ...e location where the file is normally installed If the file is found the new version could overwrite the found file If the file is not found the new version could be installed to the default location z Message Text Enter a message to display during the search operation z Return Type Select whether to return only the first match or list of all matches z Drives to Search Select to search local drive...

Page 110: ...le for self registration Mark this to queue the file listed in Pathname for later self registration Set Activate SVS Layer on Startup This SVS script action activates a virtual software layer when the computer restarts To complete the dialog box z Layer GUID Enter the layer s GUID globally unique identifier or a variable that represents the layer s GUID If you enter the layer s GUID do not include...

Page 111: ...roduct s installation directory Set Control Text This action appears only when you are in a dialog box script This action changes the text associated with a control in a dialog box Controls without names cannot be manipulated with this action To access this action 1 Double click a Custom Dialog script line The dialog box appears in the Custom Dialog Editor 2 Select View Dialog Script Editor A smal...

Page 112: ...h shows the dialog box to see or change the name of controls To name a control right click the control select Control Properties and in the dialog box that appears enter a name in the Control Name field Set File Attributes This action sets the attributes of one file or a group of files To complete the dialog box z File Pathname Specify a file to change example MAINDIR Acrobat pdf You can use wildc...

Page 113: ...iles are saved in the base file system and are not lost To remove an SVS exclude entry use the Remove SVS Exclude Entry action See Remove SVS Exclude Entry on page 107 To complete the dialog box z Layer GUID For a global exclude leave this blank For a layer exclude enter the layer s GUID globally unique identifier or a variable that represents the layer s GUID If you enter the layer s GUID do not ...

Page 114: ...ts an existing path to its equivalent long or short path if the installation runs on Windows 95 or NT For this to work the specified directory or file must exist Convert to uppercase or lowercase All alphabetical characters are converted to the case you select Evaluate Expression The expression in New Value is evaluated according to the rules outlined in Variables and Expressions on page 33 z Appe...

Page 115: ...ecutables are not needed for your Web site to operate we recommend that you turn these permissions off to limit the possibility of malicious code destroying your Web server Set Windows Installer Property This action sets the value of a property in the currently running Windows Installer installation You can either hard code a value or set the property to the value of a variable Use this action onl...

Page 116: ...ition specified in the While Statement Settings dialog box is true the script lines inside the loop execute repeatedly If the condition is not true then the While loop is exited and the next script line is executed To create a While loop 1 Add a While Statement and complete the dialog box While Variable Select a variable from the first drop down list and a comparison method from the second drop do...

Page 117: ...The script continues executing inside the wizard loop until the last dialog box has been completed and accepted Use this script action to create the wizard loop To complete the dialog box z Dialog Boxes Displays a list of the Custom Dialog actions inside the wizard loop structure Select a dialog box to edit its setting in the bottom part of the Wizard Loop Settings dialog box z Skip Dialog This le...

Page 118: ...t Editor Reference 118 WiseScript Actions variable is ignored and can be left blank The result is considered true if it evaluates to a non zero result The password comparisons are not applicable in this product ...

Page 119: ...languages Typically dialog boxes are not used in WiseScripts that run silently or in WiseScripts that you use as custom actions in a Windows Installer installation The information in this section is provided in case you open or edit WiseScripts that contain dialog boxes About the Custom Dialog Editor The Custom Dialog Editor is a built in utility Use it to do the following Access the Custom Dialog...

Page 120: ...LG file in the Dialogs Template subdirectory of this product s installation directory This does not affect the current installation You can add a saved dialog box to another installation by selecting File menu Open in the Custom Dialog Editor Editing Dialog Boxes When you edit a dialog box the changes affect the current installation only However if you save the dialog box and overwrite the DLG tem...

Page 121: ...ert Position Select where on the screen to display the dialog box If you select Default the dialog box is centered on the screen Do not display wizard graphic on this dialog Normally the wizard graphic is set in the Wizard Loop script action and applies to all dialog boxes in the wizard loop Mark this check box to turn off the wizard graphic on this dialog box 4 Click OK About Dialog Box Controls ...

Page 122: ...ext Text that you can link to actions or a Web page See Adding Hot Text Controls on page 129 List Box A single column of values The end user can select one or more values from the list See Adding List Box Controls on page 131 Play AVI An animation This does not include controls to play stop rewind or fast forward the movie See Adding Play AVI Controls on page 132 Push Button A clickable button Gen...

Page 123: ...ox the letter A is appended to the variable that stores the return value If the end user selects the second check box the letter B is appended and so on The variable stores letters of all check boxes that are selected Example If the end user marks the first third and fourth check boxes the variable is ABD Variable Specify the name of the script variable that stores the return value of this dialog ...

Page 124: ...which makes disabled options retain their disabled state even when the end user navigates between dialog boxes If this check box is cleared the variable takes the value of the option that was selected and the lowercase information is lost 4 Click OK Adding Combo Box Controls A combo box can take three forms a list box a drop down list and a drop down list that can accept text entry In the text ent...

Page 125: ...e action to set a variable to the value of one of the options Then select that variable in the Variable field Combo Box Type Select the combo box type Simple List box from which end users can make a selection Drop Down Drop down list that allows text entry or selection from the list Drop List Drop down list that only allows selection from the list Control Name Enter the name by which you will refe...

Page 126: ...the text in the edit field This is enabled only when the Multi line check box is marked Control Name Enter the name by which you will refer to this control in the dialog box script Leave this blank if you will not manipulate this control with a script Horiz Scroll Mark this to add a horizontal scroll bar Vert Scroll Mark this to add a vertical scroll bar Auto HScroll Mark this to scroll the text i...

Page 127: ...tory Mark this to remove trailing backslashes from the text before it is placed in the variable Confirm If Exists Mark this to prompt for confirmation if the path that the end user enters already exists on the destination computer Clear this check box to prevent the This directory already exists message from appearing X Position Y Position Specify the exact location of the control on the dialog bo...

Page 128: ... Spacing Dialog Box Controls on page 139 Note A dialog unit is based on the size of the dialog font usually 8 point MS Sans Serif A horizontal dialog unit is 1 4 the average width of the font and a vertical dialog unit is 1 8 the average height of the font Width Height Specify the exact dimensions of the control in dialog units You can also resize controls by dragging their handles though this is ...

Page 129: ...the dialog box in the Custom Dialog Editor See Editing Dialog Boxes on page 120 2 Select Add menu Hot Text The Hot Text Control Settings dialog box appears 3 Complete the dialog box Label Enter the text to use as hot text Variable Specify the name of the script variable that stores the return value of this dialog box control Value Enter the value that gets assigned to the variable if this button i...

Page 130: ... system font is used Default Font Click this to use the font specified on the Dialog Box Properties dialog box Disabled Color Enabled Color Click Color to choose from the palette or to define custom colors Enabled Color is the color in which the hot text appears when the end user moves the mouse pointer moves over the text Underline Enabled Text Mark this to underline the hot text when the end use...

Page 131: ...name by which you will refer to this control in the dialog box script Leave this blank if you will not manipulate this control with a script List Box Type Select the list box type Normal A simple list Program Manager Groups A list of the items in the Programs group of the Start menu Directory Tree Browse A directory tree browser including an edit field directory tree and disk drive list List Box w...

Page 132: ... X Position Y Position Specify the exact location of the control on the dialog box You can also use the alignment commands to precisely arrange controls on the dialog box See Aligning and Spacing Dialog Box Controls on page 139 Note A dialog unit is based on the size of the dialog font usually 8 point MS Sans Serif A horizontal dialog unit is 1 4 the average width of the font and a vertical dialog...

Page 133: ...are simply buttons example OK or Cancel When clicked they perform an action such as saving the dialog box data closing the dialog box or advancing to the next dialog box Each dialog box must have at least one button that allows the end user to exit the dialog box 1 Open the dialog box in the Custom Dialog Editor See Editing Dialog Boxes on page 120 2 Select Add menu Push Button The Push Button Con...

Page 134: ...tion to be started See Specifying Execute Program Settings on page 138 Execute Named Event Passes a named event to the dialog box script The DLG_EVENT_TYPE variable is set to the entered text See Creating a Custom Dialog Box Script on page 143 X Position Y Position Specify the exact location of the control on the dialog box You can also use the alignment commands to precisely arrange controls on t...

Page 135: ... uses the Back button Mark this check box to cause any lowercase letters in the variable to stay in the variable which makes disabled options retain their disabled state even when the end user navigates between dialog boxes If this check box is cleared the variable takes the value of the option that was selected and the lowercase information is lost Variable Specify the name of the script variable...

Page 136: ...angles and frames differently but now there is no longer any difference Bevel Specify the 3D appearance of the frames or rectangles Inset Frame rectangle appears to sink into the dialog box Flush Frame rectangle appears at the same level with the dialog box Outset Frame rectangle appears to pop out of the dialog box Control Name Enter the name by which you will refer to this control in the dialog ...

Page 137: ...necessary to allow it to fit in the allotted space Omitted directories are indicated in the path by No Wrap Mark this to prevent text wrapping if the text is too long to display on a single line No Prefix Normally the ampersand character in static text indicates that the next character should be underlined and used as a shortcut to that control If you mark this check box the is displayed literally...

Page 138: ...agging their handles though this is not as precise 4 Click OK Specifying Execute Program Settings You can execute a program or link to a Web page when the end user clicks a hot text or button control on a dialog box 1 Open the Hot Text or Push Button Control Settings dialog box See Adding Hot Text Controls on page 129 or Adding Push Button Controls on page 133 2 Mark the Execute Program option and...

Page 139: ...e left edge of the leftmost control Align Controls Right Aligns the right edge of the selected controls with the right edge of the rightmost control Align Controls Top Aligns the top edge of the selected controls with the top edge of the topmost control Align Controls Bottom Aligns the bottom edge of the selected controls with the bottom edge of the bottommost control Space Evenly Down Distributes...

Page 140: ...iew press Esc Note Although static controls example graphics text messages divider lines and so on are included in the tab order they are ignored when the end user presses the Tab key Therefore their actual tab order is irrelevant Solutions for Dialog Box Problems Typically dialog boxes are not used in WiseScripts that run silently or in WiseScripts that you use as custom actions in a Windows Inst...

Page 141: ... script line for the dialog box The Custom Dialog Editor opens 2 Select Edit menu Dialog Box Properties The Dialog Box Properties dialog box appears See Setting Dialog Box Properties on page 120 3 Towards the bottom of the dialog box mark Do not display wizard graphic on this dialog 4 Click OK Keeping Disabled Controls From Reactivating This problem affects radio buttons and check boxes Example A ...

Page 142: ...n page 120 The master dialog box is the first dialog box that is displayed when the associated Custom Dialog script action is executed 2 In the Custom Dialog Editor select File menu New Dialog The Dialog Box Properties dialog box appears 3 Complete the dialog box and click OK See Setting Dialog Box Properties on page 120 4 Configure the new dialog box See Adding and Editing Dialog Box Controls on ...

Page 143: ...is built into the wizard loop dialog boxes by default 4 Click OK Creating a Custom Dialog Box Script Each dialog box can include an attached WiseScript that lets you perform script actions in response to events inside a dialog box You create this WiseScript in the Dialog Script Editor which is a scaled down version of Script Editor It contains only those script actions that can be used in dialog b...

Page 144: ...in Script Editor with the addition of these script actions that manipulate controls on the dialog box programmatically Set Control Attributes Set Control Text and Set Current Control Call DLL Function on page 46 Check Configuration on page 51 Check If File Dir Exists on page 55 Display Message on page 69 Edit INI File on page 71 Edit Registry on page 71 Else Statement on page 75 ElseIf Statement o...

Page 145: ...dialog box to display the current amount of free memory in the lower left corner z Have the UPDATE event enable the Next button on a wizard dialog box when a password field contains the correct value The UPDATE event is called whenever any field or control is changed and the variable associated with each field or control contains its current value suitable for testing in a script z Have the VERIFY...

Page 146: ...jects to a Billboard on page 148 About Billboards Billboards are a series of one or more graphics that present a slide show to the end user while files are being installed on the destination computer These are typically used to encourage the end user to register the product to promote related products or to provide other useful information Accessing the Custom Billboard Editor 1 Select Script Edit...

Page 147: ...n the Custom Billboard Editor you can move rearrange recolor or resize all objects Example Text remains editable once it has been added making it easy to translate your billboards into multiple languages If you import bitmaps created in other programs you can still use the Custom Billboard Editor to place other objects example editable text over them The Custom Billboard Editor includes a blue wor...

Page 148: ...e Save As Adding Objects to a Billboard The Custom Billboard Editor is object based and lets you add different types of objects 1 Access the Custom Billboard Editor See Accessing the Custom Billboard Editor on page 146 2 From the Add menu select an object 3 Drag in the work area to create the object The polygon tool requires that you click at each point of the polygon then double click at the last...

Page 149: ...TrueType font Font Style Click Set Font to choose the font size and style for this object Text Color Click Pick to choose a color for the text Placement Specify the size and location of the object in pixels The upper left corner is 0 0 The black rectangle on the billboard editor defines an area of 640 x 480 pixels 4 Click OK Editing Billboard Line Objects When you draw a line on a billboard you de...

Page 150: ...Add menu Rectangle or Rounded Rectangle or Ellipse and drag the dimensions of the object in the billboard editor The Object Settings dialog box opens 3 Complete the dialog box Line Style Choose the texture for the line that outlines the shape Fill Style Select a pattern to fill the object 3D Rectangle only Select a 3D effect Line Width The width of the object s outline in pixels Line Color Fill Co...

Page 151: ...itor to add captions and content to the bitmap rather than making the text part of the bitmap so that you can edit the text later The Custom Billboard Editor supports 256 color and true color bitmap BMP files When using multiple bitmaps it is important that they all be created using the same graphics editor so the files share a common color palette Otherwise the colors can shift when the bitmaps d...

Page 152: ...it menu To align billboard objects The alignment and spacing commands help you align and space objects in relation to one another 1 Open the billboard in the Custom Billboard Editor by double clicking its custom action in Script Editor 2 Use Shift click to select multiple objects 3 Select one of the following commands from the Layout menu Align Left Align Right Align Top Align Bottom Space Evenly ...

Page 153: ...mage at a time set to 1 To display all images simultaneously set to 0 The oldest image is removed first Build Effect Specify a transition effect Center Horizontal Place at Right Scale to Screen Mark this for the image to cover the same percentage of the screen regardless of screen size Hide Progress Bar Mark this to hide the progress bar during image display Center Vertical Place at Bottom Tile Ba...

Page 154: ...echnical support because end users who have problems installing can email the installation log Use the Add Text to Install log script action to add your own commands to the log You can use it to comment the install log or to customize your uninstall See Add Text to INSTALL LOG on page 42 File Replacement Problems in System32 Following are file replacement problems you might encounter z Files that ...

Page 155: ...our file z If the problem occurs because your file is a later version of a system file but you are trying to install it to a different location than the existing system file consider installing it to the existing location and changing your application to look for it in the existing location z You can turn off version checking for the file not recommended Do this by selecting an option from the Rep...

Page 156: ...mpiler Variables page See Compiler Variables on page 17 Variable Description _ALIASNAME_ BDE Alias name _ALIASPATH_ BDE Alias path _ALIASTYPE_ BDE Alias type _BDEWIN16DIR_ BDE directory for 16 bit systems _BDEWIN32DIR_ BDE directory for 32 bit systems _BDEWIN32INST_ BDE custom directory for use on systems that previously did not have BDE installed _BDEWIN32LANG_ BDE language code _BDEWIN32OPT_ BDE...

Page 157: ...is the directory where idapi32 dll is installed and registered It is used by the BDE runtime script for installing new aliases and for ensuring that updates to the BDE get installed into the correct directory We recommend that you do not change this variable CMDLINE The command line options passed to the installation EXE CRLF Holds a carriage return linefeed character for use in making lists and s...

Page 158: ...INI File returns E if the file could not be written or null if the edit was successful Execute Program returns the numeric exit code return code from the called application LANG The language the end user selects in a multi language installation We recommend that you do not change this variable PASSWORD Set this to the password to be used for password protected files Setting this variable disables ...

Page 159: ...TITLE The title of the installation BACKUP Path to the end user s selected backup directory on the destination computer BRANDING If this is set to 1 user information is written to CUSTDATA INI in the directory containing the installation EXE CDESKTOPDIR Common desktop directory for adding shortcuts to desktop CGROUPDIR Path to the directory where shortcuts for all end users are stored on Windows o...

Page 160: ...OCEXITCODE is not blank the return code from the installation is set to the contents of PROCEXITCODE This lets you write conditional code based on the results of an external program Be sure to mark the Wait for Program to Exit check box on the Execute Program Settings dialog box for the Execute Program action PROGRAM_FILES Windows Program Files directory STARTMENUDIR Directory of the Start menu fo...

Page 161: ...RPROFILE The directory that contains the Default User profile C Documents and Settings Default User COMMONADMINTOOLS C Documents and Settings All Users Start Menu Programs Administrative Tools COMMONAPPDATA C Documents and Settings All Users Application Data COMMONDESKTOP C Documents and Settings All Users Desktop COMMONDOCUMENTS C Documents and Settings All Users Documents COMMONFAVORITES C Docum...

Page 162: ...ents and Settings User Cookies DESKTOP C Documents and Settings User Desktop FAVORITES C Documents and Settings User Favorites FONTS C WINDOWS Fonts HISTORY C Documents and Settings User Local Settings History LOCALAPPDATA C Documents and Settings User Local Settings Application Data LOCALSETTINGS C Documents and Settings User Local Settings MYMUSIC C Documents and Settings User My Documents My Mu...

Page 163: ...e sample scripts that manipulate strings and perform calculations For details on sample scripts see ScriptHelp htm in the Samples subdirectory of this product s installation directory Symbols Functions SENDTO C Documents and Settings User SendTo STARTMENU C Documents and Settings User Start Menu STARTUP Folder that contains user specific items to be run on startup on the destination computer C Doc...

Page 164: ...tr1 str2 Returns the portion of a string str1 after the indicated substring str2 Example After windows d returns ows Len str Returns the length of a given string Do not include the character because this operator does not return a string Lcase str Converts all characters in a string to lowercase Ucase str Converts all characters in a string to uppercase Ltrim str Deletes all leading spaces Rtrim s...

Page 165: ...tting compiler variables defined in a text file named Compile txt product_installation_directory Wise32 exe c d C Development Compile txt C Development Application wse Automated build process You can use command line options in conjunction with other processes to create an automated build process 1 Enter the following command line statement into a batch file or program that has the ability to run ...

Page 166: ...path Z path Extracts files to the specified path then restarts M Runs the installation in manual mode prompting for system directories examples Windows System M file name Specifies a values file for installation For information on reading variables see Set Variable on page 113 M1 Displays the name of each self registering OCX or DLL as it is registered M2 Reserved for internal use by WiseScript Ed...

Page 167: ...box that appears Type the title at the end of the command line after all other options In the example above the title would be Application Uninstall S Silent mode The uninstall proceeds silently with no splash screen no dialog boxes and no end user choices R Rollback mode U Removes the Select Uninstall Method dialog box which means the end user does not see options for a custom automatic or repair...

Page 168: ...159 BACKUPDIR 157 157 batch file scheduling 165 BDE_CONFIGDIR 157 Before 164 billboard about 147 adding to script 68 arranging object 152 bitmap adding 151 editing text 148 ellipse adding 150 exporting 148 importing 148 line adding 149 location 152 moving object 152 number to display 153 object adding 148 opening 148 overlapping object 152 polygon adding 150 properties 152 rectangle adding 150 res...

Page 169: ...on 133 radio button 135 rectangle 136 spacing 139 static 127 137 tab order 139 text 137 Copy Local File s 58 Create Directory 60 Create Directory in SVS Layer 61 Create Service 61 Create Shortcut 62 Create Shortcut in SVS Layer 64 Create SVS Layer 65 Create Virtual Directory 65 credentials file 19 20 CRLF 157 CSTARTMENUDIR 159 CSTARTUPDIR 159 Custom Billboard 65 Custom Billboard Editor about 147 a...

Page 170: ...PLORER 160 expression about 33 evaluating 114 expression operators 163 Expression True 75 90 116 117 F file adding to layer 41 attributes 112 checking existence 55 copying to destination computer 93 date time modified 87 deleting 67 deleting from layer 66 downloading from Web 58 finding on destination computer 82 four digit modified date 88 FTP from Web 58 in use 56 renaming 107 renaming in layer ...

Page 171: ...ase 164 Left 163 Len 164 line adding to billboard 149 number 23 list box control adding to dialog box 124 131 with check boxes 131 logging 154 logon name getting 88 long 48 long pointer 48 loop beginning 116 ending 76 lowercase converting 114 Ltrim 164 M main installation script 24 MAINDIR 160 mainline script 24 manual reference 15 master dialog box 142 memory checking 52 finding 87 message displa...

Page 172: ... Exit 148 148 scheduling task 165 script about 35 adding action 25 blank 29 commenting out lines 26 comments 106 conditional loop 32 connection lines 23 editing 25 26 finding text in 26 include script See include script line number 23 naming 22 opening multiple 26 referencing compiler variable 17 replacing text in 26 saving 25 saving to text file 26 sections 35 testing 14 script action about 39 ad...

Page 173: ...g file 99 using installation log 42 unwise exe 166 unwise32 exe 166 uppercase converting 114 URL check 54 user defined action about 27 blank script for 29 changing parameter 27 creating 28 dialog box for 29 in actions list 28 interacting with developer 29 parameters for action 29 shared directory 27 testing 31 tutorial 29 V values file 114 variable about 33 automatic run time 157 compiler 34 156 f...

Page 174: ...g behavior 61 creating 61 starting stopping 115 WinSock 54 Wise scripting language 11 WISE_ERROR_RTN 82 160 Wise32 exe run from command 165 WiseScript about 11 actions 39 in Windows Installer 13 portable project 14 troubleshooting 154 WiseScript Editor starting 12 WiseUpdate adding with script 95 wizard dialog box changing image 141 disabling check box 141 disabling radio button 141 Wizard Loop ac...

Search results

Summary of Contents for WISESCRIPT EDITOR 8.0

Reviews:

Related manuals for WISESCRIPT EDITOR 8.0

Brands by name

Popular brands

Symantec WISESCRIPT EDITOR 8.0, Reference

Search results

Summary of Contents for WISESCRIPT EDITOR 8.0

Reviews:

Related manuals for WISESCRIPT EDITOR 8.0

Brands by name

Popular brands