|
Spaces store content in organized groups. A
space
is
essentially a folder that stores content such as PDF or XML documents,
images, audio, videos, and so on. You can create new spaces by using
the Document Management Java or web service API (Deprecated). For
example, you can create a space named
Test Directory
, as
shown in the following illustration.
The web service quick starts that correspond to the Document
Management service use the following WSDL:
http://localhost:8080/soap/services/DocumentManagementService?WSDL&lc_version=9.0.1
For information about the Document Management service, see
Services Reference for LiveCycle
.
Note:
Adobe is migrating Content Services ES customers
to the Content Repository built on the modern, modular CRX architecture,
acquired during the Adobe acquisition of Day Software. The Content
Repository is provided with LiveCycle Foundation and is available
as of the LiveCycle ES4 release.
Summary of steps
To create a space, follow these steps:
-
Include project files.
-
Create the service client.
-
Define the space name.
Include project files
Include the necessary files in your development
project. If you are using Java to create a client application, include
the necessary JAR files. If you are using web services, include
the proxy files.
Add the following JAR files to your project’s
class path:
-
adobe-livecycle-client.jar
-
adobe-usermanager-client.jar
-
adobe-contentservices-client.jar
-
adobe-utilities.jar (required if LiveCycle is deployed on
JBoss)
-
jbossall-client.jar (required if LiveCycle is deployed on
JBoss)
Note:
These JAR files are required
if you are using the EJB connection mode. If you are using the SOAP
connection mode, include additional JAR files.
Create the service client
Before you can programmatically create
a space, establish a connection and provide credentials. This task
is accomplished by creating a service client, which is based on
the LiveCycle service named
Document Management
.
Define the space name
Invoke the Document Management service’s
createSpace
method
to create a space. Specify the name of the new space and the store
name. The default value for this parameter is
SpacesStore
.
Create Content Services (deprecated) spaces using the Java API
Create a space by using the Document Management Service
API (Java):
-
Include project files.
Include client JAR files,
such as adobe-contentservices-client.jar, in your Java project’s
class path.
-
Create the service client.
-
Define the space name.
Create a Content Services (deprecated)
space by invoking the
DocumentManagementServiceClientImpl
object’s
createSpace
method
and passing the following values:
-
A string value that
specifies the name of the store where the space is created. You
can specify
SpacesStore
for this parameter value.
This value is a mandatory parameter.
-
A string value that specifies the fully qualified path of
the new space (for example,
/Company Home/Test Directory
).
This value is a mandatory parameter.
The
createSpace
method
returns a string value that specifies the identifier value of the
new space. This identifier value is in a GUID format, such as
556acef7-8478-46d9-bdd6-ea955d21d617
.
Create Content Services (deprecated) spaces using the web service API
Create a space by using the Document Management Service
API (web service):
-
Include project files.
Create a Microsoft .NET
project that uses MTOM. Ensure that you use the following WSDL definition:
http://localhost:8080/soap/services/DocumentManagementService?WSDL&lc_version=9.0.1
.
Note:
Replace
localhost
with the IP
address of the server hosting LiveCycle.
-
Create the service client.
-
Create a
DocumentManagementServiceClient
object
by using its default constructor.
-
Create an
DocumentManagementServiceClient.Endpoint.Address
object
by using the
System.ServiceModel.EndpointAddress
constructor.
Pass a string value that specifies the WSDL to the LiveCycle service
(for example,
http://localhost:8080/soap/services/DocumentManagementService?WSDL
).
It is not necessary to use the
lc_version
attribute.
This attribute is used when you create a service reference.
-
Create a
System.ServiceModel.BasicHttpBinding
object
by getting the value of the
DocumentManagementServiceClient.Endpoint.Binding
field.
Cast the return value to
BasicHttpBinding
.
-
Set the
System.ServiceModel.BasicHttpBinding
object’s
MessageEncoding
field
to
WSMessageEncoding.Mtom
. This value ensures that
MTOM is used.
-
Enable basic HTTP authentication by performing the following
tasks:
-
Assign the AEM forms user name to the field
DocumentManagementServiceClient.ClientCredentials.UserName.UserName
.
-
Assign the corresponding password value to the field
DocumentManagementServiceClient.ClientCredentials.UserName.Password
.
-
Assign the constant value
HttpClientCredentialType.Basic
to the
field
BasicHttpBindingSecurity.Transport.ClientCredentialType
.
-
Assign the constant value
BasicHttpSecurityMode.TransportCredentialOnly
to
the field
BasicHttpBindingSecurity.Security.Mode
.
-
Define the space name.
Create a Content Services (deprecated)
space by invoking the
DocumentManagementServiceClient
object’s
createSpace
method
and passing the following values:
-
A string value
that specifies the name of the store where the space is created.
You can specify
SpacesStore
for this parameter
value. This value is a mandatory parameter.
-
A string value that specifies the fully qualified path of
the new space (for example,
/Company Home/Test Directory
).
This value is a mandatory parameter.
The
createSpace
method
returns a string value that specifies the identifier value of the
new space. This identifier value is in a GUID format, such as 556acef7-8478-46d9-bdd6-ea955d21d617.
|
|
|
