Show TOC

 Configuring AdaptersLocate this document in the navigation structure

Use

In Guided Procedures (GP), you can transfer forms in two ways:

  • Using a synchronous connection

    The form is transferred through the HTTP protocol. This enables the user to submit data back to the GP framework using a Servlet on the GP side that receives the data and sends it for further processing.

    More information: Enabling Form Submission Using HTTP

  • Using an asynchronous connection

    The form can initially be accessed through the HTTP protocol. After the form is processed, it is sent back to a recipient's mailbox as an e-mail attachment.

    More information: Enabling Form Submission Using SMTP

If you want to edit your form in offline mode, you use an asynchronous connection. To do this, you configure the adapter communication data. An adapter is a module ensuring the connection between the GP framework and the service that provides the form (such as ADS).

You can use more than one communication connection setting of an adapter at the same time for different composite forms.

Procedure
  1. In the portal, navigate to Administration  → Composite Forms  → Configure Adapters.
  2. In the list of available adapters, make sure you select the template.PDF adapter based on Java for composite forms.

If you are using interactive forms migrated from SAP NetWeaver 7.0 to SAP Composition Environment, you may also see adapter.adobe in the adapter list. This adapter can have only one active communication connection setting and it is used by all interactive forms.

  1. To specify connection properties, create a new entry or modify an existing one.

    Set the following parameters:

Overview of Adapter Parameters for Forms

Parameter Description

Name

Enter a unique name for the communication connection setting.

Note

To edit the name of a communication setting, it should not be used by a callable object or composite form.

Protocol

Choose between the following e-mail protocols:

  • imap4.
  • pop3.

Server

Enter the mail server to receive the form.

Folder Name

Enter the target folder of your e-mail program, such as Test folder .

User name

Enter the username of the mailbox account.

Password

Enter the account password.

Confirm

Confirm the account password.

Client

Enter the name part of your e-mail address, that is, everything that comes before the at sign (@).

Tip

john.smith

Domain

Enter the domain part of your e-mail address, that is, everything following the at sign (@).

Tip

@company.com
  1. To use a communication setting as the default for all composite forms, select it in the Default column.

If you have selected the adapter.adobe from the adapter list, the Name and Default columns are not visible because you can choose only one communication setting from the communication settings list that is used by all interactive forms. Using multiple communication settings at the same time is only supported by the template.PDF adapter based on Java for composite forms.

  1. To initiate a communication connection, choose Start.
  2. To view the current status of the connection, choose Refresh.
  3. You can delete an entry by choosing Delete.
    Note

    You cannot delete a communication setting that is the default one or is in use by a callable object or a composite form.

More Information

Creating and Configuring Forms

Exposing Composite Forms as Callable Objects