{"data":{"allMdx":{"nodes":[{"frontmatter":{"title":"Page not found","description":null},"rawBody":"---\ntitle: Page not found\n---\n\nimport { Box } from '@xstyled/styled-components'\nimport { Article, ScreenContainer, Button } from '../components'\nimport { Link } from \"gatsby\"\nimport notFoundImageURL from '../images/404.png'\n\n<Article style={{ textAlign: 'center', overflow: 'hidden' }}>\n  <ScreenContainer mt={5} position=\"relative\">\n    <Box forwardedAs=\"h1\" m={0}>\n      There's a leak in the website.\n    </Box>\n    <Box\n      forwardedAs=\"img\"\n      alt=\"Leak illustration\"\n      src={notFoundImageURL}\n      width={500}\n      height=\"auto\"\n      mt={{ xs: '-20%', md: -100 }}\n      mb={{ xs: '-10%', md: -30 }}\n    />\n    <Box forwardedAs=\"p\" my={3} mx=\"auto\" fontSize=\"1.5em\">\n      The page you are looking for does not actually exist.\n    </Box>\n    <div>\n      <Button forwardedAs={Link} to=\"/\">\n        Back to home\n      </Button>\n    </div>\n  </ScreenContainer>\n</Article>\n","slug":"404"},{"frontmatter":{"title":"","description":null},"rawBody":"---\nslug: /\nredirect: /docs/\n---\n","slug":""},{"frontmatter":{"title":"Overview","description":"overview"},"rawBody":"---\ntitle: Overview\nsection: Background Service\ndescription: overview\norder: 1\n---\n\n\n# Background Service Overview\n\n<br />\n\nMost of the Upload Client functionality is provided by a Windows service, software that runs in the background and is started automatically when the computer is turned on. This is what allows the detection and transfer of new files to continue even when the [User Interface](/docs/user-interface/main-window/) is closed and the user is logged off.\n\n\n## Details\n\nThe background service is named \"Pathcore Upload Background\" and can be managed using the standard Windows service administration tools (Control Panel > System and Security > Administrative Tools > Services).\n\nThe service runs as the \"Local System\" account by default.\n\n<details>\n\n <summary> To manually install the \"Pathcore Upload Background\" service </summary>\n\n 1. Click on the **Start** button at the bottom left of the screen\n\n 2. In the search bar, enter the following:\n    ```\n    %ProgramFiles%\\Pathcore Upload Client\\upload_background_service.exe /i\n    ```\n\n 3. Run the command as Administrator\n\n</details>\n\n<details>\n\n <summary> To stop the \"Pathcore Upload Background\" service </summary>\n\n <div class=\"warning\">\n   If the service is stopped or uninstalled, files will not be transferred to PathcoreFlow.\n </div>\n\n 1. Click on the **Start** button at the bottom left of the screen\n\n 2. Click on **Settings**\n\n 3. In the search bar enter \"Control Panel\" and click on the result that matches\n\n 4. Click on **System and Security**\n\n 5. Click on **Administrative Tools**\n\n 6. Open **Services**\n\n 7. Locate the \"Pathcore Upload Background\" service and right-click on it to bring up the context menu\n\n 9. Click **Stop**\n\n</details>\n\n<details>\n\n <summary> To manually uninstall the \"Pathcore Upload Background\" service </summary>\n\n <div class=\"warning\">\n   If the service is stopped or uninstalled, files will not be transferred to PathcoreFlow.\n </div>\n\n 1. Stop the \"Pathcore Upload Background\" service\n\n 2. Click on the **Start** button at the bottom left of the screen\n\n 3. In the search bar, enter the following:\n    ```\n    %ProgramFiles%\\Pathcore Upload Client\\upload_background_service.exe /u\n    ```\n\n 4. Run the command as Administrator\n\n</details>\n","slug":"docs/background-service/overview"},{"frontmatter":{"title":"Initial Set Up Guide","description":"initial set up guide"},"rawBody":"---\ntitle: Initial Set Up Guide\nsection: Upload Client\ndescription: initial set up guide\norder: 3\n---\n\n# Initial Set Up Guide\n\n<br />\n\n1. Log in. See the [User Account](/docs/user-interface/user-account/) page for more details\n\n   1. Open the main user interface\n\n   2. Click on the ![Log in](../images/login.svg) **Log in** button at the top left of the window\n\n   3. Enter the URL of your PathcoreFlow service in the **Server** field (e.g. `https://example.pathcore.com` or `http://192.168.0.120`)\n\n   4. Enter your email address in the **Username** field (e.g. `john.smith@example.com`)\n\n   5. Enter your password in the **Password** field\n\n   6. Click on the **Log In** button\n\n2. Configure the basic Upload Client settings\n\n   1. Click on the ![Open Settings](../images/gear.svg) **Open Settings** button in the Action Bar at the top of the main window to display the Settings window\n\n   2. Click on the ![Folder](../images/folder.svg) button to open the **Select a Directory** dialog window and browse to the desired watch folder\n\n   3. (Optional) Set the **Scan Depth**, **Scan Schedule**, **Stable Threshold**, and/or **Filter Conditions**. See the [Settings](/docs/user-interface/settings/) page for more details\n\n   4. Click on the **Apply** button in the **Settings** window to save your changes\n\n3. Click on the ![Resume](../images/play.svg) **Resume** button in the Action Bar at the top of the main window to begin the scanning process\n","slug":"docs/upload-client/initial-set-up-guide"},{"frontmatter":{"title":"Overview","description":"overview"},"rawBody":"---\ntitle: Overview\nsection: Upload Client\ndescription: overview\norder: 0\n---\n\n\n# Overview\n\n<br />\n\nThe Upload Client is a Windows utility designed to automate uploads to a PathcoreFlow installation. It can be configured to monitor a folder and automatically upload files to PathcoreFlow as they are added. Optionally, files with certain extensions can be ignored, and the Upload Client can handle MRXS and VSI multi-file images. PathcoreFlow’s API is used to communicate with the PathcoreFlow server over HTTPS on port 443.\n\nThe Upload Client has two main components: a [background service](/docs/background-service/overview/) that monitors a specified folder, and the [user interface](/docs/user-interface/main-window/) that shows upload progress and lets you change configuration settings.\n\n\n## Features\n\nThe Upload Client provides some additional features to facilitate data ingestion into PathcoreFlow:\n- Files can be [filtered](/docs/user-interface/settings/#filter-conditions) based on extension, folder, or file name\n- Support for multi-file images, including VSI, MRXS, NDPIS, and AFI\n- [Custom metadata fields](/docs/user-interface/custom-fields/) for uploaded files, such as a scan workstation name\n- Transfers can be paused and resumed at any time\n- Active file transfers continue when the user interface is closed, and even continue when the Windows user is logged out thanks to the [background service](/docs/background-service/overview/)\n\n\n## Requirements\n\nThe Upload Client can only be installed on a computer running the Windows operating system.\n\nA valid user account is necessary to connect the Upload Client to PathcoreFlow. This user account, which may be a limited upload account rather than an individual's user account, has the following requirements:\n- Access to all Team content in the Repository. See the [Accessible Content](https://docs.pathcore.com/flow/manual/latest/docs/settings/accessible-content/) page in the PathcoreFlow user manual for more details.\n- The following [permission flags](https://docs.pathcore.com/flow/manual/latest/docs/settings/permissions/) are needed:\n  - Team Permissions \\> Manage uploaded files\n  - File Permissions \\> Upload\n- Additional functions of the Upload Client require these permissions:\n  - Folder Permissions \\> View: to launch PathcoreFlow from the Upload Client\n  - Image Permissions \\> View: to open uploaded images in PathcoreFlow\n  - Image Permissions \\> Edit metadata: to apply custom fields to images\n  - File Permissions \\> View: to open other uploaded files in PathcoreFlow\n  - File Permissions \\> Edit metadata: to apply custom fields to other files\n","slug":"docs/upload-client/overview"},{"frontmatter":{"title":"Installation Guide","description":"installation guide"},"rawBody":"---\ntitle: Installation Guide\nsection: Upload Client\ndescription: installation guide\norder: 2\n---\n\n# Upload Client Installation Guide\n\n<br />\n\n1. Run the setup file executable\n\n2. Click on the **Next** button\n   ![Upload Client Setup - 01](../images/uc-installer-01.png)\n\n3. Accept the License Agreement by clicking on the **I Agree** button\n   ![Upload Client Setup - 02](../images/uc-installer-02.png)\n\n4. Select a location for installation and click on the **Next** button\n   ![Upload Client Setup - 03](../images/uc-installer-03.png)\n\n5. Select a Start Menu folder and click on the **Next** button\n   ![Upload Client Setup - 04](../images/uc-installer-04.png)\n\n6. Review the list of components to install and the space required. Click on the **Install** button to begin the installation\n   ![Upload Client Setup - 05](../images/uc-installer-05.png)\n\n7. Wait for the installation to complete then click on the **Next** button\n   ![Upload Client Setup - 06](../images/uc-installer-06.png)\n\n8. The Upload Client is now installed. Click on the **Finish** button\n   ![Upload Client Setup - 07](../images/uc-installer-07.png)\n\n9. At this point it is recommended to copy the Pathcore Upload Client shortcut from the Start Menu to your Desktop and/or pin it to the taskbar\n","slug":"docs/upload-client/installation-guide"},{"frontmatter":{"title":"","description":null},"rawBody":"---\nslug: /docs/\ntitle: \"\"\norder: 0\n---\n\n\n# Pathcore Upload Client\n\n## User Manual\n\n[Release Notes - v2.0](https://docs.pathcore.com/upload-client/release-notes/v2.0/)\n\n- Upload Client\n  - [Overview](/docs/upload-client/overview/)\n  - [Installation Guide](/docs/upload-client/installation-guide/)\n  - [Initial Set Up Guide](/docs/upload-client/initial-set-up-guide/)\n  - [Support](/docs/upload-client/support/)\n- User Interface\n  - [Main Window](/docs/user-interface/main-window/)\n  - [User Account](/docs/user-interface/user-account/)\n  - [Settings](/docs/user-interface/settings/)\n  - [Settings (Advanced)](/docs/user-interface/settings-advanced/)\n  - [Custom Fields](/docs/user-interface/custom-fields/)\n  - [Upload History](/docs/user-interface/upload-history/)\n- Background Service\n  - [Overview](/docs/background-service/overview/)\n","slug":"docs/"},{"frontmatter":{"title":"Support","description":"support"},"rawBody":"---\ntitle: Support\nsection: Upload Client\ndescription: support\norder: 4\n---\n\n# Support\n\n<br />\n\n\n## File Locations\n\nThe Upload Client stores files in the following locations:\n\n| Location                                | Description |\n| ---                                     | --- |\n| `%ALLUSERSPROFILE%\\Pathcore\\Upload`     | Folder containing the background service database and log files |\n| `%APPDATA%\\Pathcore\\Upload Client.ini`  | Upload Client configuration file |\n| `%LOCALAPPDATA%\\Pathcore\\Upload Client` | Folder containing the client log files |\n| `%ProgramFiles%\\Pathcore Upload Client` | The executable and shared libraries default install location |\n\n\n## Uninstall\n\nRemoving the software requires administrator rights. Please consult with your local IT support for assistance.\n\n<details>\n\n <summary> To uninstall the Upload Client from Apps & Features </summary>\n\n 1. Click on the Start button, then Settings, then Apps\n\n 2. Click on \"Pathcore Upload Client\" in the list of Apps\n\n 3. Click on the **Uninstall** button\n\n 4. Follow the instructions on the screen to remove the software\n\n</details>\n\n<details>\n\n <summary> To manually uninstall the Pathcore Upload Client </summary>\n\n 1. Click on the **Start** button at the bottom left of the screen\n\n 2. In the search bar, enter the following:\n    ```\n    %ProgramFiles%\\Pathcore Upload Client\\Uninstall.exe\n    ```\n\n 3. Run the command as Administrator\n\n 4. Follow the instructions on the screen to remove the software\n\n</details>\n\n\n## Contact Support\n\nIf you require additional assistance, please use the following link to request help:\n\n  [Submit Support Request](https://pathcore.freshdesk.com/support/tickets/new)\n","slug":"docs/upload-client/support"},{"frontmatter":{"title":"Custom Fields","description":"custom fields"},"rawBody":"---\ntitle: Custom Fields\nsection: User Interface\ndescription: custom fields\norder: 5\n---\n\n# Custom Fields\n\n<br />\n\nWith 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).\n\n<div class=\"info\">\n  In order to apply custom fields, the user account used to connect the Upload Client to PathcoreFlow requires the Edit metadata permission flag.\n</div>\n\n\n## Values\n\nFields 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.\n\nFor more information, see the [Custom Fields](https://docs.pathcore.com/flow/manual/latest/docs/metadata/custom-fields/) page of the PathcoreFlow user manual.\n\n<details>\n\n <summary> To add a Value custom field </summary>\n\n 1. Click on the ![Open Custom Fields](../images/label.svg) **Open Custom Fields** button in the Action Bar at the top of the main window to display the Custom Fields window\n\n 2. Click on the ![Add Custom Field](../images/plus.svg) 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**\n\n 3. In the **Custom Field** popup dialog:\n    1. Click on the **Value** tab\n    2. Enter the **Name** of the metadata field in PathcoreFlow\n    3. Enter the **Value** to apply to the field\n    4. Click on the **Apply** button to save your changes, or click on the **Cancel** button to cancel\n\n 4. Click on the **Apply** button in the **Custom Fields** window to save your changes\n\n</details>\n\n\n## File Properties\n\nA **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.\n\n<details>\n\n <summary> To add a File Property custom field </summary>\n\n 1. Click on the ![Open Custom Fields](../images/label.svg) **Open Custom Fields** button in the Action Bar at the top of the main window to display the Custom Fields window\n\n 2. Click on the ![Add Custom Field](../images/plus.svg) 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**\n\n 3. In the **Custom Field** popup dialog:\n    1. Click on the **File Property** tab\n    2. Enter the **Name** of the metadata field in PathcoreFlow\n    3. Select the desired information from the **Value** dropdown menu:\n       - **Relative Path**: the local path to the file, relative to the defined scan folder\n       - **Absolute Path**: the local path to the file\n       - **Size**: the size of the file, in bytes\n       - **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)\n\n    4. Click on the **Apply** button to save your changes, or click on the **Cancel** button to cancel\n\n 4. Click on the **Apply** button in the **Custom Fields** window to save your changes\n\n</details>\n\n\n## Environment Variables\n\nAn **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).\n\n<div class=\"info\">\n  The Upload Client background service runs as a local system account, and it is in that context that the environment variables are resolved. This means that values from the currently logged in user are NOT available.\n</div>\n\n<details>\n\n <summary> To add an Environment custom field </summary>\n\n 1. Click on the ![Open Custom Fields](../images/label.svg) **Open Custom Fields** button in the Action Bar at the top of the main window to display the Custom Fields window\n\n 2. Click on the ![Add Custom Field](../images/plus.svg) 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**\n\n 3. In the **Custom Field** popup dialog:\n    1. Click on the **Environment** tab\n    2. Enter the **Name** of the metadata field in PathcoreFlow\n    3. Enter the name of the local environment variable to use in the **Value** field\n    4. Click on the **Apply** button to save your changes, or click on the **Cancel** button to cancel\n\n 4. Click on the **Apply** button in the **Custom Fields** window to save your changes\n\n</details>\n\n<details>\n\n <summary> Example environment variables in Windows </summary>\n\n - **COMPUTERNAME**: The name assigned to the local workstation\n - **OS**: Current operating system\n\n</details>\n\n\n## Managing Custom Fields\n\n<details>\n\n <summary> To edit an existing custom field </summary>\n\n 1. Click on the ![Open Custom Fields](../images/label.svg) **Open Custom Fields** button in the Action Bar at the top of the main window to display the Custom Fields window\n\n 2. Right-click on the item in the custom fields list to bring up the context menu\n\n 3. Click **Edit**\n\n 4. In the **Custom Field** popup dialog:\n    1. Make the desired changes to the field settings\n    2. Click on the **Apply** button to save your changes, or click on the **Cancel** button to cancel\n\n 5. Click on the **Apply** button in the **Custom Fields** window to save your changes\n\n</details>\n\n<details>\n\n <summary> To remove a custom field </summary>\n\n 1. Click on the ![Open Custom Fields](../images/label.svg) **Open Custom Fields** button in the Action Bar at the top of the main window to display the Custom Fields window\n\n 2. Right-click on the item in the custom fields list to bring up the context menu\n\n 3. Click **Delete**\n\n 4. Click on the **Yes** button to confirm\n\n 5. Click on the **Apply** button in the **Custom Fields** window to save your changes\n\n</details>\n\n<details>\n\n <summary> To remove all custom fields </summary>\n\n <div class=\"warning\">\n   There is no undo option after removing all custom fields.\n </div>\n\n 1. Click on the ![Open Custom Fields](../images/label.svg) **Open Custom Fields** button in the Action Bar at the top of the main window to display the Custom Fields window\n\n 2. Click on the **Clear All** button at the top right of the filter list\n\n 3. Click on the **Yes** button to confirm\n\n</details>\n","slug":"docs/user-interface/custom-fields"},{"frontmatter":{"title":"Main Window","description":"main window"},"rawBody":"---\ntitle: Main Window\nsection: User Interface\ndescription: main window\norder: 1\n---\n\n# Main Window\n\n<br />\n\nThe main window of the Upload Client shows the current status of active uploads, recent activity, and provides access to both the PathcoreFlow web application and the local folder it is monitoring for new files.\n\n<div class=\"info\">\n  When the main user interface window is closed, the background service continues to upload files and monitor the scan folder for new images.\n</div>\n\n\n## Action Bar\n\nAt the top of the main window is the Action Bar, which includes buttons for many common activities.\n\n- ![Log in](../images/login.svg) **Log in** / Username: Log in to PathcoreFlow, or log out the current active user\n- ![Pause](../images/pause.svg) **Pause** / ![Resume](../images/play.svg) **Resume**:\n  - **Pause**: Stops active uploads and scanning for new files until the user resumes\n  - **Resume**: Resumes any paused transfers and restarts the scheduled scan of new files\n- ![Launch PathcoreFlow](../images/open.svg) **Launch PathcoreFlow**: Opens PathcoreFlow in your default web browser\n- ![Open Folder](../images/folder.svg) **Open Folder**: Opens the folder which the client is monitoring for new files in Windows Explorer\n- ![Open Settings](../images/gear.svg) **Open Settings**: Displays the [Settings](/docs/user-interface/settings/) window\n- ![Open Custom Fields](../images/label.svg) **Open Custom Fields**: Displays the [Custom Fields](/docs/user-interface/custom-fields/) window\n\n<details>\n\n <summary> To pause/resume all uploads </summary>\n\n - Click on the ![Pause](../images/pause.svg) **Pause** button in the Action Bar at the top of the main window to pause all activity, or\n\n - Click on the ![Resume](../images/play.svg) **Resume** button in the Action Bar at the top of the main window to resume transfers\n\n</details>\n\n\n## Active Uploads\n\nThis section displays a list of currently active file transfers. When completed, items are moved to the [Recent Uploads](#recent-uploads) section.\n\n<details>\n\n <summary> To upload a file </summary>\n\n 1. Click on the ![Open Folder](../images/folder.svg) **Open Folder** button from the Action Bar at the top of the main window to open the monitored folder in Windows Explorer\n\n 2. Copy a file into this folder, and the Upload Client will automatically begin the transfer\n\n\n <div class=\"info\"><div>\n   The upload will not start instantly. The background service polls the scan folder according to the <strong>Scan Schedule</strong> defined by the user in the Settings.\n </div></div>\n\n</details>\n\n<details>\n\n <summary> To see the current transfer rate of an active upload </summary>\n\n 1. Locate the item in the Active Uploads list\n\n 2. Hover over the progress bar of the item with the cursor. A tooltip will appear which includes the amount of data uploaded, the total size of the item, and the current transfer rate\n\n</details>\n\n<details>\n\n <summary> If the progress bar for an upload is red </summary>\n\n This indicates that a problem has occurred:\n - Hover over the progress bar of the item with the cursor. A tooltip will appear which provides additional information\n - Consult the [Status Bar](#status-bar) at the bottom of the window for any relevant error messages\n\n</details>\n\n\n## Recent Uploads\n\nThis section displays a list of the most recently completed file transfers.\n\n<details>\n\n <summary> To open a transferred file in PathcoreFlow </summary>\n\n 1. Locate the item in the Recent Uploads list\n\n 2. Click on the item name to open it in PathcoreFlow in your default web browser\n\n\n <div class=\"info\">\n   If the item has been deleted from PathcoreFlow, clicking on its name in this list will do nothing.\n </div>\n\n <br />\n\n <div class=\"info\">\n   If the user account used to connect the Upload Client to PathcoreFlow does not have the required permissions to view the item, clicking on it will also do nothing.\n </div>\n\n</details>\n\n\n## Status Bar\n\nAt the bottom of the main window of the user interface is the Status Bar. This displays a message reflecting the state of the Upload Client to the user.\n\nSome examples of messages:\n- \"x/y Files uploaded...\": A running count of the number of successful transfers and how many total items are to be uploaded\n- \"Uploads paused.\": Transfers have been paused by the user. They can be resumed by clicking on the **Resume** button in the [Action Bar](#action-bar)\n- \"Unable to connect to the server. Please try again later.\": A network problem is preventing the Upload Client from reaching PathcoreFlow. Transfer will resume automatically when the network problem is resolved\n","slug":"docs/user-interface/main-window"},{"frontmatter":{"title":"Settings (Advanced)","description":"settings (advanced)"},"rawBody":"---\ntitle: Settings (Advanced)\nsection: User Interface\ndescription: settings (advanced)\norder: 4\n---\n\n# Settings (Advanced)\n\n<br />\n\n## Custom Cron Expressions\n\nThe Upload Client supports great flexibility in its scan schedule via custom cron expressions. A cron expression is 6 fields representing a time schedule of the form:\n\n```\n<seconds> <minutes> <hours> <days of month> <months> <days of week>\n```\n\n\n### Allowed Values\n\nThe following values are allowed in the corresponding cron fields:\n\n| Field         | Allowed Value | Special Characters |\n| ---           | ---           | --- |\n| seconds       | 0-59          | `*` `,` `-` |\n| minutes       | 0-59          | `*` `,` `-` |\n| hours         | 0-23          | `*` `,` `-` |\n| days of month | 1-31          | `*` `,` `-` `?` `L` `W` |\n| months        | 1-12          | `*` `,` `-` |\n| days of week  | 0-6           | `*` `,` `-` `?` `L` `#` |\n\n\n### Cron Special Characters\n\n| Special Character | Meaning           | Description |\n| ---               | ---               | ---         |\n| `*`               | all values        | selects all values within a field |\n| `?`               | no specific value | specify one field and leave the other unspecified |\n| `-`               | range             | specify ranges |\n| `,`               | comma             | specify additional values |\n| `/`               | slash             | specify increments |\n| `L`               | last              | last day of the month or last day of the week |\n| `W`               | weekday           | the weekday nearest to the given day |\n| `#`               | nth               | specify the Nth day of the month |\n\n\n### Cron Expression Examples\n\n- At 22:00 on every day-of-week from Monday through Friday:\n  ```\n  0 0 22 * * 1-5\n  ```\n\n- At the 12<sup>th</sup> minute past every 4<sup>th</sup> hour:\n  ```\n  0 12 */4 * * *\n  ```\n\n- Every 10 minutes overnight between 5:00 p.m. and 7:50 a.m.:\n  ```\n  0 */10 17-23,0-7 * * *\n  ```\n\nAdditional information about cron can be found on [Wikipedia](https://en.wikipedia.org/wiki/Cron), or by consulting the [croncpp library](https://github.com/mariusbancila/croncpp).\n\n\n## Regular Expressions\n\nA regular expression is a notation that specifies a search pattern. The **RegEx** filter condition provided by the Upload Client is based on [Perl Compatible Regular Expressions (PCRE)](https://www.pcre.org/). A comprehensive guide to regular expressions is beyond the scope of this manual, however some resources are linked below for reference:\n- A complete [Syntax](https://github.com/google/re2/wiki/Syntax) reference for the expressions is available.\n- The article on [regular expressions](https://en.wikipedia.org/wiki/Regular_expression) at Wikipedia.\n\n\n### Regular Expression Examples\n\n- Match files with either \"slide\" or \"WSI\" in the file name:\n  ```\n  .*(slide|WSI).*\n  ```\n\n- A more complex match based on a specific file name format:\n  ```\n  202[123][01]\\d\\d\\d- Slide \\d\\d\\d-\\d\\d-[ABC]S1.*\\.svs\n  ```\n  - This would match the following file names:\n    - `20220724 Slide 123-45-BS1 - Sample taken from lab 42.svs`\n    - `20211113 Slide 987-65-AS1 - wsi_test_scan.svs`\n    - `20211113 Slide 345-67-CS1.svs`\n  - But not these:\n    - `20192602 Slide 56-4738-29.svs`: invalid date and wrong number sequence\n    - `20220724 Slide 123-45-BS1.mrxs`: wrong file extension\n\n","slug":"docs/user-interface/settings-advanced"},{"frontmatter":{"title":"Settings","description":"settings"},"rawBody":"---\ntitle: Settings\nsection: User Interface\ndescription: settings\norder: 3\n---\n\n# Settings\n\n<br />\n\nThere are several configurable settings to customize the behavior of the Upload Client.\n\n<details>\n\n <summary> To access the Settings window </summary>\n\n 1. Open the main user interface\n\n 2. Click on the ![Open Settings](../images/gear.svg) **Open Settings** button in the Action Bar at the top of the window\n\n</details>\n\n\n## Directory Scanning\n\n\n### Scan Directory\n\nThe scan directory is the location on the local computer or network to monitor for new files. Files placed in this folder are automatically uploaded to PathcoreFlow.\n\nEnter the path to the folder in the field, or use the ![Folder](../images/folder.svg) button to open the **Select a Directory** dialog window and browse to the desired folder.\n\n\n### Scan Depth\n\nThe scan depth determines how many subfolders deep to scan for new files.\n\n- If set to `-1` (the default), the Upload Client will scan all subfolders recursively\n- If set to `0`, the Upload Client will only scan the specified folder. It will not scan subfolders\n- If set to a positive value, the Upload Client will scan that number of levels deep into subfolders\n\nSetting the scan depth to `0` or a positive value can be useful for preventing the Upload Client from unnecessarily scanning into a nested archive folder structure, for example.\n\n\n### Scan Schedule\n\nThe scan schedule determines how often the [background service](/docs/background-service/overview/) checks the specified folder for new files to upload.\n\nThe default scan schedule is \"every 10 minutes\".\n\n<details>\n\n <summary> To set the scan schedule </summary>\n\n 1. Click on the ![Open Settings](../images/gear.svg) **Open Settings** button in the Action Bar at the top of the main window to display the Settings window\n\n 2. Click on the **Edit** button next to the current **Scan Schedule** value\n\n 3. In the **Set Search Schedule** popup dialog:\n    1. Select how often you want to scan: **Minutes**, **Daily**, **Weekly**, or **Custom (Advanced)**\n    2. Adjust the value according to the base schedule you have selected:\n       - **Minutes**: How many minutes between each scan\n       - **Daily**: The time of each day to perform a scan\n       - **Weekly**: The number of weeks between each scan\n       - **Custom (Advanced)**: A [custom cron expression](/docs/user-interface/settings-advanced/#custom-cron-expressions)\n    3. Click on the **Apply** button to save your changes, or click on the **Cancel** button to cancel\n\n 4. Click on the **Apply** button in the **Settings** window to save your changes\n\n\n <div class=\"info\"><div>\n   The next five (5) scheduled scan times, based on the current configuration, are displayed at the bottom of the dialog under <strong>Next Scheduled Scans</strong>\n </div></div>\n\n</details>\n\n\n### Stable Threshold\n\nThe stable threshold is the amount of time a file must remain unchanged before the Upload Client considers it ready to begin processing. This prevents the problem of files being uploaded while still in the process of being created (e.g. a WSI in the mid-point of being written from a scanner).\n\n<details>\n\n <summary> To set the stable threshold </summary>\n\n 1. Click on the ![Open Settings](../images/gear.svg) **Open Settings** button in the Action Bar at the top of the main window to display the Settings window\n\n 2. Enter the number of seconds, minutes, or hours you want to wait before uploading a file into the **Stable Threshold** field\n\n 3. Select the desired time unit from the dropdown menu: **second(s)**, **minute(s)**, or **hour(s)**\n\n 4. Click on the **Apply** button in the **Settings** window to save your changes\n\n</details>\n\n\n## Filter Conditions\n\nFilter conditions allow you to limit which files are processed by the Upload Client, by matching against the file extension, folder name, or a custom [regular expression](/docs/user-interface/settings-advanced/#regular-expressions).\n\n<div class=\"info\"><div>\n  If you create an <strong>Include</strong> filter, all non-matching files are automatically excluded from processing.\n</div></div>\n\n<details>\n\n <summary> To add a filter based on file extension </summary>\n\n 1. Click on the ![Open Settings](../images/gear.svg) **Open Settings** button in the Action Bar at the top of the main window to display the Settings window\n\n 2. Click on the ![Add Filter Condition](../images/plus.svg) button at the top right of the filter list\n\n 3. In the **Filter Condition** popup dialog:\n    1. Click on the **File Extension** tab\n    2. Select the desired file type from the **Extension** dropdown menu\n    3. Select whether to **Include** or **Exclude** the selected file type\n    4. Click on the **Apply** button to save your changes, or click on the **Cancel** button to cancel\n\n 4. Click on the **Apply** button in the **Settings** window to save your changes\n\n</details>\n\n<details>\n\n <summary> To add a filter based on folder name </summary>\n\n 1. Click on the ![Open Settings](../images/gear.svg) **Open Settings** button in the Action Bar at the top of the main window to display the Settings window\n\n 2. Click on the ![Add Filter Condition](../images/plus.svg) button at the top right of the filter list\n\n 3. In the **Filter Condition** popup dialog:\n    1. Click on the **Folder** tab\n    2. Enter the relative path to the folder in the field, or use the ![Folder](../images/folder.svg) button to open the **Select a Directory** dialog window and browse to the desired folder.\n    3. Select whether to **Include** or **Exclude** the selected folder\n    4. Click on the **Apply** button to save your changes, or click on the **Cancel** button to cancel\n\n 4. Click on the **Apply** button in the **Settings** window to save your changes\n\n</details>\n\n<details>\n\n <summary> To add a filter based on a regular expression </summary>\n\n 1. Click on the ![Open Settings](../images/gear.svg) **Open Settings** button in the Action Bar at the top of the main window to display the Settings window\n\n 2. Click on the ![Add Filter Condition](../images/plus.svg) button at the top right of the filter list\n\n 3. In the **Filter Condition** popup dialog:\n    1. Click on the **RegEx** tab\n    2. Enter a [regular expression](/docs/user-interface/settings-advanced/#regular-expressions) in the field to match against. When it is validated, the \"Invalid\" notice at the bottom right of the dialog will change to \"Valid ![Valid](../images/valid.svg)\"\n    3. Select whether to **Include** or **Exclude** the selected folder\n    4. Click on the **Apply** button to save your changes, or click on the **Cancel** button to cancel\n\n 4. Click on the **Apply** button in the **Settings** window to save your changes\n\n</details>\n\n<details>\n\n <summary> To edit an existing filter condition </summary>\n\n 1. Click on the ![Open Settings](../images/gear.svg) **Open Settings** button in the Action Bar at the top of the main window to display the Settings window\n\n 2. Right-click on the item in the filter conditions list to bring up the context menu\n\n 3. Click **Edit**\n\n 4. In the **Filter Condition** popup dialog:\n    1. Make the desired changes to the filter settings\n    2. Click on the **Apply** button to save your changes, or click on the **Cancel** button to cancel\n\n 5. Click on the **Apply** button in the **Settings** window to save your changes\n\n</details>\n\n<details>\n\n <summary> To remove a filter condition </summary>\n\n 1. Click on the ![Open Settings](../images/gear.svg) **Open Settings** button in the Action Bar at the top of the main window to display the Settings window\n\n 2. Right-click on the item in the filter conditions list to bring up the context menu\n\n 3. Click **Delete**\n\n 4. Click on the **Yes** button to confirm\n\n 5. Click on the **Apply** button in the **Settings** window to save your changes\n\n</details>\n\n<details>\n\n <summary> To remove all filter conditions </summary>\n\n <div class=\"warning\"><div>\n   This will remove all configured filters and cause the Upload Client to process <em>all files</em> in the monitored folder.\n </div></div>\n\n 1. Click on the ![Open Settings](../images/gear.svg) **Open Settings** button in the Action Bar at the top of the main window to display the Settings window\n\n 2. Click on the **Clear All** button at the top right of the filter list\n\n 3. Click on the **Yes** button to confirm\n\n</details>\n","slug":"docs/user-interface/settings"},{"frontmatter":{"title":"Upload History","description":"upload history"},"rawBody":"---\ntitle: Upload History\nsection: User Interface\ndescription: upload history\norder: 6\n---\n\n# Upload History\n\n<br />\n\nThe Upload Client retains the list of all files it uploaded to your PathcoreFlow Repository.\n\n<details>\n\n <summary> To access the Upload History window </summary>\n\n 1. Open the main user interface\n\n 2. Click on the **View Upload History** button at the bottom right of the window\n\n</details>\n\n\n## Details\n\nThe upload history list includes the filename, the date and time the file was uploaded, and the file size. To return to the main window, click on the **Done** button at the bottom right of the window.\n\n<details>\n\n <summary> To filter the upload history list by filename </summary>\n\n 1. Click on the **View Upload History** button at the bottom right of the main window to display the Upload History window\n\n 2. Click in the search box indicated by the ![Search](../images/search.svg) icon\n\n 3. Type in the filter you wish to apply to the filenames. Only the items matching this text will be displayed\n\n</details>\n\n<details>\n\n <summary> To open a transferred file in PathcoreFlow </summary>\n\n 1. (Optional) Use the search box to filter the list of items\n\n 2. Locate the item in the Upload History list\n\n 3. Click on the item name to open it in PathcoreFlow in your default web browser\n\n\n <div class=\"info\">\n   If the item has been deleted from PathcoreFlow, clicking on its name in this list will do nothing.\n </div>\n\n <br />\n\n <div class=\"info\">\n   If the user account used to connect the Upload Client to PathcoreFlow does not have the required permissions to view the item, clicking on it will also do nothing.\n </div>\n\n</details>\n","slug":"docs/user-interface/upload-history"},{"frontmatter":{"title":"User Account","description":"user account"},"rawBody":"---\ntitle: User Account\nsection: User Interface\ndescription: user account\norder: 2\n---\n\n# User Account\n\n<br />\n\nBefore images can be uploaded, a user account must be logged in to connect the Upload Client to PathcoreFlow.\n\n<div class=\"info\"><div>\n  A valid user account is necessary to connect the Upload Client to PathcoreFlow. This user account has certain <a href=\"../../upload-client/overview/#requirements\">requirements</a>.\n</div></div>\n\n<details>\n\n <summary> To log in to the Upload Client </summary>\n\n 1. Open the main user interface\n\n 2. Click on the ![Log in](../images/login.svg) **Log in** button at the top left of the window\n\n 3. Enter the URL of your PathcoreFlow service in the **Server** field (e.g. `https://example.pathcore.com` or `http://192.168.0.120`)\n\n 4. Enter your email address in the **Username** field (e.g. `john.smith@example.com`)\n\n 5. Enter your password in the **Password** field\n\n 6. Click on the **Log In** button\n\n\n <div class=\"info\"><div>\n   If an error occurs during log in, hover the cursor over the <strong>Login failed</strong> message to see more detail about the cause of the problem.\n </div></div>\n\n</details>\n\n<div class=\"info\">\n  While logged in, the User Account window shows the date and time the current credentials will expire.\n</div>\n\n<details>\n\n <summary> To log out from the Upload Client </summary>\n\n 1. Open the user interface\n\n 2. Click on your name at the top left of the window\n\n 3. Click on the **Log Out** button\n\n</details>\n","slug":"docs/user-interface/user-account"}]},"site":{"siteMetadata":{"showSearch":true,"showVersions":true}}}}