Imagine Communications DALingest Client User Manual
Anúncio
Anúncio
Installation Reference
D-Series™ DALingest
Client v3.39
4-February-2015
Revision: Release
D-Series™ DALingest Client v3.39 Installation Reference
Publication Information
© 2015 Imagine Communications Corp. Proprietary and Confidential.
Imagine Communications considers this document and its contents to be proprietary and confidential.
Except for making a reasonable number of copies for your own internal use, you may not reproduce this publication, or any part thereof, in any form, by any method, for any purpose, or in any language other than English without the written consent of Imagine Communications. All others uses are illegal.
This publication is designed to assist in the use of the product as it exists on the date of publication of this manual, and may not reflect the product at the current time or an unknown time in the future. This publication does not in any way warrant description accuracy or guarantee the use for the product to which it refers. Imagine Communications reserves the right, without notice to make such changes in equipment, design, specifications, components, or documentation as progress may warrant to improve the performance of the product.
Trademarks
Product names and other brands (such as ADC™, D-Series™, Nexio®, Nexio® Insight, Nexio® Motion,
PowerSmart®, Versio™) are trademarks or trade names of Imagine Communications or its subsidiaries.
Microsoft® and Windows® are registered trademarks of Microsoft Corporation. All other trademarks and trade names are the property of their respective companies.
Contact Information
Imagine Communications has office locations around the world. For domestic and international location and contact information see: http://www.imaginecommunications.com/contact-us/
Support Contact Information
For domestic and international support contact information see:
Support Contacts: http://www.imaginecommunications.com/services/technical-support/
eCustomer Portal: http://support.imaginecommunications.com
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 2 of 84
D-Series™ DALingest Client v3.39
Installation Reference Contents
Contents
Activating the Configure Drop-down Menu ......................................................... 15
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 3 of 84
D-Series™ DALingest Client v3.39
Installation Reference Contents
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 4 of 84
D-Series™ DALingest Client v3.39
Installation Reference Contents
Configuring Default ARC Value (Quick Data Entry) ............................................... 60
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 5 of 84
D-Series™ DALingest Client v3.39
Installation Reference Contents
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 6 of 84
D-Series™ DALingest Client v3.39
Installation Reference Contents
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 7 of 84
D-Series™ DALingest Client v3.39
Installation Reference
DALingest Client Overview
DALingest Client Overview
About DALingest Client
D-Series™ DALingest is a client-side application for controlling frame-accurate ingests from VTR to video server inside a DAL automation system. It resides on a networked, Windows®-based workstation used for tape timing, barcoding, and read/write user-bit encoding.
DALingest Client:
Creates and maintains material records in the DALdb database. These records are used to generate reports concerning the clips that are stored on the video server.
Supports ingest control panels for capturing timecode data from tape and reviewing material from VTRs and video servers connected to a DAL Ingest Manager or DAL Channel
Manager Automation system.
Uses the real-time control capabilities of the Automation system to control a VTR and server ports.
DALingest Client is best suited for stations that want:
An integrated station database solution (integration with DALdb - a persistent station database for material). Here the product resides on a workstation connected to the private automation LANs and DALdb database.
On-demand, frame-accurate dubbing only (integration with playout automation) and do not need the schedule-based dubbing capability of Ingest Manager.
Both on-demand, frame-accurate dubbing and schedule-based, frame-accurate dubbing capability (have Ingest Manager automation).
About Limited Ingest Support
DALingest Client can connect to playout automation (A7500v3). However, since review and trim are not available on playout automation, these options are hidden from the user. DALingest checks for the existence of the ‘CONFIRM’ field in Store.CFG to determine if the automation system it is connected to has limited ingest ability.
If the field is found, the system is assumed to have full ingest capabilities.
If the field is not found, the system is assumed to have limited ingest capability.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 8 of 84
D-Series™ DALingest Client v3.39
Installation Reference
System Requirements
DALingest Client Overview
For DALingest to make use of all its functionality, it requires all of the following components to be installed and correctly configured.
Operating System
•
As of DALingest v3.37 the minimum O/S version and IE version supported has been expanded.
•
DALingest can be installed on Windows 7, with IE 8 or better installed on them.
DALingest can still operate on Windows XP.
As of DALingest v3.35 the minimum O/S version and IE version supported has increased.
DALingest must be installed on Windows Server 2003 SP1 or Windows XP SP2 or better, with IE 6 SP2 or better installed on them.
The Windows 2000 platform is no longer supported.
•
For DALingest v3.34 and earlier the minimum O/S version is MS Windows NT family
(NT4, 2K, XP) with the most recent service packs installed.
Note: If installing an O/S, it is always best to go to the latest Service Pack for that O/S (e.g.
SP3 for Windows XP).
MDAC 2.7 SP1 (Microsoft Data Access Components, required for communications with
DALdb). This ensures the ODBC, OLE DB, ActiveX Data Objects (ADO), and Remote Data
Services (RDS) technologies are supported on the machine where DALingest is to be installed.
•
The ADO components (including RDS) and some OLE DB modules require administrator privileges on Microsoft Windows NT, Microsoft Windows 2000, or Microsoft Windows
XP to install and register correctly. See http://msdn.microsoft.com/data/ for greater detail.
A DALdb session on the LAN that is accessible from the DALingest PC
•
•
Ingest Client supports DALdb running on MS SQL 2000 (or MSDE) or MySQL 4.0 (or better).
Support for the MySQL database requires the MyODBC (MySQL Connector/ODBC) driver be installed in order to connect to a MySQL database server.
•
DALdb schema version 1.12.01.03 and previous (where XX is a minor version number for the database).
Note: The schema version specified for DALingest Client must match the version specified for
D-AIS. Otherwise the DALingest Client application will be unable to save records to the
database.
D-Series Ingest automation (A8800 V3.79.00.ALPHA and above, A6800 V3.12.00.ALPHA and above, A7800V3 V3.00.00.ALPHA)
D-Series™ playout automation V3 and V4
Supported VTRs and video servers connected to the automation system.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 9 of 84
D-Series™ DALingest Client v3.39
Installation Reference
A record bus correctly configured on the automation system.
A DAL Jog/Shuttle panel connected to the DALingest PC. (Optional)
Supported Barcode Scanner and Printer. (Optional)
DALingest Client Overview
DALingest License File
DALingest will not run unless a valid “Licence.cfg” file is present in the directory containing the
DALingest executable and initialization files (“DALingest.exe” and “DALingest.ini”) indicating that
DALingest is authorized to run on the specific workstation hardware.
To obtain a valid “Licence.cfg” file: The required “Licence.cfg” file must be obtained from
Imagine Communications.
If this file is missing, does not include a recognized digital signature from Imagine
Communications, or has been modified after the digital signature was generated, then
DALingest will not start up and instead an informative error message is displayed.
About “Licence.cfg”
Sections
The “Licence.cfg” consists of one or more sections (indicated by the line “[section name]”), much like a Windows INI file. DALingest ignores the contents of any sections except the
“[DALingest]” section, which must be present.
Parameters
The “Licence.cfg” configuration file may contain the following parameters:
Parameter
CLIENT_ID1
CLIENT_ID2
! some text
Description
A string identifying the client to whom the License configuration file is issued.
An additional identifying string (typically used to identify one of several installations licensed by the same client).
Note 1: The parameters “CLIENT_ID1”, “CLIENT_ID2” normally appear at the top of the “Licence.cfg” file, before the start of any application specific sections (so they are common to all Windows
applications sharing a particular “Licence.cfg” file).
Note 2: The DALingest “Help|About DALingest…” dialog box also displays the client ID strings from the DALingest “Licence.cfg” file.
Lines beginning with “!” are ignored (so they can be used for comments).
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 10 of 84
D-Series™ DALingest Client v3.39
Installation Reference DALingest Client Overview
Parameter
[DALingest]
[some other section name]
Description
This indicates the start of the Licence.cfg section that is intended for DALingest.
DALingest ignores any other sections in the Licence.cfg file apart from the DALingest section. This allows DALingest to:
-
Share a single Licence.cfg file with other Windows applications (e.g. DALstation).
-
Share a copy of the same file as other D-MAS Windows applications (e.g. DALpanel or DALstation).
ETHERNET_ADDR This entry is used to limit DALingest to executing on specific hardware. The computer the DALingest is running on must have a network interface with an Ethernet address matching one of these entries.
-
It consists of six 2-digit hexadecimal numbers separated by colons (e.g. ETHERNET_ADDR=02:07:01:10:A9:A3).
-
This parameter may appear more than once to specify multiple cards.
Note: The “ETHERNET_ADDR” parameter is similar to that already used in existing D-MAS product “Licence.cfg” files.
Minimum “Licence.cfg” file Requirements
A minimal “Licence.cfg” file for DALingest has client identification strings and a “[DALingest]” section with a single ETHERNER_ADDR entry:
! WARNING - Editing this file will stop the automation system from running!
CLIENT_ID1="Example Client Name"
CLIENT_ID2="Installation Name"
[DALingest]
ETHERNET_ADDR=00:20:AF:F0:C4:0C
SIGNATURE: DAL-DMAS "Authorized Agent" 2005-10-17 16:57:27
B59970D029B944915F9DA7B28297571D9953E77A
9E2281EB5F53CF1132238DDD18C8FEE71B2AA436
However, it is more typical to provide:
A single file for a customer site with multiple “ETHERNET_ADDR” entries (one for each workstation running DALingest), or
A single file for multiple applications (e.g. one set of “ETHERNET_ADDR” entries in the
“[DALingest]” section, and another set in a “[DALstation]” section).
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 11 of 84
D-Series™ DALingest Client v3.39
Installation Reference DALingest Client Overview
DALingest does not impose any specific limit on the number of ETHERNET_ADDR entries that it recognizes (other than the limit imposed by available memory).
Obtaining the Ethernet Address
There are two common methods for obtaining the Ethernet address.
“Network Connections” applet
On Windows XP, use the control panel “Network Connections” applet.
3
4
Step
1
2
Action
On Windows XP, select Start>Control Panel> “Network Connections”.
Select the appropriate “Local Area Connection” entry.
Right click and then invoke “Properties…” from the context menu.
Hover the mouse cursor over the description of the network adapter in the box labeled “Connect using” and the Ethernet appears in a tooltip (labeled
“MAC Address”).
“ipconfig /all” Command
Open a command prompt window and use the command “ipconfig /all”. This lists various properties of the network adapters including the “Physical Address”.
Note: The “Licence.cfg” file uses a “:” character to separate the individual bytes of an Ethernet address, while Windows uses “-”.
About Configuring DALingest Client
When DALingest starts up, it immediately attempts to connect to its three components: DALdb,
D-MAS, and the Jog/Shuttle panel. The status bar at the bottom of the application shows the status of these connections.
All devices automatically attempt to connect on startup. If the device cannot connect or there is a configuration error, the user is notified (except on startup).
When the indicator is shown in red, the device is disconnected. The user can click once on the device in the status bar to attempt to reconnect it.
To configure the devices and the ingest parameters, visit the configuration dialogs located under the Configure menu.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 12 of 84
D-Series™ DALingest Client v3.39
Installation Reference DALingest Client Overview
The Configure Menu
The Configuration menu allows the selection and the subsequent setup of specific DALingest
Client hardware and configuration options. This menu selection allows for configuration of the following:
Jog/Shuttle Panel Settings
Barcode Scanner / Printer Settings
Hide Configuration Options
Advance Ingest Operations Configuration
The Advance Ingest Operations Configuration dialog is only available after DALingest Client is
configured and once an Ingest Operation is started. This dialog allows the user to setup various options that require a fairly broad depth of knowledge of automation and the ingest procedure.
This option sets the defaults for all future ingests.
Diagnostic Logging Level Configuration
The Diagnostic Logging dialog is used to configure system logging levels. This dialog is accessed
by selecting from the Menu Help>Diagnostic Logging.
User Bit SOM Offset Configuration
An SOM offset can be configured for use when reading / writing user bits. The User Bits group
control sports a SOM- button that when pressed fills the edit control above it with the SOM of the material less a configured offset.
RTS and DTR Standard COM Ports Configuration
USB “virtual” Windows COM ports to be used for panels.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 13 of 84
D-Series™ DALingest Client v3.39
Installation Reference Installing the DALingest Client Executable
Installing the DALingest Client
Executable
To Install the Executable
Place the DALingest application executable (DALingest.exe) on the target computer. It runs without any installation procedure.
Recommended Path: C:\Program Files\......\’station call letters’\Media Client
DALingest may require installation of MDAC 2.7 (downloadable from the Microsoft web site).
However, this is typically not necessary and MDAC should only be installed if problems are encountered while attempting to setup the connection to DALdb.
Directory Structure
C:\Program Files\ ……\’station call letters’\Media Client
Directory
\Media Client
\Media
Client\logs
File Notes
DALingest.exe The main application
DALfile.ini The initialization file – automatically updated from the configuration tool in the main application. Can be written to directly if required.
DALingest.chm The DALstation Help file.
All log files are stored in here
About DALingest.ini
All the entries in DALingest.ini are written directly by the Media Client application. There is typically no need to edit this file directly unless absolutely required by a specific parameter.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 14 of 84
D-Series™ DALingest Client v3.39
Installation Reference Activating the Configure Drop-down Menu
Activating the Configure Drop-down
Menu
To Activate the Configure Drop-down
Menu
After initial installation, Media Client hides the Configure drop-down menu. To configure Media
Client, activate the Configure Drop-down menu.
Step
1
2
3
Action
Shut down Media Client
Open the DALingest ini file.
Find the [Options] section shown below and set Show Config=1
4
5
Restart Media Client
The Configure drop-down menu is now available.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 15 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Step Action
Activating the Configure Drop-down Menu
6 (Option) To hide the Configure drop down menu again, choose Hide
Configuration Options…
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 16 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Configuring D-MAS Settings
Configuring D-MAS Settings
To Configure D-MAS Settings
The Media Client can connect to up to 4 D-Series Ingest Automation Systems to provide machine control. The details of this connection are set up in the DMAS Configuration Options dialogue.
This configuration allows for:
A new server configuration to be created.
A server configuration to be edited.
A server configuration to be deleted.
Organization of configured servers in the list to assist with management of the selected reconnection strategy
Manual, Semi-automatic and Automatic reconnection once DALingest becomes disconnected from D-MAS. Connections to other configured servers is attempted if an attempt to connect to a selected server fails.
To Add a Server
Step Action
1 Select D-MAS Settings from the Configure drop-down menu.
2 The D-MAS Configuration Options dialog box opens
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 17 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Step Action
Configuring D-MAS Settings
3
Click New ( ) to specify the IP address, and description as configured in
PORT.CFG on the destination automation system. Up to 4 servers can be defined for connection.
4
5
In Group box: D-MAS Server Location:
-
Port: Specify the port for the D-MAS Server. Type in the Port Number of the Ingest Automation Server. Typically this is:
SCH_SVR_PORT=20025. It is located in System.cfg in the Data Directory of the Ingest Automation Server.
Specify a valid username and password as configured in PASSWORD.CFG that has access to the record bus on which DALingest will be ingesting to. (See
‘Configuring Ingest Parameters.’)
In Group box: Authentication:
-
User: Specify the user level. Type in the User Category that you want the media Client to log on as.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 18 of 84
D-Series™ DALingest Client v3.39
Installation Reference Configuring D-MAS Settings
Step Action
-
Password: Specify the password for user Authentication. Type in the
Password for the User category you want to log on as.
6
7
Specify the required Reconnect on Disconnect option:
-
Manual: Reconnect on Disconnect: On disconnect, DALingest colours the D-MAS pane of the Status Bar red. The operator is responsible for re-initiating a connection to D-MAS.
-
Semi-Automatic: Reconnect on Disconnect: On disconnect, DALingest colors the D-MAS pane of the Status Bar red. Automatically attempt connection to other configured servers if an attempt to connect to a selected server fails. The operator is responsible for acknowledging each reconnection attempt by manually closing the ‘Select and
Connect To D-MAS’ dialogue.
-
Automatic: Reconnect on Disconnect: On disconnect, DALingest colors the D-MAS pane of the Status Bar red. Automatically attempt connection to other configured servers if an attempt to connect to a selected server fails. No operator action is required for any reconnection attempt.
Select the correct button to conclude the operation:
-
Cancel: Cancel the operation and close the dialog.
-
Revert: Revert to previous settings.
-
Save and Close: Save the entries and close the dialog.
-
Save and Connect: Save the entries, close the dialog, and connect to D-
MAS automation using the new values.
To Modify Existing Server Entries
Use the following procedures to modify existing server entries.
To Move D-MAS Servers in the Location list
To assist with management of the selected reconnection strategy, these buttons allow a server configuration to be:
Moved up the list of server configurations, such that it is considered for use in connection before servers below it during a reconnection scenario,
Moved down the list of server configurations, such that it is considered for use in connection after servers above it during a reconnection scenario.
Move Down the list
Click ( ) to invoke the Nove Down function or press the ‘Ctrl+Down Arrow’ (while on the list only), moves the list selection one entry towards the bottom of the list if it is not the last entry
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 19 of 84
D-Series™ DALingest Client v3.39
Installation Reference Configuring D-MAS Settings of the list. Otherwise it does nothing. When an entry is moved, it exchanges places with the entry below it. The CPU/LAN numbers are not exchanged so the entries remain consecutively numbered.
Move Up the list
Click ( ) to invoke the Move up function or press the ‘Ctrl+Up Arrow’ (while on the list only), moves the list selection one entry towards the top of the list if it is not the first entry of the list.
Otherwise it does nothing. When an entry is moved, it exchanges places with the entry above it.
The CPU/LAN numbers are not exchanged so the entries remain consecutively numbered.
To Edit an Existing Entry
Click ( ) to invoke the Edit function or press the ‘Enter’ key (while on the list only), or by double-clicking on a list entry, allows editing of the list selection if there is one, using the same dialogue as ‘New’. Selecting the ‘OK’ button commits any changes to the selected list entry.
Selecting ‘Cancel’ aborts any changes.
To Delete an Existing Entry
Click ( ) to invoke the Delete function, or press the ‘Delete’ key (while on the list only).
Deletes the list selection if there is one. When an entry is deleted, subsequent entries are renumbered so they remain consecutive.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 20 of 84
D-Series™ DALingest Client v3.39
Installation Reference Configuring Jog/Shuttle Panels
Configuring Jog/Shuttle Panels
DAL Jog/Shuttle Panel
The Jog-Shuttle panel can be used for timing operations instead of the DALingest Client’s Device
Control interface. Only one panel per ingest client is currently supported.
The Jog-Shuttle panel is operational for both VTR timing and DVS timing. This panel provides jog and shuttle operations for both types of devices. However, depending on DVS device type, the rewind and fast forward keys may not operate properly. These keys operate properly for VTR devices. For more information on the panel, refer to the Jog-Shuttle Panel: Reference Guide.
The Media Client is often connected to a Jog / Shuttle Panel. The Jog/Shuttle panel can be used to control the manual device that is used as the source ingest device (via the automation system). The details of this connection are set up in the Jog / Shuttle Panel Configuration dialogue.
To Configure DAL Jog/Shuttle Panel Settings
Step
1
Action
Select Jog/Shuttle Panel Settings from the Configure drop-down menu.
2 The Jog/Shuttle Panel Configuration dialog box opens
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 21 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Step Action
Configuring Jog/Shuttle Panels
3
4
5
Add a Panel Configuration
To add a panel configuration to the ‘Configured Panels’, select the ‘+’ button.
Note: A panel configuration cannot be added to the ‘Configured Panels’ list
more than once. Inserting a new entry into the ‘Configured Panels’ list removes any associated values from the ‘Add Panel Configuration’ dropdown
menus.
In the ‘Add Panel Configuration’ section, The associated
-
Panel Name: Select the Panel from this dropdown. The dropdown menu contains a list of the jog/shuttle panels which require a serial connection and are known by DALingest.
-
In the above example screen the panel name ‘DAL J/S Control’ represents the older DAL Jog/Shuttle Control Panel. ‘ J/S Control’ represents the new Jog Shuttle panel.
-
Serial Port: Select the serial communication port used for the
Jog/Shuttle panel. The arrow provides a dropdown of available COM ports. Only those serial ports which are available on the current workstation are listed in the ‘Serial Port’ dropdown menu.
DAL Jog/Shuttle Control Panel Note: Connect the Jog Shuttle Panel to a valid
serial port communicating at 38400 baud (default baud rate).
To Remove an Existing Panel Configuration
If an existing panel configuration is no longer applicable, highlight the entry, and then select the button labeled ‘x’.
The highlighted entry is removed from the ‘Configured Panels’ list and the entry values are re-added to the ‘Add Panel Configuration’ dropdown lists.
Note: The ShuttlePRO2 Panel cannot be removed from the ‘Panel
Configuration’ list because it is an automatic configuration. When the
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 22 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Step
6
Configuring Jog/Shuttle Panels
Action
ShuttlePRO2 Panel entry is highlighted, the button labeled ‘x’ is disabled.
Select the correct button to conclude the operation:
-
Cancel: Close the dialog box without saving changes.
-
Revert: Revert to previous settings.
-
Save and Close: Save the entries and close the dialog.
-
Save and Connect: Save the entries, close the dialog, and connect to
Ingest Automation using the new values.
Contour ShuttlePro 2
The Contour Shuttle Pro2, with its unambiguous button operation, helps simplify and streamline the ingest process. This device can be used as the primary ingest tool for moving material into the transmission system. This panel is used in processing material quickly and efficiently while supplying quality assurance. To provide this functionality, the device is used in conjunction with the DALingest Client workstation. The workstation displays the events to be ingested and the control panel provides a “hands-on” user interface.
Jog Wheel, Shuttle Ring Limitations
Although the ShuttlePRO2 panel allows for simultaneous movement of the outer shuttle ring and jog wheel, doing so will display inaccurate timecodes within DALingest. Avoid simultaneous movement of the jog wheel and shuttle ring.
To Configure the ShuttlePro2
Configuration of the ShuttlePRO2 panel is automatic and does not require operator input. to configure any open Contour Shuttle Pro2 buttons, use procedures detailed in manufacturer documentation. The following image illustrates the ShuttlePro2 Button Layout.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 23 of 84
D-Series™ DALingest Client v3.39
Installation Reference
ShuttlePro2 Button Layout
Configuring Jog/Shuttle Panels
To install the DALingest settings for the ShuttlePRO2
The ShuttlePRO2 is a plug-n-play USB device and does not require any special configuration. Just plug it into an available USB port on the DALingest Workstation.
IMPORTANT: Before installing the ShuttlePRO2 on the DALingest workstation, ensure any previous installation of this device has been removed. Not removing Shuttle Device Software may cause erratic panel behavior.
Microsoft DirectX 8.1 Requirement
If the client operating system predates Microsoft Windows XP, a ShuttlePRO2 Panel cannot be used without first installing Microsoft’s DirectX library. Microsoft’s DirectX library contains a second library, DirectInput, which is used to obtain panel notifications (i.e. button presses and jog/shuttle wheel movement) from the ShuttlePRO2 panel. The DirectInput technology allows for automatic configuration of the ShuttlePRO2 panel.
The dinput8.dll file (i.e. Microsoft’s DirectInput Library) is included with the Microsoft DirectX installation. The Microsoft DirectX installation files can be found at the following location: http://www.microsoft.com/downloads/details.aspx?FamilyID=db685892-afc4-40e3-bad0d4db291a8095&DisplayLang=en
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 24 of 84
D-Series™ DALingest Client v3.39
Installation Reference Configuring Jog/Shuttle Panels
To create a web page that shows the ShuttlePRO2 Settings
(Optional)
Use the following procedure to create a web page that shows the ShuttlePRO2 settings for a given application.
Step
1
2
3
4
5
Action
In the Target dropdown, select the application and then select the Options button.
Select the Export Settings Info menu selection.
Enter a location to save the html file. A dialog appears.
Select the Save button.
Open the html page to view show the mappings for the given application.
About Configuring Multiple Ingest Control
Panels
DALingest supports the configuration of multiple ingest control panels. Although multiple panels may be configured, communication is limited to one panel at a time, with the panel currently attempting communication is termed the default panel.
Detecting a Default Panel Automatically
If both a DAL Jog/Shuttle Control Panel and ShuttlePRO2 Panel are configured and connected but a default panel has not been selected, the ShuttlePRO2 Panel takes precedence as the default panel.
If a ShuttlePRO2 panel is not connected and a default panel has not been selected, the first configured serial port panel in the configured panel list will be set as the default (even if it is not connected).
If the current default panel becomes disconnected from the workstation and the operator does not select a different default panel, reconnecting the panel allow the operator to continue using the previously disconnected panel.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 25 of 84
D-Series™ DALingest Client v3.39
Installation Reference Configuring Jog/Shuttle Panels
To Review the Current Default Panel
Connection
The DALingest status bar item JOG-SHUTTLE refers to the current default panel (which may not be the DAL Jog/Shuttle Control Panel).
The connection indicator at the bottom of the screen lights green to indicate (the only indication) the port is successfully configured by DALingest to be used as a jog/shuttle panel.
(Red indicates no connection.)
This indicator does not confirm the panel is communicating with DALingest.
Valid panel operation is confirmed by the panel mirroring the DALingest display in the VTR control.
To Determin the Default Panel
To determine which panel is selected as the default, right click on the JOG-SHUTTLE status bar item. A popup menu displays all configured panels. The default panel is identified with a checkmark.
To Change the Default Panel
To change the default panel, the select a different panel in the menu. The default panel can also be changed from the Jog/Shuttle Configuration Dialog.
Note: If there are no panels configured, the right-click menu is disabled.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 26 of 84
D-Series™ DALingest Client v3.39
Installation Reference Configuring Barcode Scanner / Printer
Configuring Barcode Scanner /
Printer
To Configure the Barcode Scanner
DALingest allows for the configuration of the serially connected barcode scanner in the
Configuration | Barcode Printer/Scanner Settings dialog.
Barcode scanner support; specifically for the Welch Allyn scanner; but generally for any scanner that supports decoded output with code ID prefixes and suffixes (discussed below.)
Output Format: The barcode scanner must output the data to the serial port asynchronously in a specific format:
[CodeID][barcode data][CR]
[CodeID] is a single character which represents the type of barcode that has been scanned.
e – represents an Interleaved 2 of 5 format, which is parsed as a Sony barcode
n – represents a Code 39 format which is interpreted as a single material ID
[CR] is 0x13, the ASCII carriage return character.
Step
1
Action
Select Barcode Scanner/Printer Settings from the Configure drop-down menu.
2 The Barcode Scanner / Printer Configuration dialog box opens.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 27 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Step Action
Configuring Barcode Scanner / Printer
3
4
Configure the following elements in the Barcode Scanner Group box:
-
Port: Specify the communication port used. Options are COM 1 –
COM 4. The DALingest application shows only those COM ports found on the system.
-
Baud Rate: Specify the communication baud rate. Options are 4800,
9600, 19200.
-
Parity/Data/Stop: Specify the stop bit used. Options are N81, N82,
N71, N72, E81, E82, E71, E72, O81, O82, O71, O72, S81, S82, S71, and
S72.
-
Enable: Enable/Disable all fields for selection and input.
Select the correct button to conclude the operation:
-
Cancel: Close the dialog box without saving changes.
-
Revert: Revert to previous settings.
-
Save and Close: Save the entries and close the dialog.
-
Save and Connect: Save the entries, close the dialog, and connect to
Ingest Automation using the new values.
Configuring Welch Allyn 5700 Barcode Scanners
Configure the Welch Allyn scanner to output this format by following the instructions, in the
5700 scanner, revision K manual.
On page 1-13, under the ‘Reset Factory Settings’ header, scan the ‘Factory Default Settings’ barcode.
On page 1-13, under the ‘Quick Suffix Selections’ header, scan the ‘Program Carriage Return
Suffix’ barcode.
On page 2-10, under the ‘Code I.D. Transmit Selection’, scan the ‘Enable’ barcode.
This resets the scanner to use 9600 baud, E71 configuration, and sends the proper prefix and suffix.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 28 of 84
D-Series™ DALingest Client v3.39
Installation Reference Configuring Barcode Scanner / Printer
Configuring HHP IT5800 Barcode Scanners
The procedure for configuring the Welch Allyn 5700 barcode scanner will not correctly configure
HHP IT5800 barcode scanners.
To configure a HHP IT5800 barcode scanner, download Visual Menu 2003 software from www.hhp.com
in order to setup the IT5800.
To Configure the Barcode Printer
DALingest allows for the configuration of the serially connected barcode printer.
Barcode printer support: specifically for the SONY barcode printer protocol, and the ZEBRA printer protocol, with adjustable parameters for X and Y offsets, the barcode narrow bar width, and the ratio between narrow and wide bars.
The printer settings (valid COM port, etc.) are only checked when the user selects ‘Print.’
Two printer protocols are supported; the SONY printer protocol, and the ZEBRA printer protocol. Both communicate serially. The only supported type of barcode for printing is the
SONY barcode format.
Step
1
Action
Select Barcode Scanner/Printer Settings from the Configure drop-down menu.
2 The Barcode Scanner / Printer Configuration dialog box opens.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 29 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Step Action
Configuring Barcode Scanner / Printer
3
4
Configure the following elements in the Barcode Scanner Group box:
-
Port: Specify the communication port used. Options are COM 1 –
COM 4.
-
Baud Rate: Specify the communication baud rate. Options are 1200,
2400, 4800, 9600, 19200.
-
Parity/Data/Stop: Specify the stop bit used. Options are N81, N82,
N71, N72, E81, E82, E71, E72, O81, O82, O71, O72, S81, S82, S71, and
S72.
-
Enable: Enable/Disable all fields for selection and input.
-
Printer Protocol: Barcode Printer: Specifies the protocol used. Options are: Sony and Zebra.
-
Options: Specifies other options used.
Select the correct button to conclude the operation:
-
Cancel: Close the dialog box without saving changes.
-
Revert: Revert to previous settings.
-
Save and Close: Save the entries and close the dialog.
-
Save and Connect: Save the entries, close the dialog, and connect to
Ingest Automation using the new values.
About the ‘Parity/Data/Stop’ Field
The following table defines the options presented for the ‘Parity/Data/Stop’ fields:
Option Parity Data
Bits
N81
N82
None
None
8
8
1
2
Stop
Bits
Option Parity Data
Bits
M81
M82
Mark
Mark
8
8
1
2
Stop
Bits
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 30 of 84
D-Series™ DALingest Client v3.39
Installation Reference
E71
E72
O81
O82
O71
O72
Option Parity Data
Bits
N71
N72
None
None
7
7
E81
E82
Even 8
Even 8
Even 7
Even 7
Odd
Odd
Odd
Odd
8
8
7
7
2
1
2
1
2
1
1
2
1
2
Stop
Bits
Configuring Barcode Scanner / Printer
Option Parity Data
Bits
M71
M72
Mark
Mark
7
7
S81
S82
Space 8
Space 8
S71
S72
Space
Space
7
7
1
2
1
2
1
2
Stop
Bits
Directly Editing Parameters Using Print Barcode preview dialog
Parameters are also editable directly in the Print Barcode preview dialog box (below), so they may be adjusted as necessary and saved once suitable values are found.
Controlling the Barcode Printing Position: Horizontal and
Vertical
Some parameters can be typed in with the format <KEY>=<VALUE>;… Spaces are ignored.
Example: “XOFFSET=13;WIDTH=3;RATIO=2.6;”
Currently, only four parameters exist, and are only valid for a printer which follows the ZEBRA
printer protocol.
Name Permitted Values
<Default Value>
Description
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 31 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Name Permitted Values
<Default Value>
YOFFSET 0…9999
<5>
XOFFSET
WIDTH
RATIO
0…9999
<12>
1…10
<2>
2.0 … 3.0 (by 0.1)
<2.5>
Description
Configuring Barcode Scanner / Printer
The vertical offset from the printer detected start of media to the beginning of the barcode. Adjust this parameter if the barcode is not printed in the correct vertical position on the label.
The horizontal offset from the printer detected start of media to the beginning of the barcode.
Adjust this parameter if the barcode is not printed in the correct horizontal position on the label.
The width, in dots, of the narrow bar of the barcode. If the barcode has problems being scanned, adjust this parameter.
The ratio of the narrow bar to the wide bar. If the barcode has problems being scanned, adjust this parameter.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 32 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Configuring the Database
Configuring the Database
To Configure the Database
The Media Client is connected to the DALdb on the Content Server. The details of this connection are set up in the Materials Database Configuration Options dialogue.
Step Action
1 Select Database from the Configure drop-down menu.
NOTE: If you have dual DAIS computers you’ll have Database One and Two settings.
2 The Materials Database Configuration Options dialog box opens.
The ‘Database Information’ options in this dialog box, depend on:
-
The database type selected: MS SQL Server 2000 or MySQL 4.0 (or greater).
-
If redundancy, is being configured. Then a main database (database one settings) and a backup database (database two settings) are
configured. For details reference: Configuring for Database
Dialog w/ Type: MySQL 4.0 .
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 33 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Step Action
Configuring the Database
Dialog w/ Type: MS SQL Server 2000
3 In the ‘Database Information’ Group box specify the following:
-
Database Name: The name of the database. (e.g. DALDB)
-
Server (IP address): The IP address of the database server. This is the
Network Name of the Information Server computer which holds the database. Note: This option appears if MS SQL Server 2000/MSDE is
selected as the Type.
-
Data Source: An ODBC data source name (not a hostname or IP address) is expected for the MySQL database type. This is the name of a previously configured data source. Note: This option appears if
MySQL 4.0 or greater is selected as the Type.
-
Type: Select the type of database from a read-only pick list of supported databases (Microsoft SQL Server/MSDE, MySQL 4.0 or greater). Database queries and updates are made using syntax appropriate for the configured database type. As with the other database options, the configured database type persists over DALingest
Client sessions. Note: The default database type is Microsoft SQL
Server/MSDE.
-
Connect locally: Select to connect to a local database. This checkbox is
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 34 of 84
D-Series™ DALingest Client v3.39
Installation Reference Configuring the Database
Step Action
4
5
6 closely related to the “Server (IP address)/Data source”. o
If the DALdb server is on the same computer as Media Client, make sure Connect Locally checkbox is checked. o
Otherwise, uncheck Connect Locally and enter the IP address of the DALdb computer on the local network.
In the ‘Authentication’ Group box specify the following:
-
User: Specify the user level.
-
Password: Specify the password for user Authentication.
Select the correct button to conclude the operation:
-
Cancel: Close the dialog box without saving changes.
-
Revert: Revert to previous settings.
-
Save and Close: Save the entries and close the dialog.
-
Save and Connect: Save the entries, close the dialog, and connect to
Ingest Automation using the new values.
(Option) Click the Test button to check connectivity to the database. You’ll see the success or fail alert box
To Configure Database Support
DALingest supports connection to a MS SQL Server 2000/MSDE or MySQL 4.0 (or greater) database. Follow the procedures in this section to enable DALingest to communication with the specified database,
To enable DALingest to communicate with a MySQL, install the MyODBC (MySQL
Connector/ODBC) driver on the DALingest computer and configure a data source.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 35 of 84
D-Series™ DALingest Client v3.39
Installation Reference Configuring the Database
For MySQL Server
For the MySQL server type use the following procedures to setup an ODBC data source on
Windows 2000 or Windows XP as follows.
To Setup an ODBC Data Source
For the MySQL server type use the following procedure to setup an ODBC data source on
Windows 2000 or Windows XP.
3
4
5
Step
1
2
Description
Download the latest production release of the MySQL Connector/ODBC driver (licensed under the GPL) from: http://www.mysql.com/downloads/api-myodbc.html
.
Download MyODBC Windows version .exe file (currently MyODBC-
3.51.12.exe) from www.mysql.com
Note: Support continues for MyODBC-3.51.08.exe
Execute the MyODBC.exe file to install.
Select defaults for all install prompts.
Add a data source.
To Add a Data Source
After installation, add a data source as follows:
7
8
9
2
3
4
5
6
Step
1
Description
Execute Control Panel|Administrative Tools|Data Sources(ODBC).
Select System DSN tab, and then click Add button.
Select MySQL ODBC type.
Set Data Source Name to “DALDB” (uppercase).
Set Host/Server Name(or IP) to hostname of database server.
Set Database Name to “daldb” (lowercase).
Set User to the login to be used to access the database.
Set Password to the password to be used to access the database.
Click Okay to complete.
For Microsoft SQL Server 2000
For the Microsoft SQL Server 2000 server type, access can be provided by either by using an
Oledb connection or an ODBC Data Source.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 36 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Setup an Oledb connection
Use the following procedure to setup an Oledb connection.
Step
1
2
Configuring the Database
Description
Specify the database name. Use daldb.
Specify the user name and password. These are supplied by an automation site engineer.
Setup an ODBC Data Source
Use the following procedure to setup an ODBC data source on Windows 2000 or Windows XP.
3
4
5
Step
1
2
8
9
6
7
Description
Execute Control Panel|Administrative Tools|Data Sources(ODBC).
Select System DSN tab and then click Add button.
Select SQL Server type.
Set Data Source Name to “DALDB” (uppercase).
Set Host/Server Name(or IP) to hostname of database server.
Set Database Name to “daldb” (lowercase).
Set User as supplied by an automation site engineer.
Set Password as supplied by an automation site engineer.
Click Okay to complete.
To Configure a DALingest Client DALdb Connection
Use the DALingest Client Materials Database Configuration Options dialog to configure a database (DALdb) configuration contains four options.
2
3
Step
1
4
Action
Specify the name of the catalog that the user is connecting to. This is typically called DALdb.
Specify the Type of database: MS SQL Server 2000 or MySQL 4.0.
If MS SQL Server 2000 is selected as the Type, then specify the IP address of the database server.
If MySQL 4.0 (or greater) is selected as the Type, then specify an ODBC data source name.
If the DALdb server is on the same computer as DALingest, make sure
‘Connect Locally’ is checked, otherwise, uncheck ‘Connect Locally.’
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 37 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Step
5
6
Configuring the Database
Action
Enter the IP address of the DALdb session on the local network.
Warning: If the IP address is invalid or points to a computer that does not actually have a DALdb session running, it can take up to 30 seconds before the connect function will time out and display an error.
Specify a User name and Password. The username and password are session specific and should be provided by the administrator of the DALdb database.
Full access to all the tables in the database is required for DALingest to operate; DALingest does no explicit checking for permissions.
Specifying the D-AIS Database
Configuration
DALingest Client supports the D-AIS database schema and D-AIS or DALdb running on MS SQL
2000 (or MSDE), or MySQL.
Note: The schema version specified for DALingest Client must match the version specified for D-
AIS. Otherwise the DALingest Client application will be unable to save records to the database.
INI [DB] Key Setting
Version=NN.##.xx.yy (For example: 1.10.01.00)
(Where,
NN is the version number
## is a major version number for the database
XX is a minor version number for the database
yy is a minor version number for the database.)
This key allows DALingest Client to correctly support the D-AIS database schema. Specify the target database schema.
Specifying Version=1.10.01.00, or an invalid value, causes DALingest Client to use the original
DALingest/DALdb schema.
Configuring for Database Redundancy
DALingest permits the setup of two machines, database-1 and database-2. These correspond to two machines, one which is CPU-1 and one which is CPU-2.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 38 of 84
D-Series™ DALingest Client v3.39
Installation Reference Configuring the Database
On startup, load, and save, DALingest automatically detects which database is active and which is standby by loading the system table field, ‘_MAIN_CPU=1’.
If DALingest cannot connect to the main database, but can connect to the standby database, the standby database is assumed to be main.
If it is discovered that DALingest thinks one database is active when it is actually backup,
DALingest automatically switches to use the other database (_MAIN_CPU = 2) and informs the user of the transfer of control.
For instance, if CPU 2 is active, but when loading a material, DALingest reads the “_MAIN_CPU” field and retrieves a value of 1, DALingest switches databases to use CPU 1 (database 1 connection settings.)
This functionality requires database schema version 1.05.00 or above.
Configuration
To use the redundancy check, define two database connections – a main database (database one settings) and a backup database (database two settings).
Configure the Main Database
Step
1
2
3
Action
From the Configuration Menu select Database>Database One Settings… The
Materials Database Configuration Options dialog box appears.
Configure it for the database type selected: MS SQL Server 2000 or MySQL 4.0
(or greater).
This should correspond to the System.TBL setting for the computer designates as _MAIN_CPU = 1
Save the settings.
The .INI settings for database 1 are under the [DB] section, ‘Main’ determines the database that DALingest thinks is the main CPU.
Configure the Secondary/Backup Database
Step
1
2
Action
From the Configuration Menu select Database>Database Two Settings… The
Materials Database Configuration Options dialog box appears.
Typically configure it for the same database type selected for Database One:
MS SQL Server 2000 or MySQL 4.0 (or greater).
This should correspond to the System.TBL setting for the computer designates as _MAIN_CPU = 2
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 39 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Step
3
Action
Configuring the Database
Save the settings. The .INI settings for database 2 are under the [DB2] section
.
Upgrade Consideration: Managing
Announcement Type and Material Type
Before upgrading DALingest or upgrading the DB schema to 1.12.00.00 or later from a schema previous to it…
Current versions of DALingest set Material Type directly and “slave” Announcement Type to it (when it exists, i.e. schemas before 1.12.00.XX).
This differs from previous operations where Announcement Type was set directly and
Material Type was “slaved” to it.
Because of this change to which DB field is authoritative, care should be taken to ensure that the field values are equivalent for the clip inventory in DALDB.
Step Action
1
2
Run SQL Query
The materials which have Announcement Type and Material Type not corresponding to each other can be determined with the following SQL query which can be run from MySQL Query Browser, MySQL Control Center, or
MySQL command line:
USE DALDB;
SELECT MATERIAL_ID, ANNOUNCEMENT_TYPE, MATERIAL_TYPE material m where
NOT (
(m.ANNOUNCEMENT_TYPE='' AND m.MATERIAL_TYPE='') OR
(m.ANNOUNCEMENT_TYPE='PG' AND m.MATERIAL_TYPE='') OR
(m.ANNOUNCEMENT_TYPE='CA' AND m.MATERIAL_TYPE='C') OR
(m.ANNOUNCEMENT_TYPE='PR' AND m.MATERIAL_TYPE='T') OR
(m.ANNOUNCEMENT_TYPE='ID' AND m.MATERIAL_TYPE='I') OR
(m.ANNOUNCEMENT_TYPE='ZS' AND m.MATERIAL_TYPE='S') OR
(m.ANNOUNCEMENT_TYPE='ZM' AND m.MATERIAL_TYPE='M') OR
(m.ANNOUNCEMENT_TYPE='ZX' AND m.MATERIAL_TYPE='X')
);
Manage Clips in Error
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 40 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Step
Configuring the Database
Action
If the Material Type field is in error for clips found with this query, edit the clips with DALingest (this version or a previous version) to set the types to correspond.
Enabling Source Reservation
Reservation of both VTR and DVS devices is supported. At most one VTR and one DVS source can be reserved per DALingest instance.
Source reservation is disabled by default. To enable source reservation, set the
ENFORCE_SRC_RESV field within the SYSTEM table of the DALDB to ‘Y’.
Requires schema version 1.09.00 or greater.
Restricting Access for Material Deletion
In DALingest v3.32 restrictions can be placed on user groups through the use of the new
DIC_MATERIAL_PRIV in DALDB. This allows control to be set over which users who run the application are allowed to delete a material.
By default, material deletion is unrestricted.
It is enabled if an entry exists for the given privilege group in the DIC_MATERIAL_PRIV table and a matching group name is present in the DALingest.INI file.
When disabled, DALingest is unable to delete a material from the DALDB database or from external servers.
When material deletion is enabled, DALingest’s ability to delete a material is dependent on the privilege code set in the new DALDB table described below.
Material Privileges Table (DIC_MATERIAL_PRIV)
The DIC_MATERIAL_PRIV table within the DALDB schema provides the ability to enable delete functionality for DALingest clients who possess appropriate privilege. Privileges are set on a per group basis. There is a record in the table for each group unrestricted to delete material.
The following parameters detail the schema.
PRIV_OWNER
Privileged group name. The PRIV_OWNER field can be a group name entered manually, or be a default group name inserted at the time of schema creation. The default group name is
‘daemon’. This group name is used in the case that no other group privilege is chosen. The
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 41 of 84
D-Series™ DALingest Client v3.39
Installation Reference Configuring the Database
‘daemon’ group has full access to material deletion (in order to support backwards compatibility).
DEL_PRIV_TYPE{=Y,N} (Default: N)
The privilege code specifying which deletion privileges are applicable to the PRIV_OWNER.
•
If blank, ‘Y’ or any other character, full access to material deletion is provided.
•
A ‘D’ character is used to denote a default group with full access to material deletion
If ‘N’, material deletion is disabled.
DALingest.INI
Enter a matching group name in the DALingest.INI file matching the name specified in the
PRIV_OWNER field of the DALdb DIC_MATERIAL_PRIV table.
Updating an Operator’s Group Status
If required, use the following procedure to update an operator’s group status
Step Action
1 From the DALingest main menu select Configure > Database > Database X
Settings, (where X represents the DB to connect to). The ‘Materials Database
Configuration Options’ dialog is displayed.
2
3
Select a group name from the ‘Group’ dropdown menu. The appropriate privileges are granted (depending on the DEL_PRIV_TYPE settings for that group in the DIC_MATERIAL_PRIV table).
Select either the ‘Save and Connect’ or ‘Save and Close’ buttons.
- The group setting is stored in the DALingest.INI file.
- If a group has not been manually set using the Materials Database
Configuration Options dialog, the default group is assumed (i.e.’daemon’), and unrestricted deletion privileges are granted.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 42 of 84
D-Series™ DALingest Client v3.39
Installation Reference Configuring the Database
About Adding and Managing Privileged Groups
The privileged owners list is expected to be managed using the MySQL Query Browser.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 43 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Configuring the Source Map
Configuring the Source Map
Source Settings
The Media Client often controls sources. The mapping of these sources are set up in the Source
Map Configuration dialog box.
•
Configure a VTR Alias
•
•
Configure a DVS Alias
Configure a Record Bus Alias
Open the Source Map Configuration Dialog
Step
1
Action
Select Source Settings from the Configure drop-down menu.
2 The Source Map Configuration dialog box opens:
Active Buttons:
The following table lists active buttons on the Source Map Configuration dialog.
Button Description
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 44 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Step Action
X
+
OK
Cancel
DVS1
DVS2
Configuring the Source Map
Delete the highlighted entry.
Add an entry.
Accept and apply entries.
Abort operations without saving changes and close the dialog.
Record Bus Alias: Specify the first bus machine destination.
Record Bus Alias: Specify the second bus machine destination.
VTR Aliases: Set the alias for the default VTR. Make Default
VTR
To Configure a VTR Alias
The ‘Default VTR’ provides an easy way to specify a default device to control when DALingest successfully connects to automation – this device is automatically selected on connection.
VTR Aliases provide a way for the user to specify a list of VTRs that can be used to time tapes.
The ‘default’ VTR is the one the manual device control uses when a tape assignment is selected, OR when no material is currently open (to permit arbitrary browsing of tapes.)
The arrow menu at the upper left of the manual device control allows the user to change the current VTR (and subsequently the default VTR.)
Step Action
1 From the Source Map Configuration dialog, in the VTR Aliases group box, choose a source from the Source Name combo box.
2
3
Type in the name you want to assign to the source in the Alias combo box:
Click the button to add the new alias to the list.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 45 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Step Action
Configuring the Source Map
4
5
(Option) To delete an alias from the list, highlight it and click
(Option) To set a VTR to be the default machine, highlight it and click
(Option) The default VTR is marked *
When finished click OK.
6
7
To Configure a DVS Alias
DVS Aliases map a DVS ID to an automation source name. Specifically, when an assignment is made to a DVS ID, say “DVS1”, the source in this table that is associated with DVS1 is the source that is opened by the manual device control when an assignment to DVS1 is made the current assignment.
For example, if in the table, alias “DVS1” was associated with “VDR1A,” when the user opened a material and clicked on the server assignment to DVS1, the manual device control would start controlling the source “VDR1A.”
Important: Map the DVS alias to the Location Table name in D-AIS.
Step
1
Action
From the Source Map Configuration dialog, in the DVS Aliases group box, choose an alias you want to assign to the source in the Alias combo box
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 46 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Step
2
Action
Configuring the Source Map
Choose a source from the Source Name combo box. This is the name of the
DVS ID used for the record that is inserted into DALdb after a successful ingest.
3
Click the button to add the new alias to the list.
4
5
(Option) To delete an alias from the list, highlight it and click
When finished click OK.
To Configure a Record Bus Alias
Specifies the DVS ID that is associated with a record bus. Specifically, this is the DVS ID that is used to automatically create a server assignment after an ingest has been successfully completed.
Note: Only record buses with non-blank entries in this table are displayed.
Important: Always map the Record Bus alias to the Location Table in D-AIS.
About Configuring a Second Bus Machine
DALingest allows a second DVS to be associated with a destination bus. The main reason for making this association is to reflect a configuration in D-MAS where main and reserve ingest server encoders are specified for bus machines for the ingest buses used by DALingest.
Configure DALingest to have more than one DVS associated with an ingest bus, only for those ingest buses used by it that have encoders for more than one server (queried by D-AIS) specified as bus machines in BUS.TBL on D-MAS.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 47 of 84
D-Series™ DALingest Client v3.39
Installation Reference Configuring the Source Map
Only one additional (two total) DVS can be associated with an ingest bus on DALingest.
Supported Workflow Note
The second DVS assignment is created with the SOM and EOM of the first DVS assignment
(possibly set during the confidence replay review step), which may not reflect the material’s user data set by D-MAS on the second DVS (there is no means yet to review and trim a clip using a second bus monitor machine in DALingest). As a result, query results for the material on the server may be incorrect until such a time as a database refresh is done by D-AIS for the DVS. For this reason, this configuration is only supported for workflows that do not trim the clips using the confidence replay dialogue. In other words, the clip must be timed prior to the ingest (i.e.
Time Tape tab) or individually by DVS after the ingest (i.e. Time Server Clip tab).
Step
1
Action
From the Source Map Configuration dialog, in the Record Bus Aliases group box, the Record Bus Aliases pane automatically fills with possible Bus Names
(Record in this example)
2
3
Highlight the Bus Name you want to assign an alias to by clicking with your mouse. This is the name of the bus that has the machine or video server attached that is the destination for all ingests.
Choose the alias you want to assign to the Bus Name in the Alias combo box:
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 48 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Step
4
Action
5
Click
When finished click OK.
Configuring the Source Map
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 49 of 84
D-Series™ DALingest Client v3.39
Installation Reference Configure “Using the Material Table”
Configure “Using the Material Table”
About the “Use Material Table” option
When the “Use Material Table” configuration option is enabled, the SOM/EOM/Duration fields from the Material table can be displayed and defined via the DALingest “Time Server Clip” user interface. This permits customers to use the DALingest “Time Server Clip” feature to review a new clip and save corrected SOM and Duration values to its Material table record for future use on D-MAS playout schedules.
Important: The “Use Material Table” configuration option can only be changed when a Material
Item record is not open.
Enable the Use Material Table option
Step
1
Action
Select Use Material Table from the Configure drop-down menu. The option is enabled and checked to indicate it is active.
Selected Checked
2
3
To uncheck the checked option, simply reselect it.
(Option) The state of the configuration option is saved to and read from the
DALingest “ini” file. So this option can be edited by changing the string (“Use
Material Table=1” or “Use Material Table=0”) in the DALingest “ini” file.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 50 of 84
D-Series™ DALingest Client v3.39
Installation Reference Hiding the Configure Drop-down Menu
Hiding the Configure Drop-down
Menu
Specifying Hide Configuration Options
Typically, once the DALingest Client is installed, the Hide Configuration Options… option is selected to secure the application against inadvertent changes.
To hide the Configure drop-down menu
After the initial configuration period, select this option to permanently hide the configuration options.
From the Configure drop-down menu choose Hide Configuration Options…
To re-enable the Configure drop-down menu
To re-enable, set the .INI file value Show Config=1 under [Options].
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 51 of 84
D-Series™ DALingest Client v3.39
Installation Reference Configuring Advanced Ingest Operations
Configuring Advanced Ingest
Operations
About Advanced Ingest Operations
The Ingest Control Center dialog appears when an ingest operation is started (i.e. select the
Ingest button on the bottom of the Ingest properties pane) and the batch Ingest Control Center dialog appears when a batch ingest operation is started. These dialogs provide an at-a-glance account of the operation status, and allow the operator to start an ingest operation, abort the ingest operation, and acknowledge (accept) the recording when done.
Clicking the Options button or selecting the arrow button located to the extreme right of the
Ingest Input selection buttons displays a menu that permits the configuring of ingest edit options. This menu acts as a one-shot deal – the settings for review and confirm are remembered for the current ingest only. Use the dialog to set the system defaults (which are stored in the .INI file).
Selecting the Options button also opens the Advanced Configuration Options Dialog.
The configuration options determine the amount of user interaction in the ingest process.
Option… When enabled (checked)…
Confirm before Presents the DVS confirmation dialog that shows the user the entry
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 52 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Option…
inserting DVS assignment
Advanced
Configuration
Configuring Advanced Ingest Operations
When enabled (checked)…
that is entered into DALdb.
If the clip has review enabled, the DVS confirmation dialog does not permit manual editing of the SOM and EOM for the database – since this should have been accomplished using the review dialog.
Note: This option is in only available when DALingest Client is used with an Ingest Manager Automation system.
Allows the user to setup various options that require a fairly broad depth of knowledge of automation and the ingest procedure. It allows the user to set the defaults for all future ingests.
Note: Selecting the Options button on the Ingest Control Center
Dialog will also opens the Advanced Configuration Options Dialog.
Advanced Ingest Options Dialog
This selection allows the user to setup various options that require a fairly broad depth of knowledge of automation and the ingest procedure. This option sets the defaults for all future ingests.
Options
The configuration options determine the amount of user interaction in the ingest process.
Options
Archive to…
Description
Archive Options: Options are ‘Don’t Care’, ‘None’, ‘Library’,
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 53 of 84
D-Series™ DALingest Client v3.39
Installation Reference Configuring Advanced Ingest Operations
Options Description
‘Server’ and ‘Both’.
Archive Options: Specify the number of copies. Copies
Delete
Archive Priority
Review/Trim after
Ingest
Confirm before saving DVS assignment
Archive Options: Specify delete function. Options are ‘Don’t Care’,
Yes, No.
Archive Options: Specify the priority for archiving material.
Options are ‘Don’t Care’, 'Low', 'Medium', 'High', 'Urgent'.
Confirmation Options: Allows the user to review and trim (to database) the clip after it has been ingested to the server.
Confirmation Options: Presents the DVS confirmation dialog that shows the user the entry that will be entered into DALdb (using the same method as manual entry when timing materials.)
If the clip has review enabled, the DVS confirmation dialog will not permit manual editing of the SOM and EOM for the database – as it should have already been accomplished using the review dialog.
Note: This option is in only available when DALingest Client is used with an Ingest Manager Automation system.
Ingest Event Fields Displays target ingest event fields.
Use these setting for all future ingests
Check Box: select to keep and use settings for all ingest operations.
Buttons
The following table lists active buttons on the Advanced Ingest Options dialog.
Button
Cancel
Load System
Defaults
OK
Description
Cancel operation without saving changes
Load any system default settings.
Accept entries
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 54 of 84
D-Series™ DALingest Client v3.39
Installation Reference Configuring “TV Width codes”
Configuring “TV Width codes”
Introduction
DALingest v3.36 and higher support the full range of D-Series “TV Width” codes. Enable support for this option by setting the “Expanded Aspect Ratio” configuration parameter to 1 and by manually defining the list of available "TV Width" codes and corresponding list of equivalent
"Aspect Ratio" text strings in the [Options] section of the DALingest system ini configuration file.
For example:
[Options]
Expanded Aspect Ratio=1
TV Width codes=W|1|2|3|4|5|6|7|14|16
Aspect Ratio Text=W|1|2|3|4:3|4:3SP14|16:9SP14|16:9SP4|14:9|16:9
Note: On initial start the application automatically adds "Expanded Aspect Ratio=0" parameter to the INI file. The "TV Width codes" and "Aspect Ratio Text" parameters must be added manually.
About these options
DALingest v3.36 and higher provides configuration options “Expanded Aspect Ratio”, “TV Width codes” and “Aspect Ratio Text” in “DALingest.ini” file within the “Options” key section.
These options are read from the “DALingest.ini” file when the application is started. “TV
Width codes” and “Aspect Ratio Text” are read only if the “DALingest.ini” file contains string
“Expanded Aspect Ratio=1”.
The operator should compose “TV Width codes” and “Aspect Ratio Text” before starting the application.
When the DALingest application is closed, the current state of the “Expanded Aspect Ratio” parameter is saved to the “DALingest.ini” file. After the saving, the “TV Width codes” option contains the full list of supported TV Width codes separated by the “|” symbol. All spaces are ignored.
Configuring “Expanded Aspect Ratio”
DALingest supports the “Expanded Aspect Ratio” system configuration parameter that can enable or disable support for the full range of D-Series “TV Width” codes.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 55 of 84
D-Series™ DALingest Client v3.39
Installation Reference Configuring “TV Width codes”
To configure the “Expanded Aspect Ratio” parameter
4
5
Step
1
2
3
Action
Using an ASCII editor open the “DALingest.ini” file.
Under [Options] Edit the string to enable (“Expanded Aspect Ratio=1”) or disable (“Expanded Aspect Ratio=0”) this configuration option.
When disabled (“Expanded Aspect Ratio=0”), DALingest continues to function as previously defined.
When enabled (“Expanded Aspect Ratio=1”), DALingest reads from the
“DALingest.ini” file the list of supported TV Width codes and the list of
Aspect Ratio text strings which corresponds to TV Width codes. All lists should be composed by the operator before starting the application (details to compose these lists are in the Configuration Changes section).
Under [Options] manually define the list of available "TV Width" codes and corresponding list of equivalent "Aspect Ratio" text strings
Save the changes to the “DALingest.ini” file.
Close and restart DALingest for these changes to take effect.
When the DALingest application is closed, the current state of the “Expanded
Aspect Ratio” parameter is saved to the “DALingest.ini” file. After the saving, the “TV Width codes” option contains the full list of supported TV Width codes separated by the “|” symbol. All spaces are ignored.
Example Expanded Aspect ratio selections
The example expanded Aspect Ratio field illustrates how combo-box “Aspect Ratio” on the
Material Details Tab is displayed when the list of supported TV Width codes and the list of
Aspect Ratio text strings are composed according to the table below:
DALdb TV Width Code DALingest Aspect Ratio
Text
(blank)
W
(blank)
W
© 2015 Imagine Communications Corp. Proprietary and Confidential
D-MAS TV Width Code
(blank)
W
4-February-2015 | Page 56 of 84
D-Series™ DALingest Client v3.39
Installation Reference
5
6
7
14
16
3
4
1
2
DALdb TV Width Code DALingest Aspect Ratio
Text
1
2
3
4:3
4:3SP14
16:9SP14
16:9SP4
14:9
16:9
D-MAS TV Width Code
5
6
7
14
16
3
4
1
2
Configuring “TV Width codes”
Reviewing DALingest.ini file settings
In the “DALingest.ini” file within the “Options” key section:
The TV Width codes are:
•
TV Width codes=W|1|2|3|4|5|6|7|14|16
The “Aspect Ratio Text” options for the TV Width codes are:
•
Aspect Ratio Text=W|1|2|3|4:3|4:3SP14|16:9SP14|16:9SP4|14:9|16:9
The “Aspect Ratio Text” option contains the list of Aspect Ratio text strings for each supported TV Width code separated by the “|” symbol. All spaces are ignored.
Allowable Actions
The operator can expand a number of TV Width codes in the future (to cover the full range of numeric values between 1 and 16 and further).
The operator can rename each Aspect Ratio Text string.
About Composing “TV Width codes” and “Aspect Ratio Text”
When composing “TV Width codes” and “Aspect Ratio Text”, keep the following cautions in mind:
If the number of items from the “TV Width codes” option (N) is less than the number of items from the “Aspect Ratio Text” option (M), the last items (M-N) will not be read from the “Aspect Ratio Text” option. It is the same situation if the number of items from the
“Aspect Ratio Text” option is less than the number of items from the “TV Width codes” option.
For example:
TV Width codes=W|1|2|3|4|5|6|7
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 57 of 84
D-Series™ DALingest Client v3.39
Installation Reference Configuring “TV Width codes”
Aspect Ratio
Text=W|1|2|3|4:3|4:3SP14|16:9SP14|16:9SP4 |14:9|16:9
In this case the application reads:
DALdb
TV Width Code
DALingest
Aspect Ratio Text
W
1
W
1
5
6
7
2
3
4
2
3
4:3
4:3SP14
16:9SP14
16:9SP4
If one (or more) of the items in the “TV Width codes” option is blank (“||”), the corresponding item from the “Aspect Ratio Text” option is ignored. It is the same situation if one (or more) of the items in the “Aspect Ratio Text” option is blank (“||”).
For example:
TV Width codes= W||2| 3|4|5 |6|7|14|16
Aspect Ratio Text= W|1|2 |3||4:3SP14 |16:9SP14|16:9SP4|14:9|16:9
In this case the application reads:
DALdb
TV Width Code
DALingest
Aspect Ratio Text
3
5
W
2
6
7
14
W
2
3
4:3SP14
16:9SP14
16:9SP4
14:9
16 16:9
After “TV Width codes” and “Aspect Ratio Text” loading, the “Default” item is added to the head of the Aspect Ratio Text list and the blank item (contains a space) is added to the head of the TV Width code list.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 58 of 84
D-Series™ DALingest Client v3.39
Installation Reference Configuring “TV Width codes”
When the application is closed, the actual states of the “TV Width codes” and “Aspect Ratio
Text” options (edited with presented before cases) are saved to the “DALingest.ini” file.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 59 of 84
D-Series™ DALingest Client v3.39
Installation Reference Configuring Default ARC Value (Quick Data Entry)
Configuring Default ARC Value (Quick
Data Entry)
About Quick Data Entry
On the Material Details tab, Aspect Ratio, Type of Material, Nominal Duration, and Audio Mode
1 through 4 are QDE (Quick Data Entry) combo boxes. When dropped down, these combo boxes show an optional list of most recently used (MRU) selections, an optional list of default selections, and then any remaining valid selections not included in the first two lists.
Note: It is possible that values are shown in the combo box dropdown more than once, as values can be defined multiple times in the default list, and may also be found in the MRU list.
Material duration is set to the first default of DurationSet (associated with the duration combo box in the VTR control) for new material.
Benefits
By having the MRU and default selections near the top of the list, the operator can more quickly select the entries they are most likely to select.
Using QDE for Aspect Ratio, Type of Material, Nominal Duration, and Audio Mode 1 through
4 makes it possible to set up defaults for new material created by DALingest. The default that is used is determined by the first default (i.e. Def_1) as configured in DALingest.ini.
More details follow.
Configuration
The number of MRU and the number and content of default selections is determined by configuration in DALingest.ini.
For Nominal Duration, the default that is used is determined by the first default (i.e. Def_1) as configured in DALingest.ini.
Entry Form
The [Quick Data Entry] section of DALingest.ini has entries of the form: qde_tag="attribute-list"
Each entry serves to:
•
•
Configure the number of default entries available for selection
Configure the number of MRU (most recently used) entries available for selection
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 60 of 84
D-Series™ DALingest Client v3.39
Installation Reference
•
•
Configuring Default ARC Value (Quick Data Entry)
Configure the default selections
Store the MRU selections maintained by DALingest
Attribute names
The string qde_tag must be unique within this section of DALingest.ini file. The attribute-list consists of a sequence of name-value pairs separated by an equals sign:
name1=value1 name2=value2 …
Attribute names are always a single word (i.e. no spaces), but the value may include spaces if surrounded by single quote characters or if the spaces are escaped by a backslash:
name=’value with spaces’
name=value\ with\ spaces
Values can also contain arbitrary quote characters if they are escaped with backslash:
name=’value with \’escaped\" quotes’
Backslash also needs to be escaped.
name=’value with escaped backslash (i.e. \\)’
Current valid attribute values
Default=n, where n is 0 or positive to indicate how many default entries there are
MRU=m, where m is 0 or positive to indicate how many MRU entries there are
Def_1=’value with spaces’ through Def_n=’value with spaces’ to configure the default values
MRU_1=’value with spaces’ through MRU_m=’value with spaces’ to store the MRU entries
(maintained by the system)
Quick Data Entry Tags
The following quick data entry tags are recognized:
•
•
•
•
•
•
ARCset: Settings for Aspect Ratio on the Material Details tab.
ToMset: Settings for Type of Material on the Material Details tab.
AUDIO1set: Settings for Audio Mode 1 on the Material Details tab.
AUDIO2set: Settings for Audio Mode 1 on the Material Details tab.
AUDIO3set: Settings for Audio Mode 1 on the Material Details tab.
AUDIO4set: Settings for Audio Mode 1 on the Material Details tab.
Note: The default and MRU settings must exactly match the strings that would be shown in the combo box if no QDE were configured. If in doubt as to the setting to use, select the value desired in DALingest, then use the MRU value saved in the QDE configuration to define the default setting.
Values found in the default and MRU lists that are not valid, will not be shown in the dropdown combo box list. If the first default is invalid, new materials will have their values set to the application default (i.e. the default as it existed before this change) for the setting.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 61 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Examples
Configuring Default ARC Value (Quick Data Entry)
Nominal Duration
The following is an example QDE configuration for nominal duration:
[Quick Data Entry]
NomDURset=" Default=2 MRU=4 Def_1='00:00:10:00'
Def_2='00:00:15:00'"
Hi-Def Aspect Ratios
The following QDE configuration favors high definition aspect ratios, and provides a default aspect ratio of 16:9 for new materials:
[Quick Data Entry]
ARCset=" Default=4 MRU=4 Def_1='16:9' Def_2='16:9SP14'
Def_3='16:9SP4' Def_4='14:9'"
Note: The MRU values are not populated in the above list, but will become populated with use.
Default Material Type: Commercial Break
The following QDE configuration provides a default type of material of commercial break:
[Quick Data Entry]
ToMset=" Default=1 MRU=4 Def_1='Commercial (C)'"
The following QDE configuration for the first audio mode setting favors more recent audio modes, and provides a default audio mode of 5.1 surround sound for new materials:
[Quick Data Entry]
AUDIO1set=" Default=5 MRU=4 Def_1='5.1 Ch Surround Sound'
Def_2='AC3' Def_3='Dolby' Def_4='2-Channel' Def_5='Stereo' "
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 62 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Configuring Logging Levels
Configuring Logging Levels
Configuring Diagnostic Logging
Normally, your DALingest.ini file is fully configured by Automation Engineers to enable logging.
If you change the location of the log directory you may need to re-establish the path in the ini file.
If you see this alert box, you need to:
Make a log directory
Create a path in the application ini file to that location
Close down Media Client
Open the DALingest ini file
Insert the section shown below (log file directory = should point to the location where your log directory is located)
Restart Media Client
Configuring Diagnostic Logging
Logging configuration is accomplished using a dialogue instead of editing the DAL-ingest.INI file.
Access the dialog by selecting from the Menu Help>Diagnostic Logging.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 63 of 84
D-Series™ DALingest Client v3.39
Installation Reference Configuring Logging Levels
Fields
The following table lists active buttons on the Diagnostic Logging dialog.
Button
Number of Days to Keep
Max. File Size
(kB)
Description
The number of days to keep log entries before purging.
The maximum size for the log file in KB.
Logging Enabled Enable (box checked) / Disable (box unchecked) logging.
System Specifies the name of the sub system.
System
Work List
SrcResv
DALingest
Ingest Panel
Manager
Description
Logs Work List subsystem operations. Defaults to logging level 0.
SrcResv Diagnostics
Ingest Management software
Panel Management Diagnostics
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 64 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Button
Log Level
Description
Configuring Logging Levels
Description
Bus Control
D-MAS
Connection
RT
Schedule Server connection
D-MAS schedule server connection
Info
DBQuery
Changelog
D-MAS RT (Real Time LAN) schedule server connection
D-MAS Info (Information LAN) schedule server connection
Logs DB query and command strings. The diagnostic level must be set to at least 3 to see the strings.
Logs Change Time operations. Defaults to logging level 0.
BarCodeScanner Logs what the bar code scanner sends to
DALingest. The diagnostic level needs to be set to 1 to see the scanned codes.
SrcResv Mgmt SrcResv Management Diagnostics
Specifies the logging level (0, 1, 2, 3, 4, 5)
Logging
Level
Description
0
1
2
3
Critical Errors (normally no logging)
For DBQuery: No DBQuery logging (errors are excluded also)
Errors
For DBQuery: (default) Errors are logged. DB command or query strings that cause error are logged truncated.
Warnings
Information (e.g. when records are being reloaded or an update query sent)
For DBQuery: Errors are logged. All DB command or query strings are logged; truncated if no error, wrapped (not truncated) if cause error
4
5
Detailed Information (e.g. function calls)
For DBQuery: Errors are logged. All DB command or query strings are logged wrapped.
Note: Higher logging levels also include lower level logging.
A brief description of the sub system.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 65 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Buttons
The following table lists active buttons on the Diagnostic Logging dialog.
Configuring Logging Levels
Button
OK
Cancel
Default
All to Default
Description
Save the changes.
Cancel the operation and close the dialog.
Adjust the logging level default for the selected system.
Set all parameters to their default settings.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 66 of 84
D-Series™ DALingest Client v3.39
Installation Reference
DALingest Client Version
DALingest Client Version
Checking the Version of DALingest Client
The About DALingest information box provides:
The DALingest version number
If DALfile is currently logged on, it reports the DMAS Schedule Server version currently running and some license information
Both these version numbers are required when troubleshooting with the Automation
Engineers
Step
1
Description
Select About DALingest from the Help drop-down menu.
2 The About DALingest information box opens:
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 67 of 84
D-Series™ DALingest Client v3.39
Installation Reference The Windows Application Crash Handler
The Windows Application Crash
Handler
Configuring the Windows Application
Crash Handler
This application has been compiled and linked to provide the best information possible when a crash occurs via the Windows Application Crash Handler.
The Windows Crash Handler should only be enabled and set up by or under the direct supervision of a certified automation Engineer.
Contact Automation support for more information.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 68 of 84
D-Series™ DALingest Client v3.39
Installation Reference
DALingest.ini Parameters
DALingest.ini Parameters
Configuring Source Reservation
Reservation of both VTR and DVS devices is supported. At most one VTR and one DVS source can be reserved per DALingest instance. Source reservations can occur through…
manual selection of a source from the source menu,
implicitly on start-up (VTR only),
following load of DVS stored material and choosing Time Server tab (DVS only).
Enabling Source Reservation
Source reservation is disabled by default. To enable source reservation, set the
ENFORCE_SRC_RESV field within the SYSTEM table of the DALDB to ‘Y’.
Requires schema version 1.09.00 or greater.
Configuring Implicit Source Reservation on start-up
To configure Implicit VTR Sources
Implicit source reservation on start-up attempts to reserve the source aliased in the
DALingest.INI file in section ‘Source Mapping’ with setting ‘Default VTR’.
To configure Implicit DVS Sources
Implicit source reservation on start-up attempts to reserve the source aliased in the
DALingest.INI file in section ‘Source Mapping’ with setting ‘DVS Aliases Default’.
Enabling Access to Source Reservation Management
Source Reservation Management is intended to prevent conflicts between multiple DALingest clients via reservation of a source during source usage. These management features can be made available to those clients who possess an appropriate level of privilege.
When enabled, Source Reservation Management allows a DALingest instance to release the source reservation of a different instance.
Source reservation management should only be used when required
Use of this functionality is only intended to resolve problematic cases when a DALingest client is unable to release its own source.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 69 of 84
D-Series™ DALingest Client v3.39
Installation Reference DALingest.ini Parameters
Clients affected by cancelled reservations do not receive immediate notification of the source release.
Setting Access
Access to source reservation management functionality within the DALingest application is restricted by default, and controlled by the ‘Src Reservation Mgmt’ setting within the ‘Options’ section of the corresponding DALingest.INI file.
Access is restricted when set to 0.
Access is granted when set to 1.
The DALingest.INI file is only referenced on application start-up.
Configuring AutoCreateMediaAssignment
AutoCreateMediaAssignment is set within the [Options] section of DALingest.INI. (0: disable, 1: enable.)
If enabled (1), DALingest automatically creates a media assignment when a material ID is entered that doesn’t exist in DALdb.
If disabled (0), when a material ID is entered that doesn’t exist in DALdb, the Media field is set to the same text as the Material field (but no media record nor a media assignment are created), the text is fully selected, and the field colored orange to indicate the media record and media assignment do not exist.
Configuring QuickPick String Values
These values are used in Search Window and Device Control Buttons.
The Search String: Duration dialogue has its edit fields replaced with combo boxes. Search text can be entered into these combo boxes as they were entered into the edit fields previously, or the combo box can be used to select a value from a list.
The Quickpick Device Control duration buttons have been replaced with a combo box.
The values found in the combo box list are taken from the .INI file and persist between invocations of DALingest. The values consist of both most recently used (MRU) values and default values. MRU values are found first in the list, then Default values.
Configuring Default and MRU Values
The number of default values, default values, and number of MRU values are configured in the
INI file in the [Quick Data Entry] section as described below.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 70 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Entry Format
The [Quick Data Entry] section of DALingest.ini has entries of the form: qde_tag="attribute-list"
DALingest.ini Parameters
Each entry serves to:
Configure the number of default entries available for selection
Configure the number of MRU (most recently used) entries available for selection
Configure the default selections
Store the MRU selections maintained by DALingest
The string qde_tag
The string qde_tag must be unique within this section of DALingest.ini file.
The attribute-list
The attribute-list consists of a sequence of name-value pairs separated by an equals sign: name1=value1 name2=value2 …
Attribute names are always a single word (i.e. no spaces), but the value may include spaces if surrounded by single quote characters or if the spaces are escaped by a backslash: name=’value with spaces’ name=value\ with\ spaces
Values can also contain arbitrary quote characters if they are escaped with backslash: name=’value with \’escaped\" quotes’
Backslash also needs to be escaped. name=’value with escaped backslash (i.e. \\)’
Valid Attribute Values
Currently, the valid attribute values are:
Default=n, where n is 0 or positive to indicate how many default entries there are
MRU=m, where m is 0 or positive to indicate how many MRU entries there are
Def_1=’value with spaces’ through Def_n=’value with spaces’ to configure the default values
MRU_1=’value with spaces’ through MRU_m=’value with spaces’ to store the MRU entries
(maintained by the system)
Quick Data Entry Tags
The following quick data entry tags are currently recognized:
DurationSearch. This is used by the Search String : Duration search dialogue of the Search tab, to populate a combo box of quick pick durations.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 71 of 84
D-Series™ DALingest Client v3.39
Installation Reference DALingest.ini Parameters
DurationTolSearch. This is used the Search String : Duration search dialogue of the Search tab to populate a combo box of quick pick durations tolerances.
DurationSet. This identifier is used in the section to configure the Quickpick duration combo box for Device Control buttons.
Example Entry for…
Quick Pick Duration Search
The following is an example entry for quick pick durations (with some line wrapping introduced by Word):
[Quick Data Entry]
DurationSearch=" Default=4 MRU=4 Def_1='00:00:05:00'
Def_2='00:00:10:00' Def_3='00:00:15:00' Def_4='00:00:20:00'"
Quick Pick Duration Set
The following is an example configuration (with some line wrapping introduced by Word):
[Quick Data Entry]
DurationSet=" Default=8 MRU=4 Def_1='00:00:05:00'
Def_2='00:00:10:00' Def_3='00:00:15:00' Def_4='00:00:20:00'
Def_5='00:00:30:00' Def_6='00:01:00:00' Def_7='00:01:30:00'
Def_8='00:02:00:00'"
This example duplicates the possible settings provided by the Quickpick duration buttons that were replaced. The default settings for this configuration can be made identical to those for the identifier DurationSearch.
Configuring the User Bit SOM Offset
An SOM- button is located on the User Bits control within the Device Control area of DALingest.
When the User Bits control and SOM- button are enabled, pressing the button fills the edit control above it with the SOM of the material less a configured offset. This location can then be used for reading/writing user bits.
To Configure the Offset
Configuring the offset is done within the DALingest.INI file:
[Options]
UB SOM Offset=x
Where, x = the number of seconds to subtract from the material SOM.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 72 of 84
D-Series™ DALingest Client v3.39
Installation Reference DALingest.ini Parameters
If the parameter is not configured, it default to 0 seconds, effectively making the SOM- button act as an SOM button.
This offset is not used elsewhere.
Configuring RTS and DTR Lines of Standard
COM Ports
DALingest Media Client allows the specification of states of RTS and DTR lines of communication ports that are used to permit standard PC motherboard COM ports, third party serial card COM ports, or USB “virtual” Windows COM ports to be used for panels.
DALingest is configurable through DALingest.INI to set, clear, or configure for handshaking the
RTS and DTR lines of a COM port.
In the absence of configuration, the ports are configured to clear RTS and set DTR to provide proper configuration for SER-8 and SER-4 cards for backwards compatibility. Only those ports that are configured for use for panels use the new configuration for the RTS and DTR lines.
Configuration
Configuration of the ports is made by editing the INI file directly – there is no operator interface provided as it is expected to be set up initially and not changed often.
Configuration of the RTS and DTR lines in DALingest.ini has the following form:
[COM Port Lines]
COMx=rts_setup|dtr_setup
Where,
X= the COM port number, rts_setup = blank or one of RTSSET, RTSCLR, or RTSHANDSHAKE, dtr_setup = blank or one of DTRSET, DTRCLR, or DTRHANDSHAKE.
If an action is not specified for DTR for a port, either by omitting a specification for the port, or omitting any DTR specification in the specification for the port (e.g. COM9=RTSCLR), then
DTR is set by default to enable SER-4 cards for backwards compatibility.
If an action is not specified for RTS for a port, either by omitting a specification for the port, or omitting any RTS specification in the specification for the port (e.g. COM9=DTRCLR), then
RTS is cleared by default to enable SER-8 cards for backwards compatibility.
Example Setting
The following is an example RTS/DTR setting:
[COM Port Lines]
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 73 of 84
D-Series™ DALingest Client v3.39
Installation Reference DALingest.ini Parameters
!Provides SER-8 and SER-4 support. Same could be had by omitting the line
COM6=RTSCLR|DTRSET
!These lines do the same thing
COM7=|
COM8=
COM9=RTSCLR
COM10=DTRSET
COM11=DTRSET|RTSCLR
Configure support for Vision Drop Frame
Duration Rules
Supporting new interpretation of duration values within D-Series has been added. It can be enabled/disabled by using the new entry in the [Option] section named "Dropframe Duration" in the "DALingest.ini" file.
DALingest configuration is specified in the dalingest.ini file. The new entry in the [Options] section named Dropframe Durationsn has a value of 0 (off) or 1 (on). If it is not present, it will default to 0 (off).
Dynamically update segments during 1086 record
DALingest periodically refresh the UI for segments that aren't updated by the operator. This functionality allows the user to refresh the currently loaded clip to view new segments as they are being populated by DMAS by making DALingest periodically check and update its UI and internal data buffers if a new segment record is added or some other change is detected while recording of its currently open Material item is still in progress.
Implementation Details
A system timer is set to refresh the UI for segments that aren’t updated by the operator. The system timer is set to the interval defined by the DALingest.ini
"MaterialSegmentsAutoRefreshInterval" parameter if it is set to positive value. Otherwise, the timer is disabled and the UI is not refreshed.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 74 of 84
D-Series™ DALingest Client v3.39
Installation Reference DALingest.ini Parameters
For every timer tic, if it has been enabled in the configuration, changes made by the operator are subtracted from changes made in the database, and the internal data structures are updated by the resulting changes and displayed in the UI.
DALingest.ini Configuration Change
A new "MaterialSegmentsAutoRefreshInterval" parameter was added to the DALingest.ini configuration file.
This parameter is used to Enable/Disable the Material`s Segments Auto Refresh and to set interval of the Material`s Segments Auto Refresh in seconds. Valid entries are:
0: (Default) Material`s Segments Auto Refresh are disabled.
Any integer value more than zero: Material`s Segments Auto Refresh Interval are set.
Any integer value less than zero: Material`s Segments Auto Refresh are disabled.
Reference: .INI File Keys
Most configuration of DALingest Client is performed from the GUI. The following INI keys are provided for reference only. Accessing the .INI file should only be done under the supervision on a qualified Automation Engineer. <[ ] denotes a blank value.>
[Diagnostic Log - File Settings]
Key Name Default Value
(Permitted values)
Log File Enabled 1 (0,1)
Log File
Directory
.\debugimd
Description
[DMAS]
Key Name Description
IP Address
Port
User
Password
[ ]
[ ]
[ ]
Default Value
(Permitted values)
[ ] The D-MAS connection information.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 75 of 84
D-Series™ DALingest Client v3.39
Installation Reference
[J/S Panel]
Key Name
Port
Baud
Default Value
(Permitted values)
[ ]
Description
DALingest.ini Parameters
The COM port to which the Jog
The baud rate. Defaults to 9600, not currently used.
[DB]
Key Name
Server
Catalog
User
Password daemon
DAL-kvs
Connect Locally 0 or 1 (Y/N)
Type
Version
Default Value
(Permitted values)
DALDB
DALDB
3
...
1.08.XX
1.09.XX
1.10.XX
Etc…
Description
The remote server on which the database is connected to, in the form of an IP address. This is used only if Connect Locally = N.
The name of the database catalog, typically
DALdb.
The authentication information.
Determines if the DALdb session is local or remote (use the server address).
The DB type; MySQL or MS SQL.
Allows DALingest Client to correctly support the
D-AIS database schema. Valid versions are listed
Note: Specifying Version=1.10.01.00, or an invalid value, causes DALingest Client to use the original DALingest/DALdb schema.
[DB2]
Key Name Default Value
(Permitted values)
[ ]
Description
Server
Catalog [ ]
The remote server on which the database is connected to, in the form of an IP address. This is used only if Connect Locally = N.
The name of the database catalog, typically
DALdb.
The authentication information. User daemon
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 76 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Key Name Default Value
(Permitted values)
Password DAL-kvs
Connect Locally 0 or 1 (Y/N)
Description
DALingest.ini Parameters
Determines if the DALdb session is local or remote (use the server address).
The DB type; MySQL or MS SQL. Type
[JS Panel]
2
Key Name Default Value
(Permitted values)
Default Port
Baud
Panel Mapping
COM6
9600
Description
The port connecting the current default panel.
Communication port baud rate.
This key name lists all of the panels that are configured to connect via serial port.
[Options]
Key Name Default Value
(Permitted values)
30
Description
Frame Rate
Expire Offset
Report Ext
Database
Owner
Dropfame
Duration
30 txt automation
0 (0, 1)
The default frame rate for the application – should be set to the same as D-MAS, or warnings and odd behavior may result.
The number of days from the recording that the expire date on the material should be automatically set to.
The extension of the saved reports generated by the output logs.
Note: This parameter is not currently used in
DALingest.
The owner of the database. The database administrator should setup this key – it is not editable in the program itself.
Enable/Disable supporting new interpretation of duration values within D-Series. (0: disable/off, 1: enable/on.)
If it is not present, it defaults to 0 (off).
The log level for diagnostic logging. Log Level 0 (0, 1,…)
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 77 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Key Name
Show Config
Default Value
(Permitted values)
1 (0, 1)
Description
DALingest.ini Parameters
WarnIfSchema
Differs
AutoCreateMed ia Assignment
1 (0, 1)
0 (0, 1)
AutoStartIngest 0 (0, 1)
Expanded
Aspect Ratio
0 (0, 1)
TV Width codes W|1|2|3|4|5|6|7|14
|16
Aspect Ratio
Text
W|1|2|3|4:3|4:3SP14
|16:9SP14|16:9SP4|1
4:9|16:9
Enable/Disable ‘Hide configuration options’ from the Configure menu. (0: disable, 1: enable.)
Send warning if is a difference in schema versions is encountered. (0: disable, 1: enable.)
Automatically create a media assignment. (0: disable, 1: enable.)
Automatically start ingest . (0: disable, 1: enable.)
DALingest is enhanced to support the full range of D-Series “TV Width” codes. Enable this option by setting the “Expanded Aspect Ratio” configuration parameter to 1 and by manually defining the list of available "TV Width" codes and corresponding list of equivalent "Aspect
Ratio" text strings.
Manually add parameter. (See “Expanded
Aspect Ratio” parameter.)
Manually add parameter. (See “Expanded
Aspect Ratio” parameter.)
[Ingest]
Key Name Description
Default VTR
Default Value
(Permitted values)
[ ]
Ingest Bus
Ingest DVS
Sticky Default
VTR
Confirmation
RECORD1
PVS-m
0 (0, 1)
Y (Y/N)
The default VTR to select from the list upon connection to D-MAS.
The bus to which all clips will be ingested.
The DVS ID to which DVS assignments will be generated on a successful ingest.
Allows the user to choose whether or not to remember the last device selected when moving between devices, shutting down the program, etc. (0: disable, 1: enable.)
Specifies whether an ingest should be reviewed.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 78 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Key Name Default Value
(Permitted values)
Archive Delete [ ] (Y/N/[ ])
Archive Copies 0
Archive Type 0
Archive Priority 0
0, 1 (Y/N) Confirm DVS
Assignment
Take Timeout 60
Description
DALingest.ini Parameters
These values should not be edited manually,
These values should not be edited manually,
These values should not be edited manually,
These values should not be edited manually,
Specifies whether to show the DVS add dialog after a successful ingest.
Specifies take timeout. The user may change this key to affect a timeout between 1 and
3600 seconds. (Values 1-3600 are legal.
Specifying 0, or other values specified outside this range produces an infinite timeout, i.e. the operation will not time out.)
Ingest Fields
[Diagnostic Log - File Settings]
Key Name Default Value
(Permitted values)
Log File Enabled 1
Description
Log File
Directory
<working directory of program>
Determines if diagnostic logging is enabled for this session.
Change this directory to point to an appropriate logging directory if it is not desirable to have the logs in the same directory as the executable.
[Diagnostic Log – Log Levels]
Key Name
WorkList
Default Value
(Permitted values)
0
Description
Changelog
DALingest
0
Specifies the logging level (0, 1, 2, 3, 4) for the
Work List sub system operations.
Specifies the logging level (0, 1, 2, 3, 4) for the
ChangeLog sub system operations.
Specifies the logging level (0, 1, 2, 3, 4) for the
Ingest Management software operations.
Specifies the logging level (0, 1, 2, 3, 4) for the D-MAS
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 79 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Key Name Default Value
(Permitted values)
Description
DALingest.ini Parameters
D-MAS RT
D-MAS Info
DBQuery 3
BarCodeScanner 1
D-MAS schedule server connection.
Specifies the logging level (0, 1, 2, 3, 4) for the
D-MAS RT (Real Time LAN) schedule server connection.
Specifies the logging level (0, 1, 2, 3, 4) for the
D-MAS Info (Information LAN) schedule server connection.
Specifies the logging level (0, 1, 2, 3, 4, 5) for the DBQuery sub system operations.
Logs DB query and command strings. The diagnostic level must be set to at least 3 to see the strings.
Specifies the logging level (0, 1, 2, 3, 4) for the
BarCodeScanner sub system operations.
Logs what the bar code scanner sends to
DALingest. The diagnostic level needs to be set to 1 to see the scanned codes.
[Barcode Scanner]
Key Name
Port
Baud
Config
Default Value
(Permitted values)
[ ]
0
[N81] (N/E/O/M/S)
(8/7) (1/2)
Description
The scanner connection information
The scanner baud rate
The configuration for the port: Parity, followed by Data bits, followed by Stop bits.
N/E/O/M/S: None/Even/Odd/Mark/Space
[Barcode Printer]
Key Name
Port
Baud
Config
Protocol
Default Value
(Permitted values)
[ ]
0
[N81]
[ ] (ZEBRA/SONY)
Description
The printer connection information.
The printer baud rate
Configuration (see scanner Config above)
The protocol for the printer, either ZEBRA or
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 80 of 84
D-Series™ DALingest Client v3.39
Installation Reference
Key Name Default Value
(Permitted values)
Description
DALingest.ini Parameters
Params [ ]
[COM Port Lines]
Key Name
COMx=rts_setu p|dtr_setup
Default Value
(Permitted values)
COMx=RTSCLR|DTRSE
T
Description
X = the COM port number, rts_setup = blank or one of RTSSET, RTSCLR, or
RTSHANDSHAKE, dtr_setup = blank or one of DTRSET, DTRCLR, or
DTRHANDSHAKE.
[Private Defaults]
Key Name
Section 01
Default Value
(Permitted values)
=PPPPPPPPPPPPPPPP
[Source Mapping]
Key Name
DVS Aliases
DVS Aliases
Default
VTR Aliases
Default Value
(Permitted values)
Leitch,PRV-
02,Leitch2,PRV-03
Leitch,PRV-
02,Leitch2,PRV-03
VTR3,EMG-B
BUS to DVS
Default VTR
Default Rec Bus
RECORD1,PVSm,RECORD2,PVS-r
VTR3
SONY.
Printer-defined parameters, see ‘Printer
Parameters’ above.
Description
Description
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 81 of 84
D-Series™ DALingest Client v3.39
Installation Reference
[Quick Data Entry]
DALingest.ini Parameters
Key Name
DurationSearch
Default Value (Permitted values)
=" Default=8 MRU=4 Def_1='00:00:05:00' Def_2='00:00:10:00'
Def_3='00:00:15:00' Def_4='00:00:20:00' Def_5='00:00:30:00'
Def_6='00:01:00:00' Def_7='00:01:30:00' Def_8='00:02:00:00'"
DurationTolSearch =" Default=0 MRU=4"
DurationSet =" Default=8 MRU=4 Def_1='00:00:05:00' Def_2='00:00:10:00'
Def_3='00:00:15:00' Def_4='00:00:20:00' Def_5='00:00:30:00'
Def_6='00:01:00:00' Def_7='00:01:30:00' Def_8='00:02:00:00'"
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 82 of 84
D-Series™ DALingest Client v3.39
Installation Reference Reference: The Dub List File Format
Reference: The Dub List File Format
About Dublists
Dub lists are ASCII files that contain a set of event records, like those in a traffic file, that are used to identify materials that are contained on one or more pieces of tape media. They contain the following information at a minimum, and may or may not contain additional information.
Source Media ID (the tape that the material exists on)
Material ID
SOM and Duration (single segment)
Dub lists support unsegmented items, segmented items, and multiple unsegmented items on a media. For segmented items, each dub list entry comprises one segment of a multi-segment record. DALingest collates these entries and displays them to the user as one item.
If multiple dub list entries for a material ID are found, it is assumed that each dub list entry represents a segment (e.g. if five dub list entries are found for material MATID001, then
MATID001 is assumed to be a multi-segmented item with 5 segments); the overall duration and SOM of the material are calculated from the segment SOMs and durations.
If only one dub list entry is found for a material ID, the material is assumed to be unsegmented.
Dub List File Format
Dub lists are stored as flat, column delineated ASCII files. The layout of these files is stored in the
DUBLIST_FORMAT table of the database. Using this table requires database schema v1.06.00 or later.
Reference DALdb Schema Tables: DUBLIST_FORMAT, WORKLIST and WORKLIST_ASSIGNMENT are required by the DALingest Work List feature. These tables work interactively to support Dub
Lists and Work Lists.
DUBLIST_FORMAT
This table contains a record for each field to be retrieved from a dub list entry and stored in the corresponding WORKLIST_ASSIGNMENT field of same name. Some WORKLIST_ASSIGNMENT fields are required (e.g. MATERIAL_ID, MEDIA_ID, etc.) and some are optional (e.g.
FRAME_RATE).
If a field in a dub list record can be correlated with a field in the database, that field data is used to populate the database, otherwise, the field is ignored.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 83 of 84
D-Series™ DALingest Client v3.39
Installation Reference Reference: The Dub List File Format
The WORKLIST_FIELD_ID field is the primary key of the table.
Parameter Settings
LENGTH
A numeric value representing the length of the dub list entry field.
START_COLUMN
A numeric value representing the 1-based start column of the dub list entry field (e.g. a field at the beginning of a dub list entry would have a start column of 1).
In other words this is the 1-based offset of dub list field within a dub list entry (i.e. column number)
WORKLIST_FIELD_ID={MATERIAL_ID, MEDIA_ID, SOM, EOM, DURATION, FRAME_RATE}
This 32-character uniquely identifies the dub list field within the database. It specifies the name of the associated WORKLIST_ASSIGNMENT column and can be any of the following:
MATERIAL_ID, MEDIA_ID, SOM, DURATION, or FRAME_RATE.
•
The SOM and DURATION fields in a dub list entry must be of the form hh:mm:ss:ff and the SOM represents an absolute value.
•
•
The FRAME_RATE field, if provided, must contain a numeric value (e.g. 25, 30, etc.).
Both MATERIAL_ID and MEDIA_ID fields must contain a valid string.
Defining a record for FRAME_RATE is optional. If the dub list entries do not contain a frame rate field, DALingest uses the configured default frame rate for converting time strings.
Records with a WORKLIST_FIELD_ID that do not match one of the supported values are ignored by DALingest.
To prevent ambiguity in computing a material or segment duration when importing a dub list, only one of EOM or DURATION can appear in the DUBLIST_FORMAT table. If both are specified, an import of the dub list fails, a pop-up dialogue indicates that the dub list format could not be loaded from the database.
EOM information is not stored in the WORKLIST_ASSIGNMENT table for a work list record, but is computed when the record is read, from SOM and Duration.
© 2015 Imagine Communications Corp. Proprietary and Confidential 4-February-2015 | Page 84 of 84
Download
Link público atualizado
O link público para seu chat foi atualizado. Você pode visualizar e gerenciar seus links de chat após o registro aqui.
Link público do documento
Anúncio
