Directory and File Pathnames Reader Parameters
Path Parameters
Specifies the search pattern to use when looking for files and folders. Only filenames and folder names that match the Path Filter will be output as features.
Special Characters Supported |
|
---|---|
? |
Matches any single character. |
* |
Matches any sequence of zero or more characters. |
** |
Matches the current folder and recursively all subfolders. |
[chars] |
Matches any single character in chars. If chars contains a sequence of the form a-b then any character between a and b (inclusive) will match. |
{ab, cd,e,...} |
Matches any of the strings ab, cd, e, etc. |
Notes:
- If the value supplied is a relative path, then it will be respective to the dataset.
- If it is an absolute or UNC path, then it will be treated as such. Note that some expressions may not be interpreted correctly as absolute or UNC paths due to other characters in the pattern.
- Because the pattern is a regular expression, using forward slashes as separators will provide the best results because forward slashes do not conflict with either glob escape characters or UNC path names.
Examples | |
---|---|
C:/data/*.dgn |
expands to all files in the c:\data folder that end with a .dgn extension |
C:/data/**/*.dgn |
expands to all files in the c:\data folder and any subfolder below it that ends with a .dgn extension |
C:/**/*.dgn |
expands to all files on the entire C: drive that end with a .dgn extension |
C:/{data,archive}/*.dgn |
expands to all files in the c:\data and c:\archive folders that end with a .dgn extension |
C:/{data,archive}/92*.dgn |
expands to all files in the c:\data and c:\archive folders that start with 92 and end with a .dgn extension |
/data/92?034.dgn |
expands to all files in the <dataset>\data folder that start with 92, have any letter or number next, and end with 034.dgn |
/data/92[a-z]034.dgn |
expands to all files in the <dataset>\data folder that start with 92, have any lowercase letter next, and end with 034.dgn |
How to access the Path filter after initial workspace generation.
C:\data\*.dgn |
Single backslashes are interpreted as escape characters in the pattern and must be escaped themselves to be treated as literals. For example: C:/data/*.dgn |
\\myfolder\*.csv |
If myfolder is a folder instead of a host, this will fail. Instead, use forward slashes for UNC paths and omit the leading separator for relative paths. For example: //myhost/*.csv myfolder/*.csv |
C[:]/*.txt |
Sometimes specifying the glob pattern syntax can conflict with the path interpretation. Depending on the conflict, there may or may not be combinations of dataset and filter that will succeed. |
C:\\**\\*.dgn |
** glob expansions only work with forward slashes. To avoid this issue, use forward slashes for path separators. For example, use C:/**/*.dgn instead. |
Specifies whether to search for both files and folders, files only, or folders only.
Specifies whether to populate the path_modified_date, path_accessed_date, path_created_date, path_filesize, path_ownername, and path_readonly attributes for files and folders with the corresponding timestamps, file size, owner name and read-only attributes.
If set to No, the attributes will still exist but with their values set to “”.