1E 9.x (on-premises)

FileSystem

Core

Finds directory paths given a leaf directory name.

DirectoryName (string): The name of the directory to be found. This cannot contain path separators and therefore is always just the leaf node of the path (the deepest part of the path).

Fast (boolean; optional, default true): Selects either the fast NTFS search technology or the previous,slower (but fully reliable) technology.

TimeoutSecs (integer; optional, default 600): If the operation has not completed within the specified time period, it will fail with an error.

Exclude (Table, optional): A single column table where each row contains a root relative directory path that you want to exclude from recursive search.

For each directory found:

FileSystem.FindDirectoryByName(DirectoryName:"wibble", Fast:true);

The above method call might find the following on relevant platforms:

C:\Program Files\Acme Corp\Wibble

/usr/local/wibble

But it will never find these:

C:\Program Files\Acme Corp\Wibble\bin

/usr/local/wibble/bin

@exclude =
SELECT
        column1 AS Path
FROM
        ( VALUES
                ("C:\\"),
                ("E:\\IgnoredFolder")
        );

FileSystem.FindDirectoryByName(DirectoryName:"wibble",Exclude:@exclude);

This method searches all fixed disks, which is a resource expensive process and may take some time if Fast=false.

Symbolic links are ignored on non-Windows OS.