Opens a Vignette attr-file. With a licensed version you will be able to read a complete attr-file into TrapEd and display the complete project-structure. Without a license only three project-directories will be displayed. Depending on the version of transferproject with which the attr-file is build, you can have two charsets: Latin1 or UTF-8.

Read as UTF-8

If you are not sure open your file with the checkbutton Read as UTF-8 clicked (which is the default anyway). In Pre-V6-Vignette-Versions the data in the attr-file was stored in Latin1.

Read records/Read files

Sometimes you have large Vignette-projects, or at least large attr-files, which are only large becuase there are tons of records in it. Mostly these record-meta-data (which is stored in the attr-file) is of no use, when you simply want to look at the template-code. The Open-dialog has an option to ignore the records (or the submitted files) while reading.

Of course you cannot save the modified attr-file with records, when you have read the attr-file with the Read records-option off.

Read and compress?

Furthermore you can tell TrapEd to ignore all the useless attributes (e.g. who is interested in the attribute Notes which isn't filled anyway or anything of the workflow-stuff). TrapEd will use less memory if the attr-file is opened with Read and compress. But be sure that if you open the attr-file as "compressed" you can only save again as "compressed". So this option is used mostly to only search through the templates. A Known bug is the impossibility to do a transferproject in Vignette 4.2, when the attr-file was saved as compressed.

If you have forgotten which parameters you have provided while opening the file, you can look at File/Properties. If the file was read in UTF-8, "compressed" or with files/records ignored this is mentioned in the properties-dialog.

Save as...

There is no "Save"-function in TrapEd because you should not overwrite your attr-file unless you already made a backup-copy. You should keep this as a backup, if something is destroyed. Save as... saves the complete project-structure to a file. This functionality is only available if you have obtained a License.

If you have a large attr-file and you only want to edit and search through an attr-file you may save the data "compressed". That is without all those unnecessary attributes like LockTime or LaunchPolicy. However you should be carefull when importing "compressed" attr-files into Vignette (e.g. it's a known bug that compressed attr-files cannot be imported into Vignette 4.2).

Export selected subproject...

With the export-function you can write subsets of the complete project to an attr-file. The selected subproject is taken as the root. This function is only available if you have obtained a License.

You also have to be careful here, when there are submitted files in any exported subprojects, because you have to adapt the *.zip (or *.tar) -archive-file with the submitted files as well.

Like in "Save as..." you can save the data in a compressed form.

Dump to filesystem...

Maybe you don't like the integrated editor in TrapEd? You can use your own editor an simply edit all the templates within a directory. With "Dump to filesystem" you can write all the templates below the marked project into the choosen directory.

Suppose you have the following project-hierarchie:

JspSamples

    CDS APIs
       jsp_cds_component (with path '/bsp/jsp_cds_component')
       jsp_cds_lib (Library, no path)

You can write the templates in these formats:

Docroot

The paths of the templates are created relative to your choosen directory. Inside the created directory the template is written in Vignette-manner:

<cache>,<templateid>,,<browserCaps>.<ext>
where

<cache> = 0 if template is cached or 1 if not
<templateid> is the DB-Key of this template (or RecordID)
<browserCaps> the information of the browserCaps-attribute (variations)
<ext> the extension of the template (usually html)

With this mode you can dump the templates as if they were created for the webserver-cache (you have to put in your dynamic oid, of course). Libraries (or other Templates without a path are written in the root-directory (the choosen dump-directory).
For the above project-structure the dumped files would be (export-direcotry: dump):
./dump/bsp/jsp_cds_component/1,1031,,00.html
./dump/1,1030,,00.html

Flat

All the templates are written with their names (and their extension) into the choosen directory (this is possibly the option you usually use). If you export the above project-structure into directory dump you will get:
./dump/jsp_cds_component.html
./dump/jsp_cds_lib.html

CMS-Explorer

This mode dumps the files as if you have used the CMS-Explorer.
The example-project-structure would therefore look like this (export-directory again: dump):

./dump/JspSamples/CDS APIs/jsp_cds_component.jsp ./dump/JspSamples/CDS APIs/jsp_cds_lib.jsp

The additional template information which is written as XML into "*.vgn"-files when you export from CMS-Explorer are neither written nor read from TrapEd.

After dumping you can simply edit the templates with your favourite editor. After changing the template-files simply synchronize the directory again (of course with the same "mode").

Synchronize with filesystem...

With this functionality you can read the previously dumped files into TrapEd. You should provide the same mode (Docroot, Flat or CMS-Explorer) as provided when dumping. When synchronizing TrapEd simply goes through all templates beneath the marked (left-explorer-tree) project and checks for an identically named file in the provided "synchronize-directory". If a file with this name is found and the file-content is different from the one in TrapEd the template within TrapEd is overwritten with the content from the file.

Additionally CMS-Explorer-like files (those which store the meta-data of templates in XML-format) are not read from TrapEd.

Import directory...

This functionality is used to import many files beneath a choosen directory. This can be used to create attr-files from scratch. Simply choose a directory and import it. All the files beneath this directory will be imported.

To specify which file-extension should be mapped to which tempate-type, simply set the file-extension-associations in the import-pane of the option-dialog.

You can choose extension for Tcl-ServerPages (TSP), Active-ServerPages (ASP), Java-ServerPages (JSP) and simple "submitted" Files (e.g. images). Be careful when importing "submitted" files. You have to create your own tar- or zip-file (depending on the Vignette-server-platform) which contains these files. The tar- or zip-file has to have exactly the same name as your attr-file (for an overview on how transferproject and TrapEd works see Overview).

The generated attr-file is only valid for Vignette V6. Furthermore there is no RecordID generated (because this will be determined when importing the attr-file into Vignette). All spaces in directory-paths will be replaced by "_" to generate a valid path for Vignette.

Check consistency

To provide a basic kind of sanity check, you should check the consistency before saving the project and importing it into Vignette. This is especially important if you have imported a directory-structure, which may contain the same filenames in different directories (these are mapped to template-names, which have to be unique!).

Check consistency does the following checks:

do duplicate template-names exist?
template-names contains illegal characters (like ">")?
do duplicate Paths exist?
Do all paths begin with "/"?
are there duplicate RecordID's?

Properties

The dialog prints information about the attr-file (if one is opened).

Properties-dialog

The properties-dialog shows information about:

the file-path to the attr-file
the mode in which it was opened (compressed? files read? ...), see Menu>Open
and some information from the attr-file which are of almost no use, e.g. the database-connection and the username/password used to connect to the database.
the Database-password is most likely encrypted (depending on your CMS-configuration).
If you have an unlimited license for TrapEd the password is decrypted and displayed (see image of Properties-dialog). This feature is not available for the 30-days license.

Edit

Delete template/project

The marked project, template, ... will be deleted. You can also mark a project, template, ... in the explorer-tree and press <Delete> or click the right mouse-button to get a context-menu with a delete-entry. But be aware that there is no undo for a delete-operaton.

To mark multiple items hold down the Shift or Control-Key and click on the explorer-tree-items.

Be careful to delete projects which has submitted files. Because only the metadata is stored inside the attr-file, while the real file/image-data is stored in the *.zip/*.tar-file, you should adapt the *.zip/*.tar-file manually (see Faq).

Go to ID/DB key...

Often while doing a transferproject you get error-message like: "error ... /ci/121a". Find this content-item with Vignette's Project Manager is mostly a PITA. With TrapEd you can simply insert the ID into this dialog and TrapEd will jump directly to that template.

Furthermore you can also jump directly to a template or a record if you have the database key. This database key is listed in the "Misc"-Tab of the "Details"-Dialog in the Vignette Project Manager and often refered to in template-error-messages.

Search/replace...

This provides the main functionality of TrapEd. Search/replace is always context-sensitive to the currently marked project/template/... For a more detailed description see SearchReplace.

Search all...

With the functionality you can search for all projects/templates/... with a specific pattern. All the hits are listed and you can jump directly to the hits when clicking on the result list. You can also mark the entries and copy them to the clipboard (with Ctrl-c) and paste them into Excel or whatever you need. This is really useful for documenting purposes.

For a more detailed description see SearchReplace.

New Project/Template/File/Record

Since version 2.0 of TrapEd it is possible to create new objects. Simply mark the project beneath which you want to create an item and choose New item either from the menu or the context-menu.

You get a nearly empty input-mask to enter the attributes. But be careful when e.g. create a new template and choosing the TemplateType. After you have saved the template and marked another item in the explorer-tree, the attribute TemplateType will become read-only and you won't be able to change it, except be deleting and creating the template again.

View

Statistics

This function does compute some simple statistics on the currently marked project and lists them. It shows the number of templates with different attribute-values (e.g. how many templates are "Always Private", or who created how many templates). This may be a help for detecting problems (e.g. when the number of templates with "cache" = "y" is zero) or may help with documenting the project.

Especially the information from "LockedBy" may be helpful, because you may run into problems while importing this "transferproject"-export.

Some additional info from the attr-file, like the database-connection, ... are also listed in this dialog.

License

This opens the license-dialog. It displays the harddisk-id which is the base for the License.

Extras

Options

→ Attributes

Here you can specify which attributes you want to edit. Most of the times you are not interested in all the possible attributes, so you can simply click on the ones you are focused.

→ Import

Specify which file-extensions should be mapped to which kind of templates/files. You can choose between extensions which are mapped to TSP/ASP or JSP-templates or which should be created as "Files" (be careful: files have to be imported with a separate tar- or zip-file; see Import directory...)

The file-extensions are case-insensitive (as usual under Windows).

→ Misc

To improve the display of your templates you can specify different settings according to what you normally do.

Options-dialog Misc-tab

You can configure the following settings:

Tab-width
The tab-width may differ from 4 to 8 depending on the editor you use for editing templates. Tab-width is only for visibility, no templates are changed! This is only a convenience so that your indentation looks o.k.
body-height
How many lines should be displayed in the text-field for the body.
If you want to edit the template-code you should set this to a larger value. If you only want to see the first lines of code then set it to e.g. 5
Paths-height
The same as in body.How many lines should be displayed for Paths. If you have many templates containing a lot of paths, you may want to increase the value.
Search-all-result-length
If you are searching for all occurrences of a pattern, you get a result-dialog in which the matching-parts of the template are displayed (see Search & Replace). Sometimes you need to have a look at some characters before or after the match to have an overview of the result.
This option lets you specify how many characters should be displayed in the "Search all"-dialog.
Viewer:
If you want to view the template-code in your favourite editor, simply enter the executable of you editor. If not provided notepad.exe is used (see Edit Button).
Show toolbar:
You can switch off the display of the toolbar.
Fontification:
You can also switch off the colorization of html-tags or links.
HTML/Link:
With these buttons you can configure how the html-tags or links should be displayed.

Help (Content)

This tries to start a browser to open you locally saved HTML-pages. If they were not found in the expected directory you get a notice where you can find the online-documentation.

But anyhow, as you are reading this, you may already have found the help ;-)

Context Menu

You can get a context-sensitive menu when you click with the right mouse-button on the projects/templates/... in the project-tree.

Edit Buttons

View

Inside the "Edit"-Pane you have a "View"-Button for Templates (next to the "Save"-Button on the bottom of the "Edit"-Pane). Clicking this button opens the template-code in your favourite editor.

Be aware that the code cannot be edited in your editor. If you want to change the code you can edit it in your editor and paste it back into the body-textarea of TrapEd.

You can configure your editor in Extras>Options>Misc.

View/Execute

With TrapEd (since version 2.1) you can even have a look at "submitted files". If the folder from which you have opened the attr-file contains a file named <project-name>.zip (or .tar) you will see a View resp. Execute-button in the "file"-pane.

"View" will open the file in your standard-editor (the same way as "View" for templates does. This would be senseful if you have submitted files like javascript, stylesheets, ... which can be viewed with an editor.

"Execute" will open this file with the configured programm (depending on the file-extension and the associated program in your Windows-configuration). E.g. with "Execute" you can open submitted images with your favorite viewer.

Menu

File

Open...

Save as...

Export selected subproject...

Dump to filesystem...

Docroot

Flat

CMS-Explorer

Synchronize with filesystem...

Import directory...

Check consistency

Properties

Edit

Delete template/project

Go to ID/DB key...

Search/replace...

Search all...

New Project/Template/File/Record

View

Statistics

License

Extras

Options

→ Attributes

→ Import

→ Misc

Help (Content)

Context Menu

Edit Buttons

View

View/Execute