Hilfe: Attribute
Überblick über die Attribute


Allgemeine Beschreibung
CollectionType

Folgende Werte können hier eingegeben werden: Cluster, Sequence, MultiCluster und AlternativeCluster - welche alle Unterarten der allgemeinen Collection sind und die alle zusätzliche Möglichkeiten bieten. Cluster werden auf Seite 4 näher erklärt, die anderen Collection-Typen finden Sie auf Seite 6.

Description

Dieses Attribut können Sie verwenden, um einer Collection oder einem Cluster eine kurze Inhaltsbeschreibung zuzuordnen. Web-Clients zeigen diese Beschreibung zwischen dem Titel der Collection und ihrem Inhaltsverzeichnis an, wenn kein "FullCollectionHead" für die Collection gesetzt wurde.

Es ist auch möglich, verschiedene Versionen dieser Beschreibung in verschiedenen Sprachen einzugeben (mittels des Sprach-Präfix - siehe oben). In diesem Fall wird nur die Beschreibung, die der gesetzten Sprache entspricht, angezeigt. Anders als beim "Titel" ist es jedoch nicht zwingend erforderlich, daß ein Sprach-Präfix vergeben wird.

DocAuthor, DocDate

Diese Attribute werden verwendet, um den echten Autor des Dokumentes (nicht den der Person, die das Dokument am Server einfügt) und das echte Datum des Dokumentes (nicht das Datum, wann es am Server eingefügt wurde) einzugeben.

HW_HEADER

Hyperwave zeigt standardmäßig Frame-Dokumente ohne Kopf- und Fußzeilen. Wenn an ein Dokument dieses Attribut mit dem Wert "yes" besitzt, wird es immer mit Kopf- und Fußzeile angezeigt.

HW_PLAIN

Wenn ein Dokument dieses Attribut mit dem Wert "yes" besitzt, wird es ohne Hyperwave Kopf- und Fußzeile dargestellt.

HW_UI_Target

Dieses Attribut gibt an, wie der Name des Fensters lautet, in dem das Dokument (welches dieses Attribut besitzt) angezeigt werden soll. Als Attributwert ist jeder String zulässig. Es gibt zwei vordefinierte Fensternamen, und zwar "dialogs" und "HW_Mainwindow", wobei der zweite der Name des Browser-Hauptfensters ist, und der erste den Namen des HWIS-Dialogfensters repräsentiert (in dem z.B. Suchoptionen oder Attributwerte eingegeben werden). Wenn Sie einem Dokument beispielsweise dieses Attribut mit dem Wert "dialogs" geben, erscheint das Dokument im Fenster, in dem normalerweise Dialoge angezeigt werden. Wenn das Attribut einen neuen, nicht vordefinierten Wert erhält, wird das Dokument in einem neuen Fenster angezeigt.

HW_UI_WinStyle

Dieses Attribut ermöglicht es dem Benutzer, den "Stil" des Fensters, in welchem das Dokument erscheinen soll, auszuwählen. Sein Wert wird dem Statement window.open(URL,"window_features") als Parameter übergeben (Standard Client-Side JavaScript Parameter).

HW_WM_ForceTemplates

Dieses Attribut ändert das Standardverhalten beim Öffnen von Dokumenten mit eigenen Applikationen (z.B. MS Word oder Excel). Üblicherweise werden diese Dokumente durch Anklicken im Browserfenster einfach geöffnet. Wenn obiges Attribut vorhanden ist und den Wert "yes" besitzt, wird anstelle des Dokumentes nur ein Link zu ihm, begleitet von Standard Hyperwave Kopf- und Fußzeile, angezeigt. Zweck dieser Funktionalität ist es, dem Benutzer Methoden von Dokumentklassen zugänglich zu machen. Durch hinzufügen des Strings ;internal&action=plain.action zur URL des Dokumentes wird die Wirkung o.g. Attributes aufgehoben.

Keyword

Dieses Attribut ist optional, (d.h. Sie müssen es nicht eingeben) und erlaubt Ihnen, dem Objekt, das Sie einfügen, Schlagwörter Ihrer Wahl zuzuordnen. Diese Wörter können dann für die Suche nach diesem Objekt verwendet werden, was bedeutet, daß Sie dafür Wörter nehmen sollten, die im Titel nicht ohnehin bereits vorkommen. Sie können für jedes Schlüsselwort ein neues Schlüsselwort-Feld hinzufügen oder in einem Feld verschiedene Wörter - getrennt durch Leerzeichen - eintragen. Wenn Sie mehrere Wörter als einen Schlüsselwort-Begriff eingeben möchten, verbinden Sie sie mit Bindestrichen, z.B.: "decision-support-systems".

MimeType

Das MIME-Protokoll wird in der Internet-Kommunikation verwendet, um Dokumente verschiedener Formate zu übertragen. Das Protokoll behandelt die Vielschichtigkeiten, indem es eine Beziehung (Mapping) zwischem dem Format des Dokumenteninhalts und dem Format der Dokumentendarstellung auf dem Computer herstellt. Es wird verwendet, um Ihrem Web-Browser mitzuteilen, wie er den Inhalt des übertragenen Dokumentes interpretieren muß. Mit den passenden Einstellungen von Hilfs-Applikationen und -Software, kann Ihr Browser automatisch die notwendigen Aktionen setzen, damit Sie Zugriff auf Inhalte, die in zahlreichen Formaten übertragen werden , haben. Deshalb ist es auch wichtig, den richtigen MimeType einzutragen, wenn Sie Dokumente in einen Hyperwave Server einfügen; Beispiele dafür sind "text/html" für HTML-Text und "image/jpeg" für JPEG-Bilder.

Name

Dies kann fast jeder beliebige Name sein, den Sie Ihrem Dokument oder Ihrer Collection geben können - mit einigen wenigen Ausnahmen: er muß am Server, auf dem Sie das Objekt einfügen, einzigartig sein und darf keine Leerzeichen enthalten.

PLACETemplate

PLACE ist eine Meta-HTML-Sprache, die verwendet wird, um das Erscheinungsbild der WaveMaster-Oberfläche zu ändern. Sie besteht aus normalen Sprach-Konstruktoren, wie z.B. dem if-Statement, einem Macro-Statement oder einem While-Loop und einer Anzahl von sogenannten Platzhaltern. Diese machen Meta-Informationen zum gegenwärtigen Dokument und Informationen über den Hyperwave Server verfügbar und können vom Typ STRING, NUMBER oder BOOL sein.

Normalerweise haben alle Dokumente auf einem bestimmten Server dasselbe Erscheinungsbild. Das PLACETemplate-Attribut wird verwendet, um dieses Erscheinungsbild für ein bestimmtes Dokument zu verändern. Um dies zu tun, brauchen Sie ein Template, das dem Dokument das gewünschte Aussehen verleiht. Das Template-Script muß am Server - mit MimeType "text/plain" - eingefügt werden. Damit nun das Dokument wirklich auch dieses Erscheinungsbild annimmt, muß es das PLACETemplate-Attribut erhalten, wobei der Wert dieses Attributes der Name oder die GOid des PLACETemplates ist.

PresentationHints

Standardmäßig präsentiert Hyperwave Collections in Listenform mit Verweisen, d. h. wenn Sie eine Collection aufrufen, sehen Sie einfach ihr Inhaltsverzeichnis. Diese Präsentationshinweise nun können dazu verwendet werden, um dieses Erscheinungsbild zu verändern. Dafür gibt es verschiedene Einträge für dieses Feld.

  • CollectionHead: Wenn Sie normalerweise eine Collection aufrufen, sehen Sie nur eine Liste der Kinder in der Collection-Hierarchie; kein darin enthaltenenes Dokument wird angezeigt. Wenn Sie nun jedoch eines dieser Dokumente oder Cluster zum CollectionHead erklären, wird dieses Dokument automatisch angezeigt, wenn die Collection aufgerufen wird. Darunter erscheint dann zusätzlich eine Liste mit Verweisen zu den anderen Mitgliedern der Collection.
  • FullCollectionHead: Dieser ist ähnlich dem CollectionHead - ein Dokument wird automatisch präsentiert, wenn die Collection aufgerufen wird - allerdings wird die Liste mit den Verweisen zu den anderen Mitgliedern der Collection unterhalb des Dokumentes nicht angezeigt.
  • Hidden: Dieses Attribut (hidden = verborgen) ist nützlich für Dokumente, die sich in einem Cluster befinden: Üblicherweise zeigen Cluster mehrere Dokumente gleichzeitig an, mit dem "hidden"-Eintrag jedoch können Sie erklären, daß ein Objekt nicht angezeigt werden soll.

Price

Das Price-Attribut wird für die Hyperwave Möglichkeit der Vergebührung von Dokumenten verwendet. Verschiedenen Benutzern und verschiedenen Gruppen können verschiedene Preise zugeordnet werden, sodaß der Wert dieses Attributes auch eine Folge von Preisen sein kann (eingegeben als 32-Bit-Integer-Zahlen), gefolgt von einem Doppelpunkt und der Angabe von Benutzern und Gruppen. Jeder Preiszuordnung wird durch Strichpunkte getrennt.

Der Wert dieses Attributes kann also z.B. sein:

0x00000064;0x00000050:g websoc,u wonko; 0x00000000:u fkappe

was bedeutet, daß das Dokument 100 Einheiten (d.s. 64 in Hexadezimal) wert ist, aber Mitglieder der Benutzergruppe websoc und der Benutzer wonko einen Rabatt von 20 % bekommen und somit nur 80 Einheiten (d.s. 50 in Hexadezimal) bezahlen, während der Benutzer fkappe nichts zu zahlen hat.

Rights

Der Wert dieses Attributes setzt sich zusammen aus Lese- (R:), Schreib- (W:) und Unlink- (Lösch-) (U:) Rechten, getrennt durch Strichpunkte. Für jedes dieser Felder bedeutet 'a', daß der Autor die entsprechende Rechte hat, 'u Benutzer' bedeutet, daß die angegebenen Benutzer (die Benutzernamen jeweils durch Leerzeichen getrennt) die Rechte haben, und 'g Gruppen' bedeutet,daß die Mitglieder der angegebenen Gruppe (Gruppennamen durch Leerzeichen getrennt) die Rechte haben. Jedes dieser Felder darf nur einmal vorkommen und die Werte innerhalb dieses Feldes werden durch Beistriche getrennt. Zusammenfassend sieht die Syntax so aus:

R:a,u Benutzer,g Gruppen;W:a,u Benutzer,g Gruppen;U:a,u Benutzer,g Gruppen

wobei jedes dieser 3 Hauptfelder (R, W oder U) verwendet oder ausgelassen werden kann, genauso wie jedes der a-, u- und g-Felder verwendet oder ausgelassen werden kann - wie sie eben gebraucht werden.

Beispiel:

R:g projekt_a,u Schmidt

Sequence

Die Sequenznummer wird verwendet, um die Reihenfolge der Objekte zu definieren, wenn diese in einer Collection-Liste angezeigt werden. Der Wert in diesem Feld muß eine Zahl sein, negativ oder positiv. Es empfiehlt sich, Abstände zwischen diesen Zahlen zu lassen, sodaß es immer möglich ist, neue Objekte zwischen bereits vorhandenen einzufügen: z.B. 10, 20, 30 etc. Wenn ein Objekt keine Sequenznummer besitzt, wird es behandelt, als ob es die Sequenznummer Null hätte. Standardmäßig werden die Mitglieder einer Collection nach diesen Zahlen sortiert; diejenigen, die dieselben Sequenznummern haben, werden nach ihrem Titel sortiert.

SortOrder

Dieses Attribut wird für Collections verwendet - es beeinflußt die Reihenfolge, in der die Mitglieder der Collection in der Collection-Liste angezeigt werden. Der Wert dieses Attributes ist eines oder eine Kombination der folgenden Zeichen, jedes davon bedeutet ein bestimmtes Sortierkriterium.

ZeichenBedeutung
AAutor
CErstellungsdatum
EAblaufdatum
OEröffnungsdatum
STreffergenauigkeit
t Typ (Reihenfolge:Collection, Cluster, Text, Bild, Film, Audio, Szene, PostScript, Allgemeines Objekt, Anmerkung, Remote-Objekt)
TTitel
#Sequenznummer
-das danach stehende Sortierkriterium in umgekehrter Reihenfolge
Diese Einträge werden nach dem ersten Kriterium sortiert; diejenigen, die dabei nicht unterschieden werden können, werden nach dem nächsten Kriterium sortiert u.s.w. Der Eintrag #-T z.B. sortiert die Objekte nach der Sequenznummer und diejenigen, die dieselbe Sequenznummer haben, alphabetisch nach ihrem Titel. Wenn ein Objekt mehrere Titel in verschiedenen Sprachen hat, wird für das Sortieren der Titel, der der zur Zeit gesetzten Sprache entspricht, verwendet.

Weiters kann auch eine eigene Sortierreihenfolge definiert werden. Dadurch hat man die Möglichkeit nach allen Attributen zu sortieren. Eine Definition besteht dabei aus einer oder mehreren Gruppen aus 3 durch Doppelpunkt getrennten Werten. Die einzelnen Gruppen sollten dabei durch Klammerung getrennt werden.

'('<AttributName> ':' <SortierTyp> ':' <Reihenfolge>')'

Wenn sie diesen Syntax benutzen müssen immer alle 3 Werte vorhanden sein. Sind mehrere dieser Definitionsgruppen eingetragen, so wird zuerst nach dem ersten Kriterium sortiert und bei gleichem Sortierergebnis wird das nächste Sortierkriterium herangezogen, usw...

Die einzelnen Werte haben dabei folgende Bedeutung:

<AttributName>: Der Names des Attributes nach dem Sie sortieren wollen.

<SortierTyp>: <SortierTyp> legt fest wie der Attributwert interpretiert werden soll. Dabei gibt es folgende Möglichkeiten:

I (Integer): Der Attributwert wird als Zahl behandelt.
S (String): Der Attributwert wird als Zeichenkette behandelt.
D (Date): Der Attributwert wird als Datum behandelt.
E (Enumeration): Der Attributwert wird als Zeichenkette behandelt und wird nach dem Feld <Reihenfolge> sortiert.

<Reihenfolge>: Definiert die Sortierreihenfolge. Dabei sind folgende Werte gültig. Ein "+" sortiert in aufsteigender Reihenfolge; "-" sortiert in absteigender Reihenfolge; möglich ist auch eine Liste von Werten und Placeholdern.

Wird eine Liste von Werten und Placeholdern eingegeben, so wird der Attributwert mit diesen Werten verglichen und dementsprechend sortiert. Um die aktuellen Spracheinstellungen zu erhalten kann man den Placeholder %lang benutzen.

Beispiele

(Title:E:ge;en;fr)
Sortiert wird nach dem Titel, wobei zuerst alle deutschen Titel, anschließend alle englischen Titel, und letztendlich alle französischen Titel aufgelistet werden. Objekte mit anderssprachigen Titeln werden zuletzt und ohne spezielle Sortierung ausgegeben.

(Sequence:I:+)(TimeModified:D:-)(MIMEType:E:image)
Sortiert aufsteigend nach der Sequenznummer. Objekte mit gleichen Sequenznummern werden weiters nach dem Datum der letzten Änderung sortiert, wobei zuletzt geänderte Objekte zuerst gezeigt werden. Sollten beide Sortierkriterien nicht eindeutig sein werden zuerst alle Objekte die als MimeTypeAttribut den Wert image aufgezeigt.

(Title:E:%lang;en;fr)
Sortiert nach dem Titel, wobei zuerst alle Objekte der aktuell eingestellte Sprache aufgelistet werden.

(Title:E:ge)(Title:S:+)
Sortiert so, daß zuerst alle Objekte mit einem deutschem Title kommen, weiters werden die Titel noch alphapetisch sortiert. Zuerst kommen alle Objekte First the objects are sorted such that objects with a German title come first, then the objects are further sorted alphabetically by title.
Beachten sie daß für das Titelattribut sowie auch für alle anderen Attribute die mehrfach vergeben werden können zur Sortierung immer dieselbe Attributinstanz herangezogen wird. In diesem Beispiel bedeutet dies, daß zuerst alle Objekte mit deutschem Titel und weiters wenn diese Objekte alphabetisch sortiert werden, so werden sie nach dem deutschem Titel sortiert und nicht nach dem Titel einer anderen Sprachen.

TimeModified

Dieses zeigt, wann das Objekt das letzte Mal geändert wurde, d. h. wann entweder das Dokument oder seine Attribute geändert wurden. Anders als die meisten Attribute, wird dieses automatisch vom Server gesetzt und kann nicht vom Benutzer geändert werden. Das Attribut ist indiziert, das bedeutet, daß man auch Objekte nach ihrem Änderungsdatum suchen kann.

TimeOpen, TimeExpire

Diese Attribute ermöglichen es, daß die Objekte am Server nur eine gewisse Zeitspanne sichtbar sind. Das Eröffnungsdatum bezeichnet den Zeitpunkt, ab wann das Objekt sichtbar wird und das Ablaufdatum den Zeitpunkt, ab dem es nicht mehr sichtbar ist. Für den Besitzer und die Mitglieder der Gruppe System ist das Objekt immer sichtbar, unabhängig von diesen Einträgen. Die Eingabe für diese Felder muß in der Form

[jj]jj/mm/tt hh:mm:ss

erfolgen - allerdings nur bis zur gewünschten Genauigkeit: d. h. 97/07/30 ist ein gültiger Eintrag und gleichbedeutend mit 30. Juli 1997 um 0.00 Uhr.

Title

Dieses Attribut kann pro Objekt mehrmals vergeben werden, allerdings sollten dabei unterschiedliche Sprachen gewählt werden, da bei bei mehreren gleichsprachigen Titeln zufällig einer für die Anzeige gewählt wird. Im Attributdialog hat man die Möglichkeit, die Sprache des Titels durch Vergabe eines zwei-Zeichen-Präfix, gefolgt von einem Doppelpunkt, einzustellen. Die verfügbaren Sprachpräfixes sind nachstehend aufgelistet.

Sprache Abkürzung
Englisch en
Deutsch de
Französisch fr
Italienisch it
Spanisch es
Japanisch ja