Faq

Perhaps you have some Problems which are really common. So by chance you will find an answer in these frequently asked questions (Faq).

Questions:

Answers:

A: This may be caused because of the wrong ftp-transfer (always use "binary"-mode for transfering the attr-file when using ftp) or wrong extraction of a *.tar-file with WinZIP! You have to disable the CR/LF-conversion in WinZIP when extracting from a tar-archive (this option can be found in the WinZIP menu "Options/Configuration"-dialog in tab-panel "misc").

A: Simply mark the root-project in which you want to search. Press Ctrl+L (or use the menu Edit/Search all or click on the project with the right mouse-button and choose Search all in the context-menu).
In the Searchterm enter:
.*
and select the file-attribute Name.
Don't forget to check the checkbox for regular expression (regexp).
Then click on Search all. A list of all submitted files will be displayed. With the usual Ctrl+a you can select all listed items (or you click on the first item and then click Shift+click on the last item), afterwards press Delete selected and all selected items will be deleted (this can take a while).
Be careful if you simply delete a subproject (which has only submitted files beneath it). All the files are stored in a different file when calling transferproject. This file is called ex.tar or ex.zip (with ex being your transferproject-name) depending on the platform.
If you delete the whole project this project path should also be deleted from this tar-archive (resp. zip-archive) with the usual tools (e.g winzip). If the path is still in the tar-archive, you may get some warnings when doing a transferproject-import.
You can do something similar with records.

A: You can simply select the project for which you want all templates to be modified.
Open the Search/Replace-dialog and replace "y" with "n" in the attribute cache of the templates-attributes. Than click Replace all. All template should now be "non-cached".

A: Yes. Simply click on Edit/New item.
TrapEd will assign a new ID to this item, which may conflict with other items being stored inside Vignette. So if you want to import the attr-file later, you should be warned that you may create conflicts by creating new projects, templates, records or files.
You can also rename a template, save the attr-file and import it to Vignette. The "old" template will not be overwritten, instead a new one is created (because the name does not match).
So basically you can also create new templates by cloning existing ones. You should have a look at the documentation for transferproject (and it's different options -z x).
Furthermore you can use the import-facility in TrapEd to create a complete new project-structure. (for details see the menu-entry "Import directory" in Menu)

A: Yes, you can. Simply drag the template, record, file or record and drop it over the project where you want it. Be careful if submitted files are moved (you have to adapt the *.zip (or *.tar) -archive-file as well to reflect the new project-path).

A: This can be caused by different reasons. Maybe you deleted a project with TrapEd, which has some submitted files. Than the import procedure will try to open the *.zip (or *.tar-file according to your platform) and import all the files which are in this archive.
If you have deleted a project with TrapEd and there are some submitted files in there, than you must also manually edit the *.zip (or *.tar) -file and remove those project-folders.

A: Within Vignette you can simply clone the project but all template beneath are not correctly adapted. Try the following procedure:

• export the project (let's say CDA1).
• open the attr-file with TrapEd and hopefully you have some naming-guidelines (e.g all Templates starts with CDA1_... and all paths starts with /cda1/...).
• now you can simply search/replace all occurrences of CDA1 in the attribute Name with e.g. CDA2 and all paths starting with /cda1/ are replaced with /cda2/.
• save the attr-file and
• import it again into Vignette (you should use the -z 3 option of transferproject, please have a look at the documentation of transferproject).

Because of the different names your projects/templates in the new attr-file Vignette will not overwrite the old ones, but new ones are created (make sure that the names and paths doesn't collide to any existing names/paths.

A: Sure. Simply do a double-click on the attr-file. The Windows-OS will ask you for the application with which you want to open this file. Simply choose the TrapEd-executable and click on "always open this file with this application".
More Starting TrapEd.

A: TrapEd can be started with these options (see Starting TrapEd):

• -utf8 0 or -utf8 1 (default) and
• -compress 0 (default) or -compress 1.

Just create a shortcut to the TrapEd-executable. In the properties-pane insert in "target":
path-to-traped -utf8 1 -compress 1 absolute-path-to-attr-file.
But notice: it is save to open all files with the default -utf8 1 and when in doubt just use the default.

A: Not directly. But TrapEd is used to set or modify values for a range of templates, files, ... easily.
E.g. you want to have the state Live for all templates after you have imported a directory. Simply select the root-project, open the Search/replace-dialog and replace
Ready for Internal Use with
Live
and mark the attribute State from the template-attributes. Then click on Replace all. If you want to set all templates to not AlwaysPrivate, simply replace
y with
n
and mark attribute AlwaysPrivate.

A: This is true. TrapEd consumes up to 35 MB of ram for an attr-file of size 7 MB (temporarily TrapEd will use as much as 60 MB to read this file).
Maybe in one of the next versions TrapEd will be less hungry in memory, but who knows. What you can do is export single sub-projects or open the file as compressed and write it out in a compressed form. Sorry, there is not much more to do besides: "don't write so much code in your templates" :-)

A: In transferproject-version (or Vignette-versions in general) below V6 umlauts or all characters beside the normal ASCII-7-bit-characters will vanish anyway. Since V6 (or exactly V5 which is 5.5) transferproject writes everything as UTF-8. If you have a version of V6 (or higher) please use the option "Read as UTF-8" in the file-open-dialog this can be used for version below V6 as well.

A: Mark the project, open the Search all-dialog mark attribute cache for Templates and search for:

 .* (Regexp)

The resulting popup shows all templates and the match (which is y or n). You can mark all templates (with Ctrl-a, depending on the size of the list this may take a while) and copy all marked templates as usual with Ctrl-c and paste it into your favourite editor or even Excel. Optionally you can sort the list by column "Matches '.*'" before copying the list.

A: Yes. Have a look at the Api-example (you need a licensed version of TrapEd).

A: No problem, tell us and if we like this feature as well, it may be implemented in one of the next releases. But maybe you can simply implement it yourself by using the Api.

A: Simply download some additional DLLs and extract them into the directory where traped.exe resides. TrapEd should now run on Windows 98.