Other Topic Library Versions

Adding an export rule

The GV STRATUS Rules Engine can watch a source location that is in the GV STRATUS system and export assets that match your criteria to a location that is external to the GV STRATUS system. An export rule can export clips, subclips, and playlists. For playlists, a conform job is automatically triggered to render the complex asset as a simple clip. The Rules Engine exports the assets to the destination that you configure. If an asset already exists at the destination location, the Rules Engine appends a suffix to the asset file name so that the export can succeed without overwriting the existing asset. For an export rule, only K2 storage locations are available as the source scope. Other locations, such as FTP, are not available.
  1. Log in to the GV STRATUS Control Panel application with administrator privileges.
  2. In the GV STRATUS Control Panel application, click General | Rules.
  3. Click Add. Rules Editor settings open.
  4. In the Rule Type drop-down list select Export.
  5. In the Name field type in a name for the rule you are configuring.
  6. In the Description field type in a description for the rule you are configuring.
  7. In Rule Options settings, specify the rule behavior.

    1. Select whether the rule copies or moves the asset. If you select move, after the rule exports the asset, it removes the source asset from the GV STRATUS system.
    2. Select when the rule is applied each asset.
      • Execute rule only once per asset: The rule is applied once per asset. The Rules Engine uses data stored in the asset's ExecutedByRules metadata field to determine if the rule has been applied to the asset. If it has been applied, the Rules Engine does not apply it again, even if the rule criteria still match for the asset.
      • Execute every time rule conditions apply: The rule can be applied multiple times per asset, if the asset matches rule conditions multiple times.
    3. Select the priority that the Rules Engine processes the rule, with the transfers and transcodes the rule controls, when there are multiple rules in a queue waiting to be processed.
      • Priority: High: Put this rule in a queue with other high priority rules and process through the high priority rule queue before any normal priority or low priority rules.
      • Priority: Normal: Put this rule in a queue with other normal priority rules and process through the normal priority rule queue after any high priority but before any low priority rules.
      • Priority: Low: Put this rule in a queue with other low priority rules and process through the low priority rule queue after any high priority or medium priority rules.
  8. In Rule Notification settings, specify the notification behavior, if desired.

    1. Enter email addresses to which emails are sent. Separate multiple email addresses with a comma.
    2. Select one or more notification types:
      • Delivery Failed: Emails are sent if the rule operation fails.
      • Delivery Completed: Emails are sent if the rule operation succeeds.
    In order to send emails, the email server must be configured in Workflow Engine settings.
  9. In Scope settings, specify the location or locations in which the rule operates.

    1. Click Add location. The Location Selection dialog box opens.
    2. Navigate to and select the desired location. This is the location that contains the files on which the rule operates. Every time the rule runs, it looks in this location to determine if there are any assets that match the rule conditions and then operates on the assets that match.
    3. Click OK. The location is added to the Scope list.
    4. For a location in the list, if you want the rule to operate on sub-folders as well, select Include Subfolders. When this is selected, if there are multiple directories under the selected location, the rule operates in each of the sub-directories.
    5. Repeat these steps to add additional locations as desired.
    6. To change a location in the list, click the Browse button
    7. To remove a location from the list, click X.
  10. In Export Filename Format settings, set the convention for the name of the exported file.

    Asset Name is set by default, as the exported file or files must have a name.
  11. In Metadata Export settings, set the custom metadata to be included with the export.

    In the exported content, custom metadata values entered here replace any current values. So if you previously entered values for these same custom metadata fields elsewhere in the GV STRATUS system, those values are overwritten in the exported content by the values you enter here. The custom metadata fields available are configured in Core | Metadata | Custom Metadata.
  12. In Frequency settings, specify how often the Rules Engine triggers the rule.

    1. Select one of the following options:
      • Metadata Change: The rule is constantly monitoring assets in the "Scope" location.
      • Periodically: Sets the number of minutes.
      • Daily: Sets the number of days.
      • Weekly: Sets the number of weeks.
      • Monthly: Sets the day of each month.
      For Daily, Weekly, and Monthly options, a Start Time setting opens. Set the day and time the rule is triggered for the first time.
  13. In Export Options settings, configure the format of the exported files.

    You can select either a Native Format or a Transcode Format, but not both.
    1. For Native Format, select the interchange standard in which to export. When a Native Format is selected, Transcode Format is automatically set to None and disabled.
    2. For Transcode Format, configure as follows:
      • Select None: The exported file is the same format as the source on the K2 storage system.
      • Select one or more transcode formats as follows:
        • To use multiple transcoders, select a single format for each transcoder.
        • To use multiple formats from a single transcoder, select the formats for that transcoder.
        You cannot select multiple formats from multiple transcoders.
      When a Transcode Format is selected, Native Format is automatically set to None and disabled. The Transcode Format list is populated by the transcode profiles that you create and place in the transcode profile directory.
    3. For Metadata Format, select as follows to additionally export an XML metadata file:
      • None: No additional XML metadata file is exported.
      • Final Cut Pro: Metadata is exported to a Final Cut Pro project XML file. Set all other Export Options to None to export metadata only.
      • GV STRATUS Simple: Metadata is exported to a GV STRATUS schema XML file.
      These metadata format selections are XSL transforms of the STRATUS XML metadata. If you need a customized transform for your workflow, contact Grass Valley Support. Set all other Export Options to None to export metadata only. If you select a metadata format, the Metadata-Destination Path field is enabled.
    4. For Metadata-Destination Path, configure as follows:
      • If you are exporting the metadata file to the same destination as the asset file, leave this field blank. The file goes to the path configured in Destination settings.
      • If you are exporting the metadata file to a different destination than the asset file, enter the metadata file's destination path. For an FTP path, use a ftp://server/path convention. For a UNC path, use a \\server\share\path convention.
    5. If you entered a Metadata-Destination Path, configure User Credentials for that destination.
    6. For Thumbnails - Marker, select as follows:
      • None: The export does not contain thumbnails.
      • Quality - High: High: The export contains a full-resolution JPG thumbnail with no compression (100%).
      • Quality - Medium: The export contains a full-resolution JPG thumbnail compressed 85%.
      • Quality - Low: Low: The export contains a half-resolution JPG thumbnail compressed 70%.
      An export thumbnail is defined by a tn marker added to the source asset. Multiple thumbnails are exported when the source asset has multiple tn markers.
    7. For Closed Caption Format, select as follows:
      • None: No additional Close Caption file is exported.
      • K2-SCC: Workflow Engine extracts CEA-608 information stored in Ancillary data (CEA-708) from the asset on the K2 system and exports to a file in SCC format.
      • K2-TTML: Workflow Engine extracts CEA-608 information stored in Ancillary data (CEA-708) from the asset on the K2 system and exports to a file in TTML format.
      Only K2 system metadata extraction is recommended. It has much better performance than transcoder metadata extraction. If you select a Closed Caption format, the CC-Destination Path field is enabled.
    8. For CC-Destination Path, configure as follows:
      • If you are exporting the Closed Caption file to the same destination as the asset file, leave this field blank. The file goes to the path configured in Destination settings.
      • If you are exporting the Closed Caption file to a different destination than the asset file, enter the Closed Caption file's destination path. For an FTP path, use a ftp://server/path convention. For a UNC path, use a \\server\share\path convention.
    9. If you entered a CC-Destination Path, configure User Credentials for that destination.
  14. In Destination settings, define the destination location on which the rule operates.

    For Export rules, the destination must be a location that is external to the GV STRATUS system and not managed by the GV STRATUS system. An external location is not visible in the GV STRATUS application Navigator panel.

    You can set any destinations for exports. For an FTP path, use a ftp://server/path convention. For a UNC path, use a \\server\share\path convention.

    If the destination is a network share accessible from the machine hosting the GV STRATUS Control Panel application, you can click the Browse button to configure Destination Path.
  15. Configure User Credentials as required. If a UNC path destination, requirements for user credentials are as follows:
    • If both the K2 system and the export location are on the same domain, you can use domain credentials.
    • If the K2 system and the export location are on different domains and the domains have a trust relationship, you can use domain credentials.
    • If the K2 system and the export location both have a local user with the same name and password, you can use the local user credentials.
    Other UNC path user credentials are not supported.
  16. Configure Format settings to select the export container format as follows:
    • If in Export Options settings you selected a Transcode Format, you cannot configure Format settings. The selected transcode profile specifies the export container format.
    • If in Export Options settings you set Transcode Format to None, you can configure Format settings as follows:
      • None: No video/audio assets are exported, but metadata, CC, or thumbnails are exported, as configured in Export Options.
      • General eXchange Format (gxf)
      • Material eXchange Format (mxf)
      • QuickTime Movie (mov)
      • QuickTime Reference Movie (mov)
  17. Configure User Credentials as required. If a UNC path destination, requirements for user credentials are as follows:
    • If both the K2 system and the export location are on the same domain, you can use domain credentials.
    • If the K2 system and the export location are on different domains and the domains have a trust relationship, you can use domain credentials.
    • If the K2 system and the export location both have a local user with the same name and password, you can use the local user credentials.
    Other UNC path user credentials are not supported.
  18. In Rule Conditions settings, specify the conditions the Rules Engine looks for to qualify an asset.

  19. In the Select items when drop down list, select one of the following:
    • ALL of the conditions below are met: Assets that match all conditions.
    • ANY of the conditions below are met: Assets that match any condition.
    • Custom: A Custom Expression field opens in which you can enter a custom expression.
    Conditions and custom expressions are similar to those in GV STRATUS Advanced Search.
  20. Configure conditions as follows:
    • For each condition (1, 2, 3, 4, etc) click the Add Condition button and select from lists to define the condition.
    • Click the X button to remove a condition from the list.

    If the rule applies to newly created assets, such as those created by a scheduled record, configure Duration | is greater than | 00:00:00.00. This ensures the asset is ready to transfer.

    If a newly created custom metadata field is not available in the Add Condition dialog, restart the GV STRATUS Control Panel application.

  21. Click Save.
Next, enable the rule.

Copyright © 2015 Grass Valley USA, LLC. All rights reserved. GV STRATUS 3.5 gvtp_20150216_19:49:26