close

Filter

loading table of contents...

Content Server Manual / Version 2401

Table Of Contents

3.13.2.9 Groovy Shell

Caution

Deprecation Notice

As of CoreMedia Content Cloud 2004.1 groovysh is deprecated. Use cm jshell instead. For details see Section 3.13.2.8, “JShell”.

With the groovysh utility program, you can interactively access the Content Server, using Unified API commands. The Groovy Shell is a third-party tool maintained by the Groovy community. See http://groovy-lang.org/groovysh.html for details

Before you can start the Groovy Shell, copy the file apps/content-server/modules/cmd-tools/cms-tools-application/target/cms-tools/bin/groovysh.profile into your home directory as .groovy/groovysh.profile. This file defines the login parameter (username, password, IOR URL for the Content Server and creates connections to the Unified API repositories. Adjust the iorUrl property to the corresponding URL of the Content Server. The profile defines some variables, which you can use to work with the repositories.

Variable name Calls Description of return type

connection

Cap.connect(params)

CapConnection, the connection to the Content Server

cr

connection.getContentRepository();

ContentRepository, the content repository.

root

cr.getRoot()

Content, the root folder of the content repository.

ac

cr.getAccessControl()

AccessControl, all access control aspects of content.

pu

cr.getPublicationService()

PublicationService, all publication aspects of content.

qs

cr.getQueryService()

QueryService, query aspects of content. Allows making structured queries against the content repository.

ur

connection.getUserRepository()

UserRepository, gives access to users and groups.

wr

connection.getWorkflowRepository()

WorkflowRepository, gives access to workflows.

Table 3.32.  Variables for Groovy Shell


You can either start the Groovy Shell as a command line client (default) or the Groovy Console which offers a GUI. In order to start the Groovy Console, open the groovysh.jpif file and assign the groovy.ui.Console class to the JAVA_MAIN_CLASS property. The Groovy Console does not load the content from the profile file. So, copy the content of the profile file into the console and execute the script to set the required variables.

The program is executed with:

modules/cmd-tools/cms-tools-application/target/cms-tools/bin/cm groovysh

The shell is now active or the console opens and you can enter your UAPI commands. Find the UAPI Javadoc at https://documentation.coremedia.com/cmcc-12 following the CMS Javadoc link.

Get, for example, the user named "Rick":

ur.getUserByName('Rick')
Result of a command in Groovy Shell

Figure 3.1.  Result of a command in Groovy Shell


Search Results

Table Of Contents
warning

Your Internet Explorer is no longer supported.

Please use Mozilla Firefox, Google Chrome, or Microsoft Edge.