XDTO Package Editing Window

When you add a new XDTO package to the configuration tree, the XDTO package editing window opens automatically.

To open the XDTO package editing window, select the required package and use the Open package command.

The XDTO package editing window contains the hierarchical tree of the XDTO package.

The XDTO package ID containing the corresponding namespace URI is located in the tree root.

The first hierarchy level can include the following package items:

  • Import directives – a list of import directives. When you use 1C:Enterprise script to work with this XDTO package, the list of import directives will be available as the XDTOPackagesCollection object included in the Dependences property of the XDTO package.
  • Value types – a list of XDTO value types included in the XDTO package.
  • Object types – a list of XDTO object types included in the XDTO package.
  • Properties - a list of XDTO package properties. It represents declarations of objects/values that can be root items of XML documents that belong to the namespace URI of this XDTO package.

Each XDTO value type is described by the hierarchical structure and can contain the following items:

  • Pattern describes one XDTO facet of the Pattern type;
  • Enumeration – describes one XDTO facet of the Enumeration type.

Every XDTO object type is described by the hierarchical structure, which can contain a set of object properties.

XDTO Package Properties

XDTO package properties are edited in the properties palette.

In addition to the main properties (displayed when editing window is closed), you should also specify the namespace of the imported package.

XDTO Value Type Properties

XDTO value type properties are edited in the properties palette.

For XDTO value types, the properties palette includes the following properties:

  • Name - name of the XDTO value type;
  • Basic type - basic type for this XDTO value type;
  • Variant - simple type variant (elementary type, list, merger). If the value is specified, it should contradict values Element type and Merge types.
  • Element type – list item type when XDTO value type is defined by the list. All facets and the Types of subordinates should be empty;
  • Merge types - the list of types that create a merger when XDTO value type is defined by merger. Only XDTO value types can be merged. All facets and the Element Type property must be null;
  • Length - length facet;
  • Minimum length - minimum length facet;
  • Maximum length – maximum length facet;
  • Whitespaces - white spaces facet;
  • Minimum, including limit – facet of the minimum, including limit;
  • Minimum, excluding limit – facet of the minimum, excluding limit;
  • Maximum, including limit - facet of the maximum, including limit;
  • Maximum, excluding limit – facet of the maximum, excluding limit;
  • Total number of digits – facet of the total number of digits;
  • Number of fractional digits – facet of the number of fractional digits.
XDTO Object Type Properties

XDTO object type properties are edited in the properties palette.

For an XDTO object type, the properties palette includes the following properties:

  • Name - name of the XDTO object type;
  • Basic type - basic type for this XDTO object type;
  • Open - indicates if this XDTO object type is open. This property indicates whether this XDTO object can contain properties not defined in its type;
  • Abstract – indicates whether the type of XDTO object is abstract.
  • Mixed – the property indicates whether the corresponding XDTO object has mixed content. If this property is True, then the Consecutive value will always be True because mixed content cannot be modeled without using an XDTO sequence;
  • Ordered – indicates if the order of items representing property values strictly corresponds to the order of properties in the XDTO object type. If the property is False, then the input sequence order of XML items is not controlled, and output is defined by the sequence order of properties, provided that the value of the Consecutive property is not True;
  • Consecutive – indicates whether the corresponding XDTO object contains an XDTO sequence. This option is True when the order of the nested XML items cannot be unequivocally defined by the sequence order of the properties in the type, or the corresponding XDTO object has mixed content. Use the XDTO sequence to explicitly define the order of items for their presentation in the XML document. For the type objects that are False, the order of nested items corresponds sequence order of properties.
Properties of XDTO Object Type Properties

A property of the XDTO object type properties are edited in the properties palette.

For a property of XDTO object type properties, the properties palette includes the following properties:

  • Name – property name. The property names should be unique within one type of an XDTO object;
  • Type – property type. It can be both XDTO value type and XDTO object type;
  • Minimum number – minimum number of property values. Maximum number of property values can have values >= 0;
  • Maximum number – a property of an XDTO object type can be defined as containing a single or multiple values. A property is considered to contain a single value if this property = 1. When property value is > 1, it is considered that the property may have multiple values. These properties are modeled as a list in the object structure. The Maximum number value shows the maximum number of property values. Maximum number > 1 can be defined only for the properties represented as an XML item;
  • Null able – indicates whether the property can have an indeterminate value. True can be defined only for the properties with Item representation form. If Maximum number > 1, an undefined value is allowed for the property values list item;
  • Fixed – specifies if the property value is fixed. True - the fixed value itself can be obtained using the Default property;
  • Default – default property value. The default value type can only be the XDTO value type. In terms of type, this value must be compatible with the property type (i.e. be of the same type with the property type, or of the inherited type). When an XDTO object is created and a single value is allowed for a property, it would take the default value. For properties with multiple values, a list of values is empty, regardless of availability of the default value;
  • Form – is the form of property presentation in XML. It can be Text, Item or Attribute. If presentation form is Attribute or Text, value of the Maximum number property cannot be over 1. If the property is Text, the value of the Maximum number property should also be 1. For every type only a single property may have Text for presentation form while the remaining properties should be Attribute;
  • Local name – local name used for property representation. For properties with Text for presentation form it is an empty string.
Global property

Properties of a global property are edited in the properties palette.

For a global property, the properties palette includes the following properties:

  • Name – global property name. The global property names should be unique within one type of an XDTO object;
  • Link - a link to root definition of package properties;
  • Type – global property type;
  • Minimum number – minimum number of property values. If the property is 0, the value for the property may be undefined;
  • Maximum number – maximum number of property values. If = -1, the number of values for the property is unlimited;
  • Null able – indicates whether the property can have an indeterminate value;
  • Fixed – specifies if the property value is fixed;
  • Default – default property value. Lexical representation of property value should comply with the rules to check type for this property;
  • Form – is the form of property presentation in XML. It can be Text, Item or Attribute;
  • Local name – local name used for property representation.

1C:Enterprise Developer's Community