In order to import repository assets into versioned repositories, you must configure a VersionedLoaderEventListener, whose tasks include creating and checking in the workspace that is used during the import. You create a VersionedLoaderEventListener component from this class:

atg.epub.loader.VersionedLoaderEventListener

VersionedLoaderEventListener properties

The following table describes VersionedLoaderEventListener properties:

Property

Description

appendTimeToProcessName

Set to true in order to append the import time to the name of the project created and used for the import.

Default: true

checkinOnCompletion

Set to true if the workspace (and its assets) should be checked in. Otherwise, false.

If the workspaceName property is set to the name of an existing workspace—typically, an active project’s workspace—the Repository Loader blocks the check-in no matter how this property is set. If a project’s workspace is checked in while the project itself remains active, various problems result. For example, users cannot complete or delete the project, or view imported assets in the project.

Default: true

createProjects

Set to true in order to create a project and import assets into it. If set to true, the Repository Loader creates a project for importing file assets, under the name specified by properties processNamePrefix and timeFormat.

Default: false

password

Password of the user to authenticate.

Default: admin

personaPrefix

The substring in an ACL that is used to identify the user in the UserAuthority, set as follows:

Admin$user$: The user who performs the import is using an ACC account.

Profile$login$: The user who performs the import is using an ATG Business Control Center account.

Default: Admin$user$

processDescription

An arbitrary string.

Default: Imported by the RepositoryLoader

processNamePrefix

Together with timeFormat, specifies the name of the project used if createProjects is set to true.

Default: Content Administration Import

rootPath

The fully qualified path of the parent folder of the top-level folder in the manifest to import, or the folder system to scan. All folders and files to import must be in or under this root folder.

For example, you might set rootPath to /users/joe/import and import the following files via an automatic import:

/users/joe/import/file1
/users/joe/import/dir/file2
/users/joe/import/dir/dir2/file3

The directories and files imported into the PublishingFileRepository are as follows (specified from the repository’s root):

/file1
/dir/file2
/dir/dir2/file3

Note 1: When performing imports on Windows, use double backslashes (\\)as path separators. For example:

C:\\ATG\\ATG9.4\\MyProductionModule\\config

Note 2: When importing the initial set of ATG assets from your production module, such as scenarios and slots, the root path is the production module’s config directory, which contains the ATG assets.

timeFormat

The format to use when appending the import time to the name of project used for the import. The default format is:

MMMMM dd, yyyy hh:mm:ss aaa

For information on changing the default value, see the API reference for class java.text.SimpleDateFormat.

userAuthority

The userAuthority that resolves the user specified in the username property.

Default: /atg/dynamo/security/UserAuthority

userName

The username of the user to authenticate.

Default: admin

workFlowName

Default: /Content Administration/CA.wdl

workspaceName

The name of the workspace to use for the import. If the corresponding workspace does not exist, it is created by the system.

All workspace names must be unique. The import fails if the name corresponds to a completed project’s workspace (because it is already checked in).

If createProjects is set to false (the default), the system creates a workspace for the import. If the workspaceName property is not set (the default), the system creates a workspace name from the IdGenerator; otherwise, it uses the name specified in this property.

If createProjects is set to true, the system ignores this property and creates a project for the import.

Project properties

After you initialize a target site, the Repository Loader must import assets into a project. In order to do so, set the VersionedLoaderEventListener’s createProjects property to true. When you run the Repository Loader on these assets, it performs these tasks:

User access configuration

The properties userAuthority, personaPrefix, userName, and password collectively verify user access to the secured versioned repository where file assets are imported—for example, /atg/epub/file/SecuredPublishingFileRepository.

Default configuration

By default, the VersionedLoaderEventListener is configured as follows:

$class=atg.epub.loader.VersionedLoaderEventListener

versionManager=/atg/epub/version/VersionManagerService

rootPath={appModuleResource?moduleID=home&resourceURI=}

createProjects=false
projectNamePrefix=Content Administration Import
appendTimeToProjectName=true
projectDescription=Imported by the RepositoryLoader
timeFormat=MMMMM dd, yyyy hh:mm:ss aaa

workflowName=/Content Administration/CA.wdl
userAuthority=/atg/dynamo/security/UserAuthority
personaPrefix=Admin$user$
userName=admin
password=admin

checkinOnCompletion=true
checkinComment=

idGenerator=/atg/dynamo/service/IdGenerator
workspaceNameIdSpace=repositoryLoaderWkspName
#workspaceName=RepLoader-1
 
loading table of contents...