Performs tasks such as determining whether the caller has
permission to invoke the specified service operation. The invocation
request must contain a valid LiveCycle user name and password.
are different ways to send an invocation request to a service. As
well, there are different ways to send required input values to
the service. For example, assume that you use the Java API to invoke
a service that requires a PDF document. The corresponding Java method
contains a parameter that accepts a PDF document. In this situation,
the data type of the parameter is com.adobe.idp.Document.
(See Passing data to LiveCycle services using the Java API.)
you invoke a service using watched folders, then an invocation request
is sent when you place a file in a configured watched folder. If
you invoke a service using e-mail, then an invocation request is
sent to a service when an e-mail message arrives in a configured
The service container sends back an invocation response
once the operation is performed. An invocation response contains
information such as the operation results. For example, if the operation
modifies a PDF document, then the invocation response contains the
modified PDF document. If the operation was unsuccessful, then the
invocation response contains an error message.
response can be retrieved in the same way in which an invocation
request is sent. That is, if the invocation request is sent using
the Java API, then an invocation response can be retrieved using
the Java API. Assume, for example, that an operation modifies a
PDF document. You can retrieve the modified PDF document by getting
the return value of the Java method that invoked the service.
a long-lived process is invoked, an invocation response contains
an identifier value that is associated with the invocation request.
Using this identifier value, you can check the status of the process
at a later time. For example, consider the MortgageLoan long-lived
service. Using the identifier value, you can check to determine
whether the process successfully completed. (See Invoking Human-Centric Long-Lived Processes.)
diagram shows a client application (that uses the Java API) invoking
When a client application invokes a service, three
A client application sends an invocation
request to a service.
The service performs the operation that is specified in the
The service container returns an invocation response to the