Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5b

Application v 5.24b

  

 

Chapter ElevenSGML Functions (continued)

XBRLGetDefinitionArcs Function

Overview

The XBRLGetDefinitionArcs function returns a table of defined definition arcs for the loaded linkbase.

Syntax/Parameters

Syntax

string[][] = XBRLGetDefinitionArcs ( handle hXM, [int link] );

Parameters

hXM

A handle to an XBRL Object containing taxonomy information.

link

An optional int specifying the zero-based starting position to start returning arcs.

Return Value

Returns a string table of definition arcs or an empty array on failure. Use the GetLastError function to retrieve a formatted error code.

Remarks

Arcs connect labels to specific elements.

The column key names are as follows: 

  Key Name   Description/Comment  
           
  Arc Record:      
    arcrole   The arcrole attribute.  
    context_element   The contextElement attribute.  
    from   The from attribute label to the arc. This is the link from the locator to the arc.  
    order   The order attribute. Decimal with two places.  
    closed   The closed attribute, “true”, “false” or empty string.  
    priority   The priority attribute.  
    show   The show attribute.  
    title   The tittle attribute.  
    to   The to attribute as the label used to link the arc to an actual footnote record.  
    use   The use attribute.  
  Control:      
    position†   The zero based position within the definition link table.  
    s_dx†   Source file DTS index. String is “-1” if not from the DTS.  
    s_lx†   Source file linkbase index. String is “-1” if not from the Linkbase List.  
    o_sx†   Position in source file.  
    o_sy†   Position in source file.  
    ref_cnt   Number of arc references.  
    arc_flags   A string as a hexadecimal value for the status of the entry.  

 

† This value is not presented in terse mode.

Arc records are set in load order with gaps between link groups. As such, locators can be dumped a complete table or in sections when a arc position is specified.

The first arc link can be accessed from the definition link data retrieved by the XBRLGetDefinitionLink or XBRLGetDefinitionLinks functions.

If all arc are requested, there will be null records that delineate the break points in the list between definition links. the arc_flags column will have the XM_ARC_NULL_RECORD bit set.  

Related Functions

Platform Support

Go13, Go16, GoFiler Complete, GoFiler Corporate, GoFiler, GoFiler Lite, GoXBRL

Legato IDE, Legato Basic