Move
The <Move>
element moves or renames a field.
By default the source field and destination parent field are defined by the context <Field>
element. You can specify a different source or destination by setting the srcId
and destId
attributes. In other words, if you set neither srcId
nor destId
, the field stays in the same place in the metadata structure. If you set srcId
but not destId
, the new field is added as a child of the context field.
Operations are not allowed to follow as siblings of the <Move>
element.
Attribute | Description |
---|---|
destId
|
The destination parent field to move the selected field to. You must identify the destination field by tagging it with an id attribute with the same value (as in the example, below). |
name
|
The name of the resulting field. |
srcId
|
The source field to move. You must identify the source field by tagging it with an id attribute with the same value (as in the example, below). |
The following example renames the field "MyField" to "MyNewField":
<FieldStandardization> <Field name="MyField"> <Move name="MyNewField" /> </Field> </FieldStandardization>
The following example moves both "MyField/subField1" and "MyField/subField2" to the root of the document.
- "MyField/subField1" is selected using
Field
elements and then moved to the destination "root", which is the root of the document because there is anid="root"
attribute set on theFieldStandardization
element. - The operation
<Move srcId="sf" />
moves the field withid="sf"
to the current location.
<FieldStandardization id="root"> <Field name="MyField"> <Field name="subField1"> <Move destId="root" /> </Field> <Field name="subField2" id="sf" /> </Field> <Move srcId="sf" /> </FieldStandardization>