Topic: DMD0213

Export Element Documentation

The Export Documentation dialog is used to export the element documentation (Nickname, Extra Info, Description) in the current Do-more Designer project in text format. This export function's primary use is creating information that will be used by a different software package like AutoCAD (for P&I diagrams) or the C-More operator panel programming software (for automatic tag generation).

 

Note: the preferred method for moving code-blocks and/or programming elements between Do-more Designer projects is to use Cut/Copy/Paste rather than Import/Export. The Cut/Copy/Paste operations have the intelligence required to properly handle incompatibilities in the System Configurations of the source and destination projects.

 

The Export Element Documentation dialog is invoked with the File-> Export-> Element Documentation menu selection.

 

The left side of the dialog is a standard set of Windows File Save prompts allowing the programmer to specify the destination folder, the file name and the file type: Comma Delimited (.csv), or Comma Delimited Text (.txt).

Content Format

The right side of the dialog contains the four output format selections. The appropriate selection depends on the target software for the export file. Be aware that the C-More formats are NOT suitable for importing back into Do-more Designer.

 

  • Standard Format: Element Nickname, Extra Info, Description - This format option outputs one element per line, each component is enclosed in double quotes, and only elements with nicknames are exported. Unassigned Nicknames will be exported with the type set to "UB" (unassigned bit), "UN" (unassigned numeric), or "US" (unassigned structure) as appropriate.

    For example:
    "X40","start switch","Blue, 000","Start switch on operator panel"
    "X41","part present","Blue, 001","Limit that detects part in fixture"
    "X42","part locked","Blue, 002","Confirms that the clamp is locked"
    "R20","door weight","White 000","Door Weight in Pounds"

 

  • Standard Format PLUS export multi-line Description as multiple CSV fields - This option includes the standard format with the ability to preserve the user formatting of the Description field. If the Description field contains multiple lines of text with 'hard' carriage returns (ctrl-enter) inserted for formatting purposes, each line of text will be exported as a separate CSV variable.

    For example:
    "X40","start switch","Blue, 000","This","is","a","multi-line","Description"
    "X41","part present","Blue, 001","This is a single line Description"

 

  • C-More(™) Format: Tag Name (Nickname), Value Type, Element, Block Type, Block Name - This format option outputs data that can be directly imported by the C-More operator panel programming software. The export file will contain the complete database schema, and for each Element that has a Nickname, one element per line, only the Nickname is used, no double quotes, and only elements with nicknames are exported. Unassigned Nicknames will NOT be exported.

    For example:
    start switch,DISCRETE,X40,BBLOCK,X
    part present,DISCRETE,X41,BBLOCK,X
    part locked,DISCRETE,X42,BBLOCK,X
    door weight,FLOATING_PT_32,R20,BBLOCK,R
     

  • C-More(™) Format PLUS All used Elements - This option includes the C-More Standard format and additionally including all elements used in the program - even those without nicknames.

    For example:
    // nickname, data-type, DM-element, User-BuiltIn-Block-Heap-Type, block-name-or-heap-item-name
    start switch,DISCRETE,X40,BBLOCK,X
    part present,DISCRETE,X41,BBLOCK,X
    part locked,DISCRETE,X42,BBLOCK,X
    door weight,FLOATING_PT_32,R20,BBLOCK,R
    ,DISCRETE,X51,BBLOCK,X

 

See Also:

 

Related Topics:

 

Copyright © Host Engineering, Inc. ALL RIGHTS RESERVED