Entering Documentation

When modifying forms, you must know the meaning of windows and text elements. Of special importance is the description of program symbols, their meanings and availabilites. As the creator of a form, you are responsible for maintaining these data in the form documentation. Make sure to describe also those program symbols that are not used in the standard version, but that contain values that may be important when modifying the form.

Format of the Form Documentation

To enter form documentation, on the Form: Request screen

  1. Mark Documentation.
  2. Choose Create.

Depending on whether you are working in edit or display mode, you can either create or change the documentation or simply read it.

If you create documentation, the system automatically generates a template for the specified form as a model. This template contains read-only lines that represent certain sections. You can now enter documentation for each of these sections..

The read-only lines represent the different objects of a form (general information, pages, windows, and text elements). Each object begins with a key word followed by the corresponding name. The general section starts with FORM, followed by the form name. Then follow the different pages (key word PAGE), each one with its name. The system then lists the windows (ley word WINDOW) and finally the text elements (key word ELEMENT).

The names of text elements are unique only within one window, not within the entire form. Therefore, the system displays the text elements in the form documentation as a combination: window name-text element. As a proposal for the documentation of these objects, the system enters the short texts (description of the form, the pages, and the windows) into the input-enabled screen part. You can now add any relevant information.

Automatically Adjusting the Form Documentation

If a form documentation exists and you enhance the form (new pages, windows, or text elements), the system automatically adds these new objects to the form documentation when you save the form. You can then enter the appropriate documentation for these objects as described before.

If you delete pages, windows, or text elements of a form, the system does not delete the exising documentation, but flags it as no longer needed (‘*’ in front of the corresponding key word). If you create an object with the same name at a later time, the system deletes the flag, thus preserving the documentation. No longer needed objects always appear at the end of the objects list, but in the same sequence as before (general, pages, windows, text elements).

Deleting no Longer Needed Sections

You can delete documentation for objects you no longer need (see above). On the Form: Request screen, choose Utilities ® Documentation ® Clean up. The system then deletes all sections that are flagged as no longer needed ( ‘*’ in front of the key word). It also deletes all read-only lines for which no documentation (0 lines) exists.

To delete the entire form documentation, on the Form: Request screen choose Utilities ® Documentation ® Delete.

Printing the Form Documentation

To print the form documentation, choose Utilities ® Documentation ® Print. The system prints only those objects that are actually documented.

Storage and Transport

The system stores the form documentation in the form itself. This ensures that the documentation is language-dependent and takes part in the transport.

Translation

The form documentation is linked to the form translation. Choose Window texts and documentation. The list created contains the individual windows and, at the end, the Documentation, if it exists. The documentation can be translated there.

The subdivision into objects (general, pages, windows, text elements) contains both original and target language. This corresponds to the translation of text elements. There is no status administration for translated objects (new, edited, complete). Therefore, the system asks whether the documentation-if any-was translated completely when you release the form.