Asset Exporter

For the most up-to-date documentation, please visit docs.brix.ch

Exports assets in regular intervals to a defined folder. If also metadata has to be exported (as CSV or Excel file) you can use the "Extended Asset Exporter". Now also supports public URLs.

Properties

To be configured in {home}/appserver/conf/custom.properties

General properties

documentExport.license

type: String, required: yes, default: -

license key (delivered by brix cross media)

documentExport.changeDetectionNode

type: long, required: yes, default: -

Defines the ID of the root-node under which for each job a node will be created to collect the changed assets of the job.

documentExport.visibleForGroup

type: long, required: no, default: -

restrict the use of the plugin to this user group ID (superadmins always see it in any case)

documentExport.jobInterruptGraceTimeInMillis

type: int, required: no, default: 3000

grace time before a job thread is killed

documentExport.metadataExportEnabled

type: boolean, required: no, default: yes

Enable or disable the possibility to export metadata of the exported assets (as CSV or Excel file).

documentExport.simulateFileNameResolverAsAssetName

type: String, required: no, default: 1:

shortcut to speed up full exports -> simulate the asset filename resolver format: :,..., e.g. 1:jpg,2:png will assume .jpg when using dlf 1. you can leave empty to use the files original file extension (e.g. for original format

documentExport.customNameResolverFactories

type: String, required: no, default: -

Whitelist for custom name resolvers (inherit by CustomNameResolverFactory), default resolver factories are always available

documentExport.customPathResolverFactories

type: String, required: no, default: -

Whitelist for custom path resolvers (inherit by CustomPathResolverFactory), default resolver factories are always available

documentExport.exportBasePaths

type: String, required: no, default: -

Defines the base baths for the local export locations (comma-separated). If defined, the plugin only allows to export to subfolders of one of the predefines base paths. If not defined, every export location is allowed.

documentExport.sendMail

type: Boolean, required: no, default: true

If true, error mails will be sended when a job fails

documentExport.errorMail

type: String, required: no, default: -

email address for sending error mails

CSV properties

documentExport.metadataExport.csv.separator

type: char, required: no, default: ,

CSV separator for the metadata csv export

documentExport.metadataExport.csv.quotechar

type: char, required: no, default: "

CSV quote char for the metadata csv export

documentExport.metadataExport.csv.quoteAll

type: booelan, required: no, default: true

Define if all csv values are quoted

documentExport.metadataExport.csv.encoding

type: String, required: no, default: UTF-8

Encoding for the metadata csv export

documentExport.metadataExport.csv.lineend

type: String, required: no, default: \r\n

End of line for the metadata csv export

documentExport.metadataExport.csv.dateFormat

type: String, required: no, default: yyyy-MM-dd

date format for csv exports

Amazon S3 Export

  1. Create an IAM-User with AmazonS3FullAccess to get the Access Key ID and the Secret Access Key.
  2. Create a bucket to get Bucket and Region.
  3. Choose Amazon S3 as Export type and enter the values from above.

Attention: We need the region and not the region name which is specified when creating the bucket. See here for a list of all values.

CRON properties

documentExport.cronExpression.hourly

type: String, required: no, default: 0 0 0/1 1/1 ?

Cron expression for hourly execution

documentExport.cronExpression.daily

type: String, required: no, default: 0 0 0 1/1 ?

Cron expression for daily execution

documentExport.cronExpression.weekly

type: String, required: no, default: 0 0 0 ? SUN

Cron expression for weekly execution

documentExport.cronExpression.manually

type: String, required: no, default: 59 59 23 31 12 ? 2099

Never executing cron expression

Screenshots

Asset Exporter Adminmenu

Asset Exporter Create Export

Asset Exporter Overview

Release Notes

1.0

Released 2016-07-18

  • Initial Version

1.1

Released 2016-12-15

  • Extension for logging (the report can either be exported together with the assets or stored locally on the server)

1.2

Released 2017-02-16

  • The export destination can be either a share available on the server or an FTP server

1.9

Released 2017-09-26

  • Export configuration, adapt node IDs and mode

2.0

Released 2017-09-28

  • Search export jobs possible

2.3

Released 2018-03-28

  • Combination of different search criteria for a search export job possible

2.5

Released 2018-12-11

  • Public URLs

2.5.9

Released 2019-01-17

  • DefaultNameResolverFactories and CustomNameResolverFactories. Default are always available, custom have to be enabled by the customNameResolverFactories property.

2.6.0

Released 2019-01-22

  • Base paths for export configurable

2.7.0

Released 2019-01-22

  • SearchJob: Cron-Expression customizable, empty and not-empty searches

2.8.2

Released 2019-03-04

  • Custom path resolvers, Amazon S3 Export

2.8.4

Released 2019-03-19

  • Execute-As setting for superadmin to define as which user a job should be executed, for non-supperadmin jobs will be executed as creator user.
  • Only show own export-tasks (except superuser)
  • Button to manually schedule assets to its jobs

2.8.6

Released 2019-03-27

  • job setting to set export status on exported assets (infofield an value configurable)

2.8.12

Released 2019-05-08

  • if export status value is empty, infofield value will be cleared in return option "none" for export status infofield

2.9.0

Released 2019-05-15

  • export status value for failed and for succeeded exports
  • toast notification when asses are rescheduled