Bentley Communities
Bentley Communities
  • Site
  • User
  • Site
  • Search
  • User
  • Welcome
  • Products
  • Support
  • About
  • More
  • Cancel
Content Management
  • Product Communities
  • ProjectWise
  • Content Management
  • More
  • Cancel
Content Management
Content Management Wiki Using ScanRefs.exe
    • Sign in
    • +Content Management - Wiki
    • +Bentley i-model Composition Server
    • +Field Data Management - Welcome
    • +ProjectWise Caching Server
    • +ProjectWise Change Storage Area
    • The Levels of ProjectWise Design Integration Application Integration
    • +ProjectWise Design Integration Server
    • +ProjectWise Design Integration V8i
    • +ProjectWise Document Publisher
    • +ProjectWise Edge - Mobile
    • -ProjectWise Explorer Client
      • 55037 Error moving document User cannot delete corrupt files
      • A way to list users and working dirs
      • A way to search documents in a specific version and showing related references (references and referenced by) on search results
      • A way to search only document versions in PW
      • Application Error The instruction at 0x5ad71531 referenced memory at 0x00000014
      • Attribute Exchange tabs grayed out in Excel 2007
      • Attribute not showing in modify command dialog box
      • +Audit Trail - ProjectWise Explorer Client
      • Batch File Renaming in ProjectWise
      • +Bentley IMS Login
      • +BS1192 Rules Engine - ProjectWise Explorer Client
      • Cannot open file class not registered
      • +Check In Dialog - ProjectWise Explorer Client
      • Copy files with document codes
      • Datasources not displaying in ProjectWise Explorer
      • +Document Code - ProjectWise Explorer Client
      • +Document Creation - ProjectWise Explorer Client
      • +Documentation & Help - ProjectWise Explorer Client
      • Drag and Drop Issue in ProjectWise Explorer
      • Error -11149 Cannot save instance to storage
      • Error 112219 "Invalid filename"
      • Error 2627
      • Error 50176 Cannot start application for the specified document. Check your program associations. Operating system function call failed.
      • Error 58057 Creating new version of document in folder
      • Error found in Custom UI XML of "ProjectWise iDesktop Integration"
      • Error on thread and file stuck with coming in status
      • +Export / Import Tool - ProjectWise Explorer Client
      • Failed to get object identifier by its GUID
      • Folder descriptions displaying instead of name?
      • +Folders / Subfolders - ProjectWise Explorer Client
      • +GUI - ProjectWise Explorer Client
      • Inherited Environment
      • +Installation - ProjectWise Explorer Client
      • +Integration - AutoCAD - ProjectWise Explorer Client
      • +Integration - DGN Platform - ProjectWise Explorer Client
      • +Integration - MicroStation - ProjectWise Explorer Client
      • +Integration - Office - ProjectWise Explorer Client
      • +Integration - Revit - ProjectWise Explorer Client
      • Integration with FME
      • Invalid socket The connection to the remote host is broken
      • Issue with Bentley Connect Edition and AutoCAD 2014 Civil 3D and Civil 3D 2016 on same PC
      • Last Error 347 Cannot start application for the specified document
      • Last Error 58174. Error moving document
      • +Localization - ProjectWise Explorer Client
      • Make external clients unable to use licensing
      • +Messaging Service - ProjectWise Explorer Client
      • Microsoft Office 2010 prerequisites are missing
      • +MISC - ProjectWise Explorer Client
      • No scroll bar on the Attribute properties tab
      • +Open / Save / Copy / Move - ProjectWise Explorer Client
      • Opening a file integrated with PW uses the local workspace
      • Optimizing File Transfer Performance in ProjectWise Explorer
      • PDF for Photo Preview are not showing
      • +Photo Preview - ProjectWise Explorer Client
      • Photo-Preview Fix
      • +Project - ProjectWise Explorer Client
      • ProjectWise Explorer Won't Start or is Giving you a "PWC.exe -Application Error
      • Revit - “The file is already open for editing in another process"
      • +Search - ProjectWise Explorer Client
      • +Security and Permissions - ProjectWise Explorer Client
      • Sequence number / serial number is not increasing in document code
      • Setting the default startup folder
      • Spatial Tab missing in ProjectWise Explorer CONNECT for other accounts than main administrator (pwadmin)
      • Troubleshooting ProjectWise Explorer using Process Monitor (ProcMon)
      • +User Tools - ProjectWise Explorer Client
      • Using ScanRefs.exe
      • Using the Local Document Organizer In ProjectWise
      • +Views - ProjectWise Explorer Client
      • Workflow rules engine, Error -50001 Attribute specified in action not found
      • +Workflows & States - ProjectWise Explorer Client
    • +ProjectWise Explorer Client V8i
    • ProjectWise Explorer Connect Edition Upd3 Unattended Install
    • +ProjectWise integration module for Revit
    • +ProjectWise Integration Server
    • +ProjectWise Publishing Server
    • +ProjectWise Solutions
    • +ProjectWise Web View Server
    • ProjectWise Project Insights
    • +ProjectWise Web Cloud Service
    • +ProjectWise Drive
    • +ProjectWise Web View
    • +Microsoft Teams Integration
    • +ProjectWise Workflow Rules Engine
    • +Working from Home with ProjectWise

     
     Questions about this article, topic, or product? Click here. 

    Using ScanRefs.exe

    Scans ProjectWise documents and folders to detect various relationships between the files.

    USAGE:

       scanrefs -d datasource [-u username] [-p password]

                [-mode scanmode]

                [-masters documentlist] [-masterfolders folderlist]

                [-priority folderlist] [-proximity [r:]number] [-order orderlist]

                [-af applicationlist]

                [-l logfile] [-lv]

                [-f paramsfile]

                [-q]

     

    OPTIONS:

       -d datasource    Datasource name to connect to.

       -u username      Username for the datasource connection.

                        If this option is absent, SSO login will be attempted.

       -p password      Password of the datasource user.

                        If this option is absent, password prompt will be shown.

       -mode scanmode   Specifies a list of scanning modes to use.

                        If this option is absent, the tool will operate in "references;linksets" mode.

                         Possible modes:

                           references - scan for references.

                           linksets   - scan DGN documents for link sets.

                           urfcs      - update references from current set - no attempt will be made at creating new sets,

                                        only existing reference sets will be updated. If this mode is enabled, priority or

                                        proximity reference search paths will be ignored.This option is intended to be used after

                                        upgrading a datasource from a pre-V8.1 version.

                                        Note that this mode disables other modes.

                        Modes can be combined:

                           references;linksets - scan for reference documents and for DGN link sets.

     

      -masters documentlist       A list of documents to scan for references and/or linksets.

                                   For more information see notes and example below.

       -masterfolders folderlist   A list of folders to scan for references and/or linksets.

                                   For more information see notes and example below.

     

      -priority folderlist    Enable priority search for reference files in the specified folders.

                               For more information see notes and example below.

     

       -proximity [r:]number   Enable proximity search for reference files <number> levels above the master file's folder.

                               r: switch enables recursive search (includes subfolders).

                               Examples:

                                  -proximity 0   - look for references in the

                                                   master's folder.

                                  -proximity 1   - look for references in the

                                                   parent folder of the master.

                                  -proximity r:1 - look for references in the

                                                   master's folder's parent folder

                                                   and its subfolders.

     

       -order orderlist        Order in which the proximity and priority searches will be done (if both are enabled).

                               If this parameter is not specified, proximity search will take precedence.

                               Examples:

                                  -order proximity;priority - proximity first.

                                  -order priority;proximity - priority first.

     

       -af applicationlist     Application filter for the lists of documents to scan - only the documents with matching

                               application names will be scanned. Example:

                                  -af "MicroStation;AutoCad;Bentley Navigator"

     

       -l logfile              Log file path.

       -lv                     Use verbose logging - write more details to the log file. 

     

       -f paramsfile           Load additional program parameters from the file on the local file system.

      

       -q                      Run in quiet mode. No information will be printed in this mode.

     

    NOTES:

       Folder and document lists are ordered combinations of:

          folder or document paths:

             "Top level folder 1\Subfolder 1.1"

     

          recursive folder paths (includes subfolders):

             "r:Top level folder 1\Subfolder 1.1"

     

          folder or document GUIDs:

             {0031FAC5-9A8B-412A-AF13-F76B26A68E09}

     

          recursive folder GUIDs (includes subfolders):

             r:{0031FAC5-9A8B-412A-AF13-F76B26A68E09}

     

       More complex example:

          -priority "Top level folder 1\Subfolder 1.1;{0031FAC5-9A8B-412A-AF13-F76B26A68E09};r:Top level folder 1\Subfolder 1.2"

     

       Notice that paths are specified without the virtual \Documents\ folder.

     

       Since the lists are ordered, the item first in the list will be processed first.

     

       Furthermore, a number of list parameters of the same name is allowed - in such case their contents will be merged into the same list in the same

       order as those parameters are listed.

     

       For example, the combination of:

          -masterfolders "Top level folder 3" -masterfolders "Top level folder 1;Top level folder 2"

       is equivalent to:

          -masterfolders "Top level folder 3;Top level folder 1;Top level folder 2"

      

       In the rare case when you need to use a GUID as an item name, or an item name starts with r:, you can avoid automatic recognition by prepending the

       name with a backslash character:

          -masterfolders "\{0031FAC5-9A8B-412A-AF13-F76B26A68E09}"

          -masterfolders "r:\{0031FAC5-9A8B-412A-AF13-F76B26A68E09}"

          -masterfolders "\r:{0031FAC5-9A8B-412A-AF13-F76B26A68E09}"

     

    EXAMPLE:

       Let's suppose the documents you are working with are located here:

          pw:\\server.domain.com:datasource\Documents\Top level folder 1

     

       These documents have link sets and they also reference other documents, which are located in the same folder and its subfolders.

     

       You can use the following command line to detect the relationships between these documents on ProjectWise:

          scanrefs -d server.domain.com:datasource -u user -masterfolders "Top level folder 1" -proximity r:0

     

       You could also use priority search instead:

          scanrefs -d server.domain.com:datasource -u user -masterfolders "Top level folder 1" -priority "r:Top level folder 1"

    • ScanRefs.exe
    • ProjectWise Explorer Client
    • Share
    • History
    • More
    • Cancel
    • Greg Holland Created by Bentley Colleague Greg Holland
    • When: Mon, Nov 5 2018 4:30 PM
    • Greg Holland Last revision by Bentley Colleague Greg Holland
    • When: Mon, Nov 5 2018 4:33 PM
    • Revisions: 2
    • Comments: 0
    Recommended
    Related
    Communities
    • Home
    • Getting Started
    • Community Central
    • Products
    • Support
    • Secure File Upload
    • Feedback
    Support and Services
    • Home
    • Product Support
    • Downloads
    • Subscription Services Portal
    Training and Learning
    • Home
    • About Bentley Institute
    • My Learning History
    • Reference Books
    Social Media
    •    LinkedIn
    •    Facebook
    •    Twitter
    •    YouTube
    •    RSS Feed
    •    Email

    © 2021 Bentley Systems, Incorporated  |  Contact Us  |  Privacy |  Terms of Use  |  Cookies