com.day.cq.dam.scene7.api

Interface Scene7Service

public interface Scene7Service

The Scene7Service provides methods for interacting with the official Scene7 API.

Field Summary

Fields

Modifier and Type	Field and Description
static int	CONTAINER Scene7 specification used in getAssociatedAssets - Array of set and template assets containing the specified asset.
static int	DERIVED Scene7 specification used in getAssociatedAssets - Array of assets that are derivatives of the specified asset.
static int	GENERATED Scene7 specification used in getAssociatedAssets - Array of assets that were generated from the specified asset.
static int	GENERATOR Scene7 specification used in getAssociatedAssets - Array of assets that were used to generate the specified asset.
static int	MEMBER Scene7 specification used in getAssociatedAssets - Array of assets contained by the specified set or template asset.
static int	OWNER Scene7 specification used in getAssociatedAssets - Array of assets that own the specified asset.

Method Summary

Modifier and Type	Method and Description
java.lang.String	addUser(S7Config s7Config, java.lang.String firstName, java.lang.String lastName, java.lang.String email, java.lang.String defaultRole, java.lang.String password, Instant passwordExpires, boolean isValid, java.util.List<Scene7CompanyMembership> membershipArray) Creates a user account and adds the account to one of more companies
Scene7BatchMetadataResult	batchSetAssetMetadata(S7Config s7Config, java.util.List<Scene7MetadataUpdate> updates) Sets asset metadata using batch mode.
Scene7BatchMetadataResult	batchSetImageFields(S7Config s7Config, java.util.List<Scene7ImageFieldUpdate> updateArray) Sets asset metadata using batch mode.
java.lang.String	createAssetSet(S7Config s7Config, java.lang.String folder, java.lang.String name, java.lang.String type, Resource resource, Scene7AssetSet setDefinition, java.lang.String thumbAssetHandle) Create an AssetSet asset on Scene7 server
java.lang.String	createFolder(S7Config s7Config, java.lang.String cqFolderPath) Create a folder on Scene7 server
java.lang.String	createImageSet(S7Config s7Config, java.lang.String imageSetFolder, java.lang.String imageSetName, java.lang.String thumbAssetHandle) Deprecated. Use createImageSet(S7Config, String, String, String, Resource, String)
java.lang.String	createImageSet(S7Config s7Config, java.lang.String folder, java.lang.String name, java.lang.String type, Resource resource, java.lang.String thumbAssetHandle) Create an ImageSet asset on Scene7 server
java.lang.String	createViewerPreset(S7Config s7Config, java.lang.String folderHandle, java.lang.String name, java.lang.String type, java.util.List<Scene7ConfigSetting> configSettings) Deprecated. Use createViewerPreset(S7Config, String, String, String, Resource, List)
java.lang.String	createViewerPreset(S7Config s7Config, java.lang.String folderHandle, java.lang.String name, java.lang.String type, Resource resource, java.util.List<Scene7ConfigSetting> configSettings) Create a preset view to determine what users can see.
java.lang.String	deleteAsset(java.lang.String assetHandle, S7Config s7Config) Returns a String success, note that the underlying S7 API call does not provide a data response.
java.lang.String	deleteAssets(java.lang.String[] assetHandleArr, S7Config s7Config) Delete multiple assets Returns a String success, note that the underlying S7 API call does not provide a data response.
java.lang.String	deleteFolder(java.lang.String folderHandle, S7Config s7Config) Returns a String success, note that the underlying S7 API call does not provide a data response.
java.lang.String	deleteImageFormat(S7Config s7Config, java.lang.String imageFormatHandle) Deletes an image format.
void	deleteImageMap(S7Config s7Config, java.lang.String imageMapHandle) Deletes an image map
java.util.List<Scene7User>	getAllUsers(S7Config s7Config, boolean includeInvalid) Return all users
java.lang.String	getApplicationPropertyHandle(S7Config s7Config) Returns the application property handle.
Scene7Asset	getAsset(java.lang.String assetHandle, java.lang.String[] responseFields, java.lang.String[] excludeFields, S7Config s7Config) Returns a single Scene7Asset object.
java.util.List<Scene7Asset>	getAssets(java.lang.String[] assetHandles, java.lang.String[] responseFields, java.lang.String[] excludeFields, S7Config s7Config) Returns a Scene7Asset list, based on a list of asset handles
Scene7Asset	getAssociatedAssets(Scene7Asset asset, S7Config s7Config) Retrieves the sub-assets and the origiator asset associated with the given asset
java.lang.String	getCompanyMembership(ResourceResolver resourceResolver, java.lang.String userHandle, java.lang.String email, java.lang.String password, java.lang.String region) Returns a JSON representation of the company membership information provided by Scene7.
java.util.List<Scene7Asset>	getContainerAssets(Scene7Asset scene7Asset, S7Config s7Config)
java.lang.String	getFlashTemplatesServer(S7Config s7Config) Deprecated.
java.lang.String	getFolderHandle(java.lang.String cqFolderPath, S7Config s7Config) Returns s7 folder handle for the associated cq folder
Scene7Folder	getFolderTree(java.lang.String folderPath, int depth, java.lang.String[] responseFields, java.lang.String[] excludeFields, S7Config s7Config) Returns a Scene7Folder holding a tree structure
java.lang.String	getFxgServer(S7Config s7Config) Deprecated.
Scene7Asset	getGeneratedAssets(Scene7Asset asset, S7Config s7Config) Retrieves the generated assets associated with the given input asset
java.util.List<Scene7ImageFormat>	getImageFormats(S7Config s7Config) Returns image formats, such as PDF, EPS, SWF, and others.
java.util.List<java.lang.String>	getImagePresets(S7Config s7Config) Returns a list of Scene7 image preset names for the given S7Config
java.util.List<java.lang.String>	getJobLogDetails(java.lang.String jobHandle, S7Config s7Config) Returns a list of Scene7 asset handles(Strings) for the given job handle
java.lang.String	getJobStatus(S7Config s7Config, java.lang.String jobName) Get scene7 job status with given jobName, the jobName should be uniq, if there are many job have same name, it only get the first one
java.lang.String	getLinkedScene7ConfigPath(Resource resource) Returns property dam:scene7CloudConfigPath of a given Resource object
Scene7Asset	getMasterAsset(Scene7Asset asset, S7Config s7Config) Retrieves the originator asset associated with the given asset
java.util.ArrayList<UploadJobDetail>	getMultiFileJobLogDetails(java.lang.String jobHandle, S7Config s7Config) Returns an Arraylist of job details objects
java.lang.String	getPreviewServerUrl(Resource resource, ResourceResolver configResolver) Retrieves Scene7 remote asset preview /is/image/ URL (context path with image server uri).
java.lang.String	getPreviewVideoServerUrl(Resource resource, ResourceResolver configResolver) Retrieves Scene7 remote video preview /is/content/ URL (context path with image server uri).
java.util.List<Scene7PropertySet>	getPropertySets(java.lang.String typeHandle, S7Config s7Config) Returns the video encoder preset type handle.
java.lang.String	getPublishServer(S7Config s7Config) Returns the domain name of the S7 publish server
java.lang.String	getPublishServerUrl(Resource resource, ResourceResolver configResolver) Retrieves Scene7 remote asset publish /is/image/ URL (server domain and image server uri).
java.lang.String	getPublishVideoServerUrl(Resource resource, ResourceResolver configResolver) Retrieves Scene7 remote video publish /is/content/ URL (server domain and image server uri).
java.util.Map<java.lang.String,java.lang.String>	getS7AssetMetadata(S7Config s7Config, java.lang.String assetHandle) Retrieves a metadata map (key-value pair) associated with a Scene7 asset
java.util.List<Scene7Asset>	getS7VideoRenditions(S7Config s7Config, java.lang.String assetHandle) Retrieves a list of Scene7 video renditions with their names and asset handles
java.lang.String	getScene7ID(Resource resource) Returns property dam:scene7ID of a given Resource object
java.lang.String	getUserHandle(ResourceResolver resourceResolver, java.lang.String email, java.lang.String password, java.lang.String region) Returns a unique user handle from Scene7.
java.util.List<Scene7User>	getUsers(S7Config s7Config, java.lang.Boolean includeInactive, java.lang.Boolean includeInvalid, java.util.List<java.lang.String> companyHandleArray, java.util.List<java.lang.String> groupHandleArray, java.util.List<java.lang.String> userRoleArray, java.lang.String charFilterField, java.lang.String charFilter, java.lang.String sortBy, java.lang.Integer recordsPerPage, java.lang.Integer resultsPage) Return a optionally sorted, filtered and paged list user results
java.lang.String	getVideoEncoderPresetTypeHandle(S7Config s7Config) Returns the video encoder preset type handle.
Scene7ViewerConfig	getViewerConfigSettings(S7Config s7Config, java.lang.String assetHandle) Get the viewer configuration for the referenced asset
java.lang.String	getXMPPacket(S7Config s7Config, java.lang.String assetHandle) Retrieves an XMP Metadata packet for the specified asset.
boolean	isJobActiveByJobHandle(java.lang.String jobHandle, S7Config s7Config)
boolean	isJobActiveByOriginalName(java.lang.String originalName, S7Config s7Config)
boolean	isResourceLinkedToScene7(Resource resource) Returns true if Resource object is linked to Scene7 based on its metadata
boolean	moveAsset(S7Config s7Config, Resource resource, java.lang.String folder) Moves an asset to a specific folder
boolean	moveAssets(S7Config s7Config, java.util.Map<Resource,java.lang.String> resourcesToFolders) Moves multiple assets independently of each other
boolean	moveAssociatedAsset(S7Config s7Config, Resource resource, java.lang.String folder) Finds and moves generated assets to a specific folder
boolean	moveFolder(S7Config s7Config, java.lang.String sourceFolder, java.lang.String destinationFolder) Move a folder to a new location
boolean	renameAsset(S7Config s7Config, Resource resource, java.lang.String name) Rename an asset
boolean	renameFolder(S7Config s7Config, java.lang.String folder, java.lang.String name) Rename a folder
java.lang.String	saveImageFormat(S7Config s7Config, java.lang.String imageFormatHandle, java.lang.String name, java.lang.String urlModifier) Deprecated. Use saveImageFormat(S7Config, String, String, String, Resource)
java.lang.String	saveImageFormat(S7Config s7Config, java.lang.String imageFormatHandle, java.lang.String name, java.lang.String urlModifier, Resource resource) Create an image format.
java.lang.String	saveImageMap(S7Config s7Config, java.lang.String assetHandle, java.lang.String imageMapHandle, java.lang.String name, java.lang.String shapeType, java.lang.String region, java.lang.String action, int position, boolean enabled) Create a new image map or edit an existing map
java.util.List<Scene7Asset>	searchAssets(java.lang.String folder, java.lang.Boolean includeSubfolders, java.lang.Boolean published, java.lang.String[] assetTypes, java.lang.String[] assetSubTypes, java.lang.String[] responseFields, java.lang.String[] excludeFields, int recordsPerPage, int resultsPage, S7Config s7Config) Retrieves a list of Scene7Assets from the Scene7 server.
java.util.List<Scene7Asset>	searchAssets(java.lang.String folder, java.lang.Boolean includeSubfolders, java.lang.Boolean published, java.lang.String[] assetTypes, java.lang.String[] assetSubTypes, java.lang.String[] responseFields, java.lang.String[] excludeFields, S7Config s7Config) Retrieves a list of Scene7Assets from the Scene7 server.
java.util.List<Scene7Asset>	searchAssetsByFilename(java.lang.String folder, java.lang.Boolean includeSubfolders, java.lang.Boolean published, java.lang.String filename, S7Config s7Config) Retrieve a list of Scene7Assets from the Scene7 server by filename.
java.util.List<Scene7Asset>	searchAssetsByMetadata(java.lang.String folder, java.lang.Boolean includeSubfolders, java.lang.String[] assetTypes, java.lang.String[] assetSubTypes, java.lang.Boolean published, MetadataCondition[] conditions, int recordsPerPage, int resultsPage, S7Config s7Config) Returns a DOM list with search results (from metadata), support specify
java.util.List<Scene7Asset>	searchAssetsByMetadata(java.lang.String folder, java.lang.Boolean includeSubfolders, java.lang.String[] assetTypes, java.lang.String[] assetSubTypes, java.lang.Boolean published, MetadataCondition[] conditions, S7Config s7Config) Returns a DOM list with search results (from metadata)
java.util.List<Scene7Asset>	searchAssetsByName(java.lang.String folder, java.lang.Boolean includeSubfolders, java.lang.Boolean published, java.lang.String name, S7Config s7Config) Retrieve a list of Scene7Assets from the Scene7 server by Scene7 asset name.
java.util.List<Scene7Asset>	searchAssetsByPartialName(java.lang.String folder, java.lang.Boolean includeSubfolders, java.lang.Boolean published, java.lang.String name, java.lang.String conditionMode, S7Config s7Config) Retrieve a list of Scene7Assets from the Scene7 server by Scene7 asset name with partial name search option
java.lang.String	setAssetPublishState(Resource resource, boolean markForPublish, S7Config s7Config) Set the publish state of a given Scene7 asset
java.lang.String	setAssetPublishState(java.lang.String assetHandle, boolean markForPublish, S7Config s7Config) Set the publish state of a given Scene7 asset
java.lang.String	setAssetsPublishState(java.util.Set<java.lang.String> assetHandles, boolean markForPublish, S7Config s7Config) Set the publish state of a given Scene7 assets
java.util.List<java.lang.String>	setImageMaps(S7Config s7Config, java.lang.String assetHandle, java.util.List<Scene7ImageMapDefinition> imageMap) Sets the image map for an asset.
void	setUserInfo(S7Config s7Config, java.lang.String userHandle, java.lang.String firstName, java.lang.String lastName, java.lang.String email, java.lang.String defaultRole, Instant passwordExpires, boolean isValid, java.util.List<Scene7CompanyMembership> membershipArray) Set user attributes
void	setViewerConfigSettings(S7Config s7Config, java.lang.String assetHandle, java.lang.String name, java.lang.String type, java.util.List<Scene7ConfigSetting> configSettings) Attach viewer configuration settings to an asset Can be viewer preset or the source asset for the viewer
void	updateAssetSet(S7Config s7Config, java.lang.String assetHandle, Scene7AssetSet setDefinition, java.lang.String thumbAssetHandle) Update an AssetSet on Scene7 server
void	updateImageSet(S7Config s7Config, java.lang.String assetHandle, ImageSetMemberUpdateArray members, java.lang.String thumbAssetHandle) Update an ImageSet on Scene7 server
void	updateImageSet(S7Config s7Config, java.lang.String imageSetAssetHandle, java.util.List<java.lang.String> setMemberHandles, java.lang.String thumbAssetHandle) Deprecated. Use updateImageSet(S7Config, String, ImageSetMemberUpdateArray, String)
boolean	updateSmartCrops(S7Config s7Config, java.util.Map<java.lang.String,java.util.Map<java.lang.String,Scene7NormalizedCropRect>> updateSmartCropMap) Update one or more Smart Crop sub asset(s)
void	updateViewerConfigSettings(S7Config s7Config, java.lang.String assetHandle, java.util.List<Scene7ConfigSetting> configSettings) Updates SWF viewer configuration settings.
void	updateXMPPacket(S7Config s7Config, java.lang.String assetHandle, java.lang.String xmpPacketAsXml) Sets or updates an XMP metadata packet for an asset.

Field Detail

CONTAINER

static final int CONTAINER

Scene7 specification used in getAssociatedAssets - Array of set and template assets containing the specified asset.

See Also:

Constant Field Values

MEMBER

static final int MEMBER

Scene7 specification used in getAssociatedAssets - Array of assets contained by the specified set or template asset.

See Also:

Constant Field Values

OWNER

static final int OWNER

Scene7 specification used in getAssociatedAssets - Array of assets that own the specified asset.

See Also:

Constant Field Values

DERIVED

static final int DERIVED

Scene7 specification used in getAssociatedAssets - Array of assets that are derivatives of the specified asset.

See Also:

Constant Field Values

GENERATOR

static final int GENERATOR

Scene7 specification used in getAssociatedAssets - Array of assets that were used to generate the specified asset.

See Also:

Constant Field Values

GENERATED

static final int GENERATED

Scene7 specification used in getAssociatedAssets - Array of assets that were generated from the specified asset.

See Also:

Constant Field Values

Method Detail

getPublishServer

java.lang.String getPublishServer(S7Config s7Config)

Returns the domain name of the S7 publish server

Parameters:

s7Config -

Returns:

A string, null if not present

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

getApplicationPropertyHandle

java.lang.String getApplicationPropertyHandle(S7Config s7Config)

Returns the application property handle.

Parameters:

s7Config - the Scene7 configuration

Returns:

the application property handle, null if not present

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

getVideoEncoderPresetTypeHandle

java.lang.String getVideoEncoderPresetTypeHandle(S7Config s7Config)

Returns the video encoder preset type handle.

Parameters:

s7Config - the Scene7 configuration

Returns:

the video encoder preset type handle, null if not present

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

getPropertySets

java.util.List<Scene7PropertySet> getPropertySets(java.lang.String typeHandle,
                                                  S7Config s7Config)

Returns the video encoder preset type handle.

Parameters:

typeHandle - - the type handle

s7Config - the Scene7 configuration

Returns:

the list of property sets

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

getUserHandle

java.lang.String getUserHandle(ResourceResolver resourceResolver,
                               java.lang.String email,
                               java.lang.String password,
                               java.lang.String region)

Returns a unique user handle from Scene7.

Parameters:

resourceResolver - resource resolver used to access Scene7 configuration

email - E-Mail address

password - Password

region - Region of the Scene7 service

Returns:

A unique user handle

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

getCompanyMembership

java.lang.String getCompanyMembership(ResourceResolver resourceResolver,
                                      java.lang.String userHandle,
                                      java.lang.String email,
                                      java.lang.String password,
                                      java.lang.String region)

Returns a JSON representation of the company membership information provided by Scene7. The information includes a company handle, a company name and an asset root path.

For example:
{
handle: 'jlkj98',
name: 'Acme Ltd.',
rootPath: '/MyAssets'
}

Parameters:

resourceResolver - resource resolver used to access Scene7 configuration

userHandle - Unique user handle

email - E-Mail address

password - Password

region - Region of the Scene7 service

Returns:

A JSON string

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

getFolderTree

Scene7Folder getFolderTree(java.lang.String folderPath,
                           int depth,
                           java.lang.String[] responseFields,
                           java.lang.String[] excludeFields,
                           S7Config s7Config)

Returns a Scene7Folder holding a tree structure

Parameters:

folderPath - - the top folder of the request - does not need to be the root.

depth - - depth of the returned folder tree.

responseFields - - fields to be filled in for each node in the tree

excludeFields - - fields to be excluded in each node of the tree

s7Config -

Returns:

A Scene7Folder object containing the requested folder structure

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

getFolderHandle

java.lang.String getFolderHandle(java.lang.String cqFolderPath,
                                 S7Config s7Config)

Returns s7 folder handle for the associated cq folder

Parameters:

cqFolderPath - - the path the target cq folder targeted in the s7 folder organization

s7Config -

Returns:

folder handle or null if the folder does not exist in s7.

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

deleteFolder

java.lang.String deleteFolder(java.lang.String folderHandle,
                              S7Config s7Config)

Returns a String success, note that the underlying S7 API call does not provide a data response.

Parameters:

folderHandle - - folder to be deleted

s7Config - - s7 config based on cloud service config info.

Returns:

String success

Throws:

java.lang.AssertionError - in case of IPS failures

deleteAsset

java.lang.String deleteAsset(java.lang.String assetHandle,
                             S7Config s7Config)

Returns a String success, note that the underlying S7 API call does not provide a data response.

Parameters:

assetHandle - - asset to be deleted

s7Config - - s7 config based on cloud service config info.

Returns:

String success

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

deleteAssets

java.lang.String deleteAssets(java.lang.String[] assetHandleArr,
                              S7Config s7Config)

Delete multiple assets Returns a String success, note that the underlying S7 API call does not provide a data response.

Parameters:

assetHandleArr - - asset to be deleted

s7Config - - s7 config based on cloud service config info.

Returns:

String success

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

searchAssetsByMetadata

java.util.List<Scene7Asset> searchAssetsByMetadata(java.lang.String folder,
                                                   java.lang.Boolean includeSubfolders,
                                                   java.lang.String[] assetTypes,
                                                   java.lang.String[] assetSubTypes,
                                                   java.lang.Boolean published,
                                                   MetadataCondition[] conditions,
                                                   S7Config s7Config)

Returns a DOM list with search results (from metadata)

Parameters:

folder - - all matched assets will be in this folder

includeSubfolders - - whether to recursively search for assets

assetTypes - - all matched assets will be one of these types

assetSubTypes - array of sub Asset Types to include in search

published - - whether the matched assets must be marked for publish (only marked - not necessarily actually published)

conditions - - metadata conditions for search

s7Config -

Returns:

A list of assets; the list can be empty if no assets have been found.

Throws:

java.lang.AssertionError - in case of IPS failures

searchAssetsByMetadata

java.util.List<Scene7Asset> searchAssetsByMetadata(java.lang.String folder,
                                                   java.lang.Boolean includeSubfolders,
                                                   java.lang.String[] assetTypes,
                                                   java.lang.String[] assetSubTypes,
                                                   java.lang.Boolean published,
                                                   MetadataCondition[] conditions,
                                                   int recordsPerPage,
                                                   int resultsPage,
                                                   S7Config s7Config)

Returns a DOM list with search results (from metadata), support specify

Parameters:

folder - - all matched assets will be in this folder

includeSubfolders - - whether to recursively search for assets

assetTypes - - all matched assets will be one of these types

assetSubTypes - array of sub Asset Types to include in search

published - - whether the matched assets must be marked for publish (only marked - not necessarily actually published)

conditions - - metadata conditions for search

recordsPerPage - maximum number of results to return

resultsPage - specifies the page of results to return, based on recordsPerPage page size

s7Config -

Returns:

A list of assets; the list can be empty if no assets have been found.

Throws:

java.lang.AssertionError - in case of IPS failures

getAssets

java.util.List<Scene7Asset> getAssets(java.lang.String[] assetHandles,
                                      java.lang.String[] responseFields,
                                      java.lang.String[] excludeFields,
                                      S7Config s7Config)

Returns a Scene7Asset list, based on a list of asset handles

Parameters:

assetHandles - - the assets to retrieve

responseFields - - fields to be filled in for each node in the tree

excludeFields - - fields to be excluded in each node of the tree

s7Config -

Returns:

A Scene7Asset list

Throws:

java.lang.AssertionError - in case of IPS failures

getAsset

Scene7Asset getAsset(java.lang.String assetHandle,
                     java.lang.String[] responseFields,
                     java.lang.String[] excludeFields,
                     S7Config s7Config)

Returns a single Scene7Asset object. If there are multiple matching assets found, return the first asset.

Parameters:

assetHandle - - the asset to retrieve

responseFields - - fields to be filled in for each node in the tree

excludeFields - - fields to be excluded in each node of the tree

s7Config - - Scene7 cloud configuration object

Returns:

A Scene7Asset object, or null if not found or failed

Throws:

java.lang.AssertionError - in case of IPS failures

getMultiFileJobLogDetails

java.util.ArrayList<UploadJobDetail> getMultiFileJobLogDetails(java.lang.String jobHandle,
                                                               S7Config s7Config)

Returns an Arraylist of job details objects

Parameters:

jobHandle - - the handle for the job to get details.

s7Config -

Returns:

An AssetList of UploadJobDetail

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

isJobActiveByJobHandle

boolean isJobActiveByJobHandle(java.lang.String jobHandle,
                               S7Config s7Config)

Parameters:

jobHandle - of the job

s7Config -

Returns:

true if active job with this jobHandle or orginalName is active, false otherwise

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

isJobActiveByOriginalName

boolean isJobActiveByOriginalName(java.lang.String originalName,
                                  S7Config s7Config)

Parameters:

originalName - of the job

s7Config -

Returns:

true if active job with this jobHandle or orginalName is active, false otherwise

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

getJobLogDetails

java.util.List<java.lang.String> getJobLogDetails(java.lang.String jobHandle,
                                                  S7Config s7Config)

Returns a list of Scene7 asset handles(Strings) for the given job handle

Parameters:

jobHandle - - the handle for the job to get details.

s7Config -

Returns:

A list containing asset handles strings

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

getJobStatus

java.lang.String getJobStatus(S7Config s7Config,
                              java.lang.String jobName)

Get scene7 job status with given jobName, the jobName should be uniq, if there are many job have same name, it only get the first one

Parameters:

s7Config - the Scene7 configuration

jobName - the name of the job

Returns:

a string indicate the result, can be "NotFound", "Done" or a string returned by the S7 API, like "Running"

getImagePresets

java.util.List<java.lang.String> getImagePresets(S7Config s7Config)

Returns a list of Scene7 image preset names for the given S7Config

Parameters:

s7Config -

Returns:

a list containing the names of the image presets defined in SPS

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

getFlashTemplatesServer

@Deprecated
java.lang.String getFlashTemplatesServer(S7Config s7Config)

Deprecated.

Retrieves the server used for serving and manipulating flash templates, depending on the Scene7 configuration.

Parameters:

s7Config - the Scene7 configuration

Returns:

a String containing the server's URL

searchAssets

java.util.List<Scene7Asset> searchAssets(java.lang.String folder,
                                         java.lang.Boolean includeSubfolders,
                                         java.lang.Boolean published,
                                         java.lang.String[] assetTypes,
                                         java.lang.String[] assetSubTypes,
                                         java.lang.String[] responseFields,
                                         java.lang.String[] excludeFields,
                                         S7Config s7Config)

Retrieves a list of Scene7Assets from the Scene7 server.

Parameters:

folder - the folder from which the assets are retrieved

includeSubfolders - whether to recursively search for assets in sub-folders of the folder where the search is performed

published - whether the matched assets must be marked for publish (only marked - not necessarily actually published)

assetTypes - all matched assets will be one of these types

assetSubTypes - array of sub Asset Types to include in search

responseFields - the response fields that should be used to populate the Scene7Asset's attributes

excludeFields - fields to be excluded from the response

s7Config - the Scene7 configuration

Returns:

a List of assets; can be empty if no assets have been found

Throws:

java.lang.AssertionError - in case of IPS failures

searchAssets

java.util.List<Scene7Asset> searchAssets(java.lang.String folder,
                                         java.lang.Boolean includeSubfolders,
                                         java.lang.Boolean published,
                                         java.lang.String[] assetTypes,
                                         java.lang.String[] assetSubTypes,
                                         java.lang.String[] responseFields,
                                         java.lang.String[] excludeFields,
                                         int recordsPerPage,
                                         int resultsPage,
                                         S7Config s7Config)

Retrieves a list of Scene7Assets from the Scene7 server.

Parameters:

folder - the folder from which the assets are retrieved

includeSubfolders - whether to recursively search for assets in sub-folders of the folder where the search is performed

published - whether the matched assets must be marked for publish (only marked - not necessarily actually published)

assetTypes - all matched assets will be one of these types

assetSubTypes - array of sub Asset Types to include in search

responseFields - the response fields that should be used to populate the Scene7Asset's attributes

excludeFields - fields to be excluded from the response

recordsPerPage - maximum number of results to return

resultsPage - specifies the page of results to return, based on recordsPerPage page size

s7Config - the Scene7 configuration

Returns:

a List of assets; can be empty if no assets have been found

Throws:

java.lang.AssertionError - in case of IPS failures

searchAssetsByFilename

java.util.List<Scene7Asset> searchAssetsByFilename(java.lang.String folder,
                                                   java.lang.Boolean includeSubfolders,
                                                   java.lang.Boolean published,
                                                   java.lang.String filename,
                                                   S7Config s7Config)

Retrieve a list of Scene7Assets from the Scene7 server by filename.

Parameters:

folder -

includeSubfolders -

published -

filename -

s7Config -

Returns:

Throws:

java.lang.AssertionError - in case of IPS failures

searchAssetsByName

java.util.List<Scene7Asset> searchAssetsByName(java.lang.String folder,
                                               java.lang.Boolean includeSubfolders,
                                               java.lang.Boolean published,
                                               java.lang.String name,
                                               S7Config s7Config)

Retrieve a list of Scene7Assets from the Scene7 server by Scene7 asset name.

Parameters:

folder - remote search folder path

includeSubfolders - to include children folders

published - to include published or non-published assets

name - Scene7 name of target asset

s7Config - Scene7 cloud configuration

Throws:

java.lang.AssertionError - in case of IPS failures

searchAssetsByPartialName

java.util.List<Scene7Asset> searchAssetsByPartialName(java.lang.String folder,
                                                      java.lang.Boolean includeSubfolders,
                                                      java.lang.Boolean published,
                                                      java.lang.String name,
                                                      java.lang.String conditionMode,
                                                      S7Config s7Config)

Retrieve a list of Scene7Assets from the Scene7 server by Scene7 asset name with partial name search option

Parameters:

folder - remote search folder path

includeSubfolders - to include children folders

published - to include published or non-published assets

name - Scene7 name of target asset

conditionMode - partial name search condition mode. Currently supported modes are "Equals" and "StartsWith"

s7Config - Scene7 cloud configuration

Returns:

a list of Scene7Assets

getGeneratedAssets

Scene7Asset getGeneratedAssets(Scene7Asset asset,
                               S7Config s7Config)

Retrieves the generated assets associated with the given input asset

Parameters:

asset - - the asset to get the sub-assets and generator from

s7Config - - the Scene7 configuration

Returns:

the original Scene7Asset object updated with the sub-assets and the originator asset

Throws:

java.lang.AssertionError - in case of IPS failures

getAssociatedAssets

Scene7Asset getAssociatedAssets(Scene7Asset asset,
                                S7Config s7Config)

Retrieves the sub-assets and the origiator asset associated with the given asset

Parameters:

asset - - the asset to get the sub-assets and generator from

s7Config - - the Scene7 configuration

Returns:

the original Scene7Asset object updated with the sub-assets and the originator asset

Throws:

java.lang.AssertionError - in case of IPS failures

getMasterAsset

Scene7Asset getMasterAsset(Scene7Asset asset,
                           S7Config s7Config)

Retrieves the originator asset associated with the given asset

Parameters:

asset - - the asset to get the originator asset

s7Config - - the Scene7 configuration

Returns:

the original Scene7Asset object updated with the originator asset

Throws:

java.lang.AssertionError - in case of IPS failures

getFxgServer

@Deprecated
java.lang.String getFxgServer(S7Config s7Config)

Deprecated.

Retrieves the server handling FXG rendering. Deprecated and only return null now.

Parameters:

s7Config - the Scene7 configuration

Returns:

a String containing the FXG server URL

setAssetPublishState

java.lang.String setAssetPublishState(Resource resource,
                                      boolean markForPublish,
                                      S7Config s7Config)

Set the publish state of a given Scene7 asset

Parameters:

resource - activated resource

markForPublish - value of markForPublish flag

s7Config - the Scene7 configuration

Returns:

String success / failure

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

setAssetPublishState

java.lang.String setAssetPublishState(java.lang.String assetHandle,
                                      boolean markForPublish,
                                      S7Config s7Config)

Set the publish state of a given Scene7 asset

Parameters:

assetHandle - unique asset identifier

markForPublish - value of markForPublish flag

s7Config - the Scene7 configuration

Returns:

String success / failure

Throws:

java.lang.AssertionError - in case of IPS failures

setAssetsPublishState

java.lang.String setAssetsPublishState(java.util.Set<java.lang.String> assetHandles,
                                       boolean markForPublish,
                                       S7Config s7Config)

Set the publish state of a given Scene7 assets

Parameters:

assetHandles - asset identifiers to set publish state

markForPublish - value of markForPublish flag

s7Config - the Scene7 configuration

Returns:

String success / failure

Throws:

java.lang.AssertionError - in case of IPS failures

createFolder

java.lang.String createFolder(S7Config s7Config,
                              java.lang.String cqFolderPath)

Create a folder on Scene7 server

Parameters:

s7Config - the Scene7 configuration

cqFolderPath - the path the target cq folder targeted in the s7 folder organization

Returns:

folder handle

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

createImageSet

java.lang.String createImageSet(S7Config s7Config,
                                java.lang.String folder,
                                java.lang.String name,
                                java.lang.String type,
                                Resource resource,
                                java.lang.String thumbAssetHandle)

Create an ImageSet asset on Scene7 server

Parameters:

s7Config - the Scene7 configuration

folder - relative target folder based on S7 Config root folder. If not exists, will attempt to create it

name - name for new ImageSet

type - type of new ImageSet (ImageSet, SwatchSet, RenderSet)

resource - (optional) if exists, jcr resource to receive metadata from new object

thumbAssetHandle - (optional) asset handle of user-defined thumbnail image for set

Returns:

asset handle of newly created ImageSet, or null on error

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

createImageSet

@Deprecated
java.lang.String createImageSet(S7Config s7Config,
                                            java.lang.String imageSetFolder,
                                            java.lang.String imageSetName,
                                            java.lang.String thumbAssetHandle)

Deprecated. Use createImageSet(S7Config, String, String, String, Resource, String)

Create an ImageSet asset on Scene7 server

Parameters:

s7Config - the Scene7 configuration

imageSetFolder - the path the target imageset cq folder targeted in the s7 folder organization

imageSetName - name of the image set

thumbAssetHandle - (optional) user defined thumbnail asset handle

Returns:

asset handle of new image set

updateImageSet

void updateImageSet(S7Config s7Config,
                    java.lang.String assetHandle,
                    ImageSetMemberUpdateArray members,
                    java.lang.String thumbAssetHandle)

Update an ImageSet on Scene7 server

Parameters:

s7Config - the Scene7 configuration

assetHandle - asset handle of the ImageSet to update

members - (optional) list of ImageSet members (Null = not updated)

thumbAssetHandle - (optional) asset handle of user-defined thumbnail image for set (Null = not updated)

Throws:

java.lang.AssertionError - in case of IPS failures

updateImageSet

@Deprecated
void updateImageSet(S7Config s7Config,
                                java.lang.String imageSetAssetHandle,
                                java.util.List<java.lang.String> setMemberHandles,
                                java.lang.String thumbAssetHandle)

Deprecated. Use updateImageSet(S7Config, String, ImageSetMemberUpdateArray, String)

Update an ImageSet asset on Scene7 server

Parameters:

s7Config - the Scene7 configuration

imageSetAssetHandle - image set Scene7 asset handle

setMemberHandles - asset handles of image set members

thumbAssetHandle - (optional) user defined thumbnail asset handle

createAssetSet

java.lang.String createAssetSet(S7Config s7Config,
                                java.lang.String folder,
                                java.lang.String name,
                                java.lang.String type,
                                Resource resource,
                                Scene7AssetSet setDefinition,
                                java.lang.String thumbAssetHandle)

Create an AssetSet asset on Scene7 server

Parameters:

s7Config - the Scene7 configuration

folder - relative target folder based on S7 Config root folder. If not exists, will attempt to create it

name - name for new AssetSet

type - type of new AssetSet

resource - (optional) if exists, jcr resource to receive metadata from new object

setDefinition - (optional) set's definition string

thumbAssetHandle - (optional) asset handle of user-defined thumbnail image for set

Returns:

asset handle of newly created AssetSet, or null on error

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

updateAssetSet

void updateAssetSet(S7Config s7Config,
                    java.lang.String assetHandle,
                    Scene7AssetSet setDefinition,
                    java.lang.String thumbAssetHandle)

Update an AssetSet on Scene7 server

Parameters:

s7Config - the Scene7 configuration

assetHandle - asset handle of the AssetSet to update

setDefinition - (optional) set's definition string (Null = not updated)

thumbAssetHandle - (optional) asset handle of user-defined thumbnail image for set (Null = not updated)

Throws:

java.lang.AssertionError - in case of IPS failures

createViewerPreset

java.lang.String createViewerPreset(S7Config s7Config,
                                    java.lang.String folderHandle,
                                    java.lang.String name,
                                    java.lang.String type,
                                    Resource resource,
                                    java.util.List<Scene7ConfigSetting> configSettings)

Create a preset view to determine what users can see. The preset view is applied when assets are published.

Parameters:

s7Config - the Scene7 configuration

folderHandle - folder handle of the folder that contains the assets

name - name for the viewer

type - type of any available viewer in IPS

resource - (optional) if exists, jcr resource to receive metadata from new object

configSettings - (optional) list containing Scene7ConfigSetting values to apply

Returns:

viewer preset handle or null if unsuccessful

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

createViewerPreset

@Deprecated
java.lang.String createViewerPreset(S7Config s7Config,
                                                java.lang.String folderHandle,
                                                java.lang.String name,
                                                java.lang.String type,
                                                java.util.List<Scene7ConfigSetting> configSettings)

Deprecated. Use createViewerPreset(S7Config, String, String, String, Resource, List)

Create a preset view to determine what users can see. The preset view is applied when assets are published.

Parameters:

s7Config - the Scene7 configuration

folderHandle - folder handle of the folder that contains the assets

name - name for the viewer

type - type of any available viewer in IPS

configSettings - list containing Scene7ConfigSetting values to apply

Returns:

viewer preset handle or null if unsuccessful

getViewerConfigSettings

Scene7ViewerConfig getViewerConfigSettings(S7Config s7Config,
                                           java.lang.String assetHandle)

Get the viewer configuration for the referenced asset

Parameters:

s7Config - the Scene7 configuration

assetHandle - asset handle for the asset of interest

Returns:

Scene7ViewerConfig with the information or null if unsuccessful

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

setViewerConfigSettings

void setViewerConfigSettings(S7Config s7Config,
                             java.lang.String assetHandle,
                             java.lang.String name,
                             java.lang.String type,
                             java.util.List<Scene7ConfigSetting> configSettings)

Attach viewer configuration settings to an asset Can be viewer preset or the source asset for the viewer

Parameters:

s7Config - the Scene7 configuration

assetHandle - asset handle for the asset to modify

name - name of the asset

type - type of any available viewer in IPS

configSettings - list containing Scene7ConfigSetting values to apply

Throws:

java.lang.AssertionError - in case of IPS failures

updateViewerConfigSettings

void updateViewerConfigSettings(S7Config s7Config,
                                java.lang.String assetHandle,
                                java.util.List<Scene7ConfigSetting> configSettings)

Updates SWF viewer configuration settings.

Parameters:

s7Config - the Scene7 configuration

assetHandle - asset handle for the asset to modify

configSettings - list containing Scene7ConfigSetting values to apply

Throws:

java.lang.AssertionError - in case of IPS failures

addUser

java.lang.String addUser(S7Config s7Config,
                         java.lang.String firstName,
                         java.lang.String lastName,
                         java.lang.String email,
                         java.lang.String defaultRole,
                         java.lang.String password,
                         Instant passwordExpires,
                         boolean isValid,
                         java.util.List<Scene7CompanyMembership> membershipArray)

Creates a user account and adds the account to one of more companies

Parameters:

s7Config - The Scene7 configuration

firstName - The user's first name

lastName - The user's last name

email - The user's email address

defaultRole - The role for the user in the companies they belong, the IpsAdmin role overrides other per-company settings

password - The user's password

passwordExpires - The instant of expiration of the password

isValid - Determine the user's validity

membershipArray - List of Scene7CompanyMembership entries enumerating the membership of the user.

Returns:

The handle of the newly created user

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

getAllUsers

java.util.List<Scene7User> getAllUsers(S7Config s7Config,
                                       boolean includeInvalid)

Return all users

Parameters:

s7Config - The Scene7 configuration

includeInvalid - Indicate if invalid users should be included

Returns:

List containing Scene7User requested

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

getUsers

java.util.List<Scene7User> getUsers(S7Config s7Config,
                                    java.lang.Boolean includeInactive,
                                    java.lang.Boolean includeInvalid,
                                    java.util.List<java.lang.String> companyHandleArray,
                                    java.util.List<java.lang.String> groupHandleArray,
                                    java.util.List<java.lang.String> userRoleArray,
                                    java.lang.String charFilterField,
                                    java.lang.String charFilter,
                                    java.lang.String sortBy,
                                    java.lang.Integer recordsPerPage,
                                    java.lang.Integer resultsPage)

Return a optionally sorted, filtered and paged list user results

Parameters:

s7Config - The Scene7 config

includeInactive - Include or exclude inactive members

includeInvalid - Include or exclude invalid members

companyHandleArray - Filter results be company

groupHandleArray - Filter results by group

userRoleArray - Filter results by user role

charFilterField - Filter results by field's string prefix

charFilter - Filter results by a specific character

sortBy - Choice of user sort field

recordsPerPage - Number of records per page to return

resultsPage - The desired result page

Returns:

List containing Scene7User requested

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

setUserInfo

void setUserInfo(S7Config s7Config,
                 java.lang.String userHandle,
                 java.lang.String firstName,
                 java.lang.String lastName,
                 java.lang.String email,
                 java.lang.String defaultRole,
                 Instant passwordExpires,
                 boolean isValid,
                 java.util.List<Scene7CompanyMembership> membershipArray)

Set user attributes

Parameters:

s7Config - The Scene7 config

userHandle - User handle

firstName - First name

lastName - Last name

email - Email address

defaultRole - The role for the user in the companies they belong, the IpsAdmin role overrides other per-company settings

passwordExpires - The password's expiration

isValid - Determine if valid IPS user

membershipArray - List of Scene7CompanyMembership entries enumerating the membership of the user

Throws:

java.lang.AssertionError - in case of IPS failures

deleteImageFormat

java.lang.String deleteImageFormat(S7Config s7Config,
                                   java.lang.String imageFormatHandle)

Deletes an image format.

Parameters:

s7Config - The Scene7 config

imageFormatHandle - Handle to the image format. (This is returned from saveImageFormat(S7Config, String, String, String, Resource)

Returns:

String success

Throws:

java.lang.AssertionError - in case of IPS failures

getImageFormats

java.util.List<Scene7ImageFormat> getImageFormats(S7Config s7Config)

Returns image formats, such as PDF, EPS, SWF, and others.

Parameters:

s7Config - The Scene7 config

Returns:

A list of Scene7ImageFormat objects

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

saveImageFormat

java.lang.String saveImageFormat(S7Config s7Config,
                                 java.lang.String imageFormatHandle,
                                 java.lang.String name,
                                 java.lang.String urlModifier,
                                 Resource resource)

Create an image format.

Parameters:

s7Config - The Scene7 config

imageFormatHandle - Image format handle you want to save

name - Image format name

urlModifier - IPS protocol query string

resource - (optional) if exists, jcr resource to receive metadata from new object

Returns:

The imageFormatHandle

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

saveImageFormat

@Deprecated
java.lang.String saveImageFormat(S7Config s7Config,
                                             java.lang.String imageFormatHandle,
                                             java.lang.String name,
                                             java.lang.String urlModifier)

Deprecated. Use saveImageFormat(S7Config, String, String, String, Resource)

Create an image format.

Parameters:

s7Config - The Scene7 config

imageFormatHandle - Image format handle you want to save

name - Image format name

urlModifier - IPS protocol query string

Returns:

The imageFormatHandle

deleteImageMap

void deleteImageMap(S7Config s7Config,
                    java.lang.String imageMapHandle)

Deletes an image map

Parameters:

s7Config - The Scene7 config

imageMapHandle - Handle for the image map to delete

Throws:

java.lang.AssertionError - in case of IPS failures

saveImageMap

java.lang.String saveImageMap(S7Config s7Config,
                              java.lang.String assetHandle,
                              java.lang.String imageMapHandle,
                              java.lang.String name,
                              java.lang.String shapeType,
                              java.lang.String region,
                              java.lang.String action,
                              int position,
                              boolean enabled)

Create a new image map or edit an existing map

Parameters:

s7Config - The Scene7 config

assetHandle - Handle to the asset the map belongs to

imageMapHandle - Handle to the image map.

name - Name of the image map

shapeType - Choice of region shape

region - A comma delimited list of points that define the region

action - The href value associated with the image map

position - The order in the list of image maps

enabled - Whether this map is enabled

Returns:

The handle to the new or edited image map

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

setImageMaps

java.util.List<java.lang.String> setImageMaps(S7Config s7Config,
                                              java.lang.String assetHandle,
                                              java.util.List<Scene7ImageMapDefinition> imageMap)

Sets the image map for an asset. You must have already created the image maps. Image maps are applied in order of retrieval from the array. This means the second image map overlays the first, the third overlays the second, and so on.

Parameters:

s7Config - The Scene7 config

assetHandle - Handle to the asset

imageMap - list of predefined Scene7ImageMapDefinition objects

Returns:

list of image map handles applied to the asset

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

batchSetAssetMetadata

Scene7BatchMetadataResult batchSetAssetMetadata(S7Config s7Config,
                                                java.util.List<Scene7MetadataUpdate> updates)

Sets asset metadata using batch mode.

Parameters:

s7Config - The Scene7 config

updates - List of Scene7ImageFieldUpdate to be applied

Returns:

Scene7BatchMetadataResult containing details on any warnings or errors

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

batchSetImageFields

Scene7BatchMetadataResult batchSetImageFields(S7Config s7Config,
                                              java.util.List<Scene7ImageFieldUpdate> updateArray)

Sets asset metadata using batch mode.

Parameters:

s7Config - The Scene7 config

updateArray - List of Scene7ImageFieldUpdate to be applied

Returns:

Scene7BatchMetadataResult containing details on any warnings or errors

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

getPreviewServerUrl

java.lang.String getPreviewServerUrl(Resource resource,
                                     ResourceResolver configResolver)

Retrieves Scene7 remote asset preview /is/image/ URL (context path with image server uri). If resource is null, then returns DMS7 default S7Config preview URL

Parameters:

resource - Scene7 sync-ed asset in DAM

configResolver - resource resolver with access to S7Config object

Returns:

String Scene7 asset preview URL

getPublishServerUrl

java.lang.String getPublishServerUrl(Resource resource,
                                     ResourceResolver configResolver)

Retrieves Scene7 remote asset publish /is/image/ URL (server domain and image server uri). If resource is null, then returns DMS7 default S7Config publish URL

Parameters:

resource - Scene7 sync-ed asset in DAM

configResolver - resource resolver with access to S7Config object

Returns:

String Scene7 asset publish URL

getPreviewVideoServerUrl

java.lang.String getPreviewVideoServerUrl(Resource resource,
                                          ResourceResolver configResolver)

Retrieves Scene7 remote video preview /is/content/ URL (context path with image server uri). If resource is null, then returns DMS7 default S7Config preview URL

Parameters:

resource - Scene7 sync-ed asset in DAM

configResolver - resource resolver with access to S7Config object

Returns:

String Scene7 asset preview URL

getPublishVideoServerUrl

java.lang.String getPublishVideoServerUrl(Resource resource,
                                          ResourceResolver configResolver)

Retrieves Scene7 remote video publish /is/content/ URL (server domain and image server uri). If resource is null, then returns DMS7 default S7Config preview URL

Parameters:

resource - Scene7 sync-ed asset in DAM

configResolver - resource resolver with access to S7Config object

Returns:

String Scene7 asset publish URL

getS7AssetMetadata

java.util.Map<java.lang.String,java.lang.String> getS7AssetMetadata(S7Config s7Config,
                                                                    java.lang.String assetHandle)

Retrieves a metadata map (key-value pair) associated with a Scene7 asset

Parameters:

s7Config - The Scene7 cloud configuration object

assetHandle - Scene7 unique asset identifier

Returns:

Map key-value pairs metadata of Scene7 asset

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

getS7VideoRenditions

java.util.List<Scene7Asset> getS7VideoRenditions(S7Config s7Config,
                                                 java.lang.String assetHandle)

Retrieves a list of Scene7 video renditions with their names and asset handles

Parameters:

s7Config - The Scene7 cloud configuration object

assetHandle - Scene7 unique asset identifier

Returns:

List a list of Scene7Assets containing video rendition names and asset handles

Throws:

java.lang.AssertionError - in case of IPS failures or undefined data format

getScene7ID

java.lang.String getScene7ID(Resource resource)

Returns property dam:scene7ID of a given Resource object

Parameters:

resource - Resource object on which to get Scene7 metadata

Returns:

String value of dam:scene7ID associated to Resource or null if property is unavailable

isResourceLinkedToScene7

boolean isResourceLinkedToScene7(Resource resource)

Returns true if Resource object is linked to Scene7 based on its metadata

Parameters:

resource - Resource object on which to get Scene7 metadata

Returns:

true if Resource object has dam:scene7ID metadata

getLinkedScene7ConfigPath

java.lang.String getLinkedScene7ConfigPath(Resource resource)

Returns property dam:scene7CloudConfigPath of a given Resource object

Parameters:

resource - Resource object on which to get Scene7 metadata

Returns:

String value of dam:scene7CloudConfigPath associated to Resource or null if property is unavailable

getContainerAssets

java.util.List<Scene7Asset> getContainerAssets(Scene7Asset scene7Asset,
                                               S7Config s7Config)

moveAsset

boolean moveAsset(S7Config s7Config,
                  Resource resource,
                  java.lang.String folder)

Moves an asset to a specific folder

Parameters:

s7Config - Scene7 S7Config object

resource - Resource object to be relocated

folder - Destination folder path

Returns:

true/false of the moveAsset() operation succeeded

moveAssets

boolean moveAssets(S7Config s7Config,
                   java.util.Map<Resource,java.lang.String> resourcesToFolders)

Moves multiple assets independently of each other

Parameters:

s7Config - Scene7 S7Config object

resourcesToFolders - Mapping of AEM resource to destination folder

Returns:

true/false of the moveAssets() operation succeeded

moveFolder

boolean moveFolder(S7Config s7Config,
                   java.lang.String sourceFolder,
                   java.lang.String destinationFolder)

Move a folder to a new location

Parameters:

s7Config - Scene7 S7Config object

sourceFolder - Path to source folder

destinationFolder - Path to destination folder

Returns:

true/false of the moveFolder() operation succeeded

moveAssociatedAsset

boolean moveAssociatedAsset(S7Config s7Config,
                            Resource resource,
                            java.lang.String folder)

Finds and moves generated assets to a specific folder

Parameters:

s7Config - Scene7 S7Config object

resource - Resource object to be relocated

folder - Destination folder path

Returns:

true/false of the moveAssociatedAsset() operation succeeded

renameAsset

boolean renameAsset(S7Config s7Config,
                    Resource resource,
                    java.lang.String name)

Rename an asset

Parameters:

s7Config - Scene7 S7Config object

resource - Resource object to be renamed

name - Asset's new name

Returns:

true/false of the renameAsset() operation succeeded

renameFolder

boolean renameFolder(S7Config s7Config,
                     java.lang.String folder,
                     java.lang.String name)

Rename a folder

Parameters:

s7Config - Scene7 S7Config object

folder - Folder to be renamed

name - Folder's new name

Returns:

true/false of the renameFolder() operation succeeded

updateSmartCrops

boolean updateSmartCrops(S7Config s7Config,
                         java.util.Map<java.lang.String,java.util.Map<java.lang.String,Scene7NormalizedCropRect>> updateSmartCropMap)

Update one or more Smart Crop sub asset(s)

Parameters:

s7Config - Scene7 S7Config object

updateSmartCropMap - Map of owner handle, sub-asset asset handles and Scene7NormalizedCropRect objects

Returns:

true/false of the updateSmartCrops() operation succeeded

getXMPPacket

java.lang.String getXMPPacket(S7Config s7Config,
                              java.lang.String assetHandle)

Retrieves an XMP Metadata packet for the specified asset.

Parameters:

s7Config - the Scene7 configuration

assetHandle - Handle to the asset you want to get XMP metadata

Returns:

XMP metadata for the given assetHandle in XML format

updateXMPPacket

void updateXMPPacket(S7Config s7Config,
                     java.lang.String assetHandle,
                     java.lang.String xmpPacketAsXml)

Sets or updates an XMP metadata packet for an asset.

Parameters:

s7Config - the Scene7 configuration

assetHandle - Handle to the asset you want to get XMP metadata

xmpPacketAsXml - updated XMP packet to update asset metadata in XML format