Adding an element

Elements are added using the Alea:Elements tag sent inside the Alea:DimensionTemplate element.

These characters are not allowed for element names:

Characters with ASCII codes below 32. For example, <TAB>, <LF>, and <CR>.
The [ and ] characters.

The maximum length of an element name is 71 characters or 213 bytes. If an element name is greater than 71 characters or 213 bytes, ErrorID = 164 is returned. If an error is returned, the element is not created but the other objects are created.

Spaces are trimmed automatically at the beginning and the end of an element name. The element is created using the trimmed name. Other white spaces are not allowed and lead result in ErrorID = 325.

Request

This request adds an element to the default hierarchy. Replace \t with a horizontal tabulator before executing the request.

<Alea:Document xmlns:Alea="http://www.misag.com"> 
  <Alea:Request RequestID="4" Class="Dimension" Method="Write"> 
    <Alea:Dimension Name="Org" FirstBatch="true" LastBatch="true" > 
      <Alea:DimensionTemplate Name="Org"/>
          <Alea:Elements>!\tAll\tWater Department</Alea:Elements> 
    </Alea:Dimension> 
  </Alea:Request> 
</Alea:Document>

Request

This request adds an element to a non-default hierarchy. Replace \t with a horizontal tabulator.

<Alea:Document xmlns:Alea="http://www.misag.com"> 
  <Alea:Request RequestID="4" Class="Dimension" Method="Write"> 
    <Alea:Dimension Name="Org" FirstBatch="true" LastBatch="true" > 
      <Alea:DimensionTemplate Name="Org"/>
        <Alea:Hierarchy Name="Org as of 2014">
          <Alea:HierarchyTemplate Name="Org as of 2014" IgnoreSourceNotExist="false"/>
          <Alea:Elements>!\tEmergency\tFire Department</Alea:Elements>
        </Alea:Hierarchy>  
    </Alea:Dimension> 
  </Alea:Request> 
</Alea:Document>