Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- oais:sa-editor [2012/10/30 12:10] – [SA Baum] guenter
+++ oais:sa-editor [2012/10/30 17:07] – Andreas Nef
@@ Zeile 1: / Zeile 1: @@
-====== Editor für Ablieferungsvereinbarungen (SA)======
+====== Verwaltung der Ablieferungsvereinbarungen (SA)======
-Der Editor für Ablieferungsvereinbarungen ist eine browserbasierte Umgebung, in der Ablieferungsvereinbarungen erstellt, verändert und verwaltet werden. Den Editor haben wir getestet mit Internet Explorer, Firefox und Google Chrome. Die Ablieferungsvereinbarungen (Submission Agreements, SA) werden im Hintergrund als XML-Dateien gespeichert und beinhalten Informationen, die relevant für die Abwicklung des Ablieferungs- und Ingest-Prozesses sind, aber auch für das gesamte Preservation Planning.
+Der Verwaltung der Ablieferungsvereinbarungen ist eine browserbasierte Umgebung, in der Ablieferungsvereinbarungen erstellt, verändert und verwaltet werden. Den Editor haben wir getestet mit Internet Explorer, Firefox und Google Chrome. Die Ablieferungsvereinbarungen (Submission Agreements, SA) werden im Hintergrund als XML-Dateien gespeichert und beinhalten Informationen, die relevant für die Abwicklung des Ablieferungs- und Ingest-Prozesses sind, aber auch für das gesamte Preservation Planning.
 ===== Anmeldung =====
-Bei Aufruf der Seite im Browser wird ein Login-Fenster angezeigt. Falls Sie noch kein Login besitzen, klicken Sie auf den Link unter den Eingabefeldern, um einen Zugang zu beantragen. Ein Benutzer mit Administrationsrechten muss Sie anschliessend freischalten.
+Bei Aufruf der Seite im Browser wird ein Login-Fenster angezeigt. Falls Sie noch kein Login besitzen, klicken Sie auf den Link unter den Eingabefeldern, um einen Zugang zu beantragen. Ein Benutzer mit Administrationsrechten muss Sie anschliessend freischalten (siehe [[oais:sa-editor&#benutzerverwaltung]]).
 {{:oais:sa-ed-01.gif?direct&300}}
@@ Zeile 56: / Zeile 56: @@
 ===== SA editieren =====
-Um eine SA zu editieren klickt man diese in der Liste der SA an und gelangt dann in das Übersichtsfenster:
+Um eine SA zu editieren klickt man diese in der Liste der SA an und gelangt dann in die Bearbeitungsfunktionen:
 {{:oais:sa-ed-04.gif?direct&600}}
 Hier stehen die folgenden Funktionen zur Verfügung:
-  * **SA ändern:** Dies ist die zentrale Funktion, über welche die SA zur Bearbeitung in einem separaten Fenster (siehe nächster Abschnitt) geöffnet wird.
+  * **[[oais:sa-editor&#editor|SA ändern]]**: Dies ist die zentrale Funktion, über welche die SA zur Bearbeitung in einem separaten Fenster (siehe nächster Abschnitt) geöffnet wird.
-  * **Web-Ansicht generieren:** Mit dieser Funktion wird der Inhalt der SA für die Anzeige im Browser vorbereitet und kann bei Bedarf auch ausgedruckt werden.
+  * **[[oais:sa-editor&#web-ansicht_generieren|Web-Ansicht generieren]]**: Mit dieser Funktion wird der Inhalt der SA für die Anzeige im Browser vorbereitet und kann bei Bedarf auch ausgedruckt werden.
-  * **SA exportieren:** Die SA wird als XML-Datei in gezippter Form an einen anzugebenden Ort gespeichert.
+  * **[[oais:sa-editor&#sa_exportieren|SA exportieren]]**: Die SA wird als XML-Datei in gezippter Form an einen anzugebenden Ort gespeichert.
 ===== Editor =====
@@ Zeile 75: / Zeile 74: @@
 Klickt man die Fragezeichen links von den Feldbezeichnungen an, werden Detailinformationen zu den einzelnen Feldern angezeigt. Hinter den jeweiligen Feldern wird jeweils mit einem Symbol angezeigt, ob der eingetragene Wert gültig ist oder nicht.
-Nach der Bestätigung wird das Hauptfenster geöffnet, wo die weitere Bearbeitung der SA erfolgt:
+Nach der Bestätigung wird das Hauptfenster geöffnet, wo die weitere Bearbeitung der SA erfolgt.\\
+==== Darstellung ====
+Es empfiehlt sich, in der linken Fensterhälfte das Register "Einfügen" auszuwählen, wo Elemente angezeigt werden, die an der Position des Cursors eingefügt werden können.\\
 {{:oais:sa-ed-06.gif?direct&300}}
-Es empfiehlt sich, in der linken Fensterhälfte das Register "Einfügen" auszuwählen, wo Elemente angezeigt werden, die an der Position des Cursors eingefügt werden können.
+In der rechten Fensterhälfte wird der Inhalt der SA angezeigt.
-In der rechten Fensterhälfte wird der Inhalt der SA angezeigt. Weist ein Element ein Symbol mit grünen Listeneinträgen auf, so sind zu diesem Element Zusatzinformationen (Attribute) festzulegen. Klicken Sie hierzu auf grüne Listensymbol, um das entsprechende Eingabefenster zu öffnen.
-Auch hier können über die Fragezeichen Detailinformationen zu den einzelnen Elementen der SA angezeigt werden:
+==== Zusatzinformationen ====
+Weist ein Element ein Symbol mit grünen Listeneinträgen auf, so sind zu diesem Element Zusatzinformationen (Attribute) festzulegen. Klicken Sie hierzu auf grüne Listensymbol, um das entsprechende Eingabefenster zu öffnen.\\
+{{:oais:sa-ed-16.png?direct&300}}\\
+==== Hilfe (Fragezeichen) ====
+Über die Fragezeichen werden Detailinformationen zu den einzelnen Elementen der SA angezeigt werden:\\
 {{:oais:sa-ed-07.gif?direct&300}}
 Die Beschreibung ist in der Regel auf Englisch und Deutsch vorhanden. Im Register "Kinder-Elemente" wird ersichtlich, welche Unterelemente mindestens einmal (+), genau einmal (keine spezielle Kennzeichnung, oder nicht zwingend (?) vorkommen müssen.
-Ist ein Element rot eingefärbt bedeutet dies, dass es noch nicht allen formellen Anforderungen entspricht. Bevor Sie den Status einer SA auf "final" setzen, sollten Sie sicherstellen, dass alle Elemente gelb sind und damit die SA alle formellen Vorgaben erfüllt. Sie können (englische) Hinweise über die noch fehlenden Punkte erhalten, indem Sie im Menü auf "Datei" – "Bewertung" klicken:
+==== Elemente einfügen ====
+Neue Elemente können via Reiter „Einfügen“ oder das Menü „Einfügen“ in das SA eingefügt werden. Es werden nur Elemente angezeigt, die an der ausgewählten Position möglich sind.\\
+Bsp: Durch Klick auf Ausgangsdatum, wird das Element in das SA eingefügt und auf der rechten Fensterhälfte dargestellt.\\
+{{:oais:sa-ed-11.png?direct&300}}
+==== Elementinhalte bearbeiten ====
+Mit dem Mauszeiger in das gewünschte Element klicken und den Inhalt bearbeiten.
+==== Element löschen ====
+Der Mauszeiger positionieren und mit der Taste [Del] oder [Backspace] das Element samt Inhalt löschen.
+==== Speichern ====
+Wenn Sie das SA fertig bearbeitet haben, dann speichern Sie es über Datei --> Speichern.
+==== Tipp ====
+Gängige Shortcuts können verwendet werden.
+==== Formelle Anforderungen ====
+Ist ein Element rot eingefärbt bedeutet dies, dass es noch nicht allen formellen Anforderungen entspricht. Bevor Sie den Status einer SA auf "final" setzen, sollten Sie sicherstellen, dass alle Elemente gelb sind und damit die SA alle formellen Vorgaben erfüllt. Sie können (englische) Hinweise über die noch fehlenden Punkte erhalten, indem Sie im Menü auf "Datei" – "Bewertung" klicken:\\
 {{:oais:sa-ed-08.gif?direct&300}}
-Wenn Sie die SA fertig bearbeitet haben, dann speichern Sie sie über Datei --> Speichern und schliessen den Editor.
 ==== SA Baum ====
 Die SA muss einige Mindestdefinitionen enthalten. Diese sind in der folgenden Struktur beschrieben.
@@ Zeile 125: / Zeile 143: @@
 </code>
-Die Zusatzinformationen sind über das Symbol links des Elementnamens in einem separaten Popup-Fenster zu bearbeiten.\\
+[[oais:sa-editor&#zusatzinformationen|Zusatzinformation]]
-{{:oais:sa-ed-16.png?direct&300|}}
 SIP-Creator -> Organisation\\
@@ Zeile 133: / Zeile 150: @@
 {{:oais:sa-ed-09.png?direct&300}}
 {{:oais:sa-ed-17.png?direct&300}}
 ====Beispiele====
 ===Zeitplan > Frequenz===
 Beispiel für eine Ablieferung mit Frequenz.\\
 {{:oais:sa-ed-10.png?direct&300}}\\
-Neue Elemente können via Reiter "Einfügen" oder das Menü "Einfügen" in das SA eingefügt werden. Es werden nur Elemente angezeigt, die an der ausgewählten Position möglich sind.\\
-Bsp: Ausgangsdatum bei einem Zeitplan.\\
-{{:oais:sa-ed-11.png?direct&300 |}}
-===== SA publizieren =====
-Die SA wurde nun im Hintergrund als XML-Datei erstellt. Sie kann von den Werkzeugen SIP-Creator, Docupack und Documill nach einem definierten Zeitraum von max. 15. Minuten verwendet werden. Damit die Vereinbarung in gut lesbarer Form im Browser dargestellt werden kann wählen Sie wiederum den Menüpunkt "Bearbeitung einer SA" an. Dort wählen Sie dann "Web-Ansicht generieren" aus.
+===== Web-Ansicht generieren =====
+Damit die Vereinbarung in gut lesbarer Form im Browser dargestellt werden kann wählen Sie wiederum den Menüpunkt "Bearbeitung einer Ablieferungsvereinbarung" an. Dort wählen Sie dann "Web-Ansicht generieren" aus.\\
+{{:oais:sa-ed-20.png?direct&300|}}\\
+Über den Link "Open PDF" ganz oben ist die Vereinbarung auch als druckbare PDF-Datei zugänglich.\\
+===== SA exportieren =====
+Um eine SA zu exportieren wählen Sie den Menüpunkt "Bearbeitung einer Ablieferungsvereinbarung" und dann "Ablieferungsvereinbarung exportieren". Die SA wird als ZIP gespeichert.
+===== SA publizieren =====
+Die SA wurde nun im Hintergrund als XML-Datei erstellt. Sie kann von den Werkzeugen SIP-Creator, Docupack und Documill nach einem definierten Zeitraum von max. 15. Minuten verwendet werden.
 ===== Projektverwaltung =====
+Alle Benutzer können Projekte erstellen. Der entsprechende Benutzer erhält dann auch explizite Rechte um ein SA dem Projekt hinzuzufügen. Ein Administrator kann weitere Teilnehmer einem Projekt zuordnen (siehe [[oais:sa-editor&#benutzerverwaltung|Benutzerverwaltung]])\\
+Ein Projekt kann nur gelöscht werden, wenn es keine SA enthält.\\
+Ein Projekt kann exportiert werden. Es werden alle SA als XML-Dateien im jeweiligen Verzeichnis exportiert. Für den Import wiederum müssen allerdings die SA einzeln als ZIP verpackt werden (siehe [[oais:sa-editor&#sa_importieren|SA importieren]]).
 :!: Administratoren\\
 Projekte werden durch den Administrator verwaltet. Er kann Projekte umbenennen, SA zwischen Projekten verschieben und Teilnehmer (Benutzer) zu Projekten hinzufügen.\\
 {{:oais:sa-ed-18.png?direct&300|}}
 ===== Benutzerverwaltung =====
 :!: Administratoren\\
-Unter Benutzerverwaltung sind alle Anmeldungen für neue Benutzer aufgelistet.\\
+Neue Benutzer werden erstellt, indem sich diese auf der Login-Seite registrieren. Anschliessend sind in der Benutzerverwaltung alle Anmeldungen für neue Benutzer aufgelistet.
-Nach dem autorisieren können Sie die Benutzerdaten anpassen, den Benutzer zu Projekten hinzufügen oder diesen löschen.\\
+Ein Administrator kann nun registrierte Benutzer für den Zugang autorisiren, Benutzerdaten anpassen, den Benutzer zu Projekten hinzufügen oder diesen löschen.\\
 {{:oais:sa-ed-19.png?direct&300}}