dXML metadata input settings & database fields
The dXML metadata functionality allows to embed user-defined (XML-formatted) database fields into the recorded .wav files, which can subsequently be accessed from Avisoft-SASLab Pro and further processed (e.g. creating a metadatabase).
The metadata input mode is activated from the command Options / dXML metadata input settings, where also the structure of the database fields is defined:
enable dXML metadata input : This option activates the metadata input mode. If activated, the dXML metadata record form will be launched.
individual records for each channel : If activated, this option will allow to enter individual data records for each channel.
create sidecar files: If activated, the dXML data will additionally saved into a sidecar .xml file having the same name as the associated .wav file.
The table below defines the individual dXML database fields. Each data field is represented as an individual row.
field name : Each data field must be given a unique field name, which cannot include special characters such as < or >.
type: A field can have one of the following data type attributes: text, bool, integer, float, date or time. The format of these data types is as follows:
text : abc123
bool : 0, 1
int : 123
float : 1.23
time: yyyy-mm-dd hh:mm:ss
The date and time data types will automatically enumerate the current date/time in their corresponding combo boxes.
size: Defines the maximum size of the text, integer and float types.
valid entries or pick list: When the file type text is selected, this edit field allows to define a set of strings that are allowed to enter or that will appear as a pick list. The individual strings must be separated by commas (“,”). A list of valid strings (such as species names) can be imported by clicking at the imp button.
validation: If activated, only the specified list of strings will be accepted. Otherwise, the defined list of strings will be displayed as a pick list.
imp : Imports a list of strings from a text file into the valid entries or pick list field. The individual string the in the .txt file must be separated by CR/LF control characters. The external .ext file can also be read by drag&drop (the cursor must be placed into the desired field before).
lock : If activated, this option will lock the input field (it will be grayed). Use this option to prevent unintentional modifications on the specific field.
A new field can be inserted by clicking at the Add button and the selected filed can be removed by the Remove button. The selected field (marked by the check box in the row titled select) can be moved by using the up and dn buttons.
The OK button will save the defined data base structure into a separate .xml file (whose name is displayed at the bottom of the dialog button). The Open button allows to open one of the previously saved .xml database structure files. The SaveAs button will save the database structure under a new filename. The Reset button will reset all fields.
reset after save: If activated, this option will execute the Reset command once the Save command has been executed. This option should only be used in conjunction with the manual triggering mode where the metadata is entered after the corresponding .wav has been finished.
Save on left click: If activated, the Save command can also be executed by left-clicking anywhere on the client area of the dXML metadata record window.
Wait for input: If activated, the subsequent trigger events will be temporarily inhibited as soon as a trigger event occurs. At the same time the freeze display state will be activated. After executing the Save command the, software will resume to normal operation.
show: If activated, this option will memorize all entered data and it will be possible to select these previous data from a pick list.
reset: Resets the history data.
In order to display the created data records properly in Avisoft-SASLab Pro, the same .xml data base structure file should be selected there (command Metadata / dXML database records / Define database structure… > Open… ).