Use the machineryTask model for DITA 1.2

The machineryTask model offers several elements that are specific to writing procedures specific to machines rather than to software. This model is not available in IXIASOFT CCMS Desktop by default, but you can enable it if you prefer to use it rather than the default strictTask.

Important: You must choose between strictTask and machineryTask. You cannot use both simultaneously (unless you create a new module that includes the superset of elements for both models, which is not covered here.) Both are invoked by a single entity, &taskbody-constraints, which must either point to the strictTask model or the machineryTask model. If you have existing tasks that use the strictTask model, and any of them include the <prereq> or <postreq> elements, those tasks will become invalid under the machineryTask model, because those two elements are not defined for machineryTask, which uses <prelreqs> and <closereqs> instead.
  1. Check out and open CompanyDitabase.dtd.
  2. At the end of the DOMAIN ENTITY DECLARATIONS section (or alphabetically, if you prefer), add the following:
    <!ENTITY % taskreq-d-dec     
      PUBLIC "-//OASIS//ENTITIES DITA 1.2 Task Requirements Domain//EN" 
             "../../technicalContent/dtd/taskreqDomain.ent"
    >%taskreq-d-dec;

    This includes the taskreq domain module into your topic shell, which is where all the elements specific to the machineryTask model are defined.

  3. Scroll to the DOMAIN EXTENSIONS section.
  4. At the end of that section, add the following:
    <!ENTITY % prereq       "prereq |
                             %taskreq-d-prereq;
                            ">
    <!ENTITY % postreq      "postreq |
                             %taskreq-d-postreq;
                            ">
  5. Scroll to the DOMAINS ATTRIBUTE OVERRIDE section.
  6. Add the &taskreq-d-att; domain to the list:
    <!ENTITY included-domains 
                              "&concept-att;
                               &reference-att;
                               &task-att;
                               &glossentry-att;                          
                               &glossgroup-att;
                               ... 
                               &mathml-d-att;
                               &equation-d-att;
                               &taskreq-d-att;                                                 
                              "
    >
  7. Scroll to the CONTENT CONSTRAINT INTEGRATION section.
  8. Comment out the existing strictTaskbody constraint:
    <!--<!ENTITY % strictTaskbody-c-def 
      PUBLIC "-//OASIS//ELEMENTS DITA 1.2 Strict Taskbody Constraint//EN" 
             "../../../dtd/technicalContent/dtd/strictTaskbodyConstraint.mod"
    >%strictTaskbody-c-def;-->
  9. Just below that, add the machineryTaskbody constraint:
    <!ENTITY % machineryTaskbody-c-def
      PUBLIC "-//OASIS//ELEMENTS DITA 1.2 Machinery Taskbody Constraint//EN" 
      "machineryTaskbodyConstraint.mod">
    %machineryTaskbody-c-def;
  10. Scroll to the DOMAIN ELEMENT INTEGRATION section.
  11. Add the following:
    <!ENTITY % taskreq-d-def     
      PUBLIC "-//OASIS//ELEMENTS DITA 1.2 Task Requirements Domain//EN" 
             "../../technicalContent/dtd/taskreqDomain.mod"
    >%taskreq-d-def;
  12. Save, close, and check in CompanyDitabase.dtd.