XIP Permissions: Unterschied zwischen den Versionen

Aus SiteparkWiki
Zur Navigation springen Zur Suche springen
(Die Seite wurde neu angelegt: =<code><permision></code>= ===Beschreibung=== Dieses XML-Element wird verwendet um IES-Rechte zu definieren. ===Erlaubte übergerodnete XML-Elemente=== <code><xip></cod...)
 
Zeile 1: Zeile 1:
−
=<code><permision></code>=
+
Rechte können über zwei Arten über XIP definiert werden.
 +
* '''<code><holder></code>''' - Definition der Rechte eines Pools. Hiermit werden nur die Rechte eines Pools für einen Nutzer/Nutzerpool gesetzt. Sollten bei einem Import rekursive Rechte vergeben werden, werden diese Rechte für bereits existierende Unterpools nicht weitergegeben. Bei Pools die anschließend in diesem Pool erzeugt werden, werden die Rechte rekursive weitergegeben (wenn automatisch recursive).
 +
* '''<code><permission></code>''' - Definition der Rechte wie über Infosite 5. Hiebei wird die Funktionalität von Infosite 5 abgebildet, mit der die Rechte vergeben werden. Hierbei können Rollen hinzugefügt und gelöscht werden oder Rollen ersetzt werden. Werden Rollen mit rekursiven Rechten hinzugefügt werden die auch auf alle bereits existierenden Unterpools weitergegeben.
 +
 
 +
 
 +
 
 +
 
 +
 
 +
=<code><holder></code>=
 
===Beschreibung===
 
===Beschreibung===
−
Dieses XML-Element wird verwendet um IES-Rechte zu definieren.
+
Dieses XML-Element wird verwendet um IES-Rechte eines Nutzer/Nutzerpools für einen Pool zu definieren. Dieses Element ist immer in einem <code><permission></code>-Element eingebetten. Dieses Permission-Element besitzt entweder ein <code>anchor</code>-Attribute, um zu definieren, für welchen Nutzer/Nutzerpool das Recht definiert ist oder es besitzt keine Attribute und liegt im [[XIP Format#XIP-INF_Verzeichnis|XIP-INF]]-Verzeichnis des Pools, für den die Rechte definiert sind.
 
===Erlaubte übergerodnete XML-Elemente===
 
===Erlaubte übergerodnete XML-Elemente===
−
<code><xip></code>, <code><userpool></code>
+
<code><permission></code>
 
===Attribute===
 
===Attribute===
 
{| class="prettytable sortable"
 
{| class="prettytable sortable"
Zeile 9: Zeile 17:
 
! Name || Beschreibung
 
! Name || Beschreibung
 
|-
 
|-
−
| <code>parent</code>
+
| <code>anchor</code>
−
| Anchor des Nutzer-Pools für diesen Nutzer. Die Angabe eines Parents ist nicht nötig, wenn die XML-Datei in einem Verzeichnis liegt, das als Pool definiert wurde (siehe [[XIP Format#XIP-INF_Verzeichnis|XIP-INF]]). Elemente können auch ohne Angabe eines Parents importiert werden, wenn mit dem Parameter <code>ies.xip.import.root</code> ein Parent definiert wurde.
+
| Anchor des Nutzers/Nutzerpools für den die Rechte definiert sind.
 
|}
 
|}
  
 
===Unterelemente===
 
===Unterelemente===
−
====<code><comment></code>====
+
====<code><role></code>====
 
=====Beschreibung=====
 
=====Beschreibung=====
−
Kommentare zu dem Nutzer
+
Rollen die dem Nutzer/Nutzerpool für den Pool zugeordnet sind.
 
=====Attribute=====
 
=====Attribute=====
−
keine
+
{| class="prettytable sortable"
−
====<code><resource></code>====
+
|- class="hintergrundfarbe1"
−
=====Beschreibung=====
+
! Name || Beschreibung
−
Beliebiger Content, der für den Nutzer definiert werden soll. Wie die einzelnen Content-Elemente definiert werden, ist unter[[XIP Content]] beschrieben.
+
|-
−
=====Attribute=====
+
| <code>anchor</code>
−
keine
+
| Anchor der Rolle, die dem Nutzer/Nutzerpool für den Pool zugeordnet sind
−
===Beispiel für einen Nutzer===
+
|-
 +
| <code>hide</code>
 +
| Gibt an, ob der Pool versteckt werden soll. <code>true</code> oder <code>false</code>
 +
|-
 +
| <code>recusion</code>
 +
| Gibt an, ob die Rechte des Pools rekursive weitergegeben werden sollen, wenn neue Pools dem Pool angelegt werden.
 +
<code>0</code> = keine Rekursion, <code>2</code> = Rechte automatisch Rekursive weitergeben.
 +
|}
 +
 
 +
===Beispiel für einen Rechtedefinition===
 
<source lang="xml">
 
<source lang="xml">
 
<?xml version="1.0" encoding="UTF-8"?>
 
<?xml version="1.0" encoding="UTF-8"?>
  
−
<user
+
<permission pool="pool.tutorial">
−
   anchor="user.wacker" name="Wacker, Willi (wacker)" parent="userpool.test2"
+
   <holder anchor="user.wacker">
−
  login="wacker" password="d2Ezc1lZQXRVUmZJSQ==" firstname="Willi"
+
      <role anchor="role.example.1" hide="false" recursion="0" />
−
  lastname="Wacker" email="willi.wacker@sitepark.com" locale="de" type="3003">
+
      <role anchor="role.exapmle.2" hide="true" recursion="1" />
 +
  </holder>
 +
</permission>
 +
</source>
 +
 
 +
 
  
−
  <resource>
 
−
    <text name="company">Sitepark GmbH</text>
 
−
  </resource>
 
  
−
</user>
+
 
 +
=<code><permission></code>=
 +
===Beschreibung===
 +
Im oben beschriebenen Fall wird dieses XML-Elemente dazu verwendet die <code><holder></code>-XML-Element zusammen zu fassen und den Pool zu definieren, für den die Rechte gelten.
 +
 
 +
Dieses XML-Element wird aber auch dazu verwendet Rechte so zu vergeben, wie es den Aktionen in der Infosite 5 Oberfläche entspricht (ersetzen, hinzufügen, löschen, alle löschen).
 +
===Erlaubte übergerodnete XML-Elemente===
 +
<code><permission></code>
 +
===Attribute===
 +
{| class="prettytable sortable"
 +
|- class="hintergrundfarbe1"
 +
! Name || für Modus || Beschreibung
 +
|-
 +
| <code>mode</code>
 +
|
 +
| Modus in der die Aktion ausgeführt werden soll. Folgende Werte sind möglich
 +
;set
 +
:Setzt ein Rolle. Existieren noch Rollen für den Nutzer/Nutzerpool für den Pool, so werden diese gelöscht.
 +
;add
 +
:Fügt ein Rolle hinzu. Existieren noch Rollen für den Nutzer/Nutzerpool für den Pool, so bleiben diese erhalten.
 +
;delete
 +
:Löscht diese Rolle für den Nutzer/Nutzerpool und den Pool
 +
;delete-all
 +
:Löscht allen Rollen für den Nutzer/Nutzerpool und den Pool
 +
|-
 +
| <code>holder</code>
 +
| <code>set, add, delete, delete-all</code>
 +
| Anchor des Nutzers/Nuterpools, für den die Rechte definiert sind.
 +
|-
 +
| <code>pool</code>
 +
| <code>set, add, delete, delete-all</code>
 +
| Anchor des Pools, auf der der Nutzers/Nuterpools Rechte hat
 +
|-
 +
| <code>role</code>
 +
| <code>set, add, delete</code>
 +
| Rolle die gesetzt, hinzugefügt oder gelöscht werden soll
 +
|-
 +
| <code>hide</code>
 +
| <code>set, add</code>
 +
| Gibt an, ob der Pool versteckt werden soll. <code>true</code> oder <code>false</code>
 +
|-
 +
| <code>recusion</code>
 +
| <code>set, add</code>
 +
| Gibt an, ob die Rechte des Pools rekursive weitergegeben werden sollen, wenn neue Pools dem Pool angelegt werden.
 +
<code>0</code> = keine Rekursion, <code>2</code> = Rechte automatisch Rekursive weitergeben.
 +
|}
 +
===Beispiel für einen Rechtedefinition===
 +
<source lang="xml">
 +
<?xml version="1.0" encoding="UTF-8"?>
 +
 
 +
<permission mode="set" holder="user.example.1" pool="pool.tutorial" role="role.example.1" hide="false" recursion="2">
 +
 
 
</source>
 
</source>
−
 
 
<noinclude>
 
<noinclude>
 
[[Category:XIP]]
 
[[Category:XIP]]

Version vom 11. Mai 2009, 12:54 Uhr

Rechte können über zwei Arten über XIP definiert werden.

  • <holder> - Definition der Rechte eines Pools. Hiermit werden nur die Rechte eines Pools für einen Nutzer/Nutzerpool gesetzt. Sollten bei einem Import rekursive Rechte vergeben werden, werden diese Rechte für bereits existierende Unterpools nicht weitergegeben. Bei Pools die anschließend in diesem Pool erzeugt werden, werden die Rechte rekursive weitergegeben (wenn automatisch recursive).
  • <permission> - Definition der Rechte wie über Infosite 5. Hiebei wird die Funktionalität von Infosite 5 abgebildet, mit der die Rechte vergeben werden. Hierbei können Rollen hinzugefügt und gelöscht werden oder Rollen ersetzt werden. Werden Rollen mit rekursiven Rechten hinzugefügt werden die auch auf alle bereits existierenden Unterpools weitergegeben.



<holder>

Beschreibung

Dieses XML-Element wird verwendet um IES-Rechte eines Nutzer/Nutzerpools für einen Pool zu definieren. Dieses Element ist immer in einem <permission>-Element eingebetten. Dieses Permission-Element besitzt entweder ein anchor-Attribute, um zu definieren, für welchen Nutzer/Nutzerpool das Recht definiert ist oder es besitzt keine Attribute und liegt im XIP-INF-Verzeichnis des Pools, für den die Rechte definiert sind.

Erlaubte übergerodnete XML-Elemente

<permission>

Attribute

Name Beschreibung
anchor Anchor des Nutzers/Nutzerpools für den die Rechte definiert sind.

Unterelemente

<role>

Beschreibung

Rollen die dem Nutzer/Nutzerpool für den Pool zugeordnet sind.

Attribute
Name Beschreibung
anchor Anchor der Rolle, die dem Nutzer/Nutzerpool für den Pool zugeordnet sind
hide Gibt an, ob der Pool versteckt werden soll. true oder false
recusion Gibt an, ob die Rechte des Pools rekursive weitergegeben werden sollen, wenn neue Pools dem Pool angelegt werden.

0 = keine Rekursion, 2 = Rechte automatisch Rekursive weitergeben.

Beispiel für einen Rechtedefinition

<?xml version="1.0" encoding="UTF-8"?>

<permission pool="pool.tutorial">
   <holder anchor="user.wacker">
      <role anchor="role.example.1" hide="false" recursion="0" />
      <role anchor="role.exapmle.2" hide="true" recursion="1" />
   </holder>
</permission>



<permission>

Beschreibung

Im oben beschriebenen Fall wird dieses XML-Elemente dazu verwendet die <holder>-XML-Element zusammen zu fassen und den Pool zu definieren, für den die Rechte gelten.

Dieses XML-Element wird aber auch dazu verwendet Rechte so zu vergeben, wie es den Aktionen in der Infosite 5 Oberfläche entspricht (ersetzen, hinzufügen, löschen, alle löschen).

Erlaubte übergerodnete XML-Elemente

<permission>

Attribute

Name für Modus Beschreibung
mode Modus in der die Aktion ausgeführt werden soll. Folgende Werte sind möglich
set
Setzt ein Rolle. Existieren noch Rollen für den Nutzer/Nutzerpool für den Pool, so werden diese gelöscht.
add
Fügt ein Rolle hinzu. Existieren noch Rollen für den Nutzer/Nutzerpool für den Pool, so bleiben diese erhalten.
delete
Löscht diese Rolle für den Nutzer/Nutzerpool und den Pool
delete-all
Löscht allen Rollen für den Nutzer/Nutzerpool und den Pool
holder set, add, delete, delete-all Anchor des Nutzers/Nuterpools, für den die Rechte definiert sind.
pool set, add, delete, delete-all Anchor des Pools, auf der der Nutzers/Nuterpools Rechte hat
role set, add, delete Rolle die gesetzt, hinzugefügt oder gelöscht werden soll
hide set, add Gibt an, ob der Pool versteckt werden soll. true oder false
recusion set, add Gibt an, ob die Rechte des Pools rekursive weitergegeben werden sollen, wenn neue Pools dem Pool angelegt werden.

0 = keine Rekursion, 2 = Rechte automatisch Rekursive weitergeben.

Beispiel für einen Rechtedefinition

<?xml version="1.0" encoding="UTF-8"?>

<permission mode="set" holder="user.example.1" pool="pool.tutorial" role="role.example.1" hide="false" recursion="2">
Abgerufen von „https://wiki.sitepark.com/index.php?title=XIP_Permissions&oldid=3221“