DPE Writer Filter Specification

The DPE Writer filter can only be used as the last filter in an output graph. It creates a new audio entry in a DigaSystem database table, using the DPE ContentService. To generate a valid file, it should be preceded in the output graph by a WAVDest filter.

Optionally a local file can be created while upload to DPE is running. This file is either kept afterwards or removed after a successful upload has been finished. See description for parameter keeplLocalFiles below.

JSON Structure

{
	"name": "DPE Writer",
	"dpeUrl": "...",
    "uploadBlockSize": ...,
    "retryInterval": ...,
    "maxRetryCount": ...,
    "maxRetryTime": ...,
    "dbServer": "...", 
    "dbTable": "...",
    "userName": "...",
    "password": "...",
    "localFile": "...",
    "keepLocalFiles": ...,
    "zeroLengthFileDeletion": "...",
    "deferEntryCreation": true/false
    "metadata": {
        "title", "...",
        "...": "...",
        ...
    }
}

JS

Field	Description
dpeUrl	Base URL of the DPE installation; or "(none)" (see section "Omitting DPE Upload" below)
uploadBlockSize	Number of bytes which are uploaded to DPE in one HTTP request. The parameter is optional, the default is 1048576 (1 MB).
retryInterval	Interval (in milliseconds) between tries to upload one block of data to DPE after the first attempt failed. The parameter is optional, the default is 1000.
maxRetryCount	Maximum number of retries to upload one block of data to DPE after the first attempt failed. The parameter is optional, the default is 60.
maxRetryTime	Maximum time frame (in milliseconds) in which the upload of one block of data to DPE must succeed. The parameter is optional, the default is 600000 (10 minutes).
dbServer	Name of the database server in the DigaSystem installation.
dbTable	Name of the table on the server, into which the new entry will be uploaded.
userName	User name and password to logon to DPE. This user must have the right to create and write an entry to the specified DigaSystem table. If these fields are both missing, the ROAD Service will fill it with defaults defined by the DpeDefaultUser and DpeDefaultPassword variables (see paragraph "Special Variables" in api/variables).
password
localFile	Full path name of a local file, which is written as "backup" in case the DPE upload fails. If only a filename is given but no path, the file is written to the default folder for temporary files. The parameter is optional; if it's not specified, no local file is written. If the file already exists (e.g. from a previous job with a failed upload), a numerical suffix is appended to the base name of the file to create a unique new filename. While creation is still in progress, two files are created (.wav for audio and .dbx for meta data), which are mostly merged into a .entry when finishing. It is strongly recommended to specify a local file as otherwise a failing DPE upload (e.g. because of a temporary problem) will lead into losing the whole audio. Placeholders are supported in this field. Whenever a change in a placeholder changes the filename, the local file is closed, renamed, and reopened. Note: On a truly local file, this renaming will never fail. However, be careful with using the feature, when the "local" backup file is actually stored on a network path. Some network storage devices may not behave reliably in such a situation.
keepLocalFiles	Specifies if and how long the local file is being kept even after a successful upload to DPE. If a number > 0 is specified here, the local file generated by the filter is not deleted even if no error occurred during the upload to DPE. Instead, the file is moved into an "Archive" sub-folder at its location. The value of the parameter defines the number of days, for which files are kept in this "Archive". If -1 (or any value < 0) is specified, the local files are left untouched at the end of the recording, regardless whether the upload to DPE was successful or not. The parameter is optional. If not specified, it defaults to 0, which means that local files are deleted immediately after a successful upload. In case the DPE upload did not succeed until its end, the local file will be kept and not automatically deleted. In this case the local file can be imported to Digas via manually dropping it to the target table (in Content Manager or DBM).
zeroLengthFileDeletion	This parameter controls what happens, if a recorded file has an audio play length of 0 (e.g. if a start level filter has never triggered). It is a string, which the following possible values: "soft": the database entry is soft-deleted. "hard": the database entry is hard-deleted "no": the database entry is not deleted The string is case-insensitive. The parameter is optional, and the default is "soft". Any value not in the list, incl. an empty string, is also handled like "soft".
deferEntryCreation	If `false` , the database entry is created immediately when the filter is connected. If `true` , database entry creation is deferred until the first audio data is going to be written. The parameter is optional, the default is `true` .
metadata	A list of field/value pairs which are sent as metadata for the new table entry. The field names must match the field names as used by the DPE Content Service. To write DigaSystem custom fields, use the "/" syntax, e.g. "CUSTOMER/MYFIELD". The metadata field is optional; if it's not specified, only a generic default title is used and the other database fields will be left empty.

Omitting DPE Upload

In test scenarios or for special use cases, you can omit the DPE upload altogether, and write the data only to a file on disk. To do this, you specify the string "(none)" (including the parentheses) in field "dpeUrl" , and in addition provide only the field "localFile" . All other fields are ignored and can be omitted in this case.

The main advantage of using this feature as compared to using a plain File Writer Filter is, that the file will be properly switched if you have an Output Switch configured in the job.