Export Locations

Introduction

An export location is a re-usable and savable configuration to create exports. These exports can either be to your computer (a download) or to an external location (e.g. YouTube). It shares a lot of its configuration with export jobs.

General information

Property	Description	Engine validation	Frontend validation

Property	Description	Engine validation	Frontend validation
Id	/	/	Not editable
Name	/	/	/
Unique folder	Whether each export to this location creates a unique subfolder for the export	Default true Readonly	Always disabled
Http URL	The (internal) url on which the export will be accessible	Is a valid url	Error toast after save if invalid
Export downloadable (a.k.a. httpAccessible)	Whether the result of the export can be downloaded If true, the export location will show up in MediaHaven under the download action. If false, the export location will show up in MediaHaven under the 'export to location' action	Readonly True if Http url is filled in	Always disabled Checked/unchecked depending on whether http url is filled in
Export reasons required	Whether an export reason is required to initiate an export	/	/
Custom export reason allowed	Whether a custom (free-text) reason is allowed in addition to the supplied list	Readonly	Always disabled
Default export location	Whether the export location is the default export location	/	Always disabled since changing this can cause a lot of issues. If you really want to change it, you can still do so through the API
Priority	/	Number between 1 and 4	Number between 1 and 4
Storage Type	The type of storage. This is a Frontend only construct	/	Dropdown Cannot be changed after creation.
Storage pool id	The id of the storage pool.	Required if server is not filled in. Should be a valid pool id.	Can only be filled in and is required if Storage Type: Storage Pool is selected Error toast on save if invalid id is provided.
Server address	The server address	Required if storage pool id not filled in. Should be a valid url.	Can only be filled in and is required if Storage Type: Server is selected Error toast on save if invalid url is provided.
Protocol	The server protocol.	Required if storage pool id not filled in.	Can only be selected and is required if Storage Type: Server is selected
Port	The port of the server	`> 0`	Can only be filled in if Storage Type: Server is selected `0 < port < 65535`
Path	The server path	/	Can only be filled in if Storage Type: Server is selected
Username	The server username. Filling it in will overwrite the existing value.	/	Can only be filled in if Storage Type: Server is selected
Password	The server password. Filling it in will overwrite the existing value.	Required if username is filled in	Can only be filled in and is required if username is filled in
Filename expression	Expression that will provide the filename of the export. You can make this very complex, but generally will be of the form: `#{R('DottedKey')}` Apostrophes included.	Should be a valid SpEL expression.	Error toast on save if an invalid expression is provided.
Temporary path	The temporary location path.	/	/
Temporary filename	The temporary filename + extension.	/	/

Export Options

Export image options

Property	Description	Engine validation	Frontend validation

Property	Description	Engine validation	Frontend validation
Height	The height in pixels an exported image will have. If not defined, the original height will be used.
Width	The width in pixels an exported image will have. If not defined, the original width will be used.
Container	The export container format, defaults to JPG when transforming and not explicitly set.	/	Dropdown
Color space	The color space of the export, defaults to sRGB when transforming and not explicitly set.		Dropdown
Rotation	The rotation of the image, in degrees
Flip	Flip the image horizontal / vertical	/	Dropdown
Cropping (top, bottom, left, right)	The offset to crop the image.
Watermark source	The source of the watermark applied by the transformation.	/	/
Watermark scale	The scale of the watermark.		Disabled unless source is filled in
Watermark opacity	The opacity of the watermark.		Disabled unless source is filled in
Watermark position	The position of the watermark.	/	Disabled unless source is filled in Dropdown

Export video options

Same as image, without colour space, rotation, flip and cropping and including:

Property	Description	Engine validation	Frontend validation

Property	Description	Engine validation	Frontend validation
Height	The height in pixels an exported videowill have. If not defined, the original height will be used.
Width	The width in pixels an exported video will have. If not defined, the original width will be used.
Bitrate	The bitrate in bits per second an exported video will have. If not defined, the original bitrate will be used.
Container	The export container format. If not defined, the original format will be used.	/	Dropdown
Channels	The number of audio channels.
Watermark source	The source of the watermark applied by the transformation.	/	/
Watermark scale	The scale of the watermark.		Disabled unless source is filled in
Watermark opacity	The opacity of the watermark.		Disabled unless source is filled in
Watermark position	The position of the watermark.	/	Disabled unless source is filled in Dropdown

Export audio options

Property	Description	Engine validation	Frontend validation

Property	Description	Engine validation	Frontend validation
Sample rate	The sample rate in hertz an exported audio file will have. If not defined, the original sample rate will be used.
Bitrate	The bitrate in bits per second an exported audio will have. If not defined, the original bitrate will be used.
Container	The file format an exported audio-only file will have. Not applicable if file contains video as well. If not defined, the original format will be used.	/	Dropdown

Export document options

Property	Description	Engine validation	Frontend validation

Property	Description	Engine validation	Frontend validation
Height	The height in pixels an exported document will have. If not defined, the original height will be used.
Width	The width in pixels an exported document will have. If not defined, the original width will be used.
Container	The export container format, defaults to JPG when transforming and not explicitly set.	/	Dropdown
Color space	The color space of the export, defaults to sRGB when transforming and not explicitly set.		Dropdown
Watermark source	The source of the watermark applied by the transformation.	/	/
Watermark scale	The scale of the watermark.		Disabled unless source is filled in
Watermark opacity	The opacity of the watermark.		Disabled unless source is filled in
Watermark position	The position of the watermark.	/	Disabled unless source is filled in Dropdown

Export partial options

This option cannot be specified beforehand on an export location but can be specified on demand when requesting the export.

Property	Description	Engine validation

Property	Description	Engine validation
Type	Enum. Values: Frames, Bytes
Start	The start of the partial, specified in frames or bytes. This point is included in the interval.	Smaller than “End” Within the range of the file size / duration
End	The end of the partial, specified in frames or bytes. This point is excluded from the interval.	Within the range of the file size / duration

Export metadata options

Property	Description	Engine validation	Frontend validation

Property	Description	Engine validation	Frontend validation
Type	If set, define how record metadata is exported.		Dropdown
Format	The sidecar format	Only allowed and required when type: Sidecar	Hidden unless Type: Sidecar Required when Type: Sidecar
Only metadata	If true, only metadata will be exported.	Only allowed when type: Sidecar	Hidden unless Type: Sidecar
Metadata translation id	The id of a metadata translation	Only allowed and required when type: Burn Must be a valid id	Hidden unless Type: Burn Required when Type burn Error toast on save when invalid id is provided.

User options

Property	Description	Engine validation	Frontend validation

Property	Description	Engine validation	Frontend validation
Allowed for all users	Whether the export location is allowed for all users of own organisation.	/	/
Allowed for all organisations	Whether the export location is allowed for all users of own organisation.	/	/
Explicitly assigned users	Users that have received explicit access to the export location. Irrelevant if one of the above options is set.	Can’t assign if one of the above options is set.	Disabled if one of the above options is set

Context (Readonly)

Property	Description

Property	Description
IsEditable	Whether the export location is editable. False if the user does not have the required functions.
AreOptionsEditable	Whether the options of the export location are editable. False for default export locations or if the user does not have the required functions.
IsDeletable	Whether the export location is deletable. False for default export locations or if the user does not have the required functions.