How to use custom metadata with integrations to dynamically route Portal packages

Dynamically route Portal packages to the destination you want within an integration workflow

Delivering files to the right place is key to any workflow. By leveraging the metadata collected by a Portal's Custom Form, MASV makes it possible to dynamically route packages to the destination you want for each integration associated with a Portal. This means you can use a single Portal with a single Custom Form to route packages to different locations based on the information the sender provides. For example, if you collect media for sporting events, you can use one MASV Portal to collect video and photos for different sports, saving the files for each sport to a different storage destination within the selected integration.

The destination folder structure does not need to pre-exist–MASV can create the folders required based on what you define in your custom path.

Overview of the process

masv-custom-portal-customize-path

Create a Portal, and set the following customizations:

  1. Custom Form: Create a Custom Form for the Portal or associate an existing Custom Form (template). Include the fields you want to use for routing to a destination folder structure.
  2. Integrations: Enable the Integration(s) you want to use with the Portal.
  3. Customize a path for the Integration. This is where you can set a subdirectory path that includes static and/or dynamic metadata information. The final destination is determined by:
    1. The root folder specified for the integration (not visible in the Customize window).
    2. Target Subdirectory (visible on the left side of the Customize window). If no Target Subdirectory is set, the custom path you set is appended to the root folder.
    3. Custom path: Specified by what you type or select in the Customize box. This is where you can include dynamic metadata elements and/or static elements.
    4. By default, the Package Name (not visible in the Customize window) is inserted as the last folder in the path.

masv-customize-path-for-portal-integration
In the path example above, there is a Target Subdirectory for the integration (/standard), a static path element (sporting-events-2025), and two dynamic custom metadata elements ({sport} and {date}). The root folder and default Package Name folder are not visible.

What type of metadata can be used in a custom path?

The following Custom Form metadata field types can be used in the custom path for your Portal integration:

  • Date Picker: The date the sender selects is formatted in the path as YYYY-MM-DD.
  • Dropdown Select: The option the sender selects in the drop-down menu determines the path.
  • Number Field: Sender can enter any number, so if there is a user error, your intended path is affected.
  • Radio Button: The option the sender selects from the radio button list determines the path.
  • Package Name: A text field used to provide a name for the package. See the section below for details.

Note: To appear as a path option in the Customize window, Custom Form metadata fields must be set as Required or include a Default option.

How does Package Name affect the path?

With the default integration settings, if you choose Package Name for your custom path, the Package Name appears in the path twice. Why? Although Package Name is a supported field, it already has a role–to provide a name for the package folder. The name is user-defined or generated by MASV (Portal name + date-time).

Some integrations (such as Amazon S3 and S3-compatible integrations) provide an option to exclude Package Name from being used for the package folder name (in the corresponding Add Integration or Edit Integration window, enable the Parent Folder Options checkbox).

So why use it for routing? As a text-based field, if you want users to type information that isn’t pre-defined (i.e. not suitable for a radio button or drop-down list), the Package Name field is an option.

To include custom metadata in the path for Portal packages delivered to an integration

  1. In the MASV Web App, select Request Files with Portals from the sidebar on the left.
  2. From the Actions column, select the menu icon for the Portal you want to use, and select Edit from the context menu.
  3. Select the Integrations tab, and from the Customize column, select the Edit icon for the integration you want to use. Note: Only active integrations can be edited (Status column toggle enabled).
  4. In the Customize window, type any static path elements you want and type { (curly bracket) to view a drop-down list of valid custom metadata fields.
  5. Select the metadata fields you want.
  6. Verify that you have the elements you want in your path, and select OK.
  7. Select the Save button in the lower-right corner of the Edit Portal page to apply the changes. masv-customize-path-metadata-list