+ All Categories
Home > Documents > Revision 0 · 2021. 1. 19. · PPA AP-907-005.003 Rev. 0 Page 2 of 35 Prepared By: Dwight L....

Revision 0 · 2021. 1. 19. · PPA AP-907-005.003 Rev. 0 Page 2 of 35 Prepared By: Dwight L....

Date post: 10-Feb-2021
Category:
Upload: others
View: 5 times
Download: 0 times
Share this document with a friend
35
PPA AP-907-005.003 Common Dynamic Instruction Model (CDIM) DECEMBER 30 TH , 2020 Revision 0
Transcript
  • PPA AP-907-005.003 Common Dynamic Instruction Model

    (CDIM)

    DECEMBER 30TH, 2020

    Revision 0

  • Common Dynamic Instruction Model (CDIM)

    PPA AP-907-005.003 Rev. 0

    Page 2 of 35

    Prepared By: Dwight L. Hargett, PPA Director of Projects and Johanna Oxstrand, Principal Investigator at Idaho National Laboratories. Reviewed By: DIRECTOR Project Leads and Core Team Members listed on Attachment 3, Acknowledgements along with an independent technical and editorial review by David Linders, Procedures Consultant, BCP Engineers and Consultants. Approved On: December 30th, 2020 Approved By: Linda Mar, PPA Chair Notice Neither PPA nor any of its employees, members, supporting organizations, contractors, or consultants make any warranty, expressed or implied, or assume any legal responsibility for the accuracy or completeness of, or assume any liability for damages resulting from any use of any information apparatus, methods, or process disclosed in this standard or that such may not infringe privately owned rights. © Copyright 2020. This information is the property of the Procedure Professionals Association, Inc. (PPA). All rights reserved. ___________________________________________________________________________

  • Common Dynamic Instruction Model (CDIM)

    PPA AP-907-005.003 Rev. 0

    Page 3 of 35

    REVISION SUMMARY DESCRIPTION

    New supporting document for PPA AP-907-005, Procedure Writer's Manual, that provides a standard set of XML Elements and Attributes for digitally executed instructions on how to perform a task. Developing within the CDIM structure will allow for dynamic instructions to be shared, viewed, converted, and understood between adopters of the CDIM.

  • Common Dynamic Instruction Model (CDIM)

    PPA AP-907-005.003 Rev. 0

    Page 4 of 35

    TABLE OF CONTENTS

    SECTION .......................................................................................................................... PAGE

    1.0 PURPOSE ..................................................................................................................... 6

    2.0 SCOPE .......................................................................................................................... 6

    3.0 DEFINITIONS ................................................................................................................ 6

    4.0 INSTRUCTIONS ............................................................................................................ 6

    4.1 CDIM XML Schema ....................................................................................................... 6

    5.0 GENERAL INFO AND ACKNOWLEDGEMENTS .......................................................... 7

    6.0 REFERENCES AND COMMITMENTS .......................................................................... 7

    ATTACHMENT 1 – List of Acronyms .......................................................................................... 8

    ATTACHMENT 2 – PPA XML Schema Summary Report ........................................................... 9

    1.0 Schema ......................................................................................................................... 9

    1.1 Global Elements ............................................................................................................ 9

    1.2 Schema Elements, Attributes, Attribute Groups, and Simple Types ............................ 11 1.2.1 Element – DynamicInstructionSet ................................................................................ 11 1.2.2 Element – DynamicInstructionInfo ............................................................................... 12 1.2.3 Element – Section ....................................................................................................... 13 1.2.4 Element – StepInfo ...................................................................................................... 14 1.2.5 Element – StepAction .................................................................................................. 15 1.2.6 Element – NumericDataEntry ...................................................................................... 17 1.2.7 Element – TextDataEntry ............................................................................................. 18 1.2.8 Element – DateDataEntry ............................................................................................ 19 1.2.9 Element – BooleanDataEntry ...................................................................................... 20 1.2.10 Element – AttachmentDataEntry ................................................................................. 20 1.2.11 Element – Alarm .......................................................................................................... 21 1.2.12 Element – Note ............................................................................................................ 21 1.2.13 Element – Caution ....................................................................................................... 22 1.2.14 Element – Warning ...................................................................................................... 22 1.2.15 Element – Figure ......................................................................................................... 22 1.2.16 Element – HTMLTable ................................................................................................. 23 1.2.17 Element – Repositions ................................................................................................. 23 1.2.18 Element – Reposition .................................................................................................. 24 1.2.19 Element – Status ......................................................................................................... 24 1.2.20 Element – CALSTable ................................................................................................. 25 1.2.21 Element – table ............................................................................................................ 25

  • Common Dynamic Instruction Model (CDIM)

    PPA AP-907-005.003 Rev. 0

    Page 5 of 35 1.2.22 Element – row .............................................................................................................. 25 1.2.23 Element – entry ........................................................................................................... 26 1.2.24 Element – VariableData ............................................................................................... 26 1.2.25 Attribute Group – StepAttribs ....................................................................................... 27 1.2.26 Attribute Group – ActionStepAttribs ............................................................................. 27 1.2.27 Simple Type – Verbs ................................................................................................... 28 1.2.28 Attribute Group – DataInfo ........................................................................................... 28 1.2.29 Attribute Group – ComponentInfo ................................................................................ 29 1.2.30 Attribute – StatusValue ................................................................................................ 29 1.2.31 Element – GoTo .......................................................................................................... 29 1.2.32 Attribute – Number ...................................................................................................... 30 1.2.33 Element – Paragraph ................................................................................................... 30 1.2.34 Element – Verification .................................................................................................. 30 1.2.35 Element – Data ............................................................................................................ 31 1.2.36 Element – RepositionData ........................................................................................... 31 1.2.37 Element – AdHocDataCaptured .................................................................................. 31 1.2.38 Element – Form ........................................................................................................... 32 1.2.39 Element – Fragment .................................................................................................... 32 1.2.40 SimpleType – ID .......................................................................................................... 33 1.2.41 Element – Link ............................................................................................................. 33 1.2.42 Element – Revisions .................................................................................................... 33 1.2.43 Element – Revision ...................................................................................................... 34 1.2.44 Element – Change ....................................................................................................... 34 1.2.45 Element – Basis ........................................................................................................... 35

  • Common Dynamic Instruction Model (CDIM)

    PPA AP-907-005.003 Rev. 0

    Page 6 of 35 1.0 PURPOSE

    1. This document captures a content summary report output from the XML Schema for a Common Dynamic Instruction Model (CDIM). This model was developed by a broad spectrum of Energy Sector document specialist as part of an Idaho National Laboratory (INL) and Procedure Professionals Association, Inc. (PPA) co-sponsored initiative titled Dynamic Instructions Editing Tool Requirements (DIRECTOR).

    2. This document and associated XML Schema work in concert with AP-907-005.002, Dynamic Instruction Set Editor Functional Requirements.

    3. This document and associated XML Schema are designed to work in concert with AP-907-005.002, Dynamic Instruction Set Editor Functional Requirements. As new desired functional requirements are added to AP-907-005.002, the CDIM is enhanced to provide a standard structure that supports implementation of the new functionality.

    2.0 SCOPE

    1. Presentation of a basic summary of the PPA CDIM XML Schema.

    3.0 DEFINITIONS

    1. None

    4.0 INSTRUCTIONS

    4.1 CDIM XML Schema

    1. Refer to Attachment 1, PPA XML Schema Summary Report, for an XML Report that lists the key Elements and Attributes of the PPA CDIM XML Schema. The content of this report is generated directly from the PPA CDIM XML Schema using an XML Editor.

    2. While this report captures the principle Elements and Attributes of the PPA CDIM, it is not a comprehensive output of the XML code. For a more complete review, contact PPA to obtain a copy of the PPA CDIM and review using an XML Editor.

    3. While the PPA CDIM is presented using XML, this is not intended to imply that XML is the only software solution that can be used to implement this schema.

  • Common Dynamic Instruction Model (CDIM)

    PPA AP-907-005.003 Rev. 0

    Page 7 of 35 5.0 GENERAL INFO AND ACKNOWLEDGEMENTS

    1. The initiative that created this report, Dynamic Instructions Editing Tool Requirements (DIRECTOR) was initiated by Johanna Oxstrand, Principle Investigator at INL and co-sponsored by PPA with Dwight Hargett, PPA Director of Projects serving as PPA Lead.

    2. Refer to AP-907-005.002, Dynamic Instruction Set Editor Functional Requirements and Implementation Considerations for a more complete description of the DIRECTOR initiative and acknowledgements.

    6.0 REFERENCES AND COMMITMENTS

    1. AP-907-005 Rev. 3, Procedure Writer's Manual

    2. AP-907-005.001 Rev. 0, Functional Requirements for Advanced and Adaptive Smart Documents.

    3. AP-907-005.002 Rev. 0, Dynamic Instruction Set Editor Functional Requirements

    4. XML Schema Definition

    https://en.m.wikipedia.org/wiki/XML_Schema_(W3C)

  • Dynamic Instruction Set Editor Functional Requirements

    PPA AP-907-005.003 Rev. 0

    Page 8 of 35

    ATTACHMENT 1 Page 1 of 1

    List of Acronyms

    CDIM Common Dynamic Instruction Model

    DIRECTOR Dynamic Instructions Editing Tool Requirements

    INL Idaho National Laboratory

    PPA Procedure Professionals Association, Inc.

  • Dynamic Instruction Set Editor Functional Requirements

    PPA AP-907-005.003 Rev. 0

    Page 9 of 35

    ATTACHMENT 2 Page 1 of 27

    PPA XML Schema Summary Report

    1.0 Schema

    1.1 Global Elements

    Element Name Description

    DynamicInstructionSet

    Main Root Element. A controlled and organized set of digital instructions designed to improve human performance by clearly providing the purpose, specific intent, and sequenced direction for an activity, program, or process using a digital form of data display that takes advantage of the computational capabilities of the digital platform to further improve the human performance and efficiency of work execution while also enabling improved data management and analytics through interfaces to supporting digital systems and programs.

    DynamicInstructionInfo Metadata about this document.

    Section A sequence of steps that have their own heading and are intended to be executed in a stand-alone manner. StepInfo An information step that provides information (does not direct action). StepAction An action step that directs the user to perform an action against an object. NumericDataEntry Used to define numeric input information. TextDataEntry Used to define text input information. DateDataEntry Used to define date input information. BooleanDataEntry Used to define boolean input information. AttachmentDataEntry Used to define information about the requested attachment information. Alarm Defines an alarm checked after data entry.

    Note A statement that provides explanatory information to support a step or series of steps.

    Caution

    A statement displayed immediately prior or in conjunction with applicable step(s) that informs users of undesirable equipment results such as potential for equipment damage, plant transients, or conditions that may adversely affect plant operation.

    Warning A statement displayed immediately prior or in conjunction with applicable steps to warn users of potential for personnel injury, loss of life, or health hazards.

    Figure A diagram or pictorial illustration of textual matter.

    HTMLTable A systematic arrangement of data usually in rows and columns for ready reference.

  • Common Dynamic Instruction Model (CDIM) PPA AP-907-005.003 Rev. 0

    Page 10 of 35 ATTACHMENT 2

    Page 2 of 27

    PPA XML Schema Summary Report (cont.)

    Element Name Description Repositions A group of component repositions. Reposition A reposition step for a specific component. Status Section that records status changes. CALSTable Defines a CALS formatted data structure of a table representation. table CALS table object. row CALS row object. entry CALS entry object.

    VariableData Used to dynamically change variables within a generic document to a specific instance. GoTo Used to control flow in a document. Paragraph Generic Paragraph element. Verification Data Element: Added during execution. Holds verification data. Data Data Element: Added during execution. Holds user entered data. RepositionData Data Element: Added during execution. Holds reposition data.

    AdHocDataCaptured Data Element: Additional information gathered/entered the execution of the data.

    Form Specialized content model for the type of content typically needed in technical forms. Fragment Reference to dynamic content to emplace when creating the document.

    Link Reference to external linked document to be launched outside of this document. Revisions Collection of revision elements. Revision Information about a document revision. Change Details of a change to the document associated with a revision.

    Basis Captures the basic information that explains what the step is about and any regulatory drivers for the step. Table 1 - Global Elements

  • Common Dynamic Instruction Model (CDIM) PPA AP-907-005.003 Rev. 0

    Page 11 of 35 ATTACHMENT 2

    Page 3 of 27

    PPA XML Schema Summary Report (cont.)

    1.2 Schema Elements, Attributes, Attribute Groups, and Simple Types

    1.2.1 Element – DynamicInstructionSet

    1. Main Root Element - A controlled and organized set of digital instructions designed to improve human performance by clearly providing the purpose, specific intent, and sequenced direction for an activity, program, or process using a digital form of data display that takes advantage of the computational capabilities of the digital platform to further improve the human performance and efficiency of work execution while also enabling improved data management and analytics through interfaces to supporting digital systems and programs.

    2. Children are:

    Element Type Min Max DynamicInstructionInfo 1 1 Section 1 unbounded AdHocDataCaptured 0 1 Form 0 unbounded Notes 0 unbounded Fragment 0 unbounded Link 0 unbounded Revisions 0 1 VariableData 0 1

    Table 2 - Children of Element DynamicInstructionSet

    Total Children 1 to unbounded

  • Common Dynamic Instruction Model (CDIM) PPA AP-907-005.003 Rev. 0

    Page 12 of 35 ATTACHMENT 2

    Page 4 of 27

    PPA XML Schema Summary Report (cont.)

    1.2.2 Element – DynamicInstructionInfo

    1. Meta data about this document.

    2. Attributes are:

    Name Use Type Restrictions Annotation

    WorkAgainst optional string Component that a Work Order is written against.

    Template optional string This can capture the Model WO Number, Work Scope Library Number, Work Job Plan Number, etc.

    ID required Unique object ID within this document.

    UniqueID optional string Max length:50 Unique document ID within the document library. Title optional string Max length:100

    Number optional string Max length:25

    Revision optional string Max length:25

    Objective optional string

    EffectiveDate optional date

    Type required string High-level document type (ex: Procedure...). SubType optional string Max length:50 Refinement of document type.

    LevelOfUse optional Choices: Continuous Use; Information Use; Reference Use

    DocumentNamespace optional anyURI

    RelatedDocumentID optional string Max length:50

    Facility optional string

    Unit optional string

    SafetyClass optional string

    ResponsibleDept optional string Owning department of this document.

    QualCode optional string Specific qualification required to be able to perform this task. Table 3 - Attributes of Element DynamicInstructionInfo

  • Common Dynamic Instruction Model (CDIM) PPA AP-907-005.003 Rev. 0

    Page 13 of 35 ATTACHMENT 2

    Page 5 of 27

    PPA XML Schema Summary Report (cont.)

    3. Children are:

    Element Type Min Max SpecialConsideration 0 unbounded UserDefinedAttribute 0 unbounded ReviewAndApproval 0 unbounded QualCode 0 unbounded

    Table 4 - Children of DynamicInstructionInfo

    Total Children 0 to unbounded

    1.2.3 Element – Section

    1. A sequence of steps that have their own heading and are intended to be executed in a stand-alone manner.

    2. Attributes are:

    Name Use Type Restrictions Annotation ID required optional

    Title optional string Describes what will be accomplished.

    Applicability optional string

    Equation that is solved to test whether or not this section is applicable.

    NumberedChildren optional boolean

    If true, child steps are numbered and will be executed sequentially. If false, child steps are bulleted and executed in any order.

    Table 5 - Attributes of Element Section

  • Common Dynamic Instruction Model (CDIM) PPA AP-907-005.003 Rev. 0

    Page 14 of 35 ATTACHMENT 2

    Page 6 of 27

    PPA XML Schema Summary Report (cont.)

    3. Children are:

    Element Type Min Max StepAction 0 unbounded StepInfo 0 unbounded Note 0 unbounded Caution 0 unbounded Warning 0 unbounded Paragraph 0 unbounded Figure 0 unbounded GoTo 0 1 Section 0 unbounded Form 0 unbounded Link 0 unbounded QualCode 0 unbounded

    Table 6 - Children of Element Section

    Total Children 1 to unbounded

    1.2.4 Element – StepInfo

    1. An information step that provides information (does not direct action).

    2. Attributes are:

    Name Use Type Restrictions Annotation ID required

    Text required string

    StepAttribs optional Table 7 - Attributes of Element StepInfo

  • Common Dynamic Instruction Model (CDIM) PPA AP-907-005.003 Rev. 0

    Page 15 of 35 ATTACHMENT 2

    Page 7 of 27

    PPA XML Schema Summary Report (cont.)

    3. Children are:

    Element Type Min Max Paragraph 0 unbounded Link 0 unbounded Basis 0 unbounded

    Table 8 - Children of Element StepInfo

    Total Children 1 to unbounded

    1.2.5 Element – StepAction

    1. An action step that directs the user to perform an action against an object.

    2. Attributes are:

    Name Use Type Restrictions Annotation ID required

    StepType required string

    Choices: Simple action; If Then; When Then; While

    Condition optional string

    Action optional string

    ItemType optional string Max length:25

    HoldPointStart optional boolean

    HoldPointEnd optional boolean

    AdditionalInfo optional string

    QualCode optional string

    Specific qualification required to be able to perform this task.

    ResponsiblePerformer optional Department/staff responsible for executing step.

    ActionStepAttribs optional

    ComponentInfo optional

  • Common Dynamic Instruction Model (CDIM) PPA AP-907-005.003 Rev. 0

    Page 16 of 35 ATTACHMENT 2

    Page 8 of 27

    PPA XML Schema Summary Report (cont.)

    Table 9 - Attributes of StepAction

    3. Children are:

    Element Type Min Max Note 0 unbounded Caution 0 unbounded Warning 0 unbounded Paragraph 0 unbounded Reposition 0 1 Repositions 0 1 Status 0 unbounded Verification 0 unbounded NumericDataEntry 0 unbounded TextDataEntry 0 unbounded BooleanDataEntry 0 unbounded DateDataEntry 0 unbounded AttachmentDataEntry 0 unbounded Figure 0 1 HTMLTable 0 unbounded RefNote 0 unbounded StepAction 0 unbounded Link 0 unbounded StepInfo 0 unbounded Basis 0 unbounded

    Table 10 - Children of Element StepAction

    Total Children 0 to unbounded

  • Common Dynamic Instruction Model (CDIM) PPA AP-907-005.003 Rev. 0

    Page 17 of 35 ATTACHMENT 2

    Page 9 of 27

    PPA XML Schema Summary Report (cont.)

    1.2.6 Element – NumericDataEntry

    1. Used to define numeric input information.

    2. Attributes are:

    Name Use Type Restrictions Annotation ID required

    Units optional string Max length:10 Engineering units of the gathered value.

    Minimum optional float Expected minimum value. Maximum optional float Expected maximum value. DataInfo optional

    Table 11 - Attributes of Element NumericDataEntry

    3. Children are:

    Element Type Min Max Alarm 0 unbounded Data 0 1

    Table 12 - Children of Element NumericDataEntry

    Total Children 0 to unbounded

  • Common Dynamic Instruction Model (CDIM) PPA AP-907-005.003 Rev. 0

    Page 18 of 35 ATTACHMENT 2

    Page 10 of 27

    PPA XML Schema Summary Report (cont.)

    1.2.7 Element – TextDataEntry

    1. Used to define text input information.

    2. Attributes are:

    Name Use Type Restrictions Annotation ID required

    AllowOther optional boolean

    DataInfo optional Table 13 - Attributes of Element TextDataEntry

    3. Children are:

    Element Type Min Max Choice 0 unbounded Alarm 0 unbounded Data 0 1

    Table 14 - Children of Element TextDataEntry

    Total Children 0 to unbounded

  • Common Dynamic Instruction Model (CDIM) PPA AP-907-005.003 Rev. 0

    Page 19 of 35 ATTACHMENT 2

    Page 11 of 27

    PPA XML Schema Summary Report (cont.)

    1.2.8 Element – DateDataEntry

    1. Used to define date input information.

    2. Attributes are:

    Name Use Type Restrictions Annotation ID required

    Minimum optional dateTime

    Maximum optional dateTime

    DataInfo optional Table 15 - Attributes of Element DateDataEntry

    3. Children are:

    Element Type Min Max Alarm 0 unbounded Data 0 1

    Table 16 - Children of Element DateDataEntry

    Total Children 0 to unbounded

  • Common Dynamic Instruction Model (CDIM) PPA AP-907-005.003 Rev. 0

    Page 20 of 35 ATTACHMENT 2

    Page 12 of 27

    PPA XML Schema Summary Report (cont.)

    1.2.9 Element – BooleanDataEntry

    1. Used to define boolean input information.

    2. Attributes are:

    Name Use Type Restrictions Annotation ID required

    TrueValue optional string

    FalseValue optional string

    DataInfo optional Table 17 - Attributes of Element BooleanDataEntry

    3. Children are:

    Element Type Min Max Alarm 0 unbounded Data 0 1

    Table 18 - Children of Element BooleanDataEntry

    Total Children 0 to unbounded

    1.2.10 Element – AttachmentDataEntry

    1. Used to define information about the requested attachment information.

    2. Attributes are:

    Name Use Type Restrictions Annotation ID required

    DataInfo optional Table 19 - Attributes of Element AttachmentDataEntry

    3. Children are:

    Element Type Min Max Data 0 1

    Table 20 - Children of Element AttachmentDataEntry

    Total Children 0 to unbounded

  • Common Dynamic Instruction Model (CDIM) PPA AP-907-005.003 Rev. 0

    Page 21 of 35 ATTACHMENT 2

    Page 13 of 27

    PPA XML Schema Summary Report (cont.)

    1.2.11 Element – Alarm

    1. Defines an alarm checked after data entry.

    2. Attributes are:

    Name Use Type Restrictions Annotation ID required

    Setpoint optional string

    ComparisonOperator optional string

    Choices: Less than; Less than or equal to; Equal to; Greater than or equal to; Greater than; Not equal to; etc.

    Equation optional

    AlarmMessage required string

    InAlarm optional boolean Table 21 - Attributes of Element Alarm

    1.2.12 Element – Note

    1. A statement that provides explanatory information to support a step or series of steps.

    2. Attributes are:

    Name Use Type Restrictions Annotation ID required

    Note optional string Table 22 - Attributes of Element Note

    3. Sequence is:

    Element Min Max AppliesTo min=0 max=unbounded

    Table 23 - Sequence for Element Note

  • Common Dynamic Instruction Model (CDIM) PPA AP-907-005.003 Rev. 0

    Page 22 of 35 ATTACHMENT 2

    Page 14 of 27

    PPA XML Schema Summary Report (cont.)

    1.2.13 Element – Caution

    1. A statement displayed immediately prior or in conjunction with applicable step(s) that informs users of undesirable equipment results such as potential for equipment damage, plant transients, or conditions that may adversely affect plant operation.

    2. Attributes are:

    Name Use Type Restrictions Annotation ID required

    Number optional

    Cause optional string Max length:100

    Effect optional string Table 24 - Attributes of Element Caution

    1.2.14 Element – Warning

    1. A statement displayed immediately prior or in conjunction with applicable steps to warn users of potential for personnel injury, loss of life, or health hazards.

    2. Attributes are:

    Name Use Type Restrictions Annotation ID required

    Number optional

    Cause optional string

    Effect optional string Table 25 - Attributes of Element Warning

    1.2.15 Element – Figure

    1. A diagram or pictorial illustration of textual matter.

    2. Attributes are:

    Name Use Type Restrictions Annotation ID required

    FileName required anyURI

    Caption optional string Table 26 - Attributes of Element Figure

  • Common Dynamic Instruction Model (CDIM) PPA AP-907-005.003 Rev. 0

    Page 23 of 35 ATTACHMENT 2

    Page 15 of 27

    PPA XML Schema Summary Report (cont.)

    1.2.16 Element – HTMLTable

    1. A systematic arrangement of data usually in rows and columns for ready reference.

    2. Attributes are:

    Name Use Type Restrictions Annotation ID required

    HTML optional string Table 27 - Attributes of Element HTML Table

    1.2.17 Element – Repositions

    1. A group of component repositions.

    2. Attributes are:

    Name Use Type Restrictions Annotation ID required

    HowMany optional int

    Ordered optional boolean Table 28 - Attributes of Element Repositions

    3. Sequence is:

    Element Min Max Reposition min=1 max=unbounded

    Table 29 - Sequence for Element Repositions

  • Common Dynamic Instruction Model (CDIM) PPA AP-907-005.003 Rev. 0

    Page 24 of 35 ATTACHMENT 2

    Page 16 of 27

    PPA XML Schema Summary Report (cont.)

    1.2.18 Element – Reposition

    1. A reposition step for a specific component.

    2. Attributes are:

    Name Use Type Restrictions Annotation ID required

    Status required string Max length:50

    Temporary required string Choices:Temporary;Final;

    Position required string

    ExpectedPosition optional string

    ComponentInfo optional Table 30 - Attributes of Element Reposition

    3. Sequence is:

    Element Min Max RepositionData min=1 max=1

    Table 31 - Sequence for Element Reposition

    1.2.19 Element – Status

    1. Section that records status changes.

    2. Attributes are:

    Name Use Type Restrictions Annotation StatusValue optional string

    StatusBy required string Name/ID of performer StatusDate required dateTime

    Notes optional string Captures reason for N/A of a non-conditional step.

    NAApprovedBy optional string Supervisor approving N/A of a non-conditional step. Table 32 - Attributes of Element Status

  • Common Dynamic Instruction Model (CDIM) PPA AP-907-005.003 Rev. 0

    Page 25 of 35 ATTACHMENT 2

    Page 17 of 27

    PPA XML Schema Summary Report (cont.)

    1.2.20 Element – CALSTable

    1. Defines a CALS formatted data structure of a table representation.

    2. Sequence is:

    Element Min Max table min=1 max=1

    Table 33 - Seqence for Element CALSTable

    1.2.21 Element – table

    1. CALS table object.

    2. Attributes are:

    Name Use Type Restrictions Annotation rows optional int

    Number optional string Table 34 - Attributes of Element table

    3. Sequence is:

    Element Min Max tgroup min=1 max=1

    Table 35 - Sequence for Element table

    1.2.22 Element – row

    1. CALS row object.

    2. Attributes are:

    Name Use Type Restrictions Annotation num optional int

    Table 36 - Attributes of Element row

    3. Sequence is:

    Element Min Max entry min=0 max=unbounded

    Table 37 - Sequence for Element row

  • Common Dynamic Instruction Model (CDIM) PPA AP-907-005.003 Rev. 0

    Page 26 of 35 ATTACHMENT 2

    Page 18 of 27

    PPA XML Schema Summary Report (cont.)

    1.2.23 Element – entry

    1. CALS entry object.

    2. Attributes are:

    Name Use Type Restrictions Annotation valign optional string Choices: top

    num optional int Table 38 - Attributes of Element entry

    3. Children are:

    Element Type Min Max Paragraph 0 1 NumericDataEntry 0 1 DateDataEntry 0 1 BooleanDataEntry 0 1 TextDataEntry 0 1

    Table 39 - Children of Element entry

    Total Children 0 to unbounded

    1.2.24 Element – VariableData

    1. Used to dynamically change variables within a generic document to a specific instance.

    2. Sequence is:

    Element Min Max Variable min=1 max=unbounded Table 40 - Sequence for Element VariableData

  • Common Dynamic Instruction Model (CDIM) PPA AP-907-005.003 Rev. 0

    Page 27 of 35 ATTACHMENT 2

    Page 19 of 27

    PPA XML Schema Summary Report (cont.)

    1.2.25 Attribute Group – StepAttribs

    1. Attributes are:

    Name Use Type Restrictions Annotation Number optional

    Status optional string

    Max length:15 Choices: Not started; In Progress; Completed

    Table 41 - Attributes of Attribute Group StepAttribs

    1.2.26 Attribute Group – ActionStepAttribs

    1. Attributes are:

    Name Use Type Restrictions Annotation CriticalLocation optional string

    ActionVerb optional Verbs The action verb for the caption item. Object optional

    CriticalSupplementalInformation optional

    RequiresIV optional boolean

    RequiresCV optional boolean

    RequiresQA optional boolean

    RequiresPC optional boolean

    Applicability optional string

    Equation that is solved to test whether or not this section is applicable.

    Critical optional boolean Table 42 - Attributes of Attribute Group ActionStepAttribs

  • Common Dynamic Instruction Model (CDIM) PPA AP-907-005.003 Rev. 0

    Page 28 of 35 ATTACHMENT 2

    Page 20 of 27

    PPA XML Schema Summary Report (cont.)

    1.2.27 Simple Type – Verbs

    1. Defined list of expected verbs. Also allows any verb.

    a. Base: string

    (1) Choices: Annotate; Complete; Continue; Determine; Document; Ensure; Identify, Install; Obtain; Open; Perform; Restore; Unlock; Unlock and Close; Refer To; GoTo; etc.

    b. Base: string

    • Max length:25

    • Any value

    1.2.28 Attribute Group – DataInfo

    1. Attributes are:

    Name Use Type Restrictions Annotation Unnumbered optional boolean

    Number optional string Max length:15

    Prompt required string

    Varname required string Max length:50 Unique identifier for this value (PointID for example).

    Required optional boolean Table 43 - Attributes of Attribute Group DataInfo

  • Common Dynamic Instruction Model (CDIM) PPA AP-907-005.003 Rev. 0

    Page 29 of 35 ATTACHMENT 2

    Page 21 of 27

    PPA XML Schema Summary Report (cont.)

    1.2.29 Attribute Group – ComponentInfo

    1. Attributes are:

    Name Use Type Restrictions Annotation CompID optional string Max length:50

    CompDescription optional string Max length:200

    Building optional string Max length:25

    Elevation optional string Max length:25

    Room optional string Max length:25

    Location optional string Max length:100 Table 44 - Attributes of Attribute Group ComponentInfo

    1.2.30 Attribute – StatusValue

    Type string Choices Not Started; In Progress; Complete; N/A Description List of status values for a step.

    Table 45 - Attribute StatusValue

    1.2.31 Element – GoTo

    1. Used to control flow in a document.

    2. Attributes are:

    Name Use Type Restrictions Annotation ID required

    Condition optional Equation to evaluate. StepNo optional

    Table 46 - Attributes of Element GoTo

  • Common Dynamic Instruction Model (CDIM) PPA AP-907-005.003 Rev. 0

    Page 30 of 35 ATTACHMENT 2

    Page 22 of 27

    PPA XML Schema Summary Report (cont.)

    1.2.32 Attribute – Number

    Type string Max length 18 Description Defines restrictions on the document number.

    Table 47 - Attribute Number

    1.2.33 Element – Paragraph

    1. Generic Paragraph element.

    2. Attributes are:

    Name Use Type Restrictions Annotation ID required int

    Number optional

    Text optional string

    Important optional Table 48 - Attributes of Element Paragraph

    1.2.34 Element – Verification

    1. Data Element: Added during execution. Holds verification data.

    2. Attributes are:

    Name Use Type Restrictions Annotation

    VerificationType required string Choices: Independent; Concurrent; QA; Peer

    VerifiedBy required string

    VerificationDate required dateTime Table 49 - Attributes of Element Verification

  • Common Dynamic Instruction Model (CDIM) PPA AP-907-005.003 Rev. 0

    Page 31 of 35 ATTACHMENT 2

    Page 23 of 27

    PPA XML Schema Summary Report (cont.)

    1.2.35 Element – Data

    1. Data Element: Added during execution. Holds user entered data.

    2. Attributes are:

    Name Use Type Restrictions Annotation Value optional string

    GatheredBy optional string

    GatheredDate optional dateTime

    InAlarm optional boolean

    Notes optional string Table 50 - Attributes of Element Data

    1.2.36 Element – RepositionData

    1. Data Element: Added during execution. Holds reposition data.

    2. Attributes are:

    Name Use Type Restrictions Annotation Position optional string

    PositionedBy optional string

    PositionedDate optional dateTime

    Alarm optional boolean

    Notes optional string Table 51 - Attributes of Element RepositionData

    1.2.37 Element – AdHocDataCaptured

    1. Data Element: Added during execution. Additional information gathered and entered during execution.

    2. Sequence is:

    Element Min Max Data min=0 max=unbounded Table 52 - Sequence for Element AdHocDataCapture

  • Common Dynamic Instruction Model (CDIM) PPA AP-907-005.003 Rev. 0

    Page 32 of 35 ATTACHMENT 2

    Page 24 of 27

    PPA XML Schema Summary Report (cont.)

    1.2.38 Element – Form

    1. Specialized content model for the type of content typically needed in technical forms.

    2. Attributes are:

    Name Use Type Restrictions Annotation Number optional string

    Title optional

    Reference optional anyURI

    ID required int Table 53 - Attributes of Element Form

    3. Sequence is:

    Element Min Max Paragraph min=0 max=unbounded CALSTable min=0 max=unbounded FixedLayout min=0 max=unbounded

    Table 54 - Sequence for Element Form

    1.2.39 Element – Fragment

    1. Reference to dynamic content to emplace when creating the document.

    2. Attributes are:

    Name Use Type Restrictions Annotation ID required int

    RefID required int

    TargetID optional int Table 55 - Attributes of Element Fragment

  • Common Dynamic Instruction Model (CDIM) PPA AP-907-005.003 Rev. 0

    Page 33 of 35 ATTACHMENT 2

    Page 25 of 27

    PPA XML Schema Summary Report (cont.)

    1.2.40 SimpleType – ID

    1. Unique object ID within this document.

    • Base: int

    • Any value

    1.2.41 Element – Link

    1. Reference to external linked document to be launched outside of this document.

    2. Attributes are:

    Name Use Type Restrictions Annotation Caption optional string

    URI required anyURI URL or filepath of the link.

    Target optional string Specific point within the linked media (bookmark, page, frame...)

    Notes optional string Table 56 - Attributes of Element Link

    1.2.42 Element – Revisions

    1. Collection of revision elements.

    2. Sequence is:

    Element Min Max Revision min=0 max=unbounded

    Table 57 - Sequence for Element Revisions

  • Common Dynamic Instruction Model (CDIM) PPA AP-907-005.003 Rev. 0

    Page 34 of 35 ATTACHMENT 2

    Page 26 of 27

    PPA XML Schema Summary Report (cont.)

    1.2.43 Element – Revision

    1. Information about a document revision.

    2. Attributes are:

    Name Use Type Restrictions Annotation RevNo optional

    CreatedBy optional string

    EditedBy optional string Table 58 - Attributes of Element Revision

    3. Sequence is:

    Element Min Max Change min=0 max=unbounded

    Table 59 - Sequence for Element Revision

    1.2.44 Element – Change

    1. Details of a change to the document associated with a revision.

    2. Attributes are:

    Name Use Type Restrictions Annotation

    Type optional string Choices: Add; Edit; Delete Type of change being made.

    ID optional int Unique Key of the entity changed.

    Number optional Not necessary, but convenient.

    AttName optional Name of the attribute that was changed.

    OriginalValue optional

    UpdatedValue optional

    Comments optional Table 60 - Attributes of Element Change

  • Common Dynamic Instruction Model (CDIM) PPA AP-907-005.003 Rev. 0

    Page 35 of 35 ATTACHMENT 2

    Page 27 of 27

    PPA XML Schema Summary Report (cont.)

    1.2.45 Element – Basis

    1. Captures the basic information that explains what the step is about and any regulatory drivers for the step.

    2. Attributes are:

    Name Use Type Restrictions Annotation ID optional

    Source optional string

    Title optional string

    Requirement optional string

    Notes optional string Table 61 - Attributes of Element Basis

    1.0 PURPOSE2.0 SCOPE3.0 DEFINITIONS4.0 INSTRUCTIONS4.1 CDIM XML Schema

    5.0 GENERAL INFO AND ACKNOWLEDGEMENTS6.0 REFERENCES AND COMMITMENTS1.0 Schema1.1 Global Elements1.2 Schema Elements, Attributes, Attribute Groups, and Simple Types1.2.1 Element – DynamicInstructionSet1.2.2 Element – DynamicInstructionInfo1.2.3 Element – Section1.2.4 Element – StepInfo1.2.5 Element – StepAction1.2.6 Element – NumericDataEntry1.2.7 Element – TextDataEntry1.2.8 Element – DateDataEntry1.2.9 Element – BooleanDataEntry1.2.10 Element – AttachmentDataEntry1.2.11 Element – Alarm1.2.12 Element – Note1.2.13 Element – Caution1.2.14 Element – Warning1.2.15 Element – Figure1.2.16 Element – HTMLTable1.2.17 Element – Repositions1.2.18 Element – Reposition1.2.19 Element – Status1.2.20 Element – CALSTable1.2.21 Element – table1.2.22 Element – row1.2.23 Element – entry1.2.24 Element – VariableData1.2.25 Attribute Group – StepAttribs1.2.26 Attribute Group – ActionStepAttribs1.2.27 Simple Type – Verbs1.2.28 Attribute Group – DataInfo1.2.29 Attribute Group – ComponentInfo1.2.30 Attribute – StatusValue1.2.31 Element – GoTo1.2.32 Attribute – Number1.2.33 Element – Paragraph1.2.34 Element – Verification1.2.35 Element – Data1.2.36 Element – RepositionData1.2.37 Element – AdHocDataCaptured1.2.38 Element – Form1.2.39 Element – Fragment1.2.40 SimpleType – ID1.2.41 Element – Link1.2.42 Element – Revisions1.2.43 Element – Revision1.2.44 Element – Change1.2.45 Element – Basis


Recommended