Common Attributes

List of attributes for common elements.

extkey (boolean)

extkey (boolean)

Syntax

[extkey = Boolean : false]

May occur in

<field> < fields > <cond> <getcat>

any Import field

Description

An indicator of whether the referenced (field-) value specifies an external key.

Remarks

Currently, this attribute is also used to specify an external key in other places. This is fixed in an upcoming version.

extkey (value)

extkey (value

Syntax

[extkey = string]

May occur in

<link>

destination_record source_record

Description

The value of an external key.

Remarks

Currently, this attribute is also used to specify whether an external key is referenced in other places. This is fixed in an upcoming version.

extkey_as_attr

extkey_as_attr (boolean)

Syntax

[extkey_as_attr = Boolean : false]

May occur in

<field> < fields > <cond>

Description

An indicator of whether the external key of a catalog value is returned as its own attribute extkey on field level. If true, the external key is returned (as value of attribute extkey) as well as the catalog text in the response.

Remarks

This attribute is only valid in conjunction with the attribute extkey.

The following examples of request and response with extkey_as_attr on field level.

      <request>
        <query>
          <tables>
            <table tablename="Company"/>
          </tables>
          <fields>
            <field tablename="Company" fieldname="Company"/>
            <field tablename="Company" extkey="true" extkey_as_attr="true" fieldname="Country"/>
          </fields>
        </query>
      </request>
      <response>
        <query>
          <Company tableshort="FI" id="73014444233">
            <Company>Austrian Company</Company>
            <Country extkey="AUT">Österreich</Country>
          </Company>
        </query>
      </response>

extsystem

extsystem

Syntax

[extsystem = string]

May occur in

< cond > < link > < merge >

any valid Command element

any valid Table or field element

Description

The value of an external system.

Remarks

Used in conjunction with an external key.

fid

fid

Syntax

[fid = int]

May occur in

< field > (or any other field reference)

Description

The field id or the core field id (see cid attribute in <metainfo/>), unique within its table.

Remarks

The field index is usually specified in the fnr attribute.

fieldname

fieldname

Syntax

[fieldname = string]

May occur in

< field > (or any other field reference)

Description

The XML name of a field, unique within its table.

Remarks

The language-dependent name is usually specified in the name attribute.

fields

fields

Syntax

[fields = string]

May occur in

< field > (or any other field reference)

Description

A comma-separated list of fields.

Remarks

Wildcards and regular expressions can be used.

fnr

fnr

Syntax

[field = int]

May occur in

< field > (or any other field reference)

Description

The field index, unique within its table.

Remarks

The field id is usually specified in the fid attribute.

if

if

Syntax

[if = string]

May occur in

any Command element

Description

An XPath specifying a condition that is evaluated against the current MP-document. If successful, the element is processed, otherwise it is ignored.

Remarks

See Message Processing.

mnr

mnr

Syntax

[mnr = unsignedShort]

May occur in

(any field)

Description

The tenant number.

name

name

Syntax

[name = string]

May occur in

<cond>

(used in various places in the response document)

Description

The name of a table, field, catalog, or other entity.

Remarks

Commonly used to reference a language-dependent entity in the data model.

optional

optional

Syntax

[optional = Boolean : false]

May occur in

<link>

(any import field)

Description

An indicator of whether a processing error of this element causes an error. If true, an error is ignored and the respective element is treated as if it is absent.

Remarks

Commonly used for optional links.

recId

recId

Syntax

[recId = unsignedLongHex]

May occur in

<table>

(any record)

Description

A 64-bit record id specified in hexadecimal notation and prefixed with an 'x' character.

Remarks

Usually represented in full length with left zero padding.

table

table

Syntax

[table = string]

May occur in

< table > or any other table reference

Description

The table id. When used in an XML request, interface also tries to look up the table by its name when it is not found via its id.

Remarks

See also the tablename attribute.

tablename

tablename

Syntax

[tablename = string]

May occur in

< table > or any other table reference

Description

The XML name of a table. When used in an XML request, interface also tries to look up the table by its id when it is not found via its name.

Remarks

See also the table attribute.

value

value

Syntax

[value = string]

May occur in

<cond>

(used in various places in the response document)

Description

The value of a condition or field.

Remarks

none