Liste der Standard-Parameter der WIM-Objekte:
(Weitere Objektparameter werden bei den Projekt-Objektparametern beschrieben)
- CONTENT [wimXML/XHTML](optional):
- Der Text etc. für die Haupt-Darstellung eines Objektes. Meist in Form von HTML-Code mit möglichen Einbettungen von SVG-Fragmenten etc. .
- CREATED [timestamp] (obligatorisch):
- Der Wert wird automatisch durch das System bei der Erzeugung eines Objektes gesetzt.
- PUBLISHED [timestamp] (für Infos wünschenswert):
- Der Wert gibt den Veröffentlichungszeitpunkt einer Info an. Fehlt die Angabe, wird hilfsweise der Wert von CREATED verwendet.
- REDO [Liste von
DATA-Datensätzen, die aus RETIRED übernommen wurden] (optional): - Wenn eine Änderung der Objekt-Parameterwerte rückgängig gemacht wurde, werden die zu ersetzenden aktuellen Werte am Anfang der REDO-Liste eigefügt. Mit einer Redo-Aktion können "undo"-Aktionen wieder zurückgenommen werden, indem die REDO-Parameterwerte wiederverwendet werden.
Bei einer (sonstigen) Änderung von Parameterwerten werden die REOD-Parameterwerte verworfen. - RETIRED [Liste von
DATA-Datensätzen mit_link, _till, _when,_whound _why -Parametern sowie den ausgemusterten Parameterwerten] (vom System verwendet): -
Werden Parameterwerte geändert, können ihre alten Werte gespeichert werden, um z.B. die Änderungs-Historie verfolgen oder frühere Parameterwerte restaurieren zu können.
Ein
DATA-Datensatz enthält einen oder mehrere ausgemusterte Parameterwerte sowie zusätzlich die obligatorischen Parameter _link, _till,_who,_whenund optional den_why- oder weitere Parameter, deren Name jeweils mit einem "_"-Zeichen beginnen muss, damit sie sich sicher von den originalen Objekt-Parametern unterscheiden.
Der_when-Parameter enthält den letzten Gültigkeitszeitpunkt der abgeänderten Datenwerte, der _till -Parameter gibt an, bis zu welchem Zeitpunkt noch Änderungen nachgetragen wurden, der_who-Parameter enthält die Kennung des Bearbeiters der Änderungen. Der _link -Parameter enthält eine (Zufalls-)Kennung für den Eintrag, damit innerrhalb eines Zeitraums noch weitere Änderungen einer Editier-Sitzung nachgetragen werden können. Im_why-Parameter kann eine Notiz zum Grund der Werte-Änderung angegeben werden. Die Originalwerte er geänderten Parameter werden unverändert übertragen.Damit die Änderungs-Historie nicht beliebig umfangreich wird, können die Änderungseintragungen von Zeit zu Zeit zusammengefasst oder zeitlich sowie mengenmäßig begrenzt werden. Dabei wird das allgemeine "Komprimierungs-Zeitraster" verwendet. Die Lösch-Aktionen (zumindest die jeweils letzte) sollte im
RETIRED-Parameter protokolliert werden! Mit der Angabe eines_retentionPeriod-Parameters kann die vorzeitige Löschung noch (aus beispielsweise rechtlichen Gründen) benötigter alter Parameterwerte sichergestellt werden. - STORED [timestamp] (obligatorisch):
- Der Wert wird automatisch durch das System gesetzt und ist nicht von Nutzern /Redakteuren /Administratoren /... beeinflussbar.
- TITLE [wimXML/XHTML] (obligatorisch):
- Die Bezeichnung eines Objektes (Info oder Thema).
- TYPE ['topic', 'info', ?] (optional):
- Themen-Objekte müssen hier den Wert "topic" angegeben haben, damit sie schnell als solche zu erkennen sind. Info-Objekte werden mit dem Wert "info" gekennzeichnet.
In Zukunft können noch weitere Objekt-Typen hinzukommen, sodass die Verarbeitung dieses Parameters darauf eingestellt sein muss. - VALID [periods] (optional):
- Für ein Objekt können Gültigkeitszeiträume definiert werden. Paare aus Start- und Endzeit, deren Bereiche sich nicht übelappen dürfen können aufgereiht werden. Sowohl End- als auch Startzeit können alleine angegeben sein (zusammen mit einer leeren Angabe; Blanks bleiben stehen).Die Daten sind per Default vom Typ "periods".
- VERSION [timestamp] (stark wünschenswert):
- Als Wert wird der Zeitpunkt der letzten (relevanten) Änderung gesetzt. Dieses sollte in der Regel automatisch durch die verwendeten Objekt-Erstellungs- und Bearbeitungswerkzeuge geschehen.
- authors:
- XHTML-Angabe für die als Autor(en) zu verwendende Angabe. Fehlt dieser Wert, wird versucht, aus dem "owners"-Parameter den Namen des Autors abzuleiten.
- defaultEditors:
- Ist bei einem Objekt keine "editors" -Angabe eingetragen, wird ersatzweise bei den Klassifizierungen des Objektes (und notfalls auch beim Projekt-Objekt) nach einer "defaultEditors" -Angabe gesucht.
- editors:
- Liste von Objektspezifikationen, die auf die (Nutzerobjekte der) Personen (Redakteure) verweisen, die aktuell die Parameterwerte zur Darstellung eines Objektes (Titel, Inhalt, ...) ändern dürfen. Auch dürfen sie die Rubrikzuordnungen ändern sowie ein Objekt ins Archiv (oder wieder zurück) verschieben. Die Liste der Editoren darf ebenfalls geändert werden - was aber in einem Datensatz im "editorsChanged"-Parameter protokolliert wird, damit nachvollziehbar ist, welche Person wann die Verantwortung inne hatte.
Meist gibt es nur eine personenbezogene Redakteur-Angabe. Diese sollte aber durch eine funktionsbezogene Angabe (beispielsweise "Redaktion für Bereich X" "Chef-Redakteur") ergänzt werden, damit bei Ausscheiden der Person die danach verantwortliche Person die inhaltliche Verantwortung samt Änderungserlaubnis übernehmen kann. Bei mehreren Angaben ist die erstgelistete Person verantwortlich. Ist keine spezielle Autoren-Angabe ("authors"-Parameter) vorhanden, wird die Autorenangabe aus den Redakteurs-Objekten geholt.
Ist zum Objekt kein expliziter "edtitors"-Parameterwert angegeben, wird zunächst ersatzweise die owners-Angabe verwendet. Ist auch die nicht vorhanden, werden der Reihe nach die Rubriken, denen das Objekt zugeordnet wurde, nach "defaultEditors"- hilfsweise "defaultOwner"-Parameter abgesucht, dessen Wert dann verwendet wird.
Ein Redakteur muss nicht gleichzeitig auch Rechteinhaber (also "Besitzer") eines Objektes (also bspw. Dokumentes) sein. Die Rechte-Inhaber können im "owners"-Parameter des Objekts bzw. der defaultOwners-Angabe seiner Rubriken abweichend vomn der "editors"-Angabe spezifiziert werden.
Eine "editors"-Angabe ist zu einem Objekt zwingend notwendig, damit seine darstellbaren Parameterwerte bearbeitet werden können! - catchwords:
- Kommaseparierte Liste von Schlagworten, die (noch) nicht durch Themenzuordnungen abgedeckt sind.
- EventPeriods:
- Liste von Zeitpunkt- und/oder Zeitraum-Spezifikationen zu denen die Info einen Bezug hat. Beispielsweise Dauer einer Veranstaltung oder Veröffentlichungszeitpunkt eines referenzierten Papiers.
- halfValuePeriod:
- Zeitraum, in dem die Wichtigkeit /Bedeutung /Relevanz eines Objektes sich halbiert.
- hiddenContent (optional):
- Texte mit Worten, die für die Volltext-Suche verwendet aber nie dargestellt werden dürfen.
- importance:
- Die generelle Wichtigkeit /Bedeutung /Relevanz einer Info im Kontext des Projektes.
- infoRefs (nur bei Themen, optional):
- Als Dateninhalt wird die Kennung des Kontext-Themas plus eine Name + Wert -Liste der verknüpften Infos angegeben. Die Liste wird aus den manuellen Vorgaben, kombiniert mit den automatisch ermittelten Werten erstellt.
- objGoals:
- Zielsetzung für dieses Objekt. Also: Wofür ist es da? Die Beschreibung erfolgt im formatierbaren Text.
- owners:
- Liste von Objektspezifikationen mit der Angabe der (Rechte-)"Besitzer" eines Objektes. Die "Besitzer" dürfen in der Regel z.B. Änderungen am Status und Inhalt eines Objektes vornehmen. Meist sind die Autoren auch Besitzer. Zumindest, so lange sie die Rechte nicht abgegeben (z. B. verkauft) haben.
Fehlt diese Angabe, wird in den Klassifikationen des Objektes unbd notfalls beim Projekt-Objekt nach den "defaultOwners" gesucht. - relevance:
- Relevanz des Themas bzw. der Info. Sie ergibt sich aus der "Beliebtheit" bei den Nutzern.
- Neben dem eigentlichen Relevanz-Faktor (normalerweise "1") können noch
- eine objektspezifische Halbwertzeit (in Tagen)
- sowie ein eigenständiger Referenzzeitpunkt (sonst wird der Veröffentlichungs-Zeitpunkt verwendet) angegeben werden.
- Wird ein weiterer Wert für eine Halbwerzeit angegeben, gilt dieser für die Zeit NACH dem Referenzzeitpunkt und der erste Halbwertszeit-Wert nur für die Zeit davor.
- shortTitle:
- Kurzform der Bezeichnung des Objektes für eine platzsparnde Darstellung.
- sort:
- Liste von Wertepaaren mit Objekt-Kennung und Zahl (z. B. Positionsnummer). Die Objekt-Kennung gibt an, für welches Objekt der Index gedacht ist. Der Indexwert bestimmt die Position dieses Objektes in einer Liste. Bei der Angabe von Indizies beginnen die Werte bei 0. Zahlenwerte können im Prinzip aber "beliebig" sein.
- teaserText (meist sehr wünschenswert):
- Anriss zum Inhalt einer Info oder der Bedeutung eines Themas. Sollte in der Regel etwa 25 Worte lang sein und "Appetit machen", die volle Info anzusehen.
title(veraltet, ersetzt durch TITLE):Die Bezeichnung einer Info oder eines Themas- topicOverlap (nur bei Themen, optional):
- Als Dateninhalt wird die Kennung des Kontext-Themas plus eine Name + Wert -Liste der inhaltlich überlappenden Themen angegeben. Die Werte geben an, wie sehr das angegebene verlinkte Thema inhaltlich mit diesem Thema überlappt. Ist das verlinkte Thema ein vollständiges Unterthema, ergibt sich der Wert 1. Diese Angaben werden zur Konstruktion des "Thesaurus" (oder "Themenbusches") benötigt.
Die Liste wird aus den manuellen Vorgaben, (zukünftig) ggf, kombiniert mit den automatisch ermittelten Werten erstellt. - topicRefs (nur bei Themen, optional):
- Als Dateninhalt wird die Kennung des Kontext-Themas plus eine Name + Wert -Liste der verknüpften Themen angegeben. Die Liste wird aus den manuellen Vorgaben, kombiniert mit den automatisch ermittelten Werten erstellt.
- topics (nur bei Info-Objekten, optional):
- Enthält Name + Wert -Paare für die der Info zugeordneten Themen. Diese Werte (Verknüpfungsgewichte) werden aus der Kombination von manuell eingestellten Werten mit den vom WIM-System ermittelten Werten bestimmt.
- ... (optional):
- ...
[[Die obige Liste ist noch sehr unvollständig !
... tbd ... ]]
Neben den oben aufgeführten Standard-Parametern der Objekte können einige Objekttypen weitere spezielle Paremeter besitzen. Die zugehörige Dokumentation ist für die jeweiligen Nutzungsarten dieses Projektes über das WIM-Objektparameter-Thema abrufbar.
Objektparameter WIM-App-Verfahren (techn.)
