Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


This document is intended for technical staff creating imports to Signifikant Platform and describes the Signifikant Simplified XML import format.

...

*    The persistent-identity is the only attribute that is required in the import file. Often the identity, persistent-identity and number are the same, but there are use cases where these have different values.

Info
titlePersistentID

The persistentID has to be unique per type of information and no duplicates may exist. E.g. there may only be one part with the same persistentID.

If persistentID is not unique the import engine will get confused and unexpected results may occur.

Specifications

You can add an arbitrary number of additional attributes to most data types in the Signifikant information model. During import, you provide their values by using the Specifications tag which takes key/value pairs (called type and value).

...

Code Block
languagexml
titleRemove command
<!-- Sample ContentSet removal -->
<ContentSets>
   <ContentSet remove="true">
      <persistent-identity>12345</persistent-identity>
   </ContentSet>
<ContentSets>


<!-- Sample Document removal -->
<Documents>
     <Document remove="true">
         <persistent-identity>12345</persistent-identity>
     </Document>
</Documents>


Updating or overwriting presentations

Basic function in import is that import will overwrite only the values in the xml file. That is if name, identity and persistent identity exist on a presentation and xml only contains persistent identity and description, the presentation will have a name, identity, description and persistent identity afther the import. Fields may, though, contain empty string. In this case the value of that field will be replaced by an empty string.

But presentations may also be overwritten. In this case the presentation is removed and then reimported according to the xml. This is achieved by an overwrite command according to below.


Code Block
languagexml
titleRemove command
<!-- Sample Catalogue overwrite -->
<Catalogues>
   <Catalogue overwrite="true">
      <persistent-identity>12345</persistent-identity>
   </Catalogue>
<Catalogues>


<!-- Sample Part overwrite -->
<Parts>
     <Part overwrite="true">
         <persistent-identity>12345</persistent-identity>
     </Part>
</Parts>


Specific components per data type of the xml import files

...

Each text may be defined by a persistent id which can be referred from all other exports. Each text contains all translations for that text with language defined using ISO 639-1 alternatively ISO 639-1 and ISO 3166.

A text with language "" is considered being invariant, the same for all languages.

...