Migrating Smart Forms

Use

You want to migrate a Smart Form into a PDF-based form.

Prerequisites

All graphics that are used in the Smart Form have already been migrated. For more information, see Migrating BDS Graphics into the MIME Repository.

Procedure

       1.      Go to the Smart Forms initial screen (transaction SMARTFORMS).

       2.      Choose Utilities ® Migration ® PDF-Based Form ® Export.

       3.      In the dialog box, enter the name of the Smart Form that you want to migrate, the name of the PDF-based target form, and the target interface. The system suggests the name of the Smart Form as the name for the target form and target interface. You can change these names. The target form and the target interface can have different names.

       4.      Choose Continue.

       5.      The system displays the Settings dialog box where you can flag various options for migration. To activate the selected options and close the dialog box, choose Continue.

To view additional information about a particular option, select the option, and press F1.

       6.      In the dialog box Create Object Directory Entry, enter a package for the interface, or save it as a local object.

       7.      Assign the form to a package, or save the form as a local object.

       8.      The system migrates the form.

Result

Error-Free Migration

If the form was migrated without errors, the system returns a corresponding message. You now have a PDF-based form (consisting of a form and interface) that you can edit.

Initially, migrated forms and interfaces are always inactive and therefore have to be activated before a call can be made from the application.

Activating or Editing a PDF-Based Form

To activate or edit the form, choose Utilities ® Migration ® PDF-Based Form ® Edit. The system displays the initial screen of the form builder for PDF-based forms.

For more information about editing a PDF-based form, see PDF-Based Forms.

Switching Runtime

To call the PDF-based form from the application without changes to the ABAP program and formal parameters, proceed as follows:

...

       1.      Choose Utilities ® Migration ® PDF-Based Form ® Switch Runtime.

       2.      In the dialog box Switch Runtime, enter the name of the Smart Form and the name of the PDF-based form. In the Runtime Type field, select the form that you want to output at runtime.

       3.      If the PDF form is assigned to a transportable package, you have to assign the runtime switch to a transport request. If this is the case, the system automatically displays a corresponding dialog box.

Migration with Errors or Warnings

If errors or warnings occurred during migration, and the Smart Form was migrated only partially or not at all, a log is displayed. This log is written to the application log and is kept in the system for a week.

To display the log within this time period, choose Utilities ® Migration ® PDF-Based Form ® Display Log.

A log is generated for each migration run. If you migrate a Smart Form more than once, you receive multiple logs. Select a log to see the list of the properties that were not or only partially migrated. Every message in the log begins with the node name from the Smart Form. This enables you to identify the source of the error in the Smart Form.

See also:

Notes About Migrating Smart Forms