DFDCONNECT{...} -- renders an IPC diagram or list

The DFDCONNECT macro renders either a graph of the interconnections between entities (data type or process), or a formatted text (or HTML or wiki mark-up) representation of that graph.

  • Parameters:
    Parameter Description Default
    id Entity ID none, required parameter
    type Graph type, see below none, required parameter
    dir See below 3 (both)
    level The depth of the diagram, i.e. how many links away from id will be included. 0
    datanodes If non-zero, render data types as nodes in graphs 0 (do not render data types as nodes)
    printself If 0, the proc indicated by id will not be listed in the output. Valid with format only. Given proc is listed in output.
    nolocales For graphs, processes are clustered by locale. If this parameter is non-zero, the nodes are not clustered 0
    aggregate If 0, apply "format" to each matching XML node. See below. 1
    atomempty If 1, insert the empty value for individual (atomic) XPath subexpressions in format that have no results. 0
    hidedeprecated If 1, deprecated entities will not be rendered 0
    separator Specifies text to insert between each record of formatted output. $n() (newline)
    newline Text to insert in the output, if aggregate is 1, between aggregated matches. <br/>
    empty Text to insert into formatted output if an XPath expression matches nothing.  
    zeroresults Text to display if there are no matches to the query expression. No results.$n
    label Indicate how wiki links are labeled, with the Entity id, spec, aspec (abbreviated spec) or topic name
    format Specifies the output format using an XPath expression. none
    header Specifies text to insert at the top of formatted output. none
    footer Specifies text to insert at the bottom of formatted output. none
    locales Only render entities within in the given list of comma-separated locale IDs all locales are included
    exclocales Do not render entities withing the given list of comma-separated locale IDs no locales are excluded

Output is generated using data from DFDDATA macros and DFDPROC macros.

Graph Types
proc
Render a connection diagram between Process and Data Type entities, using a Process entity as a starting point. May have multiple starting points, depending on Locale associations and macro parameters.
data
Render a connection diagram between Process and Data Type entities, using a Data Type entity as a starting point. Aside from the obvious, such a diagram may also have multiple "starting points" due to the fact that multiple Processes may utilize the requested Data Type. The only Data Type entities appearing in the graph will be those matching the specified ID.
group
Render a connection diagram between Process and Data Type entities, where only Data Types that are members of the specified group are rendered, along with the Process entities that utilize those Data Types.
translation
Similar to a "data" graph type; additionally takes into account the translation between Data Types as specified in Process definitions (via DFDPROC macros).

See DataFlowDiaPluginFormatting for details on formatted text output.
Topic revision: r1 - 21 Oct 2016, JohnKnutson
The copyright of the content on this website is held by the contributing authors, except where stated elsewhere. See Copyright Statement. Creative Commons License    Legal Imprint    Privacy Policy