<fields> element, several meta-information about the document to import can be provided. The subsequent table contains the possible child elements in the exact order in which they must appear inside the <
fields> element. If not stated differently, the elements may be empty.
|The site to import the document to. This may only be emtpy, if the site can be determined from the |
|The structure node of the site. May only be empty, if an existing document is updated (the existing location is kept), the structure node is defined by a site mapping or default structure node in defined in the instance configuration.|
|The categories that are assigned to this document. Every assigned category has to be provided using an individual |
Additionally, by using the attribute
|The ID stem is the basis of the Sophora ID. It may be comprised of lower and upper case letters in combination with "_" and "-". This element may only be empty, if an existing document.|
|Defines whether to break a document's lock if it is locked by another user. If this value is |
This attribute specifies a timeout in minutes for the importer for trying to obtain the lock of the document. If the document is locked by a user, the importer will show a dialog in the DeskClient to the user holding the lock, asking her to release it. The dialog will be shown every two minutes until the lock is released or the timeout is reached. If the timeout is reached, the lock will be broken if
This attribute specifies an interval in minutes that the importer will use when re-trying to obtain the lock of the document. (Default: 2)
|Determines whether a new document will be created, if the specified external ID already exists. Possible values are |
If the external ID of the document to import is given and the repository already contains this ID, the external ID of the document to import is modified and a new document will be created.
|Lists of channel names for which the document is activated or deactivated. See "Channels" below.|
The following example shows typical fields of an import XML. Such XML will force the lock of the document to import (achieved locks of other Sophora users will be broken!) and will not create new document automatically, if the given external ID already exists in the Sophora repository:
<?xml version="1.0" encoding="UTF-8"?> <document nodeType="sophora-content-nt:imageobject" xmlns="http://www.sophoracms.com/import/4.2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <properties> [...] </properties> <childNodes> [...] </childNodes> <resourceList /> <fields> <site>news</site> <structureNode>/multimedia/bilder</structureNode> <categories> <category>Inland</category> <category>Sport;Fußball;Bundesliga</category> </categories> <idstem>bundesliga</idstem> <forceLock>true</forceLock> <forceCreate>false</forceCreate> <channels> <enabledChannels/> <disabledChannels/> </channels> </fields> <instructions> [...] </instructions> </document>