Browse for File

Asks the signed-in user to pick a file. Windows only, attended runs.

Behaviour

Risk: Low · Idempotent: No · Safe to retry: No · Recovery: Not replayed after a crash

Package System activities VeloPhex.System.Activities 0.7.1-rc.12 · Supported (Core profile) · type id velophex.system.browseForFile

Needs an interactive desktop session

Properties#

Input#

Title#

Title · String · Optional · Default: Not specified in package metadata

The dialog's title.

Filter#

Filter · String · Optional · Default: Not specified in package metadata

Which files the dialog lists, as label|patterns pairs.

Initial Folder#

InitialFolder · String · Optional · Default: Not specified in package metadata

The folder the dialog opens in.

Timeout (ms)#

TimeoutMS · Int32? · Optional · Default: Not specified in package metadata

How many milliseconds to wait for a choice before the step fails. Empty: no limit.

Output#

Selected File#

SelectedFile · String · Output

The full path of the file picked; null when the user cancelled.

Cancelled#

Cancelled · Boolean · Output

Whether the user closed the dialog without picking.

Retry and risk#

This activity is not marked safe to retry: if it fails partway, check whether its work already happened before running it again. If a run is interrupted and the outcome of a step is unknown, the step is never retried automatically (what to do). How activities declare this: characteristics, retries and risk.

Every activity also has the engine's common properties: Timeout and Continue On Error.

Generated from VeloPhex.System.Activities 0.7.1-rc.12. Category: Dialogs. Keywords: browse, select, pick, open, file, dialog, attended, user.

Properties

Input

Output

Retry and risk

Related activities