JusCMS Architecture Feasibility Study Concept 1.6.1

JusCMS,JusCMS_2,MPDL

Im Juni wurde durch den LA der juristischen Institute die Entscheidung für das Konzept 1.6.1. getroffen.

Das Konzept wurde basierend auf den Anforderungen erstellt bzw. entsprechend angepasst.

Letzte Änderungen wurden nach dem Meeting am 02.09.2009 durchgeführt (siehe "History" für Details).--Ulla 13:45, 3 September 2009 (UTC) =Vor- und Nachteile= Das Konzept 1.6.1 basiert auf dem Konzept 1.6., mit einer "Verlagerung" fast aller Funktionen hin zu PubMan.

siehe Vor-und Nachteile vom Konzept 1.6 JusCMS_Architecture_Feasibility_Study_Concept_1.6 --Gergana 14:12, 12 May 2009 (UTC)

strukturiert nach Vergleichsanalyse.xls vom Architektur-Workshop

=Grafik=

thumb|left|Datenhaltung PubMan, Eingabe Wiss. oder ZS, Ausg. Objekt, Generierung Zitation in PubMan

=Szenario=

Die primäre Datenhaltung findet in eSciDoc / PubMan statt.

Die Eingabe kann sowohl durch den Wissenschaftler als auch durch eine zentrale Stelle (ZS) erfolgen.

Die Architektur-Option soll 3 mögliche Workflows abbilden:


 * 1) rudimentäre Eingabe der Publikationsdaten durch den Wissenschaftler
 * 2) vollständige Eingabe der Publikationsdaten durch den Wissenschafter
 * 3) vollständige Erfassung der Publikationsdaten durch eine zentrale Stelle

Zusammenfassung der Änderungen im Vergleich zu Konzept 1.6:
 * die Umsetzung der Metadaten in einen juristischen Zitierstil wird auf PubMan-Seite nachprogrammiert (ggf. in Anlehnung an die Definitionen Hamburg)
 * die Zitation wird pro Datensatz dann innerhalb des XML-Export als eigenes Feld fertig generiert ausgegeben (vgl. Modell Nijmegen)
 * die Publikationsliste für die jeweiligen Tätigkeitsberichte der Institute wird auf PubMan-Seite generiert unter Verwendung des in PubMan definierten Zitierstils

=Aufwandsabschätzung= (mit Angaben von Personentagen/-monaten)

Annahmen

 * Für die Dateneingabe auf PubMan wird der Standard Workflow genutzt, i.e. der Eingeber (Depositor) gibt den Datensatz rudimentär und/oder komplett ein (submit). Der Moderator (zentrale Stelle oder Wissenschaftler) kann den Datensatz in seinem QA Workspace prüfen und ggf. ergänzen. Die Kommunikation zwischen Depositor und Moderator erfolgt über den Workflow bzw. die entsprechenden Workspaces (My items, QA Workspace).


 * Für den Datenaustausch mit Contens wird das Search&Export Interface (REST) genutzt (siehe die Ausführung zur Alternativ-Option mit SWORD im entsprechenden Arbeitspaket)


 * Für die Hilfefunktion pro Feld wird die aktuelle Tool-Tip Funktionalität benutzt.


 * Alle Änderungen an bibliographischen Angaben werden in PubMan gemacht. Zusätzliche Änderungen im CMS an den Contens-Objekten haben keine Auswirkung auf das publication item in PubMan. Es muss auf CMS Seite definiert werden, ob ein neuer Export von PubMan die möglichen Änderungen am CMS Objekt überschreibt oder nicht.
 * --Gergana 09:18, 13 May 2009 (UTC) Es muss definiert werden, ob nur die "neuen" Objekte in CMS hinzugefügt werden oder ob alle Objekte überschrieben werden. Kennzeichnung der Objekte als neu bzw. Timestamp für die Selektion der "neuen" Objekte nutzen.
 * --Hmartens 06:22, 14 May 2009 (UTC) Zu jedem Datensatz in PubMan gibt es eine Schaltfläche welche es erlaubt, zu jeder Zeit einzelne Datensätze nach Contens zu übertragen. Änderungen an Datensätzen in PubMan und anschließende Übertragung nach Contens ändern die Objekte in Contens.
 * Rechte und Privilegien für PubMan Ressourcen werden in PubMan/eSciDoc definiert. Contens CMS Privilegien werden nicht in PubMan/escidoc abgebildet.


 * Nur jene Datensätze, die in PubMan freigeschalten wurden (i.e. released), können exportiert werden. Der Publishing Prozess auf seiten Contens kann unabhängig vom PubMan Release Prozess gestaltet werden.
 * --Gergana 09:21, 13 May 2009 (UTC) Auf Seite von Contents gibt es keinen Publishing Prozess, der Eintrag wird nur von ZS überprüft. Dies wird jetzt auf Seite von PubMan erfolgen.
 * --Natasa 07:37, 15 May 2009 (UTC) In this case the Publishing process is the "ZS Überprüfung" point, is that correct?
 * --Hmartens 06:22, 14 May 2009 (UTC) Anmerkung: Sobald ein Datensatz von PubMan nach Contens übertragen wurde, ist dieser als Objekt im CMS verfügbar. Auf der Mitarbeiterseite in Contens wird er durch die Listengenerierung in der Edit-Ansicht automatisch angezeigt. Diese Mitarbeiterseite muss jetzt in Contens neu publiziert werden.
 * Das Jahrbuch der MPG wird bis 2011 über eDoc generiert: Die Daten werden in PubMan selektiert und nach eDoc exportiert. Der eigentliche Jahrbuch-Workflow passiert auf eDoc.

Arbeitspakete

 * Definition von neuen Publikationstypen plus deren Metadata, basierend auf dem eSciDoc Application Profile for publication items, i.e. Erweiterung des aktuellen eSciDoc Application Profiles
 * Aufwand PubMan: 1,5 PM (Personenmonate)


 * Definition von Validierungsregeln, i.e. Erweiterung der aktuellen Validierungsregeln pro Validierungspunkt (Eingabe/Submit und Freischaltung/Release)
 * Aufwand PubMan: 1 PM


 * Definition der Modification Workflows auf PubMan (abhängig von den verschiedenen Szenarien der Modifikation durch zentrale Stelle und/oder Wissenschaftler). Falls die aktuellen Workflows nicht ausreichen, müssen auf seiten PubMan Erweiterungen in der Kombination des Standard und Simple Modification Workflows gemacht werden.
 * Aufwand PubMan für Definition und Erweiterung: 1,5 PM


 * Eingabehilfe für Personen - Import Person data (Namen, Organisation,etc) in CoNe Datenbank
 * Aufwand PubMan: 5 PT (Personentage), falls die Daten strukturiert vorliegen
 * Aufwand PubMan: mind.1 PM (Personenmonat) falls die Daten händisch in CoNe eingetragen werden müssen (abhängig von Anzahl der Daten)


 * Definition von Hilfetexte pro Feld und /oder Dokumenttyp (in Englisch und Deutsch)
 * Aufwand lokale Experten: ca. 15 PT (hängt ab von Anzahl der Felder, die Hilfetext brauchen)
 * Aufwand PubMan: 5 PT für Generierung der spezifischen Ressource Bundles für die spezifischen Hilfetexte


 * Evaluierung von SSRN Schnittstellen, Authentifizierungsmöglichkeiten, Formate und Workflow
 * Aufwand PubMan: unklar (Informationen zu verfügbaren Schnittstellen, Formaten, Authentifizierungsmöglichkeiten sind bei SSRN angefragt)


 * Evaluation of OAuth, Shibboleth oder andere Single-Sign-on Technologien und Authorisierungsmöglichkeiten
 * Aufwand PubMan: 2-3 PM für Implementierung der erweiterten AA Komponente (abhängig von Ergebnis der Evaluierung)


 * "Look&feel CMS" während der Eingabe auf PubMan - Skin-Definition und Implementierung
 * Aufwand PubMan: 1 PM
 * Wurde als Anforderung ausgeschlossen. Ergebnis Meeting 02-09-2009.--Ulla 13:57, 3 September 2009 (UTC)


 * Preview in Contens für neu eingegebenes PubMan item:
 * Option a): Pubman liefert reines XML (Metadata) ohne Zitierstil. Die Transformation in den gewünschten Zitierstil passiert auf Contens Seite
 * Aufwand Contens: unklar
 * Option b): Pubman liefert XML, angereichert mit einem Snippet, das den Zitierstil beinhaltet
 * Aufwand PubMan: unklar, ca. 15 PT für Definition und Implementierung per Style (Aufwand abhängig von Anzahl und Komplexität)
 * Aufwand Contens: ca. 1-2 PT (?) für Anpassung der Snippet Classes an den gewünschten HTML Output


 * Export nach Contens nach Freigabe auf PubMan
 * Version 1: Pushing Mechanismus, i.e. direkter Export von einzelnen Items (Anmerkung: Sollte die direkte Push-Funktionalität umgesetzt werden, werden auf PubMan nur Standard-Interfaces eingesetzt, um die Nachnutzung für andere Institutionen zu ermöglichen)
 * Aufwand PubMan: 1 PM für Implementierung des Standard-Push Client (e.g. SWORD Client), inkl. notwendiger Authorisation
 * Aufwand Contens: unklar, für Implementierung eines Standard-Server Interface (e.g. SWORD Server), inkl. notwendiger Authorisation
 * --Hmartens 06:41, 14 May 2009 (UTC) Standard-Interfaces, ein "einfacher" XML-Export ist ausreichend. Die Contens-Implementierung wird dadurch sicherlich wesentlich einfacher. Nachnutzungseffekt SWORD-Client nice to have, Aufwand Contens SWORD-Client: unklar.
 * --Natasa 07:27, 15 May 2009 (UTC) Siehe unten, Version 2
 * Version 2: Alternative zu Direkter Export über Pushing ist der Einsatz von Search&Export Interface: Auf seiten Contens wird ein Import angestossen (e.g. zweimal am Tag). Keine zusätzliche Authorisierung notwendig, da auf seiten PubMan das Search&Export Interface plus die Daten öffentlich sind, in Contens wird das Anlegen neuer Objekte über die vorhandene Authorisierungsfunktionlität geregelt.
 * Aufwand PubMan: 1 PT für Definition notwendiger Queries/Abfragen
 * Aufwand Contens: unklar
 * Optionale Zusatzfunktion bei Version 2: Zusätzlich kann auf Contens Seite eine Funktionlität eingebaut werden, womit der Nutzer explizit ein "refresh my page" anstossen kann. Nachteil: zusätzlicher Nutzer-Aktion, zusätzliche Definition von Abfragen für jeden einzelnen Nutzer nötig
 * Aufwand PubMan: 1 PT max. für Bereitstellung von Template Queries
 * Aufwand Contens: unklar


 * Unterdrückung von Export nach Contens:
 * kein Aufwand, kann durch den Nutzer über eine entsprechende Angabe in den Local Tags des PubMan items vorbereitet werden. Die Abfrage über Search&export kann diese Local tags beinhalten/ausschliessen.


 * Benachrichtigung des Autors nach Submit oder Freigabe des Datensatzes
 * Vorbereitung und Maintenance: Nachdem der Depositor eventuell unterschiedlich von den Autoren ist, brauchen wir für eine Benachrichtigung die email Accounts eines jeden Autors in den Person data in Cone, die auch gepflegt und aktualisiert werden müssen. Aufwand PubMan: Definition/Implementierung einer sicheren Nutzeroberfläche, wo ein Nutzer seine Person data aktualisieren/ändern kann. Zur Zeit haben dieses Privileg nur Moderatoren (i.e. meist Bibliothekare), ausserdem sind Person data noch öffentlich.
 * Aufwand PubMan: 1PM
 * Für die eigentliche Umsetzung der Benachrichtigung gibt es mehrere Möglichkeiten
 * Option a) (empfohlen): RSS feed für den Autor (Jeder Autor kann eine Suche nach seinen last released items über RSS liefern lassen, sofern er einen Feed Reader installiert hat.
 * Aufwand PubMan: 2PT für Erweiterung des Syndication Managers für beliebige Suchen
 * Option b): E-Mail Versand an bestimmten Punkten des Workflows, basierend auf verfügbaren Mail Accounts (e.g. in CoNe und/oder User preferences von user handles => Shibboleth)
 * Aufwand PubMan: 15PT

Contens:

 * Entwicklung Import-Schnittstelle, die die von PubMan gelieferte XML-Datei (einzelne items und alle items der affiliation als Liste) verarbeiten kann (inkl. Feld "citation", das in allen Listen dargestellt werden soll)
 * Spezifikation Verarbeitung: Parsing in Contens-konformes Format; Ablage in der Contens-Datenbank als Objekt


 * Eine erste Einschätzung der für Contens notwendigen Arbeitspakete wurde von Bulatovic/Tschida hier erstellt--Ulla 13:59, 3 September 2009 (UTC)

=Zugehörige Seiten= JusCMS_Architecture_Feasibility_Study_Concept_2.3 JusCMS_Architecture_Feasibility_Study_Concept_1.6