Watch Folders Tab

Reading time ~12 minutes

This tab allows configuring watch folders that will monitor transcoding tasks.

To add a new watch folder, press the "+" button. Select one of the following task types from the list that appears:

Select_new_task_type

Currently, six task types are available for configuration in the Cinegy Convert Watch Service:

Export Media from Archive

To automate the repetitive export of media from Cinegy Archive tasks, Cinegy Archive job drop targets are used. Job drop target is a special node type displayed in the Cinegy Desktop user interface that allows export tasks submission. To submit a task, add the desired node(s) to the open job drop target container via drag-and-drop, or use the command "Send to job drop target" from the context menu. Cinegy Convert Export from Archive watch folders are designed to provide connection between Cinegy Archive job drop targets and Cinegy Convert processing queues.

Export_from_Archive_task_icon

When the "Export media from Archive" task is added, it is necessary to configure it using the corresponding form:
Watch_Folder_export_Resource_add
Important
 Valid Cinegy Archive connection settings are required to define certain watch folder parameters. Read the CAS connection configuration description for details.

Connect_button

Press the "Connect" button to establish connection to the specified database.

Disconnect_button

Once the connection is established successfully, it becomes replaced by the "Disconnect" button. Press this button in case you want to abort the connection.

Further parameters are split into two groups:

Export_watch_folder_configuration

The "Generic" group allows configuring the following settings:

  • Name – specify the export watch folder name.

  • Description – enter the export watch folder description, if needed.

  • Priority – use the drop-down list to define high, medium, low or lowest default task priority.

  • Capability resources – define the list of requirements to be met by Cinegy Convert agent to be able picking up tasks generated by the current watcher. For example, access to some special network share with restricted access can be defined as "Capability resource" and assigned to the dedicated Cinegy Convert Agent Manager machines.

    Important
    		 The capability resources are added via Cinegy Process Coordination Explorer. Refer to this article for a detailed information about capability resources creation.

In the "Scripting" group you may define preferable script to be called before source initialization either by entering it manually or exporting already made Powershell script.

The following parameters should be configured in the "Settings" group:

  • Target folder – define the export job drop target folder in the Cinegy Archive database by pressing the Configure_watch_folder_button button and selecting the required resource from the dialog that appears.

  • Scheme/target – specify the export scheme by pressing the Configure_watch_folder_button button and selecting the required resource from the dialog that appears.

  • Quality – select the desired media quality from the drop-down list.

  • Autodegradation – select the checkbox to enable switching to the next available quality.

Having defined all the parameters, press "OK".

Metadata Override

While editing the watch folder configuration, it is possible to override metadata settings from the target scheme selected for it. Press the Profile_Editor_Edit_icon button on the right to the "Scheme/target" field and select the "Edit" command:

Scheme_export_edit

The following dialog appears:

Edit_export_scheme_dialog

Here you can change the metadata fields values required for this watch folder.

Import Media to Archive

Import_to_Archive_task_icon

Having added the "Import media to Archive" task, configure it using the corresponding form that appears.

Similarly to the export from archive task type configuration, parameters are split into two groups:

Watch_Folder_import_Resource_add

The "Generic" group allows configuring the following settings:

  • Name – specify the import task watch folder name.

  • Description – enter the import watch folder description, if needed.

  • Priority – use the drop-down list to define high, medium, low or lowest default task priority.

  • Capability resources – define the list of requirements to be met by Cinegy Convert agent to be able picking up tasks generated by the current watcher. For example, access to some special network share with restricted access can be defined as "Capability resource" and assigned to the dedicated Cinegy Convert Agent Manager machines.

    Important
    		 The capability resources are added via Cinegy Process Coordination Explorer. Refer to this article for a detailed information about capability resources creation.

In the "Scripting" group you may define preferable script to be called before source initialization either by entering it manually or exporting already made Powershell script.

The following parameters should be configured in the "Settings" group:

  • Scheme/target – specify the import scheme by pressing the Configure_watch_folder_button button and selecting the required resource from the dialog that appears.

  • Watch folder – define the import folder on the local PC or in a network share by pressing the Configure_watch_folder_button button. Select the desired folder or make a new one and press "Select Folder".

  • File masks – define the specific file types the watch folder will identify for processing. Multiple masks can be specified with ; used as a separator (e.g. *.avi; *.mxf).

Having defined all the parameters, press "OK".

Metadata Override

While editing the watch folder configuration, it is possible to override metadata settings from the target scheme selected for it. Press the Profile_Editor_Edit_icon button on the right to the "Scheme/target" field and select the "Edit" command:

Scheme_edit

The following dialog appears, allowing you to change the metadata fields values required for this watch folder. In order to make changes to the database related fields, establish the connection by pressing the "Connect" button.

Edit_scheme_dialog_connected

Pressing the Configure_watch_folder_button button in the "Descriptors" field will launch the dialog for editing descriptors for master clips:

master_clip_descriptors

The Rolls descriptors can also be edited on the dedicated tab:

roll_descriptors

Transcoding

Transcoding_task_icon

Transcoding task type is used for standalone mode without connection to database required. These tasks perform transcoding of a file encoded by one codec to another codec or to another wrapper, or both, or direct transcoding – repacking to another wrapper without transcoding.

The transcoding task type configuration consists of following parameters that should be set up identically to the other tasks described above.

Watch_Folder_transcoding_Resource_add

The "Generic" group parameters are:

  • Name – specify the transcoding task watch folder name.

  • Description – enter the description, if needed.

  • Priority – use the drop-down list to define high, medium, low or lowest default task priority.

  • Capability resources – define the list of requirements to be met by Cinegy Convert agent to be able picking up tasks generated by the current watcher. For example, access to some special network share with restricted access can be defined as "Capability resource" and assigned to the dedicated Cinegy Convert Agent Manager machines.

    Important
    		 The capability resources are added via Cinegy Process Coordination Explorer. Refer to this article for a detailed information about capability resources creation.

In the "Scripting" group you may define preferable script to be called before source initialization either by entering it manually or exporting already made Powershell script.

The "Settings" group parameters are:

  • Scheme/target – specify the transcoding scheme by pressing the Configure_watch_folder_button button and selecting the required resource from the dialog that appears.

  • Watch folder – define the folder to be monitored on the local PC or in a network share by pressing the Configure_watch_folder_button button and selecting the required location from the dialog that appears.

  • File masks – define the specific file types the watch folder will identify for processing. Multiple masks can be specified with ; used as a separator (e.g. *.avi;mxf*).

Metadata Override

While editing the watch folder configuration, it is possible to override metadata settings from the target scheme selected for it. Press the Profile_Editor_Edit_icon button on the right to the "Scheme/target" field and select the "Edit" command:

Scheme_export_edit

The following dialog appears:

Edit_export_scheme_dialog

Here you can change the metadata fields values required for this watch folder.

Quality Builder

Quality_builder_task_icon

Quality builder task type is used for automatic creation of non-existent qualities from the from selected quality Cinegy Archive Roll quality.

The quality builder task type configuration consists of the following parameters that should be set up identically to the other tasks described above.

Watch_Folder_Quality_Builder
Important
 Valid Cinegy Archive connection settings are required to define certain watch folder parameters. Read the CAS connection configuration description for details.

The "Generic" group parameters are:

  • Name – specify the quality builder task watch folder name.

  • Description – enter the description, if needed.

  • Priority – use the drop-down list to define high, medium, low or lowest default task priority.

  • Capability resources – define the list of requirements to be met by Cinegy Convert agent to be able picking up tasks generated by the current watcher. For example, access to some special network share with restricted access can be defined as "Capability resource" and assigned to the dedicated Cinegy Convert Agent Manager machines.

    Important
    		 The capability resources are added via Cinegy Process Coordination Explorer. Refer to this article for a detailed information about capability resources creation.

The "Settings" group parameters are:

  • File name template – define the file naming template to be used in Cinegy Archive Quality Builder jobs. This field is mandatory. Its default value is {src.name}. Macros can be used in this field.

    Note
    		 Please note that unique ID will be automatically appended to the file name to avoid potential clashes with the existing files on the disk.

  • Target folder – specify the Cinegy Archive Quality Builder job drop target by pressing the Configure_watch_folder_button button and selecting the required resource from the dialog that appears.

  • Quality builder schema – select one or several specific TV formats from the drop-down list to use them for quality building.

    Having defined the required TV format, you should specify the qualities that will be created in the corresponding Roll. To do this, press the icon button and select the required command:

    Quality_builder_parameters

    • Select – select the profile for the corresponding quality creation from the Cinegy PCS resources list in the dialog that appears.

    • Preserve – use this option to preserve the existing Roll quality, if any.

    • Remove – use this option to remove the existing Roll quality, if any.

      Note
      		 The "Preserve" option is selected for all qualities by default.
      Note
      		 The quality building parameters should be specified for each selected TV format separately in the respective settings section.

Import Documents to Archive

Import_documents_task_icon

The "Import documents to Archive" task type is used for automatic copying of pictures, folders and other document files from the network storage into Archive one and registering them in Archive.

This task type configuration consists of following parameters that should be set up identically to the other tasks described above.

Add_Import_Documents_Task

The "Generic" group allows configuring the following settings:

  • Name – specify the name of the network share to be monitored.

  • Description – enter the network share description, if needed.

  • Task priority – use the drop-down list to define lowest, low, medium or high default task priority.

  • Capability resources – define the list of requirements to be met by the Cinegy Convert agent to be able picking up tasks generated by the current watcher. For example, access to some special network share with restricted access can be defined as "Capability resource" and assigned to the dedicated Cinegy Convert Agent Manager machines.

    Important
    		 The capability resources are added via the Cinegy Process Coordination Explorer. Refer to this article for a detailed information about capability resources creation.

In the "Scripting" group you may define preferable Pre- and Post-processing scripts either by entering it manually or exporting already made Powershell script.

The following parameters should be configured in the "Document settings" group:

  • Target folder – define the folder in Archive where documents will be imported to.

  • Media Group – specify the Cinegy Archive media group to store document files.

  • DocumentBin name template – specify the DocumentBin name to be used for importing.

  • Existing behavior – from the drop-down list select the way existing documents conflicts are resolved:

    • Skip – Document import is skipped;

    • Replace – a document file is replaced with the new one;

    • Rename – a new document is renamed as [original_name] (N).[original_ext], where N is the next non-existing integer starting from 1;

    • Fail – the import task is failed.

In the "Watch folder" group the following parameters should be configured:

  • Watch folder – define the folder to be monitored on the local PC or in a network share. In case any document files are located within the watch folder the Document Bin is opened or created with the name from the DocumentBin name template.

  • File mask – define the specific file types the watch folder will identify for processing.

  • Preserve tree – specify whether the folder tree should be preserved when importing documents. When the "Preserve tree" is enabled, the folders are scanned recursively and all documents are imported. For each folder a corresponding one is created in Archive.

Export Documents from Archive

Export_documents_task_icon

Export documents from Archive task type is used for exporting of Folders, DocumentBins and Documents.

The "Export documents from Archive" task type configuration consists of following parameters that should be set up in the following groups:

Add_Export_Documents_Task

In the "Generic" group configure the following settings:

  • Name – specify the name of the task to be monitored.

  • Description – enter the task description, if needed.

  • Task priority – use the drop-down list to define lowest, low, medium or high default task priority.

  • Capability resources – define the list of requirements to be met by Cinegy Convert agent to be able picking up tasks generated by the current watcher. For example, access to some special network share with restricted access can be defined as "Capability resource" and assigned to the dedicated Cinegy Convert Agent Manager machines.

    Important
    		 The capability resources are added via Cinegy Process Coordination Explorer. Refer to this article for a detailed information about capability resources creation.

In the "Scripting" group you may define Pre- and Post-processing scripts, if available.

The following parameters should be configured in the "Document Settings" group:

  • Target folder – define the network share that will be used as a root. When a Document is provided as a job subject, the corresponding document file is copied to the Target Folder. When a Document Bin or a Folder is provided as a job subject, in case Preserve tree option is set, the folder named the same as the DocumentBin or the Folder is created in the Target Folder and used as target, each child document is copied to the Target folder.

  • Existing behavior – from the drop-down list select the way existing documents conflicts are resolved:

    • Skip – Document export is skipped;

    • Replace – file will be replaced with the new one;

    • Rename – new file will be renamed as [original_name] (N).[original_ext], where N is the next non-existing integer starting from 1;

    • Fail – export task should be failed.

In the "Watch folder" group the following parameters should be configured:

  • Watch folder – define the Cinegy Archive job drop folder to be monitored for new tasks to be monitored by pressing the Select_watch_folder_button button and selecting the required location from the dialog that appears.

  • Preserve tree – specify whether the folder tree should be preserved when exporting documents.