Custom Fields
With custom fields, the Upload Client can apply user-defined metadata to all images uploaded to PathcoreFlow. These fields can be a static key-value pair (e.g., a scanner model name), file properties (e.g., the local path from which the image was uploaded), or an environment variable (e.g., the workstation name).
Values
Fields are key-value pairs that can be associated with items in the PathcoreFlow Repository. A Value custom field is a user-defined key-value pair that is applied to every file uploaded to PathcoreFlow from the Upload Client.
For more information, see the Custom Fields page of the PathcoreFlow user manual.
To add a Value custom field
Click on the
Open Custom Fields button in the Action Bar at the top of the main window to display the Custom Fields window
Click on the
button at the top right of the field list, or right-click in the custom fields list to bring up the context menu and click Add
In the Custom Field popup dialog:
- Click on the Value tab
- Enter the Name of the metadata field in PathcoreFlow
- Enter the Value to apply to the field
- Click on the Apply button to save your changes, or click on the Cancel button to cancel
Click on the Apply button in the Custom Fields window to save your changes
File Properties
A File Property custom field is similar to a Value field, but instead of the value being user-defined it is taken from the metadata of the local file before upload.
To add a File Property custom field
Click on the
Open Custom Fields button in the Action Bar at the top of the main window to display the Custom Fields window
Click on the
button at the top right of the field list, or right-click in the custom fields list to bring up the context menu and click Add
In the Custom Field popup dialog:
Click on the File Property tab
Enter the Name of the metadata field in PathcoreFlow
Select the desired information from the Value dropdown menu:
- Relative Path: the local path to the file, relative to the defined scan folder
- Absolute Path: the local path to the file
- Size: the size of the file, in bytes
- Format: the file format. This is not necessarily the same as the file extension (e.g., a PerkinElmer .tiff file would have a format of qptiff)
Click on the Apply button to save your changes, or click on the Cancel button to cancel
Click on the Apply button in the Custom Fields window to save your changes
Environment Variables
An Environment custom field takes it value from an environment variable of the operating system (Windows) where the Upload Client is running. These may be set by the host OS, or by other software and services running on the computer (e.g., scanner management tools).
To add an Environment custom field
Click on the
Open Custom Fields button in the Action Bar at the top of the main window to display the Custom Fields window
Click on the
button at the top right of the field list, or right-click in the custom fields list to bring up the context menu and click Add
In the Custom Field popup dialog:
- Click on the Environment tab
- Enter the Name of the metadata field in PathcoreFlow
- Enter the name of the local environment variable to use in the Value field
- Click on the Apply button to save your changes, or click on the Cancel button to cancel
Click on the Apply button in the Custom Fields window to save your changes
Example environment variables in Windows
- COMPUTERNAME: The name assigned to the local workstation
- OS: Current operating system
Managing Custom Fields
To edit an existing custom field
Click on the
Open Custom Fields button in the Action Bar at the top of the main window to display the Custom Fields window
Right-click on the item in the custom fields list to bring up the context menu
Click Edit
In the Custom Field popup dialog:
- Make the desired changes to the field settings
- Click on the Apply button to save your changes, or click on the Cancel button to cancel
Click on the Apply button in the Custom Fields window to save your changes
To remove a custom field
Click on the
Open Custom Fields button in the Action Bar at the top of the main window to display the Custom Fields window
Right-click on the item in the custom fields list to bring up the context menu
Click Delete
Click on the Yes button to confirm
Click on the Apply button in the Custom Fields window to save your changes
To remove all custom fields
Click on the
Open Custom Fields button in the Action Bar at the top of the main window to display the Custom Fields window
Click on the Clear All button at the top right of the filter list
Click on the Yes button to confirm