Show TOC

Integrating Graphics into the Form ContextLocate this document in the navigation structure

Prerequisites

If you want to use the graphic reference with the MIME Repository, you must perform a special authorization to access the MIME Repository. To access the MIME Repository using URL, you must create an authorization object. You have the following options:

  • Create anonymous access for the ICF fp service :

    Extend the user role of ADS_AGENT by the following authorization:

    Authorization Object : S_DEVELOP

    Activity : display (3)

    Object Type : SMIM

    Assign ADS_AGENT to ICF fp service .

    Call T-code SICF, default_host -> sap -> bc -> fp .

    Display this fp service and select the Logon Data tab page.

    Specify the ADS_AGENT user information in the Logon Data field.

  • Create secure access using the HTTP Destination Service (recommended)

Context

You can use graphic nodes in the form context to output graphics, such as a company logo, in forms.

If you are using Adobe LiveCycle Designer to create the form layout, you can attach graphic nodes to an object of type Image Field . You use the graphic node to specify where the content of the image comes from at runtime. To do this, you either specify the URL address of an image or the name of a field in which the image content is specified in binary code at runtime.

Note

For information about the supported file formats for images, see the documentation for image fields in the online help for Adobe LiveCycle Designer .

Procedure


  1. Select the node in the context under which you want to create a graphic node.

  2. Call the context menu for the node and choose Start of the navigation path Create Next navigation step Graphic End of the navigation path.

  3. In the properties of the graphic node, set the Graphic Type . You have the following options:

    • Graphic Reference

      Choose this option if you want to insert a graphic from its address (URL). The URL can point to a Web server or to a file system. You must be able to access the graphic at the specified URL. This means that you may have to configure appropriate access rights for Adobe Document Services (ADS).

      If the graphics are saved in the MIME Repository, you have the following options (prerequisites are described above):

      • If you choose anonymous access using ICF fp service , you must define the URL for the MIME Repository.

      • If you use the HTTP Destination Service, you must define a special format for the graphic URL.

        Dest:FP_ICF_DATA_<SID>//<sub URL for MIME repository URL>

        Example: The MIME Repository URL for an example graphic is http://<server>:<port>/sap/bc/fp/graphics/public/graphics/bmaps/col/enjoy.bmp

        Define the following target: Dest:FP_ICF_DATA_<SID>//sap/bc/fp/graphics/public/graphics/bmaps/col/enjoy.bmp

    • Graphic Content

      Choose this option if you want to specify graphic content using a field. This field contains all image information at runtime. The graphic content is assigned to the field in the print program. You can use graphics from the MIME Repository or from the file system. It is important that the files are accessible at runtime.

  4. Depending on the selection you made in the last step, enter the required data:

    • If you have chosen Graphic Reference as your graphic type, enter the URL of the graphic.

      Note

      In Adobe LiveCycle Designer , you can choose whether the system gets the graphic at runtime, or whether the graphic is embedded in the form. For more information, see the online help for Adobe LiveCycle Designer .

    • If you have specified Graphic Content as your graphic type, you must do the following:

      • In Field , enter a field name from the interface. The field must have the type STRING (graphical data is Base64-coded) or XSTRING (for binary-coded graphical data).

      • Enter a valid MIME Type , such as 'image/bmp' or 'image/jpeg' .

  5. Under Conditions, enter the prerequisites that need to be met before the graphic node is processed at runtime and output in the form.

    More information: Defining Form Logic in the Form Context

Example

You want to insert a graphic from the Web site of the fictitious company AnyCompany into your form. You have chosen Graphic Reference as your graphic type. The example shows you two ways of specifying the URL.

Specifying a URL with Fixed Values

If you have inserted the graphic node in Adobe LiveCycle Designer, the following URL is entered for the graphic object:

Graphic URL

Delimiter

'http://www.anycompany.com/images/logo.gif'

-
Specifying the URL by Using Fields

GRAPHIC_NAME is a field from the interface that is entered as an import parameter. At runtime, it contains the name of the graphic that you want to load. The graphic is not known when the layout is created. Therefore, no URL is displayed in Adobe LiveCycle Designer.

The URL is constructed from the elements in the table and provided at runtime. The table shows the specifications from the Form Builder:

Graphic URL

Delimiter

'http://www.anycompany.com/images'

/

GRAPHIC_NAME

-

'.gif'

-

Graphic URL at runtime: http://www.anycompany.com/images/GRAPHIC_NAME.gif