SAP ABAP IMG Activity /IPRO/MGT_ELMNT (Define Elements)
Hierarchy
SAP_BS_FND (Software Component) SAP Business Suite Foundation
   CA-GTF-DOB (Application Component) Document Builder
     /IPRO/BASIS (Package) Tables, Structures, general Infrastruktur
IMG Activity
ID /IPRO/MGT_ELMNT Define Elements  
Transaction Code /IPRO/17000016   (empty) 
Created on 20040302    
Customizing Attributes /IPRO/MGT_ELMNT   Define Elements 
Customizing Activity /IPRO/MGT_ELMNT   Define Elements 
Document
Document Class SIMG   Hypertext: Object Class - Class to which a document belongs.
Document Name /IPRO/MGT_ELMNT    

Use

In this step you define standard elements, as well as alternate elements. Elements refer to clauses, forms, reports, and header/footer clauses. You can create elements either in HTML or in WordML.

Standard elements are globally available to all authors, whereas alternate elements contain different wording and business meaning than the standard element to which it is assigned.

Standard elements are selected on the basis of responses in the dialog process and of default values in the relevant document selection.

Note

Due to the high volume of entries, we strongly recommend that you first plan a naming convention, which assists you in maintaining correct element ordering in the generated document. Naming conventions are also useful for easy maintenance and retrieval. Elements are ordered within groupings in the section of a document. You define element ordering in the Customizing activity Define Ordering.

To find an element by ID, text, reference, or reference text, choose Search clauses in the toolbar.

Requirements

You must have performed the following activities:

Note

To create elements in WordML (in other words, using Microsoft Word), you must:

Install Microsoft Word 2003 Professional, Service Pack 2.

Install and register the Developer Support Office Framer Control ActiveX, which is available on the Microsoft website. This ActiveX is used as a container for Microsoft Office documents within SAP Document Builder.

Configure your web browser for ActiveX support.

Standard settings

Activities

To create (standard or alternate) elements:

  1. Choose Standard Elements in the dialog structure.
  2. Choose New Entries.
  3. Enter an identifier and assign the element to the corresponding regulation set.
  4. Select a content modifier if applicable.
  5. Enter the effective date. Using effective dates allows you to have one or more copies of the same element within a given regulation set.
  6. Check the version number. The version number must be '0' (active). If not, you must convert all elements.
  7. Specify the element type.
  8. Assign the element to the corresponding rule.
  9. Set the indicator Editable if you want to allow changes to the element. This setting enables authors to convert a standard element to a custom element.
  10. Specify the output type, that is, an output definition for this element in order to properly assemble this element in a document. This is a technical step, used for non-HTML elements, that should be completed by a technically skilled person. This field refers to an output definition for rendering the element. For standard elements such as clauses, stored in HTML format, you do not have to maintain the Output Type field since the HTML renderer is known. However, this does not apply to a non-HTML form or report. For example, to set up a form, you must first build it using Adobe LiveCylce Designer (Document Builder fields are set up on the form.), define an output definition for this form identifying the renderer and create a standard element in SAP Document Builder for this form. While creating the element an association to the output type from the previous step is made. This output type in turn is linked to a BAdI implementation using the Generic Output Interface BadI.
  11. Specify the element status. The status determines whether an element can be used within a document or not. In order to be included in a document, an element must have the status 'Active'.
  12. Specify the document owner.
  13. Specify the element category. Element categories are used to determine possible agents of a workflow task within a specific content.
  14. Set the WF Active indicator to trigger a separate workflow for the selected element when this element is changed.
  15. Set the Alternate Element indicator if applicable. If so, you must assign the element to a base element.
  16. Save your entries.

To assign a variable to an element:

  1. In Standard Elements, select an element.
  2. Choose Associated Variables in the dialog structure.
  3. Choose New Entries.
  4. Select an existing variable.
  5. Set the indicators Read-only and/or Required if applicable. Setting the Read-Only indicator prevents the author from editing its value.
  6. In case of multiple variables, enter a sequence number. This is the order in which the fill-in variables will be presented to an author.
  7. Specify a fill-in owner. A fill-owner refers to the author of the document and is used for information purposes only. Note that if you have set the indicator Read-Only, you cannot change the owner.
  8. Save your entries.

To assign a prescription to an element:

  1. Choose Associated Prescriptions in the dialog structure.
  2. Choose New Entries.
  3. Select a prescription. The corresponding regulation set, content modifier, and effective date are displayed automatically.
  4. Specify the date on which the prescription comes into effect.
  5. Save your entries.

To assign a guidance to an element:

  1. Choose Associated Guidance in the dialog structure and follow the steps as described above.

To define the properties of an element:

  1. Choose Properties in the dialog structure.
  2. Choose New Entries.
  3. Select a property and enter a description.
  4. Save your entries.

To define element formats:

  1. Choose Element Formats in the dialog structure.
  2. Choose New Entries.
  3. Select the relevant document format to which this element should be included.
  4. Select the appropriate format section in which this element should appear. This setting may only be overridden in the document selection element format setup. Note that authors are not allowed to move an element from its default section to another section.
  5. Set the Included by Reference indicator if you want an element to be included by reference by default. This means that only the element title will be included in the assembled document in lieu of its full text.
  6. Select the elements inclusion attribute of Mandatory, Optional, or Rule. This defines how the element will be included.
  7. Save your entries.
  8. Repeat these steps for the same document format for any further sections.
  9. Note that if you set the Element is optional or the Element is required indicator, all settings you have defined in a rule for this element or in a document selection are overridden.

To define texts for the document summary:

  1. Choose Texts in the dialog structure.
  2. Choose New Entries.
  3. Specify a text type. An element may have many text types associated with it. A text type describes the type of text it is. For example, a clause may have a full text and by-reference text associated with it, the by-reference text only containing the title of the clause.
  4. Enter the description to be displayed to the author in the Document Summary.
  5. Select the applicable text format.
  6. To edit or view a text, select an existing entry and choose Edit/Show Text. You can then either edit the text directly or copy and paste a file from your local PC. Text editing is available in Wysiwyg or in source mode. If you have opted for WordML, Microsoft Word is started after you have chosen Edit/Show Text.
  7. Save your entries.

To set up a form:

  1. Define all relevant simple variables, structures, table variables and their associations. For example, you can set up a structure that contains all the simple variables on a form.
  2. Create a form using a form development tool, such as Adobe LiveCycle Designer. Make sure that you map and spell the field names accurately. The spelling of the fields must match the spelling of the subject variables entered previously in Define Variables.
  3. Create an output type in Define Output Definition and maintain its attributes in Maintain Output Attributes. This output definition is used to render the form in a generated document later on.
  4. Create a BADI implementation for the form in Generic Output Interface.
  5. Define an element for the form, associate the simple variables to the form or, if applicable, associate the structure containing all the simple variables for this element, as&
Business Attributes
ASAP Roadmap ID 203   Establish Master Data 
Mandatory / Optional 1   Mandatory activity 
Critical / Non-Critical 1   Critical 
Country-Dependency A   Valid for all countries 
Assigned Application Components
Documentation Object Class Documentation Object Name Current line number Application Component Application Component Name
SIMG /IPRO/MGT_ELMNT 0 HLB0009110 Cross-Application Components 
Maintenance Objects
Maintenance object type C   Customizing Object 
Assigned objects
Customizing Object Object Type Transaction Code Sub-object Do not Summarize Skip Subset Dialog Box Description for multiple selections
/IPRO/ELMNT C - View cluster SM34  
History
Last changed by/on SAP  20070502 
SAP Release Created in 10A