Embed Size (px)
Citation preview
Interplay® | MAM Archive Sequences Guide
Version 2.9.0
Contents Using This Reference ....................................................................... 4
Symbols and Conventions .......................................................................................... 4 If You Need Help ......................................................................................................... 5 Avid Training Services ................................................................................................ 5
1 Introduction ....................................................................................... 6
2 Basic Concepts ................................................................................. 7 Sequence-Master Clip Relation .................................................................................. 7 Archiving Master Clips ................................................................................................ 7 Archiving Sequences .................................................................................................. 8
3 Getting Started .................................................................................. 9 Basic Configuration Steps ........................................................................................... 9 Initiating “Archive Sequences” in MediaCentral | UX .................................................. 9 Input Parameters ....................................................................................................... 12
Sequence Object Classes .................................................................................... 13 Archive Sections .................................................................................................. 13 Resolving the Archive Section for Sequences ..................................................... 13 Extending the Configuration by Sequence Object Classes ................................. 13 Master Clip Object Classes .................................................................................. 14 Resolving the Archive Section for Master Clips ................................................... 14 Extending the Configuration by Master Clip Object Classes ............................... 15 Using Mixed Attachments .................................................................................... 15 Hidden PAM2MAM Parameters ........................................................................... 16
4 Process Model ................................................................................. 17 Business Process Flow ............................................................................................. 17 Script Task Description ............................................................................................. 21
Initialize ................................................................................................................ 21 SetTimeoutError ................................................................................................... 22 SetCanceledError................................................................................................. 22 CheckUserSelection ............................................................................................ 22 ArchiveMasterclip ................................................................................................. 22 WaitForMasterclips .............................................................................................. 22 ArchiveSequence ................................................................................................. 23 CreateEdlFromSequence .................................................................................... 23 Cleanup ................................................................................................................ 23 CheckResult ......................................................................................................... 24
3
5 Data Model ....................................................................................... 25 Process Class PAM2MAM_SEQUENCE .................................................................. 25
Attributes .............................................................................................................. 25 Compound Attribute P2M_SEQ_MASTERCLIP_INFORMATION ...................... 26 Compound Attribute P2M_SEQ_SEQUENCE_INFORMATION ......................... 26
Master Clip Object Class ........................................................................................... 27 Sequence Object Class ............................................................................................. 27
Attributes .............................................................................................................. 27 Associations ......................................................................................................... 28
Legal List PAM_ARCHIVE_OBJECT_CLASS .......................................................... 28 Legal List PAM_SEQUENCE_OBJECT_CLASS...................................................... 28 Templates.................................................................................................................. 28
CREATECAT_PAM2MAM_SEQUENCE ............................................................. 28 P_PAM2MAM_SEQUENCE_ADMIN................................................................... 29 P2M_SEQ_CHOOSE_CLASS ............................................................................. 31
6 Configuration ................................................................................... 32
7 General Notes, Known Issues, and Pitfalls ................................... 34 Refreshing the PAMAdapter Configuration ............................................................... 34
Disclaimer ........................................................................................ 35
Using This Reference
Symbols and Conventions
Avid documentation uses the following symbols and conventions:
Symbol or Convention Meaning or Action
A note provides important related information, reminders, recommendations, and strong suggestions.
A caution means that a specific action you take causes you to lose data.
Courier Courier on gray background indicates code examples.
Courier blue font Courier blue font on gray background emphasizes code in examples.
The arrow indicates that line breaks in code examples are not allowed when using or writing comparable code.
Italic font Italic font is used to emphasize certain words.
Courier bold font Courier bold font identifies text that you type.
> This symbol indicates menu commands (and subcommands) in the order you select them. For example, File > Import means open the File menu and then select the Import command.
This symbol indicates a single-step procedure. Multiple arrows in a list indicate that you perform one of the actions listed
<placeholder, variable> Angle brackets indicate placeholders or variables.
UPPER CASE Indicates names of processes, process classes, data model attributes, legal lists, legal list values, states of tasks, and templates
5
If You Need Help
If you are having trouble using your Avid product:
1. Retry the action, carefully following the instructions given for that task in this guide. It is especially important to check each step of your workflow.
2. Check the latest information that might have become available after the documentation was published.
You should always check online for the most up-to-date documentation because the online version is updated whenever new information becomes available. To view the online versions, visit the Knowledge Base at www.avid.com/support.
3. Check the documentation that came with your Avid application or your hardware for maintenance or hardware-related issues.
4. Visit the online Knowledge Base at www.avid.com/support. Online services are available 24 hours a day, 7 days a week. Search this online Knowledge Base to find answers, view error messages, to access troubleshooting tips, download updates, and read or join online message-board discussions.
Avid Training Services
Avid makes lifelong learning, career advancement, and personal development easy and convenient. Avid understands that the knowledge you need to differentiate yourself is always changing, and Avid continually updates course content and offers new training delivery methods that accommodate your pressured and competitive work environment.
For information on courses/schedules, training centers, certifications, courseware, and books, please visit www.avid.com/support and follow the Training links, or call Avid Sales at 800-949-AVID (800-949-2843).
1 Introduction
This document describes the business process “Archive Sequences” which is delivered with the Mam.Kit.Production package. The Archive Sequences business process is designed to archive sequences from Interplay | Production (PAM) in an Interplay | MAM system. As sequences are only valid with their related master clips, the master clips are archived, too. The business process is initiated in Avid MediaCentral | UX. The process uses the PAM2MAM business process as sub-process to archive master clips.
The following topics provide basic information about the Archive Sequences business process:
• Basic Concepts
• Getting Started
• Process Model
• Data Model
• Configuration
• General Notes, Known Issues, and Pitfalls
For additional information, see the following documents:
• Interplay | MAM PAM2MAM Guide
• Interplay | MAM Export to MAM Guide
• Interplay | MAM Create EDL from Sequence Object Guide
2 Basic Concepts
The following topics provide general information about the relation between a sequence and its related master clips and the archiving result:
• Sequence-Master Clip Relation
• Archiving Master Clips
• Archiving Sequences
Sequence-Master Clip Relation
A sequence in PAM represents a compilation of different spans of different master clips. A sequence has its own set of metadata and reuses the physical essences of its related master clips. When a sequence is archived in MAM, a new object is created that holds the original AAF of the sequence. The related master clips are also archived in MAM, if they have not been archived in MAM before. If possible, a mixdown of the sequences’ compilation is created and stored on the sequence in MAM. This mixdown is used as a preview of the original sequence in PAM.
It is also possible to create a “working EDL” on MAM side to perform a rough cut on basis of the original sequence. This working EDL references the master clips archived in MAM.
Archiving Master Clips
If the related master clips of a sequence are not already archived in MAM, they have to be archived before the sequence itself is archived.
The master clips are archived by using the PAM2MAM business process as a sub-process. This sub-process is initialized with values read from configuration based on the master clip object class, which either is set during process initialization or in course of the ChooseMasterClipObjectClass user task.
Already archived master clips are reused and not archived again.
For details on how the master clip object class is selected, see Initiating “Archive Sequences” in MediaCentral | UX on page 9.
8
For details on the master clip object classes and the related configuration, see the following topics:
• Master Clip Object Classes on page 14.
• Archive Sections on page 13
• Resolving the Archive Section for Master Clips on page 14
• Extending the Configuration by Master Clip Object Classes on page 15
For details on the PAM2MAM sub-process, see the Interplay | MAM PAM2MAM Guide.
Archiving Sequences
The sequences are archived by using the PAM2MAM business process as a sub-process. This sub-process is initialized with values read from configuration based on the sequence object class, which is set during process initialization.
The AAF of the sequence is stored as physical essence of the sequence. The compilation of the sequence is stored in a MAM EDL XML format in the attribute EDL_XML.
For details on the sequence object classes and the related configuration, see the following topics:
• Sequence Object Classes on page 1327.
• Archive Sections on page 13
• Resolving the Archive Section for Sequences on page 13
• Extending the Configuration by Sequence Object Classes on page 13
For details on the PAM2MAM sub-process, see the Interplay | MAM PAM2MAM Guide.
3 Getting Started
The following topics provide information on how to get the Archive Sequences process running, how the process is initiated in the UI and additional object classes can be configured:
• Basic Configuration Steps
• Initiating “Archive Subclips in MAM” in MediaCentral | UX
• Input Parameters
Basic Configuration Steps
The Archive Sequences process requires the following basic configuration steps:
1. Ensure that the Mam.Kit.Production installation package is installed and configured properly.
2. Ensure that the Mam.Core.MediaCentralConnection package is installed.
3. Ensure that the Interplay MAM and Interplay Production systems to be used are configured in MediaCentral UX.
4. Ensure that the following user rights are assigned to the users and groups which are supposed to use the Archive Sequences process:
• Processes/Create_PAM2MAM_SEQUENCE
• CBA/PAM2MAM_SEQUENCE
Initiating “Archive Sequences” in MediaCentral | UX
You can trigger the Archive Sequences process in MediaCentral UX. Depending on the settings provided during process creation, a user task might be created that requires you to complete an action in the Tasks pane. You can monitor the process progress in the Progress pane.
To start the Archive Sequences process:
1. Sign in to MediaCentral UX.
Initiating “Archive Sequences” in MediaCentral | UX
10
2. Do one of the following:
In the Search pane, search for the sequences you want to archive in MAM.
In the Assets pane, open the folders that contain the sequences you want to archive in MAM.
3. Select the sequences to be archived. You can select up to 50 sequences.
4. Do one of the following:
Right-click a selected sequence, and in the context menu that opens select Actions, then – if shown – select the system that runs the process, and finally select the Archive Sequence(s) process type.
Click the Pane Menu, select Actions, then – if shown – the system that runs the process, and select the Archive Sequence(s) process type.
The Archive Sequences dialog box opens.
Initiating “Archive Sequences” in MediaCentral | UX
11
5. (Optional) Provide a main title for the process. If you provide an empty title, the default title “Archiving Asset(s)” is used.
6. (Option) Do one of the following:
Select a Master Clip Object Class. By default the ‘Video’ object class is selected. This setting is only relevant if the related master clips of a sequence are missing and are also to be archived in MAM.
Remove the Master Clip Object Class selection if multiple master clips are missing and you want to select an object class per missing master clip. In this case, a user task is created during the process runtime.
7. (Option) Check the Archive on Tape check box if you want to archive the essences in MAM on tape.
8. (Option) Check the Create EDL check box if you want to create an additional “working” EDL in MAM. This triggers the Create EDL from Sequence Object sub-process.
9. Click OK to start the process.
To complete the Choose Masterclip Object Classes user task in the Tasks pane:
If the process was started without an assigned Master Clip Object Class, a “Choose Masterclip Object Classes” user task is created that requires you to complete an action in the Tasks pane. If the task is not completed within three days, it fails with a “timeout”.
1. Open the Tasks pane.
2. Select the Choose Masterclip Object Classes task in the Tasks List.
The Task Details area shows the metadata fields and controls that are configured for the Choose Masterclip Object Classes task.
Input Parameters
12
3. Select the object class for each master clip to be archived from the Object Class list. Leave the object class empty for master clips for which you want to cancel archiving. This also cancels archiving of the related sequences.
4. Do one of the following:
Click Proceed to archive the master clips and related sequences.
Click Cancel to cancel archiving of the master clips and their related sequences.
Canceling archiving of some or all master clips leads the process to finish in “Failed” state. Even if archiving is canceled for all master clips, all sequences whose master clips are already archived in MAM are processed nevertheless.
To monitor the process in the Progress pane:
Open the Progress pane and monitor the Archive Sequences process:
a. Initializing: The process initializes.
b. (Optional) Waiting for User Input: The process has an uncompleted “Choose Masterclip Object Classes” user task.
c. Archiving in MAM: The process archives the assets in MAM.
d. Checking result: The process checks the results.
e. Finished: The process has finished.
Input Parameters
The following topics provide information on input parameters, how the mapping between target object classes and archive sections is working, and how mapping can be extended.
Input Parameters
13
Sequence Object Classes
The sequence object class which is selected by the user during process initialization is represented by the legal list PAM_SEQUENCE_OBJECT_CLASS.
Archive Sections
The archive sections are configured in the MPI profile under the section path PAM/<WorkgroupSection>/Archive/<ArchiveSection>. They provide information on how an Archive Sequences process and archiving a master clip is to be handled.
Resolving the Archive Section for Sequences
Before the archive section can be resolved for each sequence in the process attachment list, the workgroup section has to be resolved. This is done using the system ID of the attachment which has to match the MediaCentralSystemId configuration setting in the workgroup section.
After the workgroup section has been resolved, the archive section is resolved by the legal list ID related to the selected label of the sequence object class. The value has to match the SequenceObjectClassId configuration setting in the archive section.
The following rules apply when configuring the settings for section resolving:
• The mapping of PAM system IDs to the MediaCentralSystemId setting in the workgroup sections has to be unique. Only one workgroup section can have the same value for the MediaCentralSystemId setting.
• Under a dedicated workgroup section, the mapping of a PAM_SEQUENCE_OBJECT_CLASS legal list ID to the SequenceObjectClassId setting in the archive sections has to be unique. Only one archive section under a dedicated workgroup section can have the same value for the SequenceObjectClassId setting.
Extending the Configuration by Sequence Object Classes
By default, the following sequence object classes are supported which are mapped to different default archive sections in the default workgroup section Workgroup:
Input Parameters
14
Sequence Object Class Legal List ID Archive section
Archived Sequence 0 AsSequence
To support additional configuration settings, do the following:
1. Create a new entry in the PAM_SEQUENCE_OBJECT_CLASS legal list with an informative label.
2. In the MPI profile, copy and rename an archive section in the default workgroup section.
3. Configure the new archive section as needed and set the SequenceObjectClassId setting to the ID of the PAM_SUBCLIP_SEQUENCE_CLASS legal list entry created in step 1.
If you introduce a new object class to be used by the Archive Sequences business process, create also all associations to possible EDL classes in the data model. For information about the association naming scheme, see Associations on page 28.
Master Clip Object Classes
The master clip object class which is selected by the user during process initialization is represented by the legal list PAM_ARCHIVE_OBJECT_CLASS.
Resolving the Archive Section for Master Clips
Before the archive section can be resolved for each asset in the process attachment list, the workgroup section has to be resolved. This is done using the system ID of the attachment which has to match the MediaCentralSystemId configuration setting in the workgroup section.
After the workgroup section has been resolved, the archive section is resolved by the legal list ID related to the selected label of the master clip object class. The value has to match the ArchiveLegalListId configuration setting in the archive section.
The following rules apply when configuring the settings for section resolving:
• The mapping of PAM system IDs to the MediaCentralSystemId setting in the workgroup sections has to be unique. Only one workgroup section can have the same value for the MediaCentralSystemId setting.
• Under a dedicated workgroup section, the mapping of a PAM_ARCHIVE_OBJECT_CLASS legal list ID to the ArchiveLegalListId setting in
Input Parameters
15
the archive sections has to be unique. Only one archive section under a dedicated workgroup section can have the same value for the ArchiveLegalListId setting.
Extending the Configuration by Master Clip Object Classes
By default, the following master clip object classes are supported which are mapped to different default archive sections in the default workgroup section Workgroup:
Master Clip Object Class Legal List ID Archive section
Feature 0 AsFeature
Rushes 1 AsRushes
Trailer 2 AsTrailer
Video 3 AsVideo
To support additional configuration settings, do the following:
1. Create a new entry in the PAM_ARCHIVE_OBJECT_CLASS legal list with an informative label.
2. In the MPI profile, copy and rename an archive section in the default workgroup section.
3. Configure the new archive section as needed and set the ArchiveLegalListId setting to the ID of the PAM_ARCHIVE_OBJECT_CLASS legal list entry created in step 1.
Using Mixed Attachments
If you want to use the Archive Sequences business process with se quences mixed from different PAM systems, the following rules apply. Do the following for each PAM system you want to archive sequences from:
• Configure a dedicated workgroup section in the MPI profile using the PAM system ID in the MediaCentralSystemId setting.
• Configure an archive section with the legal list ID of the selected sequence object class for the SequenceLegalListId in the related workgroup section.
• Configure an archive section with the legal list ID of the selected master clip object class for the ArchiveLegalListId in the related workgroup section.
Input Parameters
16
Hidden PAM2MAM Parameters
The PAM2MAM business process is used for archiving master clips. Some input parameters are set in the Archive Sequence in MAM process dialog box; additional parameters are hidden by configuration.
In the resolved archive section, the value of the ProcessAttributeMapping setting points to a subsection of the ProcessAttributeMapping section in the MPI profile (such as ProcessAttributeMapping/Default). The following settings in this section control additional input parameters for PAM2MAM:
• DO_POST_PROCESSING: Determines if the PAM2MAM sub-processes are using a post processing script.
• IN_AUDIO_FORMAT: The audio resolution to archive.
• IN_VIDEO_FORMAT: The video resolution to archive.
4 Process Model
The following topics provide basic information on the Archive Sequences process:
• Business Process Flow
• Script Task Description
Business Process Flow
The following illustration shows the graphical Archive Sequences process model.
Business Process Flow
18
Initialize
The first step of the process is its initialization by the script task “Initialize.” If an error in this script occurs, the process exits in “Initializing failed” state.
At this point the process model forks in three parallel threads.
Thread 1: ChooseMasterclipObjectClasses user task
This thread gathers user input from the “ChooseMasterclipsObjectClasses” user task.
- The user selects the object classes for the master clips which have to be archived before the sequences can be archived. If all needed master clips are already archived in MAM or a value for the Master Clip Object Class has been selected during the initialization, the tasks of this thread are skipped.
- (Option 1) If the user task runs into a timeout, the “SetTimeoutError” script task is executed to set error information about the timeout in the process.
- (Option 2) If the user task is canceled, the “SetCanceledError” script task is executed to set error information about the cancelation in the process.
Business Process Flow
19
- (Option 3) If the user task is processed, the “CheckUserSelection” script task is executed to validate the object class selection of the user.
For more information on the handling of the user task, see Initiating “Archive Sequences” in MediaCentral | UX on page 9.
Thread 2: ArchiveMasterclipsSub sub-process
This thread runs the “ArchiveMasterclipsSub” parallel sub-process.
For each master clip not already archived in MAM, a parallel thread is started.
- The process checks for the Master Clip Object Class.
- If no Master Clip Object Class was selected during process initialization, the process checks in an interval of 30 seconds for the progress of the “ChooseMasterclipsObjectClasses” user task in Thread 1.
- If the Master Clip Object Class is neither set during process initialization nor within the “ChooseMasterclipsObjectClasses” user task, the thread for the current master clip ends. In this case, neither the master clip nor the related sequences are archived in MAM.
- If the Master Clip Object Class has been set during process initialization or within the “ChooseMasterclipsObjectClasses” user task, the “ArchiveMasterclip” script task is executed. It archives the master clip in MAM using the PAM2MAM business process.
When all parallel sub-process threads are finished, Thread 2 ends.
Thread 3: ArchiveSequencesSub sub-process
This thread runs the “ArchiveSequencesSub” parallel sub-process.
Business Process Flow
20
For each attached sequence, a parallel thread is started.
- The “WaitForMasterclips” script task is executed. It monitors the archiving of all master clips related to the current sequence.
- If not all related master clips have been archived successfully, the “Cleanup” script task is executed and the thread for the current sequence ends. In this case, at least the sequence is not archived in MAM.
- If the related master clips of the sequence are successfully archived in MAM, the “ArchiveSequence” script task is executed. It archives the sequence in MAM using the PAM2MAM business process.
- If the archiving of the sequence fails, the “Cleanup” script task is executed and the thread for the current sequence ends.
- If the sequence is archived successfully and the creation of an EDL was selected during the initialization of the process, the “CreateEdlFromSequence” script task is executed. It creates an EDL object on basis of the sequence, which can be used and modified by the user later on.
- The “Cleanup” script task is executed in any case before the thread for the current sequence ends.
When all parallel sub-process threads are finished, Thread 3 ends.
Script Task Description
21
CheckResult
When Thread 1, Thread 2, and Thread 3 are finished, the “CheckResult” script is the last script task that is executed. It analyzes the information of the process and detects if the overall status of the process is successful or not.
Script Task Description
The Archive Sequences process uses different script tasks, as described in the following sections.
Initialize
The “Initialize” script does the following:
• Reads the input parameters and validates that they are set correctly.
• For each attached subclip, it does the following:
• Resolves the system type, system ID, asset type, and asset ID from the global ID.
• Validates that the system type is interplay and that the asset type is sequence.
• Detects the correct MPI workgroup configuration section by matching the system ID.
• Resolves the MOBID and further information of the sequence using the avid.interplay.client.mediaInfo service on the ACS bus.
• Reads the composition of the sequence and saves it for further processing on disk.
• Exports the AAF of the sequence for further processing on disk.
• For each master clip in the sequence compilation, it checks if the master clip is already archived in MAM. If the master clip is not already archived in MAM, it resolves some information of it using the avid.interplay.client.mediaInfo service on the ACS bus.
• Stores all gathered information about the sequence in a line of the P2M_SEQ_SEQUENCE_INFORMATION attribute of the process.
• Stores all gathered information about the related master clips, which have to be archived, of all sequences in the P2M_SEQ_MASTERCLIP_INFORMATION attribute of the process.
Script Task Description
22
SetTimeoutError
The “SetTimeoutError” script sets the error flag and the error message for the timed out “ChooseMasterclipsObjectClasses” user task in all lines of the P2M_SEQ_MASTERCLIP_INFORMATION multi-value compound attribute.
SetCanceledError
The “SetCanceledError” script sets the error flag and the error message for the canceled “ChooseMasterclipsObjectClasses” user task in all lines of the P2M_SEQ_MASTERCLIP_INFORMATION multi-value compound attribute.
CheckUserSelection
The “CheckUserSelection” script sets the error flag and the error message of each master clip where no object class has been selected in the corresponding line of the P2M_SEQ_MASTERCLIP_INFORMATION multi-value compound attribute.
ArchiveMasterclip
The “ArchiveMasterclip” script does the following:
• Acquires the resource to synchronize the creation of the same master clip in MAM.
• Checks if the master clip is already archived in MAM.
• Resolves the archive section for the selected master clip object class.
• Reads the configuration settings needed as input parameters for the PAM2MAM sub-process.
• Starts the PAM2MAM process.
• Monitors the PAM2MAM process.
• Reads the DMGUID of the archived master clip object in MAM.
• Releases the resource to synchronize the creation of the same master clip in MAM.
WaitForMasterclips
The “WaitForMasterclips” script does the following:
Script Task Description
23
• For each master clip related to the current sequence, it monitors the line of the P2M_SEQ_MASTERCLIP_INFORMATION multi-value compound attribute for information about the archiving of the master clip.
• Sets the error information in the corresponding line of the P2M_SEQ_SEQUENCE_INFORMATION multi-value compound attribute if archiving of any related master clip failed.
ArchiveSequence
The “ArchiveSequence” script does the following:
• Acquires the resource to synchronize the creation of the same sequence in MAM.
• Reads all previous versions of the sequence already archived in MAM.
• Reads the configuration settings needed as input parameters for the PAM2MAM sub-process.
• Starts the PAM2MAM process.
• Monitors the PAM2MAM process.
• Reads the DMGUID of the archived sequence object in MAM.
• Stores the AAF of the sequence, exported in the “Initialize” script task, on the archived sequence.
• Creates and stores an EDL XML based on the sequence composition.
• Deletes all previous versions of the sequence already archived in MAM.
CreateEdlFromSequence
The “CreateEdlFromSequence” script does the following:
• Starts the PAM_CREATE_EDL_FROM_SEQUENCE_OBJECT process.
• Monitors the PAM_CREATE_EDL_FROM_SEQUENCE_OBJECT process.
Cleanup
The “Cleanup” script deletes the temporary directory on disk used for the current sequence.
Script Task Description
24
CheckResult
The “CheckResult” script does the following:
• For each sequence it does the following:
• Checks if an error can be detected for the current sequence.
• If an error was set, the error message is concatenated with the error messages of the previous failed iterations.
• Checks if a minor error can be detected for the current sequence.
• If a minor error was set, the warning message is concatenated with the warning messages of the previous iterations with minor errors.
• Defines a corresponding process state.
5 Data Model
The data model provided with the Mam.Kit.Production package contains several elements that are required for using the Archive Sequences process. The following topics provide information about the process-specific data model elements:
• Process Class PAM2MAM_SEQUENCE
• Master Clip Object Class
• Sequence Object Class
• Legal List PAM_ARCHIVE_OBJECT_CLASS
• Legal List PAM_SEQUENCE_OBJECT_CLASS
• Templates
Process Class PAM2MAM_SEQUENCE
The process class PAM2MAM_SEQUENCE contains the following attributes.
Attributes
Attribute Type Description
P2M_SEQ_EXISTING_MASTERCLIPS Text Contains information about the related master clips of all sequences, which are already archived in MAM. Format: SWoDL struct.
P2M_SEQ_IN_ARCHIVE_ON_TAPE Boolean Flag determining whether or not the PAM2MAM process archives the HiRes material on tape. This applies to master clips and sequences.
P2M_SEQ_IN_CREATE_EDL Boolean Flag determining whether or not a “working EDL” based on the sequence compilation is created.
P2M_SEQ_IN_MASTERCLIP_CLASS Legal list Contains the index of the chosen legal list entry. See Legal List PAM_ARCHIVE_OBJECT_CLASS.
Process Class PAM2MAM_SEQUENCE
26
Attribute Type Description
P2M_SEQ_IN_SEQUENCE_CLASS Legal list Contains the index of the chosen legal list entry. See Legal List PAM_SEQUENCE_OBJECT_CLASS.
P2M_SEQ_MASTERCLIP_INFORMATION Compound Contains information about the master clips which are not already archived in MAM.
P2M_SEQ_MISSING_MASTERCLIP_COUNT Integer [3] The number of master clips which are not already archived in MAM.
P2M_SEQ_PROGRESS_PER_ACTION Float [2.5] The progress value for archiving a single master clip or sequence.
P2M_SEQ_SEQUENCE_COUNT Integer [3] The number of sequences attached to the process.
P2M_SEQ_SEQUENCE_INFORMATION Compound Contains information about the attached sequences.
Compound Attribute P2M_SEQ_MASTERCLIP_INFORMATION
The P2M_SEQ_MASTERCLIP_INFORMATION multi-value compound attribute has the following sub-attributes:
Sub-Attribute Type Description
DISPLAY_NAME Text The display name of the master clip in PAM.
ERROR_MESSAGE Text Error message with information if archiving the master clip fails.
HAS_ERROR Boolean Flag determining if processing the master clip failed.
OBJECT_CLASS Legal list Contains the index of the chosen legal list entry. See Legal List PAM_ARCHIVE_OBJECT_CLASS.
SUCEEDED Boolean Flag determining if the master clip was processed successfully.
TECHNICAL Text Attribute to transmit technical data as SWoDL struct into the parallel sub-process threads for archiving the master clips.
Compound Attribute P2M_SEQ_SEQUENCE_INFORMATION
The P2M_SEQ_SEQUENCE_INFORMATION multi-value compound attribute has the following sub attributes:
Sequence Object Class
27
Sub-Attribute Type Description
EDL_CREATION_FAILED Boolean Flag determining whether or not the creation of the “working EDL” failed.
ERROR_MESSAGE Text Error message with information if processing the sequence failed.
HAS_ERROR Boolean Flag determining if archiving the sequence failed.
MOBID Text [256] The MOBID of the sequence in PAM.
SUCEEDED Boolean Flag determining if the sequence was processed successfully.
TECHNICAL Text Attribute to transmit technical data as SWoDL struct into the parallel sub-process threads for archiving the sequences.
Master Clip Object Class
The Archive Sequences process does not require a specific object class but uses the PAM2MAM process to archive master clips. Every object class meeting the criteria of the PAM2MAM process also works for archiving master clips with the Archive Sequences process.
Sequence Object Class
The Archive Sequences process does not require a specific object class but uses the PAM2MAM process to archive sequences. The PAM2MAM process requires the following attributes and associations to be used for the sequence object class.
Attributes
The following attributes have to be assigned to object classes used as sequence objects:
Attribute Type Description
EDL_XML Text The EDL XML based on the sequence composition.
PAM_ SEQUENCE_MOBID Text [256] The MOBID of the sequence in PAM.
Templates
28
Associations
For each sequence-EDL object class combination you want to use, an association type must exist. It is used to visualize the relation between an archived sequence and its “working EDL” copy. For details on the associations, see the Interplay | MAM Create EDL from Sequence Object Guide.
Legal List PAM_ARCHIVE_OBJECT_CLASS
The legal list PAM_ARCHIVE_OBJECT_CLASS contains entries for matching the archive sections in the MPI profile for master clips. See Extending the Configuration by Masterclip Object Classes on page 14.
Legal List PAM_SEQUENCE_OBJECT_CLASS
The legal list PAM_SEQUENCE_OBJECT_CLASS defines entries for matching the archive sections in the MPI profile for sequences. See Extending the Configuration by Sequence Object Classes on page 13.
Templates
The following templates are designed for the Archive Sequences process:
• CREATECAT_PAM2MAM_SEQUENCE
• P_PAM2MAM_SEQUENCE_ADMIN
• P2M_SEQ_CHOOSE_CLASS
CREATECAT_PAM2MAM_SEQUENCE
The create template for the Archive Sequences process contains all attributes that are required to start the process.
Templates
29
P_PAM2MAM_SEQUENCE_ADMIN
The P_PAM2MAM_SEQUENCE_ADMIN template contains information for administrators.
Templates
30
Templates
31
P2M_SEQ_CHOOSE_CLASS
The P2M_SEQ_CHOOSE_CLASS template contains information displayed during the ChooseMasterClipObjectClass user task.
6 Configuration
The Archive Sequences process uses the MPI profile to provide process-specific configuration settings that are listed in the following sections. For additional information, see the Interplay | MAM Configuration Settings Reference.
PAM/<WorkgroupSection>
In the PAM/<Workgroup> section these are the process-specific settings:
• InterplayWebServiceWorkgroupName: The workgroup name of the current PAM system.
• MediaCentralSystemId: The System Id representing the PAM Workgroup in MediaCentral.
• PamAdapterServiceId: The service ID of the PAM Adapter which is responsible for the current PAM system.
PAM/<WorkgroupSection>/Archive/<ArchiveSection>
In each PAM/<Workgroup>/Archive/<ArchiveSection> section these are the process-specific settings:
• AafTempDirectory: The directory to temporarly store AAF files and other metadata during process runtime.
• ArchiveLegalListId: The legal list ID mapping an entry of the PAM_ARCHIVE_OBJECT_CLASS legal list to this archive section.
• MamAafDestinationCarrierGuid: The GUID of the carrier where the AAF files are stored.
• ProcessAttributeMapping: The ProcessAttributeMapping configuration to apply to this Archive configuration.
• SequenceObjectClassId: The legal list ID mapping an entry of the PAM_SEQUENCE_OBJECT_CLASS legal list to this archive section.
ProcessAttributeMapping/<ProcessAttributeMappingSection>
In each ProcessAttributeMapping/<ProcessAttributeMappingSection> section these are the process-specific settings:
Templates
33
• DO_POST_PROCESSING: Flag to start the post processing script.
• IN_AUDIO_FORMAT: Represents the attribute IN_AUDIO_FORMAT which is filled with the given value from the PAMAdapter ('useCurrentResolution').
• IN_VIDEO_FORMAT: Represents the attribute IN_VIDEO_FORMAT which is filled with the given value from the PAMAdapter ('useCurrentResolution').
For information on the configuration settings used by the PAM2MAM sub-process, see the Interplay | MAM PAM2MAM Guide.
7 General Notes, Known Issues, and Pitfalls
The following topics provide information on general issues to keep in mind when using the Archive Sequences process:
• Refreshing the PAMAdapter Configuration
Refreshing the PAMAdapter Configuration
If you modify the configuration of the MPI profile, restart the PAMAdapter because it reads the configuration only on startup.
Disclaimer
Product specifications are subject to change without notice and do not represent a commitment on the part of Avid Technology, Inc.
This product is subject to the terms and conditions of a software license agreement provided with the software. The product may only be used in accordance with the license agreement.
This product may be protected by one or more U.S. and non-U.S. patents. Details are available at www.avid.com/patents.
This guide is protected by copyright. This guide is for your personal use and may not be reproduced or distributed, in whole or in part, without permission of Avid. Reasonable care has been taken in preparing this guide; however, it may contain omissions, technical inaccuracies, or typographical errors. Avid Technology, Inc. disclaims liability for all losses incurred through the use of this document. Product specifications are subject to change without notice.
Copyright © 1998-2016 Avid Technology, Inc. and its licensors. All rights reserved.
The following disclaimer is required by Apache Commons Logging: Copyright © 2003-2013 The Apache Software Foundation Licensed under the Apache License, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0)
The following disclaimer is required by Apache Commons Net: Copyright © 2001-2013 The Apache Software Foundation Licensed under the Apache License, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0)
The following disclaimer is required by Apache Jakarta Commons HttpClient: Copyright © 2004 The Apache Software Foundation Licensed under the Apache License, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0)
The following disclaimer is required by Apache log4net: Copyright © 2004-2011 The Apache Software Foundation Licensed under the Apache License, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0)
The following disclaimer is required by Apache Xerxes: Copyright © 2008 Apache Software Foundation Licensed under the Apache License, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0)
The following disclaimer is required by Behaviour.js: This product includes software developed by Ben Nolan and his contributors. Copyright © 2006, 2007 Ben Nolan. All rightsreserved.
The following disclaimer is required by CFlatToolbar: Portions of this product are Copyright © 2002 Roger Onslov, all rights reserved.
The following disclaimer is required by Cross-Browser X Library: Copyright © 2000-2009 Michael Foster, distributed under the terms of LGPL (http://cross-browser.com/license.html)
The following disclaimer is required by CSXButton: Copyright © 1998 Michael Santoro, all rights reserved
The following disclaimer is required by CVersionInfo: Portions of this product are Copyright © 1997 Roberto Rocco, all rights reserved.
The following disclaimer is required by Assisted Solutions InputMask: Portions of this product are Copyright © Data Reasearch Group. All rights reserved.
The following disclaimer is required by dicas: Portions of this product are Copyright © dicas digital image coding GmbH. All rights reserved.
36
The following disclaimer is required by DirectShowLib: Copyright (C) 2007 http://sourceforge.net/projects/directshownet, distributed under the terms of LGPL V2.1 (http://www.gnu.org/licenses/lgpl-2.1.html)
The following disclaimer is required by Divelements: Portions of this product are Copyright © 2003-2011 Divelements Limited.
The following disclaimer is required by DockPanelSuite: This product includes software developed by Mark Twombley, Steve Overton, and Weifen Luo and their contributors. Copyright © 2009 Mark Twombley, Steve Overton, and Weifen Luo.
The following disclaimer is required by FFmpeg: FFmpeg is Copyright © 2000-2003 Fabrice Bellard and is licensed under the terms of the GNU Lesser General Public License, which is included with this product.
The following disclaimer is required by GDCL Sample Parser: Copyright 2004 GDCL (http://www.gdcl.co.uk)
The following disclaimer is required by getElementsByAttribute: Copyright © 2006 Robert Nyman (http://www.robertnyman.com)
The following disclaimer is required by GoXam: Portions of this product are Copyright © 1995-2011 Northwoods Software. All rights reserved.
The following disclaimer is required by IC#Code #ZipLib: Copyright © 2000-2009 Michael Foster, distributed under the terms of GNU GPL with the following exception: As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.
The following disclaimer is required by IFilter Text Extracter: IFilter Text Extracter Microsoft Public License (Ms-PL)
The following disclaimer is required by ImageMagick: Copyright 1999-2014 ImageMagick Studio LLC, a non-profit organization dedicated to making software imaging solutions freely available. (http://www.imagemagick.org/script/license.php)
The following disclaimer is required by Interplay Common Playback Service: This product includes FFmpeg, which is covered by the GNU Lesser General Public License. This product includes software that is based in part of the work of the FreeType Team. This software is based in part on the work of the Independent JPEG Group. This product includes libjpeg-turbo, which is covered by the wxWindows Library License, Version 3.1. Portions copyright 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002 by Cold Spring Harbor Laboratory. Funded under Grant P41-RR02188 by the National Institutes of Health. Portions copyright 1996, 1997, 1998, 1999, 2000, 2001, 2002 by Boutell.Com, Inc. Portions relating to GD2 format copyright 1999, 2000, 2001, 2002 Philip Warner. Portions relating to PNG copyright 1999, 2000, 2001, 2002 Greg Roelofs. Portions relating to gdttf.c copyright 1999, 2000, 2001, 2002 John Ellson ([email protected]). Portions relating to gdft.c copyright 2001, 2002 John Ellson ([email protected]). Portions relating to JPEG and to color quantization copyright 2000, 2001, 2002, Doug Becker and copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, Thomas G. Lane. This software is based in part on the work of the Independent JPEG Group. See the file README-JPEG.TXT for more information. Portions relating to WBMP copyright 2000, 2001, 2002 Maurice Szmurlo and Johan Van den Brande. Permission has been granted to copy, distribute and modify gd in any context without fee, including a commercial application, provided that this notice is present in user-accessible supporting documentation.This does not affect your ownership of the derived work itself, and the intent is to assure proper credit for the authors of gd, not to interfere with your productive use of gd. If you have questions, ask. "Derived works" includes all programs that utilize the library. Credit must be given in user-accessible documentation.This software is provided "AS IS." The copyright holders disclaim all warranties, either express or implied, including but not limited to implied warranties of merchantability and fitness for a particular purpose, with respect to this code and accompanying documentation.Although their code does not appear in gd, the authors wish to thank David Koblas, David Rowley, and Hutchison Avenue Software Corporation for their prior contributions.
37
The following disclaimer is required by Interplay Entertainment Corp.: The Interplay name is used with the permission of Interplay Entertainment Corp., which bears no responsibility for the product.
The following disclaimer is required by JavaZoom: Portions of this product are Copyright © JavaZoom. All rights reserved.
The following disclaimer is required by JQuery: Copyright 2013 jQuery Foundation and other contributors (http://jquery.com/)
The following disclaimer is required by JQuery Plugin Autocomplete: Copyright (c) 2009 Jörn Zaefferer. (http://www.opensource.org/licenses/mit-license.php)
The following disclaimer is required by jquery.contextMenu: Copyright © 2008 A Beautiful Site, LLC
The following disclaimer is required by jquery.jqDnR: Copyright © 2007 Brice Burgess (<[email protected]>, http://www.iceburg.net)
The following disclaimer is required by Ui.dropdownchecklist: Copyright © 2008-2010 Adrian Tosca, Copyright (c) 2010-2011 Ittrium LLC
The following disclaimer is required by jquery.json: Copyright © 2009 Brantley Harris
The following disclaimer is required by jquery.metadata: Copyright © 2006 John Resig, Yehuda Katz, Jörn Zaefferer, Paul McLanahan
The following disclaimer is required by jquery.jqModal: Copyright © 2007,2008 Brice Burgess (<[email protected]>)
The following disclaimer is required by jquery.jTemplates: Copyright © 2009 Tomasz Gloc
The following disclaimer is required by jquery.treeview: Copyright © 2007 Jörn Zaefferer
The following disclaimer is required by jquery UI: Copyright © 2011, Scott Gonzalez et al. (http://jqueryui.com/about)
The following disclaimer is required by JScape: Portions of this product are Copyright © JScape. All rights reserved.
The following disclaimer is required by JScript Hashtable: Copyright © 2003 Michael Synovic This is a Javascript implementation of the Java Hashtable object.
The following disclaimer is required by JScript Table Sorter: © 2010 Michael Leigeber. All Rights Reserved This script has been tested in all major browsers and is available free of charge for both personal or commercial projects under the creative commons license.
The following disclaimer is required by Libjpeg-turbo: libjpeg-turbo is Copyright © 1998-2005 Julian Smart, Robert Roebling et al and is licensed under the terms of the wxWindows Library Licence, Version 3.1, which is included with this product.
The following disclaimer is required by Limited Concurrency Task Scheduler: Portions Copyright © Microsoft Corporation Inc. All Rights Reserved. Microsoft Limited Public License version 1.1
The following disclaimer is required by MediaLooks: Portions of this product are Copyright MediaLooks. All rights reserved.
The following disclaimer is required by Microsoft Corporation: Portions of this product are Copyright © Microsoft Corporation. All rights reserved.
38
The following disclaimer is required by Microsoft.Net Framework Base Class Libraries, BigRational: Portions of this product are Copyright © Microsoft Corporation. All rights reserved.
The following disclaimer is required by Microsoft Prism: Microsoft patterns & practices License; Creative Commons Attribution License 3.0 Unported
The following disclaimer is required by MOG Solutions: Portions of this product are Copyright © MOG Solutions. All rights reserved.
The following disclaimer is required by MPEG Audio: MPEG Audio technology may be included with this product. Audio MPEG, Inc. and S.I.SV.EL., S.P.A. require this notice: This product contains MPEG Audio technology licensed by Audio MPEG and SISVEL only for use in accordance with Avid's EULA. Last Updated: March 2010
The following disclaimer is required by MSTS-adapter: Copyright © 2008 Will Ballard / Duane Fields / ExactMagic
The following disclaimer is required by MVVM Lite: Copyright (c) 2009 - 2011 Laurent Bugnion
The following disclaimer is required by nUnit: Copyright (c) 2004-2009 Charlie Poole
The following disclaimer is required by Obout Software: Portions of this product are Copyright © Obout Software. All rights reserved.
The following disclaimer is required by OpenSSL: This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/)
The following disclaimer is required by PixieLib: Portions of this program borrowed from PixieLib.NET, Copyright 2005 Paul DiLascia.
The following disclaimer is required by FilterCode: Copyright © 2011 phpleo
The following disclaimer is required by PlainIt Works JeeGooContext: Copyright © 2009 - 2010 by Erik van den Berg
The following disclaimer is required by Prototype JavaScript Framework: Copyright © 2005-2008 Sam Stephenson
The following disclaimer is required by ScintillaNET: Copyright © 1998-2006 by Neil Hodgson ([email protected]) All Rights Reserved ScintillaNET bindings are Copyright © 2002-2006 by Garrett Serack ([email protected]) All Rights Reserved
The following disclaimer is required by RabbitMQ: Copyright © 2013 GoPivotal, Inc. All rights reserved
The following disclaimer is required by Script.Aculo.Us Web 2.0 JavaScript: Copyright © 2005-2008 Thomas Fuchs (http://script.aculo.us, http://mir.aculo.us)
The following disclaimer is required by Search Highlighter: Copyright (c) 2002, 2007, 2008 Stuart Langridge ([email protected])
The following disclaimer is required by Silverlight Menu: Microsoft Public License (Ms-PL) http://sl3menu.codeplex.com/license
The following disclaimer is required by Silverlight Serializer: Copyright © Mike Talbot, Microsoft Public License (Ms-PL)
The following disclaimer is required by tipsy:
39
Copyright (c) 2008 Jason Frame ([email protected]). The software and documentation is released under the MIT license. https://github.com/jaz303/tipsy/blob/master/LICENSE
The following disclaimer is required by WPF Themes: Licensed under the Microsoft Public License (Ms-PL) http://wpf.codeplex.com/license
The following disclaimer is required by WPF Toolkit: Microsoft Public License (MS-PL)
The following disclaimer is required by Xmlextras.js: Copyright © 2006 Erik Arvidsson Licensed under the Apache License, Version 2.
The following disclaimer is required by XNView: Portions of this product are Copyright © XNView. All rights reserved.
Attn. Government User(s). Restricted Rights Legend U.S. GOVERNMENT RESTRICTED RIGHTS. This Software and its documentation are “commercial computer software” or “commercial computer software documentation.” In the event that such Software or documentation is acquired by or on behalf of a unit or agency of the U.S. Government, all rights with respect to this Software and documentation are subject to the terms of the License Agreement, pursuant to FAR §12.212(a) and/or DFARS §227.7202-1(a), as applicable.
Trademarks
Avid, the Avid Logo, Avid Everywhere, Avid DNXHD, Avid DNXHR, Avid Nexis, AirSpeed, Eleven, EUCON, Interplay, iNEWS, ISIS, Mbox, MediaCentral, Media Composer, NewsCutter, Pro Tools, ProSet and RealSet, Maestro, PlayMaker, Sibelius, Symphony, and all related product names and logos, are registered or unregistered trademarks of Avid Technology, Inc. in the United States and/or other countries. The Interplay name is used with the permission of the Interplay Entertainment Corp. which bears no responsibility for Avid products. All other trademarks are the property of their respective owners. For a full list of Avid trademarks, see: http://www.avid.com/US/about-avid/legal-notices/trademarks.
Adobe and Photoshop are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. Apple and Macintosh are trademarks of Apple Computer, Inc., registered in the U.S. and other countries. Windows is either a registered trademark or trademark of Microsoft Corporation in the United States and/or other countries. All other trademarks contained herein are the property of their respective owners.
Avid Interplay | MAM Archive Sequences Guide, Created 9/9/2016. This document is distributed by Avid in online (electronic) form only, and is not available for purchase in printed form.
