Dimension CreateAttributeTable

Creates one or more attribute tables for a dimension.

The respective attribute table or tables must not exist when the operation starts.

After the operation finished successfully, the dimension is saved to disk.

Request

<Alea:Document xmlns:Alea="http://www.misag.com">
  <Alea:Request RequestID="001" Class="Dimension" Method="CreateAttributeTable">
    <Alea:Dimension Name="ValType">
      <Alea:AttributeTable ID="1">
        <Alea:Attribute Name="AFstring1" Type="C" Width="120">
          <Alea:Description>String attribute field</Alea:Description>
        </Alea:Attribute>
        <Alea:Attribute Name="AFdate1" Type="D" Width="8">
          <Alea:Description>Date attribute field</Alea:Description>
        </Alea:Attribute>
        <Alea:Attribute Name="AFlogical1" Type="L" Width="1">
          <Alea:Description>Logical attribute field</Alea:Description>
        </Alea:Attribute>
      </Alea:AttributeTable>
      <Alea:AttributeTable ID="2">
        <Alea:Attribute Name="AFnumeric2" Type="N" Width="10" Decimal="2">
          <Alea:Description>Numeric attribute field</Alea:Description>
        </Alea:Attribute>
      </Alea:AttributeTable>
    </Alea:Dimension>
  </Alea:Request>
</Alea:Document>

This table describes the XML attributes of the <Alea:Attribute> XML element:

Value of Type attribute Represented type Width (allowed values) Decimal (allowed values)
C String 1 to 253 Not applicable
N Numeric 1 to 253 0 to (width-2)
D Date 8 Not applicable
L Logical 1 Not applicable

For example, when the width of a numeric attribute is set to 10, you can define 0 to 8 bytes for the decimals.

AttributeTable IDs are 1-based. The valid AttributeTable IDs are 1, 2 and 3. The Decimal XML attribute is optional. Its default is 0.

Answer

<Alea:Document xmlns:Alea="http://www.misag.com">
  <Alea:Request RequestID="001">
    <Alea:Return />
  </Alea:Request>
</Alea:Document>

Error

<Alea:Document xmlns:Alea="http://www.misag.com">
  <Alea:Request RequestID="001">
    <Alea:Error ErrorID="error_code"/>
  </Alea:Request>
</Alea:Document>

In case of an error, no attribute table is created.

Related topics