Symantec WISESCRIPT PACKAGE EDITOR 8.0 Reference Download Page 1

Page: 1 / 268

WiseScript Package Editor Reference

Summary of Contents for WISESCRIPT PACKAGE EDITOR 8.0

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

Page 2: ... 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 CONTAINED IN THIS DOCUME...

Page 3: ...t delivers 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 B...

Page 4: ...es that 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...

Page 5: ... expertise 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 trai...

Page 6: ... Page Groups 23 Editing Installation Messages 24 Setting Preferences 25 Downloading Application Runtimes 26 Chapter 3 Installation Management 28 Changing Source Directories 28 Converting to UNC Based Source File Paths 29 Converting to Relative Source File Paths 29 Using Self Repair 30 Language Support 31 Processes for Adding Language Support 32 Distributing an Installation 34 Chapter 4 Creating Wi...

Page 7: ...3 SmartPatch 74 System Requirements 75 System Search 77 Searching for Files or Directories 77 Searching for INI Values 78 Searching for Registry Values 79 Uninstall 80 Adding Additional Commands for the Uninstaller 80 WebDeploy 81 The WebDeploy Process 82 Creating a WebDeploy Installation 82 Uploading a WebDeploy Installation to the Web 84 WiseUpdate 84 Chapter 5 Using WiseUpdate 85 About WiseUpda...

Page 8: ...Script Actions 117 Activate SVS Layer 119 Add Directory to PATH 119 Add File to SVS Layer 119 Add Text to INSTALL LOG 120 Add to AUTOEXEC BAT 121 Add to CONFIG SYS 122 Add to SYSTEM INI 123 Browse for Directory 123 Call DLL Function 124 DLL Parameter Settings 126 Passing Complex Structures to a DLL An Example 128 Capture Application to SVS Layer 129 Change SVS Layer GUID 130 Check Configuration 13...

Page 9: ...rst SVS Layer 163 Find Next SVS Layer 164 Find SVS Layer GUID 164 Get Environment Variable 165 Get Name Serial Number 165 Get Registry Key Value 166 Get SVS Layer Info 166 Get System Information 167 Get Temporary Filename 169 Get Windows Installer Property 169 Halt Compilation 170 If Statement 170 Import SVS Layer 171 Include Script 172 Initialize SVS 172 Insert Line Into Text File 173 Install Fil...

Page 10: ...201 About Dialog Boxes 201 About the Custom Dialog Editor 201 Adding a Dialog Box to the Installation 202 Editing Dialog Boxes 203 Editing Dialog Box Templates 203 Setting Dialog Box Properties 204 About Dialog Box Controls 205 Adding and Editing Dialog Box Controls 206 Adding Check Box Controls 206 Adding Combo Box Controls 207 Adding Edit Text Controls 209 Adding Graphic Controls 211 Adding Grou...

Page 11: ...s 233 Editing Billboard Rectangles and Ellipses 234 Editing Billboard Polygon Objects 235 Editing Billboard Bitmap Objects 235 Resizing Moving and Aligning Billboard Objects 236 Setting Billboard Properties 237 Chapter 10 Tools 239 About WiseScript Package Editor Tools 239 ApplicationWatch 239 Import Visual Basic Project 240 Chapter 11 Troubleshooting WiseScripts 243 About Troubleshooting a WiseSc...

Page 12: ...stallation Expert lets you configure a specific aspect of your installation For advanced customization you can edit the installation script in Script Editor which provides a powerful and easy to use scripting environment based on the WiseScript scripting language You create and edit lines in the script by setting options in dialog boxes which decreases the chances of syntax or other errors WiseScr...

Page 13: ...on the destination computer while the script is running z Built in rollback WiseScripts can be rolled back after they are executed on the destination computer z User interface WiseScripts can incorporate any type of dialog box to either inform the end user or prompt for input z WiseScript is powerful In addition to the dozens of predefined actions WiseScripts can call VBScripts and DLL functions m...

Page 14: ...n installation 1 Create a new installation or WiseScript See Starting the Software on page 15 2 WiseScript Package Editor only Set options on the Installation Expert pages to create basic installation functionality See About Installation Expert on page 36 3 Edit the script in Script Editor to create advanced installation functionality See About Script Editor on page 94 and About WiseScript Actions...

Page 15: ...sed on the WiseScript scripting language 1 In Wise Package Studio do one of the following On the Projects tab click the Run link to the right of the task or tool associated with WiseScript Package Editor The installation associated with the current project might open by default This tool might open to a different view based on command line options defined in Process Templates Setup On the Tools ta...

Page 16: ...n script actions See About the Project Settings View on page 38 z Installation Expert WiseScript Package Editor only Installation Expert lets you build an installation by pointing and clicking to fill out options See Using Installation Expert on page 36 z Script Editor Script Editor provides a powerful and easy to use scripting environment based on the WiseScript scripting language See About Scrip...

Page 17: ...ou test and compile the installation See Compiling Testing and Running a WiseScript on page 18 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 Package Editor provides an additional authoring en...

Page 18: ...Save check box in Preferences See Setting Preferences on page 25 z Test Click Test to compile and run the installation in test mode In test mode the installation performs all script actions without actually installing or modifying files However if any script lines are dependent on files being installed by previous script lines then test mode might fail Example If an Install File s line copies a Re...

Page 19: ...elp using the operating system consult its user documentation Use the following sources of information to learn about this product Note This documentation covers both WiseScript Package Editor and WiseScript Editor WiseScript Editor contains the same scripting interface as WiseScript Package Editor but it does not contain the Installation Expert interface or other installation development tools Th...

Page 20: ...ion Release Notes The product release notes cover new features enhancements bug fixes and known issues for the current version of this product To access the release notes select Release Notes from the Symantec program group on the Windows Start menu ...

Page 21: ...re defined view of page groups or creating your own view See Customizing Installation Expert Page Groups on page 23 z Change prompts and error messages displayed by the installation See Editing Installation Messages on page 24 z Set preferences See Setting Preferences on page 25 z Set the actions list in Script Editor to display only those actions you use most frequently and add your own actions t...

Page 22: ...ritten during upgrades Instead save customized templates with different names or make copies of the predefined templates and edit the copies Template Location Templates are stored in the WiseScript Editor Template subdirectory of this product s installation directory To create a custom template 1 Select File menu New The New Installation File dialog box appears 2 Select Empty Project and click OK ...

Page 23: ...ate but not the predefined sets You also cannot edit page names To add a page group 1 Select Pages menu Customize The Customize Pages dialog box appears 2 From Name select new 3 On the dialog box that appears specify a name for the new set of page groups Include an before a letter to set it as a keyboard shortcut The name appears in the Name drop down list 4 To add a new page group click the Add b...

Page 24: ...t for any other language obtain translations of the message text and enter the translated strings on the Installer Messages dialog box For information on adding language support to an installation see Language Support on page 31 To edit installation messages 1 Select Edit menu Installer Messages The Installer Messages dialog box appears 2 Complete the dialog box Language Name Select the language f...

Page 25: ...omputer where the installation directory is C Program Files Wise then you are prompted to redefine the compiler variable _WISE_ to the new WiseScript Editor application location Compiler variables are set on the Compiler Variables page Add Associated Icons and Registry Keys If you mark this when you add a file on the Files page in Installation Expert icons and registry keys that are associated wit...

Page 26: ...heck box only when testing and clear it for the final build Run in Manual Mode Mark this to have the installation EXE prompt for the locations of all directories to be used for installations example Windows System and so on whenever the installation is run from within WiseScript Package Editor Shared Directory Normally user defined actions are stored in the WiseScript Package Editor Actions direct...

Page 27: ...untimes you currently have installed and lists all the runtimes that are available for downloading 4 On the Select Runtime page mark the check box for each runtime you want to download You can click Select All to select all the runtimes or click Clear All to clear your selections As you mark check boxes the Download Size field displays the total size of the files you selected 5 When you finish sel...

Page 28: ...ation in this document does not apply to WiseScript Editor WiseScript Package Editor only As you work on an installation paths to files in the installation can become note valid if you z Move files that are part of the installation to a new directory on your computer or network z Move the installation file itself from your computer to another computer z Use relative paths and then move the install...

Page 29: ...twork can open and compile the script without encountering errors Instead of a path such as Y Application ini a file has a fully qualified path such as Server Development Application Application ini 1 Select Edit menu Source Directories The Change Source Directories dialog box appears and lists all the directories referenced in the script 2 From Type select Change source paths to UNC paths 3 Click...

Page 30: ...absent and the application is started by means of its shortcut a self repair process is started Self repair can only be run under the same user account under which the application was originally installed During self repair the installation re edits the registry re edits or recreates INI files reinstalls all files and re self registers files Self repair works only if the destination computer is ru...

Page 31: ... the end user clicks the shortcut that runs the application the shortcut runs unwise exe the uninstall program with special command line options Unwise exe checks that the required items are present If they are unwise exe opens the application The end user does not see this and if the number of required items is few the extra time to start is negligible If the required items are not present unwise...

Page 32: ...r Adding Language Support WiseScript Package Editor only You can add language support to an installation which provides the text in the installation s user interface elements in a different language Adding Language Support for a Pre Translated Language 1 In Installation Expert Languages page add the language and mark its check box See Languages on page 58 2 If you have added custom dialog boxes to...

Page 33: ...g the Uninstall Dialog Boxes Text for the uninstall dialog boxes is stored in text files in the WiseScript Editor Language subdirectory of this product s installation directory The three letter language codes are used as the file extensions Note Changes that you make to dialog boxes and script action text are added to the current installation only To make the dialog box translations available to f...

Page 34: ...ge Editor only When you complete and compile an installation you can use Package Distribution to share or deploy it by z Copying a Package to the Share Point Directory z Copying a Package to a Network Directory z Copying a Compiled Installation to an FTP Server See these topics in the Wise Package Studio Help ...

Page 35: ... on page 46 z Dialogs on page 46 z Digital Signature on page 47 z File Associations on page 49 z Files on page 50 z Fonts on page 55 z General Information on page 55 z INI Files on page 56 z Installation Log on page 58 z Languages on page 58 z Media on page 60 z Microsoft SMS on page 60 z ODBC on page 61 z Online Registration on page 62 z Password on page 62 z Product Details on page 63 z Progress...

Page 36: ... Using Installation Expert on page 36 Installation Expert does not appear in the embedded WiseScript Editor interface However several Installation Expert pages are needed to provide support for certain WiseScript actions z Compiler Variables z Digital Signature z General Information These pages are provided in the Project Settings view See About the Project Settings View on page 38 Note This docum...

Page 37: ...efine a specific aspect of the installation Examples On the Files page you define what files are included in the installation On the Registry page you define what registry keys and values are created on the destination computer Complete only the pages that are pertinent to your particular installation in any order If required information is missing an error message appears during compile z Use on ...

Page 38: ... Directory page to create a ZAP file You need a ZAP file to distribute EXEs through Microsoft Active Directory The ZAP file is created in the same directory as the installation EXE Microsoft Active Directory uses the information in the ZAP file to distribute the EXE Before you complete the Active Directory page complete the Product Details and Add Remove pages Some of the fields on the Active Dire...

Page 39: ...ct an icon to appear next to the application name in the Add Remove Programs window Click Browse to select a file from the installation z Icon Number Enter the resource index for the icon in the selected EXE or DLL file Note An executable or icon file can contain multiple icons To see the icons in a file go to Windows Explorer right click any shortcut file and select Properties Click the Shortcut ...

Page 40: ...display multiple color images that use different color palettes the colors might not appear correctly To add a billboard 1 Select Installation Expert Billboards page 2 Click Add at the right of the page and specify the billboard graphic file The billboard is added to the list on the Billboards page 3 Double click the billboard The Billboard Settings dialog box appears 4 Complete the dialog box Pat...

Page 41: ...ly during installation mark the Slow Installation Speed check box on the Build Settings page Local Graphic Normally you specify graphic files on your computer which are then compiled into the installation Mark this to specify a file from the destination computer With this option you can use variables in the Pathname field above Example INST to indicate the directory from which the installation EXE...

Page 42: ...wise the end user is notified that the installation cannot be completed and the installation aborts z Convert CD ROM to Floppy When creating a CD based installation you can use the Copy Local Files script action to copy files from the CD to the end user s hard disk rather than embedding these files in the installation EXE Mark this to have these files included in the installation EXE so the instal...

Page 43: ...section to specify a manifest file that indicates the run level for the EXE at run time The manifest file is embedded in the EXE during compile z Add a predefined manifest file for a specific run level Select one of the following options to add a predefined manifest for the user level you specify When you start a new WiseScript as a blank script which is typically a custom action this defaults to ...

Page 44: ... this to generate a SETUP INF file that contains instructions for calling the Microsoft CAB wizard and for copying files to the CAB file The SETUP INF file is part of the CAB file not in the directory structure z Optional SETUP INF Contents Optional Enter or paste additional INF file instructions for running the application Compiler Variables Use the Compiler Variables page to set compiler variabl...

Page 45: ...ariable 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 Compiler Variables page mark one of the following Compiling from Command Line Mark this to be prompted for the value of compiler variables when you compile from the command line Use this for automated build pro...

Page 46: ...ting the first component places an A in the variable the second adds a B and so on You can add up to 26 components this way You can edit the installation script and use conditional statements to determine which files are installed when each component is selected To add a component Select Installation Expert Components page click Add at the right of the page and complete the Component Details dialo...

Page 47: ...ails and attributes 1 Mark the check box next to the name of the dialog box and click Edit 2 In the Custom Dialog Editor edit the dialog See About Dialog Boxes on page 201 The changes you make affect only the dialog boxes in this WiseScript To add a dialog box Click the Add button and complete the Dialog Box Properties dialog See Setting Dialog Box Properties on page 204 Digital Signature Use the ...

Page 48: ...nstallation This is useful if the installation must be digitally signed under a higher security environment by a different individual Extra space is reserved to allow for the digital signature information If an installation does not have extra space approximately 5 K and a digital signature is added errors occur when CRC checks are performed because of the resulting size increase This option elimi...

Page 49: ...g box enter the three character extension that is associated with the program 4 Navigate to and select the EXE to associate with this file type 5 Click OK The new file association appears on the File Associations page To edit an existing file association double click it See Editing File Association Details If you chose an EXE file that is part of an optional installation component the association ...

Page 50: ...ions and icons This information is added to corresponding Installation Expert pages Note If you inadvertently add multiple instances of the same file with the same path only one copy is compiled into the installation EXE Use Script Editor Edit menu Duplicate Files Report to find duplicate files Working With the Files Page The upper two list boxes display the directories and files available to your...

Page 51: ...taining the file or files to add The files in this directory are listed in the upper right list box 5 From the upper right list box select the files to added to the destination directory To add a single file to the destination directory double click the file To add multiple files select them and click Add File 6 To add the contents of an entire directory or to use wildcard filters to add only spec...

Page 52: ... Wildcard To include or exclude files based on specific criteria enter a semicolon delimited list of wildcards Example Enter EXE for all EXE files or DLL for DLL files If you leave the wildcard fields blank all files in the directory are added Include Subdirectories Mark this to add all the subdirectories within the directory you re adding The wildcard settings apply to the subdirectories also Add...

Page 53: ...r installation the prompt does not appear Include Sub Directories If you specify a directory in Source Pathname mark this to include all subdirectories and their contents Shared DLL Counter If this is marked and the file is a DLL or VBX Windows tracks the file to prevent its removal if an installed application is still using it No Progress Bar To hide the progress bar mark this for every file in t...

Page 54: ...e this replaces the existing file if its modification date and time are the same or older than the new file Older For File Version this replaces the existing file if it has a version resource that 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 fil...

Page 55: ...neral 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 Explorer and selecting Properties If you plan to use an automated build system and want to set these values at compile time create compiler variables to set these values and enter the compiler variable name surrounded by percent sig...

Page 56: ... and one command line If you create an INI file to update a system file on the destination computer your settings are merged into the existing system file during the installation Any duplicate settings are overwritten with the values you enter here 7 Click OK To remove an INI file from the installation select it in the list on the right and click Delete To edit an existing INI file select it in th...

Page 57: ...le on the Destination Computer Edit INI File on page 150 Updating an Existing INI File on the Destination Computer WiseScript Package Editor only You can make changes to one or more of the existing system files on the destination system such as the Win INI and System INI file 1 Select Installation Expert INI Files page 2 Select the folder where the existing system file is located 3 Click New File ...

Page 58: ...appears before any of your Install File lines This option is included for backward compatibility z Create installation log in custom directory Mark this to save the installation log in a directory you specify This enables the options for selecting the directory Select a directory and enter a name for the installation log in Install Log File Name Example Install log To create a new directory for th...

Page 59: ...ion of the Display Message action z Always Prompt Mark this to have the installation always prompt the end user to select a language unless there is only one language in the installation To add a language to the installation If the language you need is not listed on the Languages page 1 Click Add on the Languages page The Select Languages dialog box appears which lists the languages that are avail...

Page 60: ... media you are using in this field Microsoft SMS WiseScript Package Editor only If an installation runs in a Microsoft Systems Management Server SMS environment you can have the installation create a status MIF file and a definition file PDF or SMS in the Windows directory during compile Use the Microsoft SMS page to specify the information for the MIF file and package definition file For informat...

Page 61: ...urces that are required by the application on the destination computer To add ODBC driver support select MDAC on the Runtimes page Select Installation Expert ODBC page click Add at the right of the page and complete the Configure ODBC Data Source dialog box z Data Source Name This name will be displayed in the ODBC data sources list on the destination computer The Import button adds an ODBC data s...

Page 62: ...ecify the location of the file that will contain the registration data on the destination computer Use the New Folder button to create a new directory within the Application or Windows directory Enter a name for the file that will contain the registration data Future installations use this file to pre enter the user s registration details such as name and company The end user can still change the ...

Page 63: ...Use the Product Details page to specify the title and the default directory for the installation Select Installation Expert Product Details page and complete the page z Installation Title Enter the name of the application It appears on the background screen and on the dialog boxes during the installation z Default Directory Enter the name of the directory in which your application is installed by ...

Page 64: ...ou can modify the first splash screen that appears when the end user runs the installation or uninstall z Initialization splash screen Choose Custom to modify the splash screen z Initialization BMP File This is enabled when you select Custom from Initialization splash screen Specify the BMP file for the splash screen that end users first see when they run the installation Note If the bitmap file y...

Page 65: ...ting or Editing Registry Key Settings on page 65 Creating or Editing Registry Key Settings WiseScript Package Editor only On the Registry page in Installation Expert you can add new registry keys edit existing registry values and import registry files To add an empty registry key 1 Select Installation Expert Registry page 2 In the lower left list box select the location for the key 3 Click New and...

Page 66: ...ly to the key or its associated value Create update key and value The value is updated if it already exists If the key or value does not exist it is created Create empty key Creates the key but does not add any values Remove key and all subkeys Deletes the key its subkeys and all named values associated with the key and its subkeys on the destination computer Remove key and value only Removes the ...

Page 67: ...fies the value as a series of null terminated strings Type the value as multiple pieces of text and press Ctrl Enter after each one Double word REG_DWORD Identifies the value as a 32 bit number in decimal notation Binary Hex REG_BINARY Identifies the value as a binary in hexadecimal notation Separate each byte by at least one space like the following example AD 30 C0 A9 40 20 A8 FC 4C 00 08 None T...

Page 68: ...untime to add For many runtimes a dialog box then appears where you can specify the version of the runtime or other settings You can edit these runtime settings by selecting the runtime and clicking Details If no dialog box appears when you mark a runtime then that runtime has no settings to edit A description section at the bottom of the Runtimes page provides information on the currently selecte...

Page 69: ...bles page You can assign the variable a value of 1 or 0 If you assign it a value of 1 the SVS Driver is included with the installation If you assign it a value of 0 the driver is downloaded during installation and the size of the installation is reduced significantly See Compiler Variables on page 44 The SVS Driver runtime requires a reboot of the end user s computer after it is installed Design y...

Page 70: ... Gothic z Point Size Specify the point size for text displayed on the installation dialog boxes If you do not specify a point size the standard Windows text size is used z Character Set Enter the number of the character set to be used Use zero which is the default unless the installation is in Japanese For a Japanese installation enter 128 and make sure you have specified MS Gothic in the Message ...

Page 71: ...or information about creating services 3 Complete the dialog box Service Name Enter the internal service name which is used in the registry Display Name Enter the name to appear in the Services control panel Executable Path Specify the complete path to the executable file as it will be on the destination computer Start the path with a variable example MAINDIR Login Username Password Enter the user...

Page 72: ...art Service Select the default setting for starting the service Service Interacts With Desktop Mark this to let the service display its user interface 4 Click OK See also Services on page 70 Shortcuts WiseScript Package Editor only Use the Shortcuts page to add shortcuts to the Startup Group desktop or Start menu of the destination computer If you added program files on the Files page Installation...

Page 73: ...the If System Has Windows 95 Shell Interface statement 3 Complete the dialog box Shortcut Name Enter the name of the shortcut Command Line Options Enter the command line options that are used to open the file associated with the new shortcut Icon Pathname Optional Specify the file that contains the icon to be used for the shortcut Otherwise the target file s icon is used Icon Number Enter the numb...

Page 74: ...stallation file If you specify multiple previous versions they re upgraded no matter what version is on the destination computer Select Installation Expert SmartPatch page and complete the page z Do Not Create SmartPatch Updates Mark this to create a full installation and not use the SmartPatch feature You can also leave this feature off while testing an installation to produce faster compiles z C...

Page 75: ...ftware click Add and specify the directory To remove a path from this list select it and click Delete System Requirements WiseScript Package Editor only Use the System Requirements page to specify minimum hardware and software requirements for the installation and to set warning messages that display to the end user if the destination computer does not meet the requirements To set a system require...

Page 76: ...ion apply only if the destination computer is running one of the following operating systems Windows 95 Window 98 Windows Me If the destination computer is running a version of Windows NT the minimum system requirements specified under the Windows NT Version item are checked instead Windows NT Version The requirements you set for the Windows NT version apply only if the destination computer is run...

Page 77: ... put into MAINDIR If you search for a registry value make sure the registry value contains a valid directory or path If the search finds the registry Value Name its Value Data is put into MAINDIR The items listed on the System Search page display the search methods for finding the old version of the application The installation performs the searches in the order listed until one is successful It t...

Page 78: ...earching for INI Values WiseScript Package Editor only On the System Search page you can set up a search for a value in an INI file on the destination computer Use this only to get an INI value that you know to be a valid path on the destination computer INI File Terminology z An INI file consists of sections with the following syntax DirectoriesAndFiles SrcDir E Application SrcFiles E Application...

Page 79: ... System Search on page 77 Searching for Registry Values WiseScript Package Editor only On the System Search page you can set up a search for a registry value on the destination computer Use this only to get an INI value that you know to be a valid path on the destination computer 1 Select Installation Expert System Search page 2 Click Add at the right of the page and select Read Registry Value The...

Page 80: ...ttom colors for the background gradient The uninstall generates a smooth transition between the two colors Uninstaller Font Specify the font to be used If you do not specify a font a standard sans serif font is used For a Japanese installation specify MS Gothic Point Size Select the point size for text displayed on the installation dialog boxes If you do not specify a point size the standard Windo...

Page 81: ...programs are executed Click OK 6 On the Uninstall page mark Delete in use files during uninstall to delete even those files that are in use when the uninstall program is running See also Uninstall on page 80 WebDeploy WiseScript Package Editor only The WebDeploy page provides an efficient method for creating true Internet based installations for your application It creates a small stub installatio...

Page 82: ...ation files to the Web server z Notify end users of the Web link to the EXE Your Computer Your Internet Host FTP HTTP Server z Contains the installation The installation is copied to the host but is not used yet The installation and its pieces are stored in an EXE file plus files named 001 002 and so on Phase 1 Upload files through FTP HTTP Protocol Destination Computer Phase 2 The end user z Runs...

Page 83: ... sure that only users with the installation stub EXE can access them Because everyone with a copy of the installation EXE uses the same user name and password this is not suitable for tracking individual user access to the Web site Host Directory Enter the path to the WebDeploy files stored on the server File Transfer Via Select how to transfer the files HTTP Protocol This option is more universal...

Page 84: ...y FTP client To upload a WebDeploy installation with an FTP client 1 Verify that a directory exists on the Web server at the address you specified on the WebDeploy page 2 Using an FTP client upload the installation files 3 Distribute the installation media or notify your end users of the Web link to the EXE To test the installation After the files are uploaded to the server you can test your appli...

Page 85: ...e destination computer is started or an end user logs on to Windows WiseUpdate Client checks for newer versions of your application at the Web location you specified If it finds a new installation it downloads and runs it WiseUpdate by itself does not deploy the current version of your application it simply adds a Web based update mechanism to your end users computers The first time you configure ...

Page 86: ...pplication directory A shortcut to WiseUpdate client is placed on the destination computer Destination Computer 3 Upload to the Web server WiseUpdate update file Installation files and Readme Your Web Server FTP HTTP z Contains the WiseUpdate update file that stores The new version number URLs to the new installation files z Contains the new installation files and Readme Phase 3 When you update yo...

Page 87: ...te Page on page 87 4 When the installation is tested and ready for distribution upload the installation files the Readme file and the update file to a Web server See Uploading WiseUpdate Files With an FTP Client on page 90 Warning If you do not upload the files before deploying your application to end users an error occurs when they check for upgrades 5 Test the WiseUpdate process See Testing Wise...

Page 88: ... basic HTTP authentication Host Password If necessary enter the password that s required to connect to the host address Enter this only if the Host Username is entered above Host Directory Enter the directory on the Web server where you plan to store updated installation files including the WiseUpdate update file To put the files in the root directory of the host leave this blank If you are workin...

Page 89: ...d or the end user logs on to Windows the shortcut runs WiseUpdate Client according to the Check Interval days setting described above If you do not mark this check box then WiseUpdate Client will never run on the end user s computer unless you code your application to run it See Options for Running WiseUpdate Client on page 91 About the WiseUpdate Update File WiseScript Package Editor only On the ...

Page 90: ...eUpdate process To test how WiseUpdate works when an update is not needed In this test the end user s version of your application matches the version on the Web server 1 Install the first version of your application on a testing computer not your development computer 2 On the testing computer open your application s installation directory and double click the file WiseUpdt exe Normally this file i...

Page 91: ...successful try to determine the problem See WiseUpdate Tips on page 92 and Troubleshooting WiseUpdate on page 93 If you see the Web page you entered in the Alternate Web Page field on the WiseUpdate page then there was a problem connecting to the host through HTTP or the necessary files were not found on the host Options for Running WiseUpdate Client WiseScript Package Editor only Options on the W...

Page 92: ... runtimes examples Windows Installer or NET runtimes WiseUpdate always tries to open the EXE not the MSI Follow these guidelines z The EXE of the MSI EXE pair must be located somewhere on the Web and must be accessible to WiseUpdate users It cannot be distributed through email or other mechanisms z On the WiseUpdate page the connection information you enter must point to the location of the WiseUp...

Page 93: ...es HTTP to connect to the Web server specified on the WiseUpdate page You typically use the FTP protocol to upload the installation EXE an optional Readme file and a WiseUpdate update file Both operations access the same location on the same server Therefore both protocols must have access to the directory and the host must be able to process both HTTP and FTP requests Also the Host Directory the ...

Page 94: ...sh like statements You compile the script along with files and other resources into an EXE When the EXE is run the script runs executing the actions that are specified in the script In WiseScript Package Editor every installation is driven by a script that specifies how to display dialog boxes edit the INI files add registry entries and so on The script provides another way of looking at the insta...

Page 95: ... Installation Title field on the Product Details page followed by Installation If you change the title of the script here it does not change on the Product Details page When you run the installation this name appears at the top of the splash dialog box the Initializing Wise Installation wizard dialog box and in the title bar of the installation screen Event From this drop down list you select the ...

Page 96: ...ctions the Favorites group displays some of the most commonly used actions while the Custom group is by default empty You can also create your own action groups See Customizing the List of Actions on page 97 Script List This list contains the script that is executed when an end user runs the EXE For information on working with scripts see Adding an Action to a Script on page 99 and Editing Scripts...

Page 97: ...lude in the group and click OK The new action group appears with the actions you selected To edit an action group 1 Click the title bar of the action group You cannot edit or remove the All Items group 2 Right click below the action group title bar and select Add Remove Items The Select Items for Group dialog box appears 3 Add delete or move group items and click OK You can customize the Actions l...

Page 98: ...n develop a library of WiseScripts that perform very specific functions You can re use these specialized scripts in future installations and easily share them with colleagues WiseScript Package Editor only By default all scripts based on the Empty Project template on the New Installation File dialog box contain two include scripts rollback wse and uninstal wse The rollback wse script is in the Can...

Page 99: ...eters When you add a Custom Dialog or Custom Billboard action the appropriate editing environment opens Some actions come in pairs Example When you add an If action you must also add an End action at the end of the condition block Script Editor indents actions inside these pairs Use the same methods to add an action to a VBScript See VBScript Actions on page 159 Editing Scripts To edit a WiseScrip...

Page 100: ...nt 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 This text file is for viewing and printing only You cannot make changes in the text file and import it back into Script Editor 1 Select File menu Save Script Text to File 2 Specify the location and name of the file Finding and Repl...

Page 101: ...inInstall wse script See also Include Script on page 172 The Script Editor Window on page 95 About Script Editor on page 94 About User Defined Actions You can streamline your development process by creating your own script actions for tasks that you perform frequently Example You have written a section of script that opens a Web page on your company s Web site Some of the script lines search the r...

Page 102: ...ing a User Defined Action This procedure describes the general steps for creating a user defined action It does not contain details on what kind of action to create or what to enter for the parts of the user defined action For an example of how to complete these details see Creating a User Defined Action Tutorial on page 103 To create a user defined action 1 Select File menu New 2 WiseScript Packa...

Page 103: ...s in the Actions list in Script Editor until you close and re open WiseScript Package Editor 8 Test the new user defined action a Close WiseScript Package Editor b Open WiseScript Package Editor and select File menu New Empty Project c In Script Editor double click your user defined action in the Actions list If it includes a dialog box the dialog box opens Complete the dialog box and click OK d S...

Page 104: ... 4 Click on the toolbar The Text Control Settings dialog box appears 5 In Text enter Milliseconds to Wait and click OK 6 Click on the toolbar The Edit Text Control Settings dialog box appears 7 Enter the following on the dialog box and click OK In Default enter WAIT_TIME In Variable enter WAIT_TIME 8 Click on the toolbar The Push Button Control Settings dialog box appears 9 Enter the following on ...

Page 105: ... the DLL Parameter Settings dialog box that appears and click OK From Parameter Type select dword From Value Source select Constant In Constant Value enter WAIT_TIME 4 Click OK on the DLL Parameter Settings dialog box 5 Click OK on the Call DLL Function dialog box 6 In Title located above the Actions list enter Wait WAIT_TIME Milliseconds This determines how the script line looks in the script 7 S...

Page 106: ...gation bar or by using the more flexible capabilities of the Script Editor debug commands The Debug menu in Script Editor has a set of debug commands that let you step through your script to make sure it functions properly or run to a breakpoint to view the script and the values of variables When you use Debug menu in the VBScript window it tests only the VBScript not the entire script See Debuggi...

Page 107: ...version with Display Message actions You add the Display Message script lines to your script to check the value of a variable or display other relevant information You then put this script inside a Compiler Variable If block that lets you customize your installation EXE at compile time Each time you compile the installation you are asked whether to create a debug version If you choose not to creat...

Page 108: ... Value enter YES Display Message In Message Title enter Main Directory In Message Text enter The Main Directory is MAINDIR Compiler Variable End The following lines should appear in your script Set Variable MAINDIR to Application If Compiler Variable _DEBUG_ Equals YES then Display Message Main Directory Compiler Variable End 7 Click Test to test your debug version A message asks if you want to co...

Page 109: ...prompt until the data entered is appropriate If While and End Actions Because a condition or loop can apply to more than one script action they are defined using at least two statements one to mark the beginning of the block of script and the other to mark its end The standard action for beginning a condition is the If action and the standard action for beginning a loop is the While action The end...

Page 110: ...etter z Must be 28 characters or less z Cannot begin with an underscore character only compiler variables can start with an underscore character z Cannot contain characters except when using substitution as described below Variables and Substitution By using variables the installation EXE can adapt to each destination computer Once information is stored in a variable it can be used in most script ...

Page 111: ...settings file an INI file or the registry The difference between compiler variables and run time variables is similar to the difference in C programming between preprocessor variables and C language variables Preprocessor ifdef statements determine which code is compiled C language If statements determine which code is executed at run time In Conditions and Expressions You can use both types of va...

Page 112: ...ariable z When a script action places a value into a variable use a run time variable Compiler variables can t be changed by scripts but only by the person who builds the installation EXE z In most other instances the type of variable to use is implicit example the Compiler If script action requires a compiler variable or is noted explicitly Anatomy of an Installation Script An installation script...

Page 113: ...log boxes that are created by Installation Expert place the correct values in the COMPONENTS variable You also can use the Select Components script action or a custom dialog box to accomplish the same result In the installation script use condition statements of the form If COMPONENTS contains A to determine which files are installed when each component is selected Script Editor scans the script l...

Page 114: ...on on page 124 z Capture Application to SVS Layer on page 129 z Change SVS Layer GUID on page 130 z Check Configuration on page 130 z Check Disk Space on page 131 z Check HTTP Connection on page 133 z Check If File Dir Exists on page 134 z Check In use File on page 135 z Check Service on page 135 z Compiler Variable Actions on page 135 z Config ODBC Data Source on page 136 z Copy Local File s on p...

Page 115: ...n page 155 z Evaluate Windows Installer Condition on page 156 z Execute Program on page 156 z Execute VBScript on page 157 z Exit Installation on page 162 z Export SVS Layer on page 162 z Find File in Path on page 163 z Find First SVS Layer on page 163 z Find Next SVS Layer on page 164 z Find SVS Layer GUID on page 164 z Get Environment Variable on page 165 z Get Name Serial Number on page 165 z G...

Page 116: ...Value on page 186 z Read Update Text File on page 186 z Read Write Binary File on page 187 z Reboot System on page 188 z Register Font on page 188 z Remark on page 188 z Remove SVS Exclude Entry on page 189 z Rename File or Directory in SVS Layer on page 190 z Rename File Directory on page 189 z Rename SVS Layer on page 190 z Search for File on page 191 z Self Register OCXs DLLs on page 192 z Set ...

Page 117: ...t Editor contains the same scripting interface as WiseScript Package Editor but it does not contain the Installation Expert interface or other installation development tools Therefore some of the information in this document does not apply to WiseScript Editor 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 ...

Page 118: ...ation to SVS Layer z Change SVS Layer GUID z Create Directory in SVS Layer z Create Shortcut in SVS Layer z Delete File from SVS Layer z Edit Registry in SVS Layer z Remove SVS Exclude Entry z Rename File or Directory in SVS Layer z Rename SVS Layer z Set SVS Exclude Entry Script Actions for Finding a Layer Use these script actions to find a layer s GUID You then store the value of the GUID in a v...

Page 119: ...te SVS Layer on page 144 and Find SVS Layer GUID on page 164 See also About SVS Script Actions on page 117 Add Directory to PATH This action adds a directory to the PATH environment variable as set in Autoexec bat The directory is appended to every occurrence of the SET PATH statement that does not already contain it A SET PATH statement is added if none exists The system restarts at the end of in...

Page 120: ...ckage Editor only Use the Installation Log page to control the creation and location of the installation log By default it is created in the application directory MAINDIR See Installation Log on page 58 WiseScript Editor Use the Open Close Install log action to create the installation log See Open Close Install log on page 181 As the installation runs on the destination computer each action it per...

Page 121: ...in a specified directory Use this option with caution because end users might have stored their own files in the directory You can use Windows standard wildcard notation example for all files Type the following as Log Text substituting your own directory path case sensitive File Tree MAINDIR Data Temp If you want the uninstall to remove not only the registry keys that were installed but also keys ...

Page 122: ...d in place but inactive If this is the case set Insert Action to insert before the existing line so that a subsequent installation finds and edits the active command not the commented line z Insert Action Select where to insert the new line in relation to the found line z Match Criteria Select how the found line matches the Search for Text z Ignore White Space Mark this to ignore spaces and tab ch...

Page 123: ...s z Case Sensitive Mark this to match case z Make Backup File Mark this to make a copy of Config sys before editing it Add to SYSTEM INI Windows 3 1x or Windows 9x only This action adds a device entry to the 386Enh section of the System ini file The destination computer is restarted automatically to force the new device driver to be loaded Do not use this action to modify the display driver displa...

Page 124: ... Start Block if Return Value True or Start While Loop When a WiseScript is called by a Windows Installer installation you can also call a DLL by using one of the Call Custom DLL or Call DLL actions in MSI Script in Windows Installer Editor To complete the dialog box z DLL Pathname Specify the path of the DLL file example MAINDIR Jso32 dll For non system DLLs the installation script must install th...

Page 125: ... DLL call are executed repeatedly until the DLL function returns zero z Perform while loop at least once If you select Loop while function returns true mark this to force the loop to execute once before the test is performed If the check box is cleared the loop is executed if the condition is true but is not executed if the condition is false z Call a function with variable parameter list Enables ...

Page 126: ...type To complete the dialog box z Parameter Type Check the table below for alternate names for data types WiseScript Corresponds to Win32 SDK type Corresponds to Visual Basic type Description short SHORT Integer 16 bit signed integer data type word WORD Integer 16 bit unsigned integer data type long LONG LRESULT BOOL Long Boolean 32 bit signed integer data type dword DWORD Use this for any paramet...

Page 127: ...urce is set to Constant enter a constant here You can enter a variable here example NUMUSERS Note WiseScript Package Editor maintains backward compatibility with DLLs written specifically for the API available in previous versions so that you can continue to use older scripts with the new WiseScript Package Editor Because future versions of WiseScript Package Editor might not support this API it i...

Page 128: ... function is a simple integer indicating success or failure The function accepts three parameters a structure that contains three elements an integer and another structure that contains two elements The calling statement for the DLL is int NewEmployee EMPLOYEE int DEPARTMENT where EMPLOYEE is a pointer to a structure int is a simple integer and DEPARTMENT is a pointer to a structure In this exampl...

Page 129: ...s For information on creating a variable for a layer s GUID see Create SVS Layer on page 144 and Find SVS Layer GUID on page 164 z Program path Specify the path and file name of the EXE When the WiseScript runs it executes the EXE and captures whatever it installs To capture an MSI enter the path to msiexec exe You can use WiseScript variables z Parameters Optional Enter parameters for running the...

Page 130: ...ts 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 117 Check Configuration This action tests the hardware configuration operating system and other characteristics of the destination computer As a result of this check the action can display a message halt the ...

Page 131: ...user selects to install You would use this action only if the WiseScript contains Install File s actions that install files permanently on the destination computer If you add components on the Components page the Files page shows an Always Installed folder and other component folders Note When a WiseScript is used in a Windows Installer installation an alternative to using the Check Disk Space act...

Page 132: ...called by a Windows Installer installation the Check Disk Space action only checks disk space for files installed by this WiseScript In other words the WiseScript EXE and the Windows Installer installation are unaware of each other s disk space requirements To avoid erroneous disk space estimates by either the WiseScript EXE or the Windows Installer installation place the Run WiseScript custom act...

Page 133: ...TML page If the installation is not true 32 bit specify both Win16 and Win32 error variables Then the Win32 WinSock dll is used followed by the Win16 WinSock dll Otherwise only the 32 bit version is used If the download is successful the Win32 Error Number Variable or Win16 Error Number Variable is set to 0 which indicates success If an error occurs the number variable is set to another error code...

Page 134: ...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 loaded enter just the DLL name not a path To check if a DLL is loaded in a specific directory include the full path Example To determine if any User32 dll is loaded just specify user32 dll To determine if c Windows System32 User32 dll is loaded s...

Page 135: ... if a particular service is running To complete the dialog box z Variable Select or enter a variable in which to put the status of the service Possible return results are Unknown Running Stopped Paused StartPending StopPending ContinuePending or PausePending Unknown means the service was not found or the current user does not have privileges to query the service If the status ends with the word Pe...

Page 136: ...mpiler variables on the Compiler Variables page The second list shows available comparisons The Value Enter the value to be used in the comparison This is case sensitive Do not enter variables in this field because it checks your computer in real time not run time If you selected File Exists above the If statement checks to see if the file that you enter in The Value exists If you selected File Ve...

Page 137: ... File s This action copies uncompressed files from a floppy disk CD the destination computer or a network drive In WiseScript Package Editor it also can copy files from an FTP or HTTP server 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 t...

Page 138: ...r only 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 prompt does not appear z Include Sub Director...

Page 139: ... the existing file if it has a version resource that 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 featu...

Page 140: ... directory to create You can use SVS variables or WiseScript variables that resolve to a valid SVS path See SVS Variables on page 250 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 117 Create Service This action installs a Windows service on operating system...

Page 141: ...he last known good configuration startup fails Otherwise it restarts with the last known 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 ther...

Page 142: ...se it in quotation marks z Destination Path Enter the path to the shortcut to be created which should end in LNK example GROUP Application lnk For the current user s desktop Start menu or Startup 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 o...

Page 143: ...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 144 and Find SVS Layer GUID on page 164 z Shortcut Name Enter the name to appear on the shortcut z Source Path Specify the path of a file that will be installed on the destination computer You can only use an SVS variable ...

Page 144: ...er You can then use the Capture Application to SVS script action to add an application to the layer or use other SVS script actions to add directories files registry keys and shortcuts to the layer The action creates a layer that requires a licensed version of the SVS Driver on the destination computer This script action can create a variable for the layer s GUID You can use this variable in most ...

Page 145: ...02 For details on the Dialog Box Properties dialog box see Setting Dialog Box Properties on page 204 For details on sample scripts that use this action see ScriptHelp htm in the Samples subdirectory of this product s installation directory Deactivate SVS Layer This SVS script action deactivates a virtual software layer To complete the dialog box z Layer GUID Enter the layer s GUID globally unique ...

Page 146: ...can use SVS variables or WiseScript variables that resolve to a valid SVS path See SVS Variables on page 250 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 117 Delete File s This action removes files from the destination computer You do not need to delete te...

Page 147: ...ayer s GUID do not include the brackets For information on creating a variable for a layer s GUID see Create SVS Layer on page 144 and Find SVS Layer GUID on page 164 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 117 Display Billboard WiseScript Package Edi...

Page 148: ...aphics from the screen before displaying the new one z Timed Display Mark this to display a series of graphics at evenly spaced intervals which is calculated by the number of files to be installed Place all Display Billboard actions before the first Install File s action if you are using Timed Display z Local Graphic Normally you specify graphic files on your computer which are then compiled into ...

Page 149: ...ckDiskSpace wse and Search wse use this action For details on sample scripts see ScriptHelp htm in the Samples subdirectory of this product s installation directory Display Progress Message This action displays a small dialog box during installation typically to indicate the computer is still working during a long operation The dialog box cannot be closed or cancelled Also use this action to remov...

Page 150: ... tabs of Setup Editor in Windows Installer Editor 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 in the Windows Install...

Page 151: ... 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 Registry Keys click the New Key button and select Key from the drop down A dialog box appears where you enter informa...

Page 152: ...ect the operation to apply to the key or its associated value Create update key and value The value is updated if it already exists If the key or value does not exist it is created Create empty key Creates the key but does not add any values Remove key and all subkeys Deletes the key its subkeys and all named values associated with the key and its subkeys on the destination computer Remove key and...

Page 153: ...efix Identifies a value entry as a multiple string These are multiple pieces of text separated by carriage returns Double Word REG_DWORD prefix Identifies a value entry as a 32 bit DWORD entry Binary Hex REG_BINARY prefix Identifies a value entry as binary Each byte should be separated by at least one blank space For instance AD 30 C0 A9 40 20 A8 FC 4C 00 08 None This is provided for compatibility...

Page 154: ... destination computer If the key already exists this action might add a value to it update it or delete it and all its associated values z Delete Key Removes the selected key from the current installation This does not remove it from the destination computer To 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 Regist...

Page 155: ... 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 conventions for WiseScript expressions See Variables and Expressions on page 110 The variable is ignored and can be left blank The result is considered true if it evaluates to a non zero result Valid Password and Invalid Password evaluat...

Page 156: ...taller You can either enter the literal condition or use WiseScript variables enclosed in percent signs See also Get Windows Installer Property on page 169 Set Windows Installer Property on page 197 Execute Program This action runs another EXE The EXE can be a file that is already installed on the destination computer a file you installed as part of the installation or a file you provide on a sepa...

Page 157: ...on sms Note This action uses the Windows ShellExecute call which means that you can open documents as well as applications When the script opens a document the associated application starts The sample scripts FTPCopy wse and Newdisk wse use this action For details on sample scripts see ScriptHelp htm in the Samples subdirectory of this product s installation directory Execute VBScript This action ...

Page 158: ...ple scripts see ScriptHelp htm in the Samples subdirectory of this product s installation directory Editing a VBScript When you use the Execute VBScript action in a WiseScript a new tab appears at the bottom of the Installation Script pane When you click this tab the VBScript window appears In this window you can create and edit the VBScript The window is similar to a WiseScript window but has fun...

Page 159: ...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 version to undo any changes you made since you last saved Debugging a VBScript When you use the Execute VBScript action in a WiseScript a new tab appears at the bottom of the Installation Script pane When you click this tab the VBScript ...

Page 160: ...one editor window you will not automatically see its properties and methods in a second window even though they will execute properly See Calling a COM Object in a VBScript on page 161 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 161: ...wse Typelib Information dialog box appears It lists TypLib information for all the objects registered on your computer 5 Do one of 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 unregis...

Page 162: ... already set the value in WISE_ERROR_RTN does not override the Application Exit Code but is written to the installation log See Run time Variables on page 248 z Install Status MIF WiseScript Package Editor only This section is available only if you have entered Status MIF information on the Microsoft SMS page MIF Text This text is added to the Status MIF file when this action is executed Success F...

Page 163: ...found To use an If statement that tests the variable leave this blank so it evaluates to false To install a new version of the file specify the file s typical location here Then if the file is found the location replaces the default value but if it is not this default value is used to install the file z Description Enter text to display if the find operation takes more than 1 5 seconds to complete...

Page 164: ...ox z Layer GUID Variable Enter a name for a variable in which to place the layer s GUID 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 117 Find SVS Layer GUID This SVS script action finds the GUID of a virtual software layer and creates a variable for this G...

Page 165: ...D in the EXE Path field Specify the file to open in the Command Line field Add the c command line option to cause the command line window to close when your program finishes execution Get Name Serial Number This action displays a dialog box that requests the end user s name company name and a product serial number It provides backward compatibility with older WiseScripts In new scripts use the Bra...

Page 166: ...nd Environment Variables If you read a REG_EXPAND_SZ value mark this to have all environment variables in the registry value replaced with their actual values The sample script URL wse uses this action For details on sample scripts see ScriptHelp htm in the Samples subdirectory of this product s installation directory Get SVS Layer Info This action retrieves information about an SVS layer on the d...

Page 167: ... the registry key where layer attributes are stored is placed in this variable These attributes include information such as the layer s name and GUID z File Redir Path Variable The file redirect path where the layer s files are stored is placed in this variable z Reg Redir Path Variable The registry redirect path where the layer s registry keys are stored is placed in this variable z Creation Acti...

Page 168: ... Drive The letter of the first network drive followed by a colon If there are no network drives the response is blank First CD ROM Drive The letter of the first CD ROM drive followed by a colon If there is no CD ROM drive the response is blank Win32s Version The version number of the currently running Win32s system in format or blank if Win32s is not installed Full UNC Pathname The UNC path of the...

Page 169: ...on on files or directories Specify the full path of the file or directory to retrieve information from You can use variables example MAINDIR Readme txt You also can enter a hardcoded path example C Program Files File exe but it is not recommended The sample script Autoplay wse uses this action For details on sample scripts see ScriptHelp htm in the Samples subdirectory of this product s installati...

Page 170: ...ation on other computers if they lack correct runtime files because the resulting installation could damage runtime installations on destination computers You do this by adding a Compiler Variable If Else End block You get the file version of a key runtime file using the file version option of a Compiler If statement Then if the file version is not the one the script requires use the Halt Compilat...

Page 171: ... and 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 See also Else Statement on page 155 ElseIf Statement on page 155 End Statement on page 155 Import SVS Layer This SVS script action imports a virtual software archive file VSA into an SVS layer To activate the layer after...

Page 172: ...ins the default script which is designed to perform an installation The combined script would then have two wizard loops two of every dialog box and so on Only the script is inserted into the calling script Any configuration in Installation Expert is ignored including compiler variables that are defined on the Compiler Variables page To complete the dialog box z Pathname Specify the path of the sc...

Page 173: ... in the Search for Existing Text area overrides any line number that is specified here unless the text is not found z Search for Text Enter the text to search for If more than one line in the file matches only the first is edited z Comment Text Enter comment to insert at the beginning of the found line When replacing an existing line use this to leave the existing line in place but inactive Set In...

Page 174: ...e the dialog box z Source Pathname Specify the path of the file on your computer You can use wildcards in this field to indicate that all the files in a directory that match a certain pattern should be installed example C Dev exe You can also use compiler variables but you should not use run time variables because this field is used at compile time z Destination Pathname Specify the path the file ...

Page 175: ...arate file z Repair application if this file is missing WiseScript Package Editor only Mark this to start self repair if this file is missing when the application starts This prevents your application from failing if this file is accidently deleted For information on setting up self repair see Using Self Repair on page 30 z Replace Existing File Select when to replace existing files on the destina...

Page 176: ...se button to create a list of files that are older versions of the file or files being installed See also Files on page 50 Install SVS Package WiseScript Package Editor only This action installs a Virtual Software Package VSP on a destination computer You can use this action to create a WiseScript that installs any number of VSPs The computer on which this action runs must have a licensed version ...

Page 177: ...e Install WiseUpdate Client action See About WiseUpdate on page 85 To complete the dialog box z Host Address Enter the Web server address or IP address where the WiseUpdate Client looks for updated software example www company com or 1 1 1 1 The WiseUpdate Client on the destination computer uses this information when it checks for updates Note The host must be accessible through both FTP and HTTP ...

Page 178: ...tting it runs with its normal interface and prompts the end user to check for updates About Windows Mobile Installations The Microsoft Windows Mobile platform supports Pocket PC and Smartphone devices A Windows Mobile device installation consists of a single self extracting CAB file and an optional Setup dll file The CAB file contains all the resources files registry keys and shortcuts that compri...

Page 179: ...e Application script action and specify the CAB files to add 3 Finish assembling the WiseScript Any resources that you add to the WiseScript other than those in any Install Windows Mobile Application script actions are installed on the desktop computer not the mobile device 4 Compile the WiseScript The CAB files are included in the compiled EXE Also an INI file that describes the CABs is created a...

Page 180: ... the mobile device installation immediately following the desktop installation See also Process for Adding Mobile Device Support to a WiseScript on page 179 Modify Component Size For files within the installation EXE the amount of required disk space is automatically tracked However if you call external EXEs that install more files the space those files require is not accounted for Use this action...

Page 181: ...ies into installation log This must be followed at some point by another Open Close Install log action that resumes writing or no log file is created z Open new installation log Mark this to create an installation log Then enter the complete path or just the file name of the new log to the right examples MAINDIR Speciallog log or Speciallog log If just a file name is entered the log is written to ...

Page 182: ...k this to remove leading and trailing spaces from both destination variables z Ignore Case Mark to make pattern matching case insensitive The sample scripts TextFile wse and URL wse use this action For details on sample scripts see ScriptHelp htm in the Samples subdirectory of this product s installation directory Pause This action temporarily stops a script from executing After the specified numb...

Page 183: ...ination computer must have a valid Internet connection If end users might not have this capability you can add a prompt on a dialog box asking the end user if they have Internet connectivity Then use the results from the prompt to run this action or not To complete the dialog box z Destination URL Enter the URL of the CGI program or ASP page that accepts posted data z Text to Post The text to post...

Page 184: ...th of the file or directory the end user selects z Default Extension Enter the extension to append to the file name if the end user does not enter one z Filter List Enter the file types to appear in the Files of Type drop down list in the Open or Save dialog box Use Shift Enter to enter a carriage return in this field Example to show text JPGs and bitmaps enter Text Files txt txt Pictures jpg jpg ...

Page 185: ...lete trailing backslashes from the text so you can use it as a directory path z Confirm If Exists If this check box is marked and the end user enters the path of an existing file or directory a dialog box asks whether to overwrite The sample scripts Adding wse Comcat wse Division wse Instr wse Lcase wse Left wse and Len wse use this action For details on sample scripts see ScriptHelp htm in the Sa...

Page 186: ...e 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 performed on the Default Value Read Update Text File This action begins a loop that reads and optionally updates text in a text file Each loop puts the next line of text into a variable You can put actions in the loop that change the conte...

Page 187: ...rites 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 above 127 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 des...

Page 188: ... 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 must already have been installed in the font directory on your computer and the font s file name must match its internal name z Font Name Enter the full n...

Page 189: ...see Create SVS Layer on page 144 and Find SVS Layer GUID on page 164 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_FILE...

Page 190: ...le 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 250 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 250 z Return variable Optional Enter a ...

Page 191: ...y the 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 d...

Page 192: ... file 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 incl...

Page 193: ...is product 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 ...

Page 194: ...which 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 w...

Page 195: ...e files 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 189 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 n...

Page 196: ...nverts 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 110 z...

Page 197: ...r executables 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...

Page 198: ...on 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 down ...

Page 199: ...inues executing inside the wizard loop until the last dialog box has been completed and accepted WiseScript Package Editor only Installation Expert creates default Wizard Loop and Custom Dialog actions for you Use this script action to customize the existing structure WiseScript Editor Use this script action to create the wizard loop To complete the dialog box z Dialog Boxes Displays a list of the...

Page 200: ...in the Value field below is evaluated according to the rules outlined in Variables and Expressions on page 110 The 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 applicable in WiseScript Package Editor only ...

Page 201: ...vide translations for dialog boxes in the installation See Adding Language Support for a New Language on page 32 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 Note This documentation covers both WiseScript Package Editor and WiseScript Editor WiseScript Editor contains the same scripting int...

Page 202: ... create a new dialog box 1 Do one of the following WiseScript Package Editor only Select Installation Expert Dialogs page select a dialog box name and click Add The new dialog box is placed before the dialog box that you selected In Script Editor double click the Custom Dialog script action in the Actions list The Dialog Box Properties dialog box appears 2 Enter a title for the dialog box in Dialo...

Page 203: ...dit In Script Editor locate and double click the Custom Dialog script line that calls the dialog box The dialog box opens in the Custom Dialog Editor 2 Make changes to the dialog box by adding editing or removing controls See Adding and Editing Dialog Box Controls on page 206 See Aligning and Spacing Dialog Box Controls on page 222 3 Select File menu Save Changes and exit See also Editing Dialog B...

Page 204: ... Title Enter the title for the dialog box Font Name Font Size Enter the exact name of a font and a point size This font type and size is applied to any text whose font attribute is set to Default Font When you add or edit a text box you can set the font to the default or override the default with a customized font Width Height Enter the dialog box size in points All dialog boxes in a wizard loop m...

Page 205: ...le bitmap graphic See Adding Graphic Controls on page 211 Group Box A boundary box drawn around related controls See Adding Group Box Controls on page 212 Hot Text Text that you can link to actions or a Web page See Adding Hot Text Controls on page 212 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 214 Play AVI An an...

Page 206: ...e control to open its settings dialog box Adding Check Box Controls Like radio buttons a group of check boxes is considered a single control However unlike radio buttons the end user can select multiple check boxes Alignment and spacing between the individual check boxes is maintained by the Custom Dialog Editor Check boxes are often used to control the installation of components or sub components...

Page 207: ...log 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 not as precise Components If this is marked the sizes of the components that correspond to the variable specified are displayed to the right of th...

Page 208: ...oups Mark this to have the items in the Programs group of the Windows Start menu appear in the combo box Drive List Mark this to display the end user s available drives in the combo box The value returned is a letter and a colon example C Directory 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 th...

Page 209: ...ecise Note A combo box field should be at least as wide as the longest option in the list Adding Edit Text Controls An edit text control lets the end user enter and edit text information You can also use it to display text example license agreements or ReadMe files 1 Open the dialog box in the Custom Dialog Editor See Editing Dialog Boxes on page 203 2 Select Add menu Edit Text The Edit Text Contr...

Page 210: ...Tab key to give focus to this field Make sure this is marked for input fields RichEdit Mark this to support rich text objects example formatted text bold italic font size variations and colors This causes rich text files to display properly Read Default Text from File Enter the path of a text file This path should be relative Use variable substitution example MAINDIR to refer to the destination di...

Page 211: ...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 Do not resize bitmap graphic Normally graphics are resized if the dialog box needs to be made larger example if the destination computer uses a larger font size Mark this check box to keep the graphic at the same size regardless of the system settin...

Page 212: ...cify 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 222 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 h...

Page 213: ...alog Displays the selected dialog box from the current set Abort Installation The end user is asked to confirm that the installation should be aborted Display Help Context If the HELPFILE variable points to a valid copy of a Windows help file the specified numeric help context is displayed Execute Program Starts another application or links to a Web page Click Edit to specify and configure the app...

Page 214: ...ing 4 Click OK Adding List Box Controls A list box is a list of values from which the end user can choose The control can return either the actual string the end user selected or its position in the list as a letter If it returns letters it returns A if the first item is selected B if the second item is selected and so on 1 Open the dialog box in the Custom Dialog Editor See Editing Dialog Boxes o...

Page 215: ...he item text itself Don t Append Mark this to not append the Program Files directory name to the Destination Directory selected by the end user 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 Components To create named compo...

Page 216: ...is control with a script 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 222 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 fo...

Page 217: ...uttons on wizard dialog boxes do not use this option They are controlled by the Wizard Loop script action If this is the first dialog box in the set it returns to the installation script Return to Script Returns to the installation script even if this dialog box was called from another dialog box in the dialog box set Display Dialog Displays the selected dialog box from the current set Abort Insta...

Page 218: ... can select only one button from the group Alignment and spacing between the individual buttons is maintained by the Custom Dialog Editor 1 Open the dialog box in the Custom Dialog Editor See Editing Dialog Boxes on page 203 2 Select Add menu Radio Button The Radio Button Control Settings dialog box appears 3 Complete the dialog box Radio Button Text Enter the text options for the radio buttons on...

Page 219: ...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 not as precise 4 Click OK The sample script License Agreement wse uses scripting to handle radio button controls For details on sample scripts see ScriptHelp htm in the Samples subdirectory of this product s installation directory Adding Rectangle ...

Page 220: ...s which means that the end user cannot change them 1 Open the dialog box in the Custom Dialog Editor See Editing Dialog Boxes on page 203 2 Select Add menu Text Control The Text Control Settings dialog box appears 3 Complete the dialog box Text Enter the text up to a maximum of 511 characters To start a new line press Ctrl Enter Enter variable names surrounded by percent signs to display the appli...

Page 221: ... space requirements for the currently selected component set Disk This variable represents the Disk Space Remaining on the installation drive Select the MAINDIR variable as it keeps track of free space in the installation directory 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 bo...

Page 222: ...t variables that were added by the executable program using a DDE link are displayed Note This field is retained for backward compatibility only Window Size You can force the application to run in a maximized or minimized window or allow it to run in its default normal window Wait for Program to Exit Mark this to pause the installation until the executed installation has exited 4 Click OK Aligning...

Page 223: ... Top or Align Controls Bottom command to move them into a row Setting Tab Order of Dialog Box Controls Tab order refers to the sequence in which controls are selected when the end user presses the Tab key By default the tab order is the order in which the dialog box controls were created 1 Open the dialog box in the Custom Dialog Editor See Editing Dialog Boxes on page 203 2 Select Layout menu Set...

Page 224: ...ectory Changing the Default Graphic on Wizard Dialog Boxes By default wizard dialog boxes contain a graphic that is not part of the individual dialog boxes It is specified on the Wizard Loop Settings dialog box where you configure the Wizard Loop script action You can change this graphic and turn it off for selected dialog boxes To change the bitmap that applies to all wizard dialog boxes 1 In Scr...

Page 225: ...box control The List Box Control Settings dialog box appears 4 Mark Don t Append and click OK 5 Select File menu Save Changes and exit See also Solutions for Dialog Box Problems on page 224 Disabling the Directory Already Exists Message When an end user runs the installation and selects an existing directory as the destination directory a message warns that the directory already exists This helps ...

Page 226: ...m Dialog script action can display a set of related dialog boxes You do this by using a button on one dialog box as a gateway to another dialog box This secondary dialog box can link to another dialog box link back to the master dialog box or return to the installation script A single dialog box set can contain up to 256 separate dialog boxes In WiseScript Package Editor the Select Destination Dir...

Page 227: ...Variable The display variable determines which dialog box in the wizard loop to present to the end user the next time the wizard loop is executed When this dialog box is presented to the end user the display variable is set to this dialog box set name If this field is not blank the dialog box is only displayed if the variable holds the same value as the Dialog Set Name field Called Dialogs Float I...

Page 228: ...troductory material in About Script Editor on page 94 Also see Conditions and Loops on page 109 and Variables and Expressions on page 110 1 Open the dialog box in the Custom Dialog Editor See Editing Dialog Boxes on page 203 2 Select View menu Dialog Script Editor The Dialog Script Editor opens 3 Create the script as you would in Script Editor The sample scripts Event Handler wse and License Agree...

Page 229: ...ons z Have the INIT event disable certain buttons if they are not valid based on previously chosen options z Have the INIT event store the current amount of free memory in a static text control then set the 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...

Page 230: ...n 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 Note This documentation covers both WiseScript Package Editor and WiseScript Editor WiseScript Editor contains the same scripting interface as WiseScript Package Editor but it does not contain the Installation Expert interface or o...

Page 231: ... drawing programs there are advantages to using the Custom Billboard Editor Example The Scale to Screen option can resize native billboard objects so they look the same regardless of the resolution of the destination computer In 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 bill...

Page 232: ...tallation z Save As Saves a billboard to a GRF file so you can share the file with others or re use it on future projects z Exit Without Saving Returns to Script Editor without saving the changes made to the billboard z Save Changes and Exit Saves the changes made to the billboard and returns to Script Editor saving the graphic as part of the installation It is only saved as a separate file if you...

Page 233: ...Text Angle Specify the angle at which text should be displayed If a non zero text angle is used the text is centered regardless of the alignment setting This feature is available only if you selected a 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 i...

Page 234: ...es and Ellipses The procedure for editing rectangles rounded rectangles and ellipses is the same except that rectangles also have a 3D option 1 Access the Custom Billboard Editor See Accessing the Custom Billboard Editor on page 230 2 Select 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 Comple...

Page 235: ... or use the X and Y fields to move the selected point to new coordinates Line Color Fill Color Click Pick to choose a color for the line and fill 4 Click OK Editing Billboard Bitmap Objects Use the Bitmap object to import bitmaps into a custom billboard Use the text tool in the Custom Billboard Editor to add captions and content to the bitmap rather than making the text part of the bitmap so that ...

Page 236: ...tor by clicking it and dragging one of the eight handles that appear around the object Move objects in the Custom Billboard Editor by clicking and dragging them For fine placement of objects use the arrow keys on the keyboard to nudge an object one pixel at a time When two or more objects overlap you can choose which one appears in front by selecting Bring to Front or Send to Back from the Edit me...

Page 237: ... Y Position Indicate the location on a 640 x 480 screen to place images On larger screens the billboard is placed proportionately based on the 640 x 480 location Erase Num Specify how many previously displayed graphics are erased before this image is displayed To display one image at a time set to 1 To display all images simultaneously set to 0 The oldest image is removed first Build Effect Specif...

Page 238: ...238 Creating Custom Billboards WiseScript Package Editor only To slow the installation speed so that each billboard displays long enough to be read select Installation Expert Build Settings page and mark Slow Installation Speed 4 Click OK ...

Page 239: ...llation See ApplicationWatch in the Wise Package Studio Help z Import Visual Basic Project See Import Visual Basic Project on page 240 Note This documentation covers both WiseScript Package Editor and WiseScript Editor WiseScript Editor contains the same scripting interface as WiseScript Package Editor but it does not contain the Installation Expert interface or other installation development tool...

Page 240: ...orted z Verify that the necessary files and dependency files required by the VB application are available z Verify that the files that require self registration are marked to self register To check this view the properties of the file and if the version section contains Ole Self Register then the file must be self registered A file might fail self registration because it doesn t need to be registe...

Page 241: ...ndency files cannot be read then the files they refer to cannot be added to the installation you are creating If any files on the Dependency Files Not Found page are crucial to this installation a Cancel the import b Locate the files and move them to the System or System32 directory c Restart the import 4 Click Next If target files were not found during the scan the Files Not Found page appears Fi...

Page 242: ...r in the Windows Start menu If you leave this blank the folder is placed in the top level of the Start menu Help File Icon Name Enter a name for the icon assigned to your program s HLP file This field is unavailable if the Visual Basic project does not contain a help file 9 Click Finish to complete the import The project is integrated into an installation file which contains all the information it...

Page 243: ...ile that helps you debug your script The log is the most complete record of what the installation did As your script runs on the destination computer each action it performs is logged in Install log This includes failures of actions to execute the reasons for the failure and what changes on your system Installation log Lets you determine what happens during the installation including what fails Se...

Page 244: ...sed on version double click its Install File s script line In WiseScript Package Editor double click the file on the Files page In the Install File Settings dialog box that appears if Check File is selected from the Replace Existing File drop down list then version checking occurs for the file To troubleshoot file replacement problems you can do one of the following z If the problem occurs because...

Page 245: ...opment tools Therefore some of the information in this document does not apply to WiseScript Editor Compiler variables are set before the installation is built and cannot be changed by an installation script Paths are relative to the build computer not the destination computer You can create and initialize compiler variables by adding an entry to the Compiler Variables page See Compiler Variables ...

Page 246: ...s _WIN_ Windows directory on the build computer _WISE_ The directory containing WiseScript Package Editor Variable Description BACKUPDIR If this is set to a path any files that are replaced during installation are backed up This variable is set by the end user on the Backup Replaced Files dialog box BDE_CONFIGDIR Directory where the BDE configuration file is stored on the destination computer This...

Page 247: ...stalled was not newer z D Date Replacement option was set to check Date Time and the condition was not met z E Exists Replacement option was Never and the file exists z I Install on restart The file was in use and will be installed on restart RESTART variable also set to S z A null value signals success If the file specification is a wildcard the value represents the last file copied or installed ...

Page 248: ...k it turns off the RESTART function SYS Windows System directory path We recommend that you do not change this variable SYS32 Path to the system directory for Win32 files We recommend that you do not change this variable TEMP Windows temporary directory path We recommend that you do not change this variable UNINSTALL_LANG Language information to make the UNWISE EXE language match the installation ...

Page 249: ...ing shortcuts to the desktop DIRECTION Used by the Wizard Loop action to control direction of motion through dialog boxes DISPLAY Holds the name of the current wizard dialog box read only DOBACKUP Holds the end user s choice as to whether to back up replaced files DOBRAND If this is set to 1 this is the first time the installation has been branded and user information is written to CUSTDATA INI EX...

Page 250: ...box for the Execute Program action WiseScript Package Editor only Also select True Win32 from the Destination Platforms drop down list on the Build Settings page This variable is the same as WISE_ERROR_RTN PROGRAM_FILES Windows Program Files directory STARTMENUDIR Directory of the Start menu for adding shortcuts STARTUPDIR Directory of the StartUp group for adding shortcuts VER_CHECK_TYPE Set this...

Page 251: ...ocuments and Settings All Users Application Data COMMONDESKTOP C Documents and Settings All Users Desktop COMMONDOCUMENTS C Documents and Settings All Users Documents COMMONFAVORITES C Documents and Settings All Users Favorites COMMONPROGRAMS Folder that contains common items that appear under Start Menu All Programs C Documents and Settings All Users Start Menu Programs COMMONSTARTMENU C Document...

Page 252: ...Settings User Local Settings MYMUSIC C Documents and Settings User My Documents My Music MYPICTURES C Documents and Settings User My Documents My Pictures MYVIDEO C Documents and Settings User My Documents My Videos NETHOOD C Documents and Settings User NetHood PERSONAL C Documents and Settings User My Documents PRINTHOOD C Documents and Settings User PrintHood PROGRAMS Folder that contains user s...

Page 253: ...m in the Samples subdirectory of this product s installation directory Symbols Functions USERPROFILE Location of the current user s profile C Documents and Settings User Addition Subtraction Multiplication Division Left str position Returns the left portion of a string where str is the string and position is the number of characters from the left to return Example Left windows 3 returns win Right ...

Page 254: ...haracters in a string to lowercase Ucase str Converts all characters in a string to uppercase Ltrim str Deletes all leading spaces Rtrim str Deletes all trailing spaces Logical Operator Example Description And A And B True only if expression A and B are both true Or A Or B True if either expression A or B is true or if both A and B are true Not A Not B True only if one expression is true Example A...

Page 255: ... FRS Latin 1 German Austrian DEA Latin 1 German Standard DEU Latin 1 German Swiss DES Latin 1 Greek ELL Other Hungarian HUN Latin 2 Icelandic ISL Latin 1 Italian Standard ITA Latin 1 Italian Swiss ITS Latin 1 Japanese JPN Hira Kana Hani Norwegian Bokmal NOR Latin 1 Norwegian Nynorsk NON Latin 1 Polish PLK Latin 2 Portuguese Brazilian PTB Latin 1 Portuguese Standard PTG Latin 1 Russian RUS Cyrillic...

Page 256: ...SE file while setting 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...

Page 257: ...ecified 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 195 M1 Displays the name of each self registering OCX or DLL as it is registered M2 Reserved for internal use by WiseS...

Page 258: ...log 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 re...

Page 259: ...toexec bat backing up 122 editing 121 PATH variable 119 automated build process 45 256 automatic run time variable 246 automatic self repair 30 53 175 AVI control 216 playing 182 B back up replaced file on destination computer 47 background of installer displaying images in 147 setting 69 background processing 26 BACKUP 248 backup copy during save 25 BACKUPDIR 246 246 batch file scheduling 256 BDE...

Page 260: ...iler Variable End 135 Compiler Variable If 135 Compiler Variables page 44 complex structure 128 component about 113 adding 46 conditional statement with 46 disk space for 221 installed by default 46 list box for 215 optional 47 program file for 46 selecting for installation 47 size modify 180 component based installation sample 46 COMPONENTS 113 131 180 249 Components page 46 Concat 253 conditiona...

Page 261: ...6 editing 227 floating dialog box 227 master dialog box 226 naming 227 properties 227 Dialogs page 46 digital signature adding 47 Digital Signature page 47 DIRECTION 249 directory adding contents 52 changing 28 checking existence 134 creating empty 139 creating in layer 140 default setting 63 filtering with wildcard 52 in installation 28 renaming 189 renaming in layer 190 searching for 77 DirectX ...

Page 262: ...ile extensions See the first letter file name converting short to long 196 long 196 prompting for 184 short 196 file CAB mobile device about 178 adding 179 Files page 50 adding directory 52 adding file 51 filter directories with wildcards 52 Find File in Path 163 Find First SVS Layer 163 Find Next SVS Layer 164 Find SVS Layer GUID 164 Finished dialog box 47 First element of structure 128 floppy di...

Page 263: ...75 serial number 62 shortcut 72 single file 18 temp directory 43 testing 18 title 63 troubleshooting 243 upgrade 74 version 55 watching 239 wizard dialog box 46 Zip format compatible 42 Installation Expert about 36 help 37 page groups 23 37 page navigation 37 pages resetting 37 undo changes 37 installation log adding text 120 creating 58 default location 58 for uninstall 80 opening closing 181 usi...

Page 264: ...ors 253 optional installation item See component options for command line 256 OSD 143 owner name getting 168 P Package Definition File PDF 60 Package Distribution about 34 page See Installation Expert page groups about 37 customizing 23 properties 23 Pages menu adding groups 23 properties 23 paging 130 parameters pass to function 128 Parse String 181 passive FTP transfer 81 PASSWORD 247 Password p...

Page 265: ...ack from command line 258 rollback wse 98 98 Rtrim 254 run application from ApplicationWatch 239 run installation 18 run level Vista 43 run program from installation 156 run time variable about 111 automatic 246 with script actions 248 runtimes Apollo 68 Crystal Reports 69 DAO 68 database 68 68 downloading 26 MDAC 68 MSDE 68 MSJet 68 Software Virtualization Solution 69 updating 26 Visual Basic 68 ...

Page 266: ... 250 STARTUPDIR 250 static control 211 220 status MIF file 60 string buffer 127 parsing 181 pointer 126 structure passing structure example 128 passing to DLL 127 substitution 110 SVS data protection 195 exclude entry removing 189 exclude entry setting 195 initialize 172 Items 117 script actions 117 variables 250 SVS Driver runtime support 69 SVS exclude entry removing 189 SVS layer GUID changing ...

Page 267: ...lication to 129 creating 144 creating directory in 140 creating shortcut in 143 deactivating 145 deleting 147 deleting file 146 exporting 162 finding first 163 finding GUID 164 finding next 164 GUID 144 importing 171 registry editing 154 renaming 190 renaming file directory 190 virtual software package installing 176 Visual Basic 68 project types 240 Visual C 68 Visual FoxPro 68 volume label getti...

Page 268: ...bleshooting 93 update file about 89 updating file 88 uploading FTP client 90 using 87 using with SmartPatch 92 using with WebDeploy 92 WiseUpdate page 85 WiseUpdt exe 91 wizard See tools wizard dialog box changing image 224 disabling check box 226 disabling radio button 226 for installation 46 Wizard Loop action 199 adding dialog box 145 word 126 word pointer 126 Z ZAP file creating 38 ZIP format ...

Search results

Summary of Contents for WISESCRIPT PACKAGE EDITOR 8.0

Reviews:

Related manuals for WISESCRIPT PACKAGE EDITOR 8.0

Brands by name

Popular brands

Symantec WISESCRIPT PACKAGE EDITOR 8.0, Reference

Search results

Summary of Contents for WISESCRIPT PACKAGE EDITOR 8.0

Reviews:

Related manuals for WISESCRIPT PACKAGE EDITOR 8.0

Brands by name

Popular brands