ProjectWise Design Integration Wiki Enumfolders.exe TN

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:

If you are using single sign on (in ProjectWise) then you do not need to use the -u or -p for user name and password. It should automatically log you in with the credentials used when you signed into windows.
Additionally you may not need to use the host name of the server in the command line, just the datasource name.

Example: enumfolders.exe -d MyDataSource -D -r -f 140