Open topic with navigation
Direct Editor
InstallShield 2015
Project: The Direct Editor is available in the following project types:
Note that the following information includes additional project-specific details.
The Direct Editor is a view in InstallShield that lets you review all of the tables in your project file (.ism) or database file (.msi, .msm, or .mst). In some project types, this view also offers functionality for advanced users who are very familiar with the Windows Installer database format.
For Windows Installer–based projects, the Direct Editor can run in two different modes:
|
•
|
Project edit mode—This mode lets you edit tables in the project file. The changes that are made in the Direct Editor are incorporated into the Windows Installer package that InstallShield creates at build time. |
Any changes that you make in the other views within InstallShield are reflected in the Direct Editor; in addition, any changes that you make in the Direct Editor are also reflected in the other corresponding views (if available). For example, if you use the Features view to add a new feature to your project, InstallShield automatically adds that feature to the Feature table in the Direct Editor. If you use the Direct Editor view to add the feature, InstallShield automatically updates the Features view accordingly.
When you are working in any of the following Windows Installer–based project types, you are working in project edit mode: Basic MSI, DIM, InstallScript MSI, Merge Module, and QuickPatch.
|
•
|
Direct edit mode—This mode lets you edit tables in the Windows Installer database (.msi, .msm, or .mst file). When you save the changes that you have made in the Direct Editor, InstallShield updates the Windows Installer database. |
Many of the other standard InstallShield views are not available in direct edit mode, since they require build-time functionality that is not available when you are directly editing the Windows Installer database.
When you are working in any of the following Windows Installer–based project types, you are working in direct edit mode: MSI Database, MSM Database, and Transform.
Using the Direct Editor in Any Project Type
The Direct Editor has a Tables explorer that lists each table in your project or database. When you select a table in this explorer, the right pane shows the following elements:
|
•
|
A row of buttons and other controls |
|
•
|
A spreadsheetlike table |
Each row in a table represents a record in your project or database. The parenthetical note in each column heading indicates the type and size of data that you enter in the column. For example, S255 indicates a string with up to 255 characters; I2 indicates a 2-byte integer.
The following table describes all of the buttons and other controls that are displayed when you select a table in the Direct Editor.
Controls in the Direct Editor View
|
|
|
|
|
New Record
|
|
Displays the Add Record to Table dialog box, which lets you adds a new row to the selected table.
|
|
Edit Selected Record
|
|
Displays the Edit Record in Table dialog box, which lets you edit the data in the selected row.
|
|
Delete Selected Records
|
|
Deletes the selected row or rows.
|
|
Cut Selected Records
|
|
Removes the currently selected rows and places them on the Clipboard.
|
|
Copy Selected Records
|
|
Copies the currently selected rows to the Clipboard.
|
|
Paste Records
|
|
Inserts the rows that are saved to the Clipboard.
|
|
Find String
|
|
Displays the Find dialog box, which lets you search for instances of a string. This dialog box lets you specify criteria such as whether you want to search in the selected table, or all tables.
|
|
Find Next
|
|
Searches for the next occurrence of the specified string.
|
|
Find and Replace
|
|
Displays the Replace dialog box, which lets you search for instances of a string and replace them with a new string. This dialog box lets you specify criteria such as whether you want to search in the selected table, or all tables.
|
|
Search Grid
|
|
Dynamically filters the records that are displayed in the Direct Editor view according to the string that you specify in this search box. As you type a string in this box, InstallShield hides all of the rows that do not contain it.
|
|
Direct Editor Help
|
|
Displays the help for the Direct Editor view.
|
Using the Direct Editor with Project Edit Mode in Windows Installer–Based Projects
In Basic MSI, DIM, InstallScript MSI, Merge Module, and QuickPatch projects, advanced users can use the Direct Editor to perform tasks such as the following:
|
•
|
View all of the tables in the project file (.ism). |
|
•
|
Add and remove records from tables. |
|
•
|
Cut, copy, and paste records or fields. |
|
•
|
Edit individual fields in the tables. |
|
•
|
Filter the table records that are shown to hide ones that do not contain a specific string. |
|
•
|
Search one table or all tables for a specific string and replace it if necessary. |
|
•
|
Resize and reorder the columns in a table. |
Tip: If you press F1 while a standard Windows Installer table is selected, the Windows Installer Help Library opens to provide information about that specific table.
Note the following details when using the Direct Editor with project edit mode in Windows Installer–based projects:
|
•
|
The File table displays only static data. InstallShield may add additional information, such as dynamically linked files, to the File table in the Windows Installer database that it creates at build time. |
|
•
|
Unlike the corresponding tables in the Windows Installer database, tables such as the Binary, Icon, and Patch tables in the .ism file do not store binary data. Rather, they store links to build-source paths. |
|
•
|
Column attributes for both standard tables and InstallShield tables cannot be altered while in project edit mode. They can, however, be edited for custom tables. Note that column attributes can be edited in standard, InstallShield, and custom tables in direct edit mode. |
|
•
|
You cannot use localizable properties in the Directory table. |
Using the Direct Editor with Direct Edit Mode in Windows Installer–Based Projects
In MSI Database, MSM Database, and Transform projects, you can use the Direct Editor to essentially perform all of the tasks that are available in this view with direct edit mode. However, instead of working with tables in the .ism file, you are working directly with the Windows Installer database (.msi, .msm, or .mst).
Using the Direct Editor in InstallScript and InstallScript Object Projects
The Direct Editor in InstallScript and InstallScript Object projects lets you see all of the tables in your .ism file; however, it is recommended that you use the other views in InstallShield to modify these types of projects.
Note that although InstallScript and InstallScript Object projects use many of the same tables that are available in Windows Installer–based projects, many of the common tables have different meanings. In addition, InstallShield ignores custom tables in InstallScript and InstallScript Object projects; custom tables are not available at run time.
See Also
Editing Installation and Project Tables
Adding Records to a Table
Deleting Records from a Table
Adding New Tables Through the Direct Editor
InstallShield Columns in Standard Windows Installer Tables
Entering Binary Data in a Table