XIP Format: Unterschied zwischen den Versionen

Aus SiteparkWiki
Zur Navigation springen Zur Suche springen
Zeile 11: Zeile 11:
  
  
==Artikelpools==
 
Um einen Artikelpool zu importieren, muss eine XML-Datei erstellt werden, die das Root-Element "<code>articlepool</code>" verwendet. Attribute des Tags erlauben die Beschreibung des Pools. Alle Angaben neben Systemwerten werden innerhalb eines Resource-Tags vorgenommen. Hier gelten die selben Bedingungen wie bei Resource-Artikeln.
 
  
Attribute des XML-Elements "<code>articlepool</code>"
 
;<code>anchor</code>
 
:Anker des Pools. Dient beim wiederholten Import als Primärschlüssel dieser Daten und als Parent für die Artikel ([[String]]).
 
;<code>name</code>
 
:Name des Pools ([[String]]).
 
;<code>parent</code>
 
:Anker des Parentpools. Die Angabe muss über einen Anker erfolgen ([[String]]).
 
;<code>directory</code>
 
:Angabe des Arbeitsverzeichnisses dieses Artikelpools ([[String]]).
 
 
Hier ein vollständiges Beispiel eines Artikelpools:
 
<source lang="xml">
 
<!--
 
Einen Artikelpool anlegen:
 
 
<articlepool    legt einen Artikel an
 
 
anchor          Anker des Pools (dient beim wiederholten Import als Primärschlüssel
 
                und als Parent für die Artikel)
 
name            Name des Pools
 
parent          Anker des Parentpools (Angabe muss über einen Anker erfolgen)
 
directory      Angabe des Arbeitsverzeichnisses dieses Artikelpools
 
-->
 
 
<articlepool
 
  anchor="import.pool.1"
 
  name="Pool für importierte Artikel (Ebene 1)"
 
  parent="gui.informations"
 
  directory="/level_1">
 
 
    <!--
 
      Sämtliche META-Daten eines Pools werden vom System implizit in einer
 
      Resource gespeichert
 
    -->
 
    <resource>
 
        <!--
 
          einfache Textfelder, in denen die Konfiguration der Artikelpools
 
          steht (auch hier über die Angabe von Ankern gelöst)
 
        -->
 
 
        <!--
 
          Angabe des Containers:
 
          "is5:gui.container.infosite.standard" oder
 
          "is5:gui.container.infosite.media" möglich
 
        -->
 
        <text name="container" anchor="is5:gui.container.infosite.standard"></text>
 
 
        <!--
 
          Angabe des Template-Pools, für die Auswahl von Templates in diesem Pool:
 
          Ein Anker aus dem eigenem System
 
        -->
 
        <text name="editorTemplatePool" anchor="standard.container.editing"></text>
 
 
        <!--
 
          Angabe des Templates für die Artikelanmeldung:
 
          "is5:gui.container.infosite.standard.all"
 
          erlaubt beispielsweise das Anlegen aller Artikeltypen
 
        -->
 
        <text
 
          name="registrationTemplate"
 
          anchor="is5:gui.container.infosite.standard.all">
 
        </text>
 
 
        <!-- beliebige weitere Eingabefelder -->
 
        <text name="sp_rubric">demo</text>
 
        <systemlink name="sp_parentLink" anchor="article.rubric"/>
 
    </resource>
 
</articlepool>
 
</source>
 
 
===Angaben zur Konfiguration===
 
Damit ein Artikelpool in InfoSite 5 so funktioniert wie ein manuell ersteller Pool, müssen bestimmte Felder mit entsprechenden <code>META</code>-Daten angelegt werden. Hierzu zählen im Besonderen die Angaben zum Feld "<code>container</code>" und "<code>registration_template</code>". Die Felder "<code>editor_template_pool</code>" und "<code>editor_template</code>" verweisen auf das ausgewählte Template bzw. den Templatepool, der dem Redakteur zur Verfügung steht.
 
<source lang="xml">
 
<!--
 
Angabe des Containers:
 
  is5:gui.container.infosite.standard
 
  is5:gui.container.infosite.media
 
-->
 
<text name="container" anchor="is5:gui.container.infosite.standard"></text>
 
 
<!--
 
Angabe des Template-Pools, für die Auswahl von Templates in diesem Pool:
 
  Ein Anker aus dem eigenem System
 
-->
 
<text name="editorTemplatePool" anchor="standard.container.editing"></text>
 
 
<!--
 
Angabe des Templates für die Artikelanmeldung:
 
  is5:gui.container.infosite.standard.all
 
  (erlaubt z.B. das Anlegen aller Artikeltypen)
 
-->
 
<text
 
  name="registrationTemplate"
 
  anchor="is5:gui.container.infosite.standard.all">
 
</text>
 
</source>
 
 
====Standard InfoSite Container====
 
Der "Standard InfoSite Container" wird i.d.R. für alle normalen Artikelpools verwandt. Hierüber ist ein Redakteur in der Lage, Artikel jeden Typs anzulegen. Die Konfiguration der möglichen Artikeltypen wird über das Feld "<code>registration_template</code>" vorgenommen. Dies erfolgt in InfoSite über eine Select-Box. Im XML-Dokument müssen diese Werte manuell über Anker eingestellt werden. Folgende Anker sind dafür vorhanden:
 
;"alle Artikel-Typen"
 
:<code>gui.container.infosite.standard.all</code>
 
;"nur Medien anlegen"
 
:<code>gui.container.infosite.standard.media</code>
 
;"nur Ressourcen anlegen"
 
:<code>gui.container.infosite.standard.resource</code>
 
;"nur Seiten anlegen"
 
:<code>gui.container.infosite.standard.page</code>
 
;"nur Seiten ohne Namensvergabe anlegen"
 
:<code>gui.container.infosite.standard.pageAutoName</code>
 
;"nur Seiten und Medien anlegen"
 
:<code>gui.container.infosite.standard.pageAndMedia</code>
 
;"nur Seiten und Ressourcen anlegen"
 
:<code>gui.container.infosite.standard.pageAndResource</code>
 
 
====Standard Medien Container====
 
Der "Standard Medien Container" wird für reine Medienpools verwandt. Hier sind neben der Angabe <code>Container</code> keine weiteren Angaben notwendig.
 
  
 
==Nutzer-, Template- und Rollenpools==
 
==Nutzer-, Template- und Rollenpools==

Version vom 7. Mai 2009, 15:04 Uhr

Beschreibung

XIP (eXchange Information Package) ist ein von Sitepark entwickeltes Format zum Austausch von Daten in und aus dem IES.

Im einfachsten Fall besteht ein XIP aus einer XML-Datei. Die auszutauschenden Daten werden in einem definierten XML-Format beschrieben. Bei komplexeren Daten kann ein XIP aus mehreren Dateien bestehen, die unterhalb eines Verzeichnis liegen müssen, aber auch Unterverzeichnisse beliebiger Tiefe enthalten können. Dieses Verzeichnis kann auch mit ZIP zu einer ZIP-Datei zusammengefasst werden.

Ein XIP ist ein drei verschiedenen Formen gültig.

  1. Einfache XML-Datei
  2. Verzeichnisstruktur mit Dateien
  3. ZIP-Datei, die Verzeichnisstrukturen mit Dateien enthält



Nutzer-, Template- und Rollenpools

Um einen Nutzer-, Rollen oder Templatepool zu importieren, muss eine XML-Datei erstellt werden, die das entsprechende Root-Element, also "userpool", "templatepool" oder "rolepool" verwendet. Attribute des Tags erlauben die Beschreibung des Pools. Alle Angaben neben Systemwerten werden innerhalb eines Resource-Tags vorgenommen. Hier gelten die selben Bedingungen wie bei Resource-Artikeln.

Attribute der XML-Elemente "userpool", "templatepool", "rolepool"

anchor
Anker des Pools. Dient beim wiederholten Import als Primärschlüssel dieser Daten und als Parent für die Artikel (String).
name
Name des Pools (String).
parent
Anker des Parentpools. Die Angabe muss über einen Anker erfolgen (String).