Asset Validation
The "Asset Validation" plugin allows to validate assets and marks them if they do not pass the validation.
Properties
To be configured in {home}/appserver/conf/custom.properties
assetValidation.license
type: String, required: yes, default: -
License key (delivered by brix Solutions AG)
assetValidation.validators
type: List of String (comma-separated), required: yes, default: -
This property takes a list of all validators that are enabled.
Validators
Every validator has its own properties. For every validator, the following properties are the same. Replace {validatorName} with the name of the validator specified in the section for the validator further down.
assetValidation.{validatorName}.nodeIdValid
type: long, required: no, default: -
If this property is set, the valid assets are collected in the configured node. This can help to find the valid assets and get an overview. Initially, all the assets can be validated and added to the node by running the "Revalidate Assets"-Task in "General"-Tab in System Tasks.
assetValidation.{validatorName}.nodeIdInvalid
type: long, required: no, default: -
If this property is set, the invalid assets are collected in the configured node. This can help to find the valid assets and get an overview. Initially, all the assets can be validated and added to the node by running the "Revalidate Assets"-Task in "General"-Tab in System Tasks.
assetValidation.{validatorName}.imagePath
type: String, required: no, default: -
This property takes a 16x16 px image which is shown on invalid assets.
NOTE: to show the bullet, the validatorName needs to be added to the list of bullets in the property "guiPlugin.bullets.asset=". This property is global and may be also used by other plugins. If not, the celum bullets need to be added to the list, e.g. guiPlugin.bullets.asset=noAssetType,invalidInformationFields,unlinked,unreleased,availability,locked,duplicate,conversionStatus,fileTypeWhitelistValdiator
assetValidation.{validatorName}.bulletId
type: String, required: yes, default: -
This property sets the ID of the bullet shown on invalid assets. The ID must also be added to the guiPlugin.bullets.asset property.
assetValidation.{validatorName}.bulletTitle
type: String, required: yes, default: -
This property sets the mouseover-title on the bullet. For multilanguage-support, add your messages to appserver/lang/customMessages_xy.properties and use the key here.
assetValidation.{validatorName}.checkboxId
type: InformationFieldId, required: no, default: -
Sets the checkbox to true if the validation is invalid and to false if the validation is valid.
assetValidation.{validatorName}.forAssetTypes
type: List of Long (comma-separated), required: no, default: -
If this property is set, the validator is only applied to assets of the configured asset type IDs.
assetValidation.{validatorName}.forFileTypes
type: List of String (comma-separated), required: no, default: -
If this property is set, the validator is only applied to assets with the configured file extensions.
File Type Whitelist
This validator takes a list of allowed file extensions.
- validatorName: fileTypeWhiteList
- bulletName: fileTypeWhiteListValidator
assetValidation.fileTypeWhiteList.whitelist
type: List of String (comma-separated), required: yes, default: -
All file extensions set in this property are allowed. Assets with one of these extensions are valid.
assetValidation.fileTypeWhiteList.checkboxId
type: InformationFieldId, required: no, default: -
Sets the checkbox to true if the validation is true.
Image Resolution Product Validator
This validator takes a minimum width multiplied by height in pixels an image must have.
- validatorName: imageResolutionProductValidator
- bulletName: imageResolutionProductValidator
assetValidation.imageResolutionProductValidator.minResolutionProduct
type: long, required: yes, default: 0
This property takes the minimum required product of the image width and height in pixels.
assetValidation.imageResolutionProductValidator.checkboxId
type: InformationFieldId, required: no, default: -
Sets the checkbox to true if the validation is true.
Video Resolution Validator
This validator takes a minWidth and / or minHeight in pixels a video must have.
- validatorName: videoResolution
- bulletName: videoResolutionValidator
assetValidation.videoResolution.mode
type: String, required: no, default: AND
This property can be set to 'OR' or 'AND'. 'OR': The video needs to have either minWidth or minHeight to be valid. 'AND': A video needs to have minWidth and minHeight to be valid.
assetValidation.videoResolution.minWidth
type: long, required: no, default: 0
This property takes the minWidth a video must have.
assetValidation.videoResolution.minHeight
type: long, required: no, default: 0
This property takes the minHeight a video must have.
assetValidation.videoResolution.checkboxId
type: InformationFieldId, required: no, default: -
Sets the checkbox to true if the validation is true.
Digital Image Colorspace Validator
This validator takes a list of allowed colorspaces for digital images.
- validatorName: digitalImageColorspace
- bulletName: digitalImageColorspaceValidator
assetValidation.digitalImageColorspace.colorspaces
type: List of String (comma-separated), required: yes, default: -
All colorspaces set in this property are allowed. Digital images with one of these colorspaces are valid.
assetValidation.digitalImageColorspace.checkboxId
type: InformationFieldId, required: no, default: -
Sets the checkbox to true if the validation is true.
Print Image Colorspace Validator
This validator takes a list of allowed colorspaces for print images.
- validatorName: printImageColorspace
- bulletName: printImageColorspaceValidator
assetValidation.printImageColorspace.colorspaces
type: List of String (comma-separated), required: yes, default: -
All colorspaces set in this property are allowed. Print images with one of these colorspaces are valid.
assetValidation.printImageColorspace.checkboxId
type: InformationFieldId, required: no, default: -
Sets the checkbox to true if the validation is true.
Image Color Depth Validator
This validator takes a list of allowed color depths for images.
- validatorName: imageColorDepth
- bulletName: imageColorDepthValidator
assetValidation.imageColorDepth.colorDepthList
type: List of String (comma-separated), required: yes, default: -
All color depths set in this property are allowed. Images with one of these color depths are valid.
assetValidation.imageColorDepth.checkboxId
type: InformationFieldId, required: no, default: -
Sets the checkbox to true if the validation is true.
Video Color Depth Validator
This validator takes a list of allowed color depths for videos.
- validatorName: videoColorDepth
- bulletName: videoColorDepthValidator
assetValidation.videoColorDepth.colorDepthList
type: List of String (comma-separated), required: yes, default: -
All color depths set in this property are allowed. Videos with one of these color depths are valid.
assetValidation.videoColorDepth.checkboxId
type: InformationFieldId, required: no, default: -
Sets the checkbox to true if the validation is true.
Video Codec Validator
This validator takes a list of allowed video codecs.
- validatorName: videoCodec
- bulletName: videoCodecValidator
assetValidation.videoCodec.videoCodecList
type: List of String (comma-separated), required: yes, default: -
All video codecs set in this property are allowed. Videos with one of these codecs are valid.
assetValidation.videoCodec.checkboxId
type: InformationFieldId, required: no, default: -
Sets the checkbox to true if the validation is true.
File Type Blacklist
This validator takes a list of forbidden file extensions.
- validatorName: fileTypeBlacklist
- bulletName: fileTypeBlacklistValidator
assetValidation.fileTypeBlacklist.blacklist
type: List of String (comma-separated), required: yes, default: -
All file extensions set in this property are prohibited. Assets with one of these extensions are invalid.
assetValidation.fileTypeBlacklist.checkboxId
type: InformationFieldId, required: no, default: -
Sets the checkbox to true if the validation is true.
Combined Validator
This validator combines multiple validators. An asset is valid only if all configured validators are valid.
- validatorName: combinedValidator
- bulletName: combinedValidator
assetValidation.combinedValidator.validators
type: List of String (comma-separated), required: yes, default: -
This property takes the bullet names of the validators to combine.
assetValidation.combinedValidator.checkboxId
type: InformationFieldId, required: no, default: -
Sets the checkbox to true if the validation is true.
Minimum Size Validator
This validator takes a minimum size in pixels. The larger image dimension must reach this value.
- validatorName: minSizeValidator
- bulletName: minSizeValidator
assetValidation.minSizeValidator.size
type: long, required: yes, default: 0
This property takes the minimum required size of the larger image dimension in pixels.
assetValidation.minSizeValidator.checkboxId
type: InformationFieldId, required: no, default: -
Sets the checkbox to true if the validation is true.
Duplicate Validator
This validator marks duplicate assets.
- validatorName: duplicateValidator
- bulletName: duplicateValidator
assetValidation.duplicateValidator.checkboxId
type: InformationFieldId, required: no, default: -
Sets the checkbox to true if the validation is true.
Densitiy
This validator takes a minimum density for assets to be valid.
- validatorName: density
- bulletName: densityValidator
assetValidation.density.noDensityValid
type: Boolean, required: yes, default: false
If this property is set to true, the asset has a valid density if there is no density given on the asset.
assetValidation.density.minDensity
type: Long, required: yes, default: -
This property takes the minimum required density for an asset to be valid.
assetValidation.density.checkboxId
type: InformationFieldId, required: no, default: -
Sets the checkbox to true if the validation is true.
Image Resolution Validator
This valdiator takes a minWidth and / or minHeight in pixels an image must have.
- validatorName: imageResolution
- bulletName: imageResolutionValidator
assetValidation.imageResolution.mode
type: String, required: no, default: OR
This property can be set to 'OR' or 'AND'. 'OR': The image needs to have either minWidht or minHeight to be valid. 'AND': An image needs to have minWidth and minHeight to be valid.
assetValidation.imageResolution.minWidth
type: long, required: no, default: 0
This property takes the minWidth an image must have. Note: If the imageResolution.mode is set to OR a valid image may not have the set minWidth since the minHeigt may be reached.
assetValidation.imageResolution.minHeight
type: long, required: no, default: 0
This property takes the minHeight an image must have. Note: If the imageResolution.mode is set to OR a valid image may not have the set minHeight since the minWidth may be reached.
assetValidation.imageResolution.checkboxId
type: InformationFieldId, required: no, default: -
Sets the checkbox to true if the validation is true.
Asset Name Validator
This Validator takes a list of forbidden strings that are not allowed in the asset name.
- validatorName: assetNameValidator
- bulletName: assetNameValidator
assetValidation.assetNameValidator.notAllowed
type: List of String (comma-separated), required: yes, default: -
This property takes a list of strings that are not allowed in the asset name.
assetValidation.assetNameValidator.checkboxId
type: InformationFieldId, required: no, default: -
Sets the checkbox to true if the validation is true.
Example
Using two validators, one for density and one for resolution:
guiPlugin.bullets.asset=noAssetType,invalidInformationFields,validMetadata,unlinked,unreleased,availability,locked,duplicate,conversionStatus,densityValidator,imageResolutionValidator
assetValidation.license=***
assetValidation.validators=densityValidator,imageResolutionValidator
assetValidation.density.bulletId=densityValidator
assetValidation.density.bulletTitle=assetValidation.invalidDensity
assetValidation.density.noDensityValid=false
assetValidation.density.nodeIdInvalid=26530
assetValidation.density.minDensity=300
assetValidation.density.forFileTypes=png,jpg
assetValidation.imageResolution.bulletId=imageResolutionValidator
assetValidation.imageResolution.bulletTitle=assetValidation.invalidResolution
assetValidation.imageResolution.nodeIdInvalid=26531
assetValidation.imageResolution.minWidth=1000
assetValidation.imageResolution.minHeight=1000
assetValidation.imageResolution.mode=AND
assetValidation.imageResolution.forFileTypes=png,jpgCompatibility Matrix
| Asset Validator | CELUM (min. version) |
|---|---|
| 1.0-1.3 | 5.13.4 |
| 1.4.0 | 6.20 |
| 1.4.2 | 7.1 |
Release Notes
1.0
Released 2018-06-15
Initial Version
1.1
Released 2018-06-20
Added Blacklist Filetype Validator
1.2
Released 2021-01-20
- Additional asset validators: Bit depth validator, video Codec validator, Color space validator
- Possibility to apply validators only for specific filetypes
1.3
Released 2022-05-04
- Various improvements to the validators
1.4
Released 2025-02-13
- Compatibility with CELUM 6.20
1.4.2
Released 2026-07-21
- Compatibility with CELUM 7.1
© brix Solutions AG