Lektionen 10-17

Die nachfolgenden Lektionen bauen auf den Lektionen 1-9 auf und zeigen den weiterführenden Einsatz von XML in agorum core. Zu jeder Lektion gehört ein XML-Skript-Beispiel, das am Anfang der Lektion verlinkt ist. Laden Sie dieses Skript herunter, damit Sie es für die jeweilige Lektion verwenden können. Die Funktionsweise des Skripts ist im Skript beschrieben.

Für das Ausführen des XML-Skripts siehe Einführung in agorum core agoscript.

Lektion 10: Einen Rechtestempel (ACL) erstellen

In dieser Lektion erstellen Sie zwei Rechtestempel (ACLs). Für die Rechtestempel verwendet das System die Benutzergruppen aus Lektion 9.

Neben den ACLs erstellt das Skript in desk4web im Bereich ACL (Rechte) den Ordner XML-Script-Schulung.

<?xml version = "1.0" encoding="ISO-8859-1"?>
<ObjectList> 

 ..........
  
 <CustomAclObject SavePoint="${ACL_XML-Script-Schulung_Partner_READ}">
    <Name>ACL_XML-Script-Schulung_Partner_test2</Name>
    <Description>ACL, der alle Partner in den Partnerbereich lässt</Description>
    <adminsAffected>true</adminsAffected>
    <AddToFolder RefType="SavePoint">${XML-Script-Schulung}</AddToFolder>
    <NoErrorIfExist/>
 </CustomAclObject>    
            
</ObjectList>

Lektion 11: Eine Partnerakte anlegen

Lektion 11 enthält den Aufbau eines Partnerbereichs inklusive einer Akte für Partner A. Das System greift beim Anlegen der Ordner auf die vorhandenen ACLs aus der Lektion 10 zu.

Struktur nach dem Ausführen des Skripts

...
  XML-Script-Schulung
    Partnerbereich
      Partner A

Fügen Sie einen Benutzer in die angelegten Benutzergruppen ein, um die Rechte zu prüfen:

1. Melden Sie sich als Super-Administrator roi in agorum core an.
2. Kopieren Sie einen Benutzer aus der Benutzerverwaltung in die Zwischenablage.
3. Schalten Sie bei diesem Benutzer die ACL-Überwachung ein, indem Sie den gewünschten Benutzer markieren und dann unter Ansicht den Eintrag ACL Überwachung anklicken.
4. Fügen Sie den Benutzer in die Benutzergruppe GRP_XML-Script-Schulung-Partner_A_ALL hinzu.
5. Öffnen Sie in Dateien den Ordner:

   XML-Script-Schulung/Partnerbereich/Partner A
   

   
   Ergebnis: Durch die ACL-Überwachung erscheint farbig, welches Recht der Benutzer in den einzelnen Ordnern hat. Der Benutzer hat jetzt im Ordner Partnerbereich READ-Rechte und im Ordner Partner A ALL-Rechte.
6. Fügen Sie denselben Benutzer in die Benutzergruppe GRP_XML-Script-Schulung-Partner_A_READ ein.
7. Aktualisieren Sie die Baumstruktur, damit das neue Recht erscheint.
   
   Ergebnis: Der Benutzer hat jetzt in den Ordnern Partnerbereich und Partner A READ-Rechte (Priorität: NOT > READ > ALL).
8. Fügen Sie zuletzt den Benutzer in die Benutzergruppe GRP_XML-Script-Schulung-Partner_A_NOT ein.
9. Aktualisieren Sie die Baumstruktur.
   
   Ergebnis: Der Benutzer hat jetzt im Ordner Partnerbereich READ-Rechte und im Ordner Partner A keine Rechte mehr (Priorität: NOT > READ > ALL).

Lektion 12: Einen Benutzer erstellen

Mit diesem Skript erstellen Sie einen Benutzer für Partner A namens partner_a.user. Zudem legt das System in der Benutzerverwaltung den Ordner XML-Script-Schulung an, unter dem es den Benutzer erstellt.

Lektion 13: Zugriffsrechte ändern

In dieser Lektion versehen Sie den Schulungsbereich mit einem neuen Recht. Bisher galt das Recht Private, erhalten vom ausführenden Benutzer. Das Skript legt eine ACL mit READ-Recht an und ordnet diese dem Schulungsbereich so zu, dass sie vererbt wird und alle die gleichen ACLs ersetzt. Zudem legt das System eine entsprechende Benutzergruppe mit dem zuvor angelegten Benutzer als Mitglied angelegt.

Wenn Sie sich nach Ausführen des Skripts mit dem Benutzer partner_a.user anmelden, hat dieser jetzt unter Dateien Zugriff auf den Bereich XML-Script-Schulung.

Lektion 14: Mitteilungen aktivieren

Mit diesem Skript aktivieren Sie Mitteilungen für den Benutzer partner_a.user für den Bereich /Dateien/XML-Script-Schulung.

Nach Ausführen des Skripts erscheinen alle neuen oder geänderten Objekte aus dem Bereich /Dateien/XML-Script-Schulung in den Mitteilungen. Dadurch sieht der Benutzer, was es Neues in seinem Bereich gibt.

Lektion 15: Zugriffsrechte erneut ändern

In dieser Lektion lösen Sie folgende Anforderung durch ein Skript:

Es soll möglich sein, den Privatbereich eines Benutzers und seine E-Mails durch andere Benutzer einsehen zu lassen. Dies soll administrativ passieren, etwa wenn ein Benutzer im Urlaub oder krank ist. Ein Stellvertreter soll dann dessen E-Mails und ggf. auch private Dateien einsehen können, damit Projekte und laufende Arbeiten weitergeführt werden können.

Bevor Sie das Skript ausführen, ersetzen Sie die Variable $$NAME$$ durch einen Benutzer. Verwenden Sie hier den Benutzer partner_a.user. Sie können suchen und ersetzen, indem Sie im Editor der Datei STR + SHIFT + R drücken. Für Replace all geben Sie $$NAME$$ ein, bestätigen mit Enter und geben dann für With partner_a.user ein.

Nachdem Sie das Skript ausgeführt haben, hat das System für den Benutzer mehrere Benutzergruppen angelegt, die gleichzeitig die Rechte eines Benutzers beschreiben, wenn Sie diesen einer Benutzergruppe zuordnen.

Das System verlinkt den Bereich Private eines Benutzers in den öffentlichen Bereich und setzt statt dem Private-ACL neue ACLs. Die Verlinkung in diesem Beispiel findet unter dem Ordner /Dateien/XML-Script-Schulung/Home statt. Darunter erstellt das System mit diesem Skript einen Ordner für den Benutzer und verlinkt dort seine Eigenen Dateien und seine E-Mail-Ordner.

Lektion 16: Zusatzattribute hinzufügen

In dieser Lektion versehen Sie eine Datei mit Zusatzattributen. Damit binden Sie über das DMS-Laufwerk und per ac.xml-Datei aus Fremdsystemen heraus Dokumente in agorum core ein und verschlagworten sie.

In diesem Beispiel verschlagworten Sie eine Rechnung. Einsatz für die Verschlagwortung ist etwa eine Kopplung mit einem ERP-System. Dieses druckt die Rechnung als PDF in ein bestimmtes Verzeichnis und speichert dann dort zusätzlich eine ac.xml-Datei. Diese wird dann automatisiert ausgeführt und verschlagwortet die zuvor gespeicherte Datei.

1. Legen Sie die Beispiel-Rechnung in diesen Ordner ab:

   /Dateien/XML-Script-Schulung/Demo/Verwaltung/Rechnungen

2. Führen Sie in diesem Ordner das Skript aus.
   
   Ergebnis: In desk4web oder im agorum core explorer erscheinen unter der Objekt-Info die hinzugefügten Metadaten auf der Rechnung.

Dank der Zusatzattribute können Sie jetzt spezifisch nach diesen Metadaten und Schlagworten suchen, etwa nach der Rechnungsnummer (agorum_rechnungsnummer:(2009123456)). So finden Sie Dokumente wieder und differenzieren sie. Diese Attribute lassen sich auch in Suchmasken integrieren, sodass Sie keine besondere Suchsyntax benötigen.

Nach der Rechnung in agorum core suchen

Geben Sie Folgendes in die Suche (im Filter Alles) ein:

agorum_rechnungsnummer:(2009123456)

Sie können die Rechnung auch über eine URL von außen aufrufen, wenn Sie sich nicht in agorum core befinden:

http://<domain agorum server>/roiwebui/aguila_module/?type=agorum.composite.acic&query=agorum_rechnungsnummer:(2009123456)

Lektion 17: Ein Adressbuch anlegen

Mit einem XML-Skript legen Sie ein Adressbuch mit Firma, Abteilungen, Zweigstelle und Personen an. Sie können aus den einzelnen Objekten ersehen, wie agorum core die Verknüpfungen abbildet.

Das Skript legt unter dem Pfad, in dem Sie es ausführen, ein Adressbuch mit einer Adresse an. Sie können das Skript in einem beliebigen Ordner ausführen.