|
You can programmatically remove an application by using
the Java and web service API. Because all applications are visible
to others who use the forms server, you should exercise caution
before you remove an application.
Note:
The name of the service that is invoked when
removing an application is ApplicationManager. Therefore, to create
a proxy object that lets you invoke its operations by using a web
service, specify the following WSDL definition:
http://localhost:8080/soap/services/ApplicationManager?WSDL
.
(See
Invoking LiveCycle using Web Services
.)
Summary of steps
To remove an application, perform the following tasks:
-
Include project files.
-
Create an ApplicationManager Client API object.
-
Locate the application to remove.
-
Remove the application.
Include project files
Include the necessary files into your development
project. If you are creating a client application by using Java,
include the necessary JAR files. If you are using web services,
make sure you include the proxy files.
Create an ApplicationManager Client API object.
To remove an
application, create an
ApplicationManager
object.
Locate the application to remove
Obtain the identifier of the
application to remove. If you do not know the identifier value,
you can retrieve all applications and search by name. Using the application
name, you can obtain the identifier value that corresponds to the application
you want to remove.
Remove the application
You can remove an application by using
its identifier value.
Remove an application using the Java API
Remove a LiveCycle application by using the Application
Manager API (Java):
-
Include project files
Include client JAR files,
such as adobe-livecycle-client.jar, in your Java project’s class
path.
-
Create an ApplicationManager Client API object.
-
Create a
ServiceClientFactory
object that
contains connection properties. (See
Setting connection properties
.)
-
Create an
ApplicationManager
object by invoking
its constructor and passing the
ServiceClientFactory
object
that contains connection properties.
-
Locate the application to remove
-
Retrieve
all applications by invoking the
ApplicationManager
object’s
getApplications
method.
This method returns a
java.util.List
object where
each element is an
Application
object.
-
Iterate through the list by casting each element to an
Application
object.
-
Create an
ApplicationId
object by invoking
the
Application
object’s
getApplicationId
method.
-
Get the application name by invoking the
ApplicationId
object’s
getApplicationName
method.
This method returns a string value that specifies the application
name. If the application name corresponds to the application that
you want to remove, you can use the
ApplicationId
object
to remove the application.
-
Remove the application
After you locate the application
to remove, invoke the
ApplicationManager
object’s
removeApplication
method
and pass the
ApplicationId
object that represents
the application to remove.
Remove an application using the web service API
Remove a LiveCycle application by using the Application
Manager API (web service):
-
Include project files
-
Create an ApplicationManager Client API object.
-
Using the Microsoft .NET client assembly, create an
ApplicationManagerService
object
by invoking its default constructor.
-
Set the
ApplicationManagerService
object’s
Credentials
data member
with a
System.Net.NetworkCredential
value that specifies
the user name and password value.
-
Locate the application to remove
-
Retrieve
all applications by invoking the
ApplicationManagerService
object’s
getApplications
method.
This method returns an array of
Objects
where each
element is a
Application
object that represents
an application.
-
Iterate through the array by casting each element to an
Application
object.
-
Create an
ApplicationId
object by getting
the value of the
Application
object’s
applicationId
data
member.
-
Get the application name by getting the value of the
ApplicationId
object’s
applicationName
data
member. If the application name corresponds to the application that
you want to remove, you can use the
ApplicationId
object
to remove the application.
-
Remove the application
After you locate the application
to remove, invoke the
ApplicationManager
object’s
removeApplication
method
and pass the
ApplicationId
object that represents
the application to remove.
|
|
|
