Show TOC

Procedure documentationIntegrating Graphics into the Form Context Locate this document in the navigation structure

 

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 Note

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

End of the note.

Prerequisites

Any graphics that you want to display with the Graphic Content option must be stored in the MIME Repository. For more information about graphics used in Smart Forms, see Migrating BDS Graphics into MIME Repository.

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 ULR, 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)

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   Create   Graphic  .

  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: ADS is the system ID (SID) of the MIME Repository, the MIME Repository URL is http://ADSserver:8000/sap/bc/fp/graphics/public/graphics/bmaps/col/enjoy.bmp

        Define the following target: Dest:FP_ICF_DATA_ADS//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 graphics must be in the MIME Repository.

  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 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.

      End of the note.

    • 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’.

  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 in 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

    Graphic URL: http://www.anycompany.com/images/logo.gif

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

  • Specifying the URL by Using Fields

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

    GRAFIK_NAME is a form interface field defined 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.