Enumfolders.exe TN
| Applies To | |||
| Product(s): | ProjectWise Explorer | ||
| Version(s): | V8i | ||
| Environment: | N/A | ||
| Area: | N/A | ||
| Subarea: | N/A | ||
| Original Author: | Bentley Technical Support Group | ||
Overview
Enumfolders.exe is a new command line utility included with the V8i release of ProjectWise, and is a part of the ProjectWise Administrator install. The application is used to provide a way to report on ProjectWise folders/files. The program is also able to re-curse through the folder structure which allows a complete report of the hierarchal folder structure. This can be very useful for users who want to export the folder/file information from ProjectWise, to a text file for review. It can also be used for viewing the name of files and folders that have been deleted.
Prerequisites
- In order to see deleted files and folders the audit trail must have been tracking folder Delete and Document Delete.
- A view in ProjectWise Explorer that shows the dmsfolder id number
Running Enumfolders.exe
To run the utility, open a command window from a system that has the ProjectWise Explorer client installed, and navigate to the ProjectWise/bin folder.
“C:\Program Files\Bentley\ProjectWise\bin\enumfolders.exe”
Running the command enumfolders.exe without any parameters will display the help.
Usage: enumfolders [-d datasource] [-u username] [-p password] [-v] [-r] [-D] [-l] [-f folder]
Enumerates the object in a folder hierarchy.
Options:
-d datasource hostname:datasource
-u user ProjectWise username
-p password ProjectWise password
-f folder ID Folder to the enumerate <GUID or integer folder ID>
-v Verbose operation
-D Include documents in object list
-l Include deleted object in object list
-r Recursive enumeration operation. All subfolders are
enumerated, along with any objects in those subfolders.
Sample keyin: this will enumerate all the files and sub folders from dmsfolder ID 140 in a datasource called MyDataSource
Enumfolders.exe –d SERVER: MyDataSource –u pwadmin –p prjwise –D –r –f 140
SERVER ProjectWise Integration Server
MyDataSource ProjectWise Datasource
-u pwadmin ProjectWise administrator username
-p prjwise ProjectWise administrator password
-D Used to include documents in the folder
-r Recurse through the folders
-f 153 Folder ID
Sample output: The output is in 6 columns
- First column describes if the output is a folder (F) or document (D)
- Second column is either the Folder ID or the Document Number
- Third column is the folder or document GUID
- Forth column is the dms folder number
- Fifth column is the name of the folder or the name of the document
- Sixth column is the description of the folder or the description of the document
F 140 {6edc92bd-4568-4daf-9193-7e2d11b7ca28} "dms00140" "Folder" ""
F ? {d105d8d6-5ffa-4a70-a632-8826c0934f30} "UNKNOWN " "Folder\sub" "" (DELETED)
D ? {1a0a4f10-af2e-43f5-be0e-83d55e4fe24f} "UNKNOWN " "folder\sub\test.txt" "dmskrnl.cfg" (DELETED)
D 2 {053afb68-1090-432f-97fd-522280465ad9} "dms00140" "folder\stuff.txt" "stuff.txt"
The ‘UNKOWN’ under the dmsfolder number indicates that the folder ‘sub’ and the file test.txt have been deleted.
To output the data to a text file use the “>” sign.
Example:
enumfolders.exe –d SERVER: MyDataSource –u pwadmin –p prjwise –D –r –f 140 > c:\PWoutput.txt
This will create a text file called ‘PWoutput.txt’ with the requested data.
Notes:
- Ifyouareusingsinglesignon(inProjectWise)thenyoudonotneedtousethe-uor-pforusernameandpassword. Itshouldautomaticallylogyouinwiththecredentialsusedwhenyousignedintowindows.
- Additionallyyoumaynotneedtousethehostnameoftheserverinthecommandline,justthedatasourcename.
Example: enumfolders.exe-dMyDataSource-D-r-f140
- Itisnotrecommendedtorunthiscommandinabatprogram.
See Also
ProjectWise TechNotes And FAQs
External Links
Bentley Technical Support KnowledgeBase
Comments or Corrections?
Bentley's Technical Support Group requests that you please submit any comments you have on this Wiki article in the "Comments" area below. THANK YOU!