BSCW-Elemente verwenden

Websiteordner verfügen über ein eigenes System von Elementen mit einer wiki-ähnlichen Syntax ([element …]), das es Ihnen erlaubt, BSCW-Elemente in Ihren Seiten zu verwenden. Bei­spiele sind das Datum der letzten Änderung einer Seite, Verweise zum Bearbeiten einer Seite, die Anzeige der Historie einer Seite oder gar ganze Aktionsmenüs. BSCW-Elemente haben einen Namen und können auch noch Parameter mit Werten haben. Ein abstraktes Bei­spiel für die Syntax von BSCW-Elementen ist

[element name param1=True param2="Ein langer Text mit Leerzeichen"]

Dieses Element name hat zwei Parameter param1 und param2 mit den Werten True bzw. "Ein langer Text mit Leerzeichen". Beachten Sie die Anführungszeichen, die nur für Wer­te benötigt werden, die Leerzeichen enthalten. Ein konkretes Beispiel für ein BSCW-Ele­ment ist

[element documentactions action=edit text="Dokument bearbeiten"]

Dieses Element stellt die Aktion Bearbeiten dar, die auf das aktuelle Dokument angewandt wird. In der Webansicht eines HTML-Dokuments in einem Websiteordner werden die BSCW-Elemente ausgewertet und die Ergebnisse in das Dokument eingefügt. Im obigen Bei­spiel würde ein Verweis mit dem Text Dokument bearbeiten in das Dokument eingefügt; Klicken auf den Verweis würde die Aktion Bearbeiten auf dem Dokument selbst aufrufen.

Hinweis: Im Rahmen der Verwendung in BSCW-Elementen von Websiteordnern haben man­che Aktionen andere Namen als gewöhnlich. Beispiele sind Änderungen zurück­nehmen statt Versionen löschen und Neuer Unterordner statt Neuer Unter-Websiteordner.

Obwohl die BSCW-Elemente-Syntax eckige Klammern verwendet, können Sie eckige Klam­mern im Text von Dokumenten eines Websiteordners weiterhin verwenden. Lediglich die Zei­chenkette [element wird als Beginn eines Websiteordner-Elements aufgefasst. Fehler in Spe­zifikationen von BSCW-Elementen führen zu Fehlermeldungen, die in den ausgewerteten Text einer Seite eingefügt werden, während der Rest der Seite sich immer noch so verhält wie erwartet.

Sie können ein BSCW-Element in beliebigen HTML-Text einbetten, der nur angezeigt wird, wenn die Auswertung des BSCW-Elements einen nicht-leeren Inhalt ergibt, wie das folgende Beispiel zeigt.

[decoration] <HTML-Text> [element ..] <HTML-Text> [/decoration]

Hier wird der gesamte Text zwischen [decoration] und [/decoration] nicht angezeigt, wenn das BSCW-Element keinen Inhalt liefert.

Im folgenden werden die verfügbaren BSCW-Elemente in alphabetischer Reihenfolge auf­ge­führt. Das Attribut ‚Statisch‘ zeigt an, ob das betreffende Element in eine statische Kopie des Websiteordners übernommen wird oder nicht (siehe 8.6.6 Websiteordner exportieren und öffentlich zugänglich machen). Sie können die BSCW-Elemente direkt in den Quell­text Ihrer Websiteordner-Seiten einfügen oder das diesbezügliche Menü im integrierten HTML-Editor benutzen.

Für eine detaillierte Definition der Parameter klicken Sie auf den Namen der Elemente.

authors Fügt eine Liste der Autoren von Dokumenten des aktuellen Websiteordners ein. Durch Klicken auf einen Autorennamen wird die Anzeige von Objekten in der durch contents erzeugten Inhaltsliste auf diejenigen Objekte eingeschränkt, die durch diesen Autor erzeugt wurden. Beachten Sie, dass das Klicken auf einen Autorennamen keine Wirkung auf hierarchische Listen hat, die mit tree erzeugt wurden.

Statisch:  Nein        
Parameter:  Keine

Beispiel:

[element authors]

back Fügt einen Verweis ein, der aus dem Websiteordner heraus auf den ersten über­geordneten Nicht-Websiteordner führt.

Statisch:  Ja  
Parameter:

icon (optional)    
Statt mit einem Text können Sie den back-Verweis auch mit einem Symbol unterlegen. Geben Sie als Wert für den Parameter icon die URL des Symbols an. Wenn sowohl icon als auch text angegeben werden, wird der Aktions­ver­weis mit dem Symbol unterlegt und der Text fungiert als Tooltip.

text (optional)    
Standardmäßig wird der Text für den back-Verweis auf den entsprechenden BSCW-Text in der jeweiligen Sprache des Benutzers gesetzt (im Deutschen also auf „Zurück“). Mit dem Parameter text können Sie eine andere Beschrif­tung des Verweises angeben.

Beispiel:

[element back text="Nach oben"]

categories Fügt eine Liste der Kategorien ein, die Objekten des aktuellen Web­site­ord­ners zugewiesen wurden. Durch Klicken auf eine Kategorie wird die Anzeige von Ob­jekten in der durch contents erzeugten Inhaltsliste auf diejenigen Objekte ein­ge­schränkt, denen diese Kate­gorie zugewiesen wurde. Beachten Sie, dass das Klicken auf eine Kategorie keine Wirkung auf hierarchische Listen hat, die mit tree erzeugt wurden.

Statisch:  Nein        
Parameter:  Keine

Beispiel:

[element categories]

comments Listet die bestehenden Kommentare zur aktuellen Seite auf und bietet standardmäßig ein Eingabefeld für neue Kommentare an, sofern der Benutzer das Recht hat, Kommentare einzugeben. Eventuelle Antworten auf Kommentare werden nicht angezeigt.

Statisch:  Ja  
Parameter:

latestfirst (optional, Standardwert False)      
Die Kommentare werden nach Entstehungsdatum sortiert. Standardmäßig er-scheint der älteste Kommentar am Anfang der Liste. Soll die Liste mit dem neuesten Kommentar beginnen, setzen Sie den Parameter auf True.

maxcomments (optional, Standardwert None, d.h. keine Beschränkung)    
Die Anzahl der angezeigten Kommentare ist standardmäßig nicht beschränkt. Mit dem Parameter maxcomments können Sie die Anzahl beschränken. Gibt es mehr Kommentare, als aufgrund der Beschränkung angezeigt werden können, er¬scheint ein Verweis, mit dem Sie sich alle Kommentare als Diskus¬si-ons¬forum in der normalen BSCW-Ansicht ansehen können.

showform (optional, Standardwert True)       
Standardmäßig wird das Eingabefeld für neue Kommentare angezeigt. Sie können das unterbinden, indem Sie den Parameter auf False setzen.

     Hinweis: Wenn der Benutzer nicht das Recht hat, neue Kommentare ein­zu­ge­ben, wird das Eingabefeld unabhängig vom Wert des Parameters nicht ange­zeigt.

Beispiel:

[element comments latestfirst=True maxcomments=7]

contents Fügt eine Liste aller Objekte, die direkt im aktuellen Websiteordner enthal­ten sind, als klickbare Verweise ein. Nach einer Volltextsuche ersetzen die Such­ergeb­nisse die Inhaltsliste, wenn keine eigene Suchergebnisseite mit searchresults definiert wurde.

Statisch:  Ja  
Parameter:

emptymsg (optional, Standardwert True)      
Standardmäßig wird bei leerer Inhaltsliste (z.B. aufgrund von Filterung) die Nach­richt „keine Ergebnisse“ angezeigt. Setzen Sie den Parameter auf "", erscheint diese Nachricht nicht. Setzen Sie den Parameter auf False, bleibt das ganze Element leer. Im letzteren Fall kann [decoration] (siehe oben) genutzt werden.

indextopmost (optional, Standardwert True)  
Standardmäßig wird die Startseite eines Websiteordners als erste in der Inhalts­liste angezeigt. Sie können die Startseite aber auch nach dem gültigen Krite­ri­um in die Inhaltsliste einsortieren, indem Sie den Parameter indextopmost auf False setzen.

metafilterdocs (optional, Standardwert None
Der Parameter metafilterdocs ermöglicht es Ihnen, nur Dokumente in der In­halts­liste anzuzeigen, die bestimmten Kriterien bezüglich eines ihrer Meta­da­ten­attri­bute genügen. Der Parameterwert besteht aus einem Meta­daten­attribut und einer komma-separierten Liste möglicher Werte. Dabei lässt sich auf Gleich­heit (=), Ungleichheit (!) und Enthaltensein (%) prüfen. Eine Quali­fizie­rung der Operatoren mit  einem vorangestellten * bewirkt eine Anzeige auch der­jenigen Dokumente, die über das gesuchte Metadatenattribut nicht ver­fü­gen. Die Beispiele unten erläutern den Gebrauch des Parameters. Die Meta­da­tenattribute sind mit ihren internen Bezeichnern zu spezifizieren. Eine Liste mit möglichen Metadaten und ihren Bezeichnern findet sich weiter unten hin­ter den Beispielen. Im Stan­dardfall wird nicht nach Metadaten gefiltert.

metafilterfolders (optional, Standardwert None)        
Funktioniert wie metafilterdocs, bezieht sich allerdings auf die Anzeige von Ord­nern in der Inhaltsliste.

onlynames (optional, Standardwert "*")        
Der Parameter onlynames ermöglicht es Ihnen, Dokumente aus der Inhaltsliste auszuschließen, deren Name nicht bestimmte Zeichenketten enthält. Geben Sie eine komma-separierte Liste der zulässigen Namen an, etwa image??.jpg oder *.html (dabei steht * für eine beliebige Zeichenkette und ? für ein be­lie­biges Zeichen). Ordner sind von diesem Filtern nach Na­men nicht betroffen.

onlytypes (optional, Standardwert "text/html")      
Wirkt wie onlynames, nur wird auf der Grundlage des MIME-Typs der Ob­jek­te gefiltert. Spezifizieren Sie als Wert dieses Parameters eine komma-sepa­rier­te Liste mit den zulässigen Typen, z.B. text/html für HTML-Dokumente. Die Spezifikation ganzer Grup­pen von MIME-Typen ist auch möglich, wobei * als Jokerzeichen eingesetzt werden kann, z.B. text/*. Ordner sind von diesem Fil­tern nach MIME-Typ nicht betroffen. Wenn Sie den Filter ausstellen wol­len, geben Sie als Wert "*" an. Sie können onlytypes gleichzeitig mit only­names ver­wenden. In diesem Fall werden nur Dokumente angezeigt, die beide Kriterien er­füllen.

paging (optional, Standardwert True)  
Legt fest, ob die Einträge der Inhaltsliste, wenn nötig, auf mehrere Seiten auf­geteilt wer­den, zwischen denen man hin- und herwechseln kann, oder nicht. Die Anzahl der Einträge pro Seite entspricht der Be­nut­zer­ein­stellung „Maxi­male Anzahl von sichtbaren Einträgen in Ordner­an­sichten“, die im oberen Me­nü unter  Optionen    Einstellungen  in der Abteilung „Darstellung“ definiert wird.

showextensions (optional, Standardwert False)       
Standardmäßig werden Dateinamenerweiterungen (so wie .html) nicht in der Inhaltsliste gezeigt. Sie können sich diese Erweiterungen jedoch anzeigen las­sen, indem Sie showextensions auf True setzen.

showfolders (optional, Standardwert "webonly")      
Legt fest, welche Ordner zusätzlich zu den anderen Objekten angezeigt wer­den, und kann einen der folgenden drei Werte haben:

all      Alle Ordner werden angezeigt.

none     Kein Ordner wird angezeigt.

webonly  Nur Websiteordner mit aktiver Startseite werden angezeigt.

showhome (optional, Standardwert True)      
Standardmäßig erscheint die Startseite in der Inhaltsliste. Sie können von die­sem Verfahren ab­wei­chen, indem Sie den Para­meter auf False setzen.

showlayout, showstyle (optional, Standardwert False)        
Standardmäßig erscheinen Layoutseite und Stildefinition nicht in der Inhalts­liste. Sie können das erzwingen, indem Sie den entsprechenden Para­meter auf True setzen.

showtemplatefolders (optional, Standardwert False)
Standardmäßig werden Vorlagenordner nicht in der Inhaltsliste angezeigt. Sie können das erzwingen, indem Sie den Parameter showtemplatefolders auf True setzen, vorausgesetzt, dass diese Ordner nach dem Wert des Parameters show­folders überhaupt angezeigt würden.

showtitle (optional, Standardwert False)       
Legt fest, ob der Name des aktuellen Ordners oberhalb der Inhaltsliste an­ge­zeigt werden soll.

sort (optional, Standardwert "byName")         
Legt die Sortierung der Inhaltsliste fest und kann die folgenden Werte haben:

byType    Sortierung nach Objekttyp

byName    Sortierung nach Name

bySize    Sortierung nach Größe

byDate    Sortierung nach Datum der letzten Änderung

byRating  Sortierung nach Bewertung

Es können auch mehrere Sortierkriterien als komma-separierte Liste angege­ben werden. Ein - vor dem Sortierkriterium kehrt die Sortierreihenfolge um. Wenn sort nicht angegeben wird, wird nach Namen sortiert.

uplink (optional, Standardwert False)
Standardmäßig enthält die Inhaltsliste für alle Unter-Websiteordner einen Ver­weis auf den übergeordneten Websiteordner, jedoch nicht im Websiteordner auf oberster Ebene. Sie können diesen Verweis unterdrücken, indem Sie den Parameter uplink auf False setzen. Sie können den Verweis auch auf oberster Ebene erscheinen lassen, indem Sie den Wert auf True setzen.

target (optional, Standardwert "")   
Legt fest, in welchem Browserfenster Dokumente eines bestimmten Typs, die in der Inhaltsliste enthalten sind, ge­öff­net werden sollen. Der Wert des Para­meters besteht aus einer komma-se­pa­rierten Liste von Anga­ben, die sich auf das Zielfenster und den MIME-Typ des Dokuments beziehen. Die Angabe eines Fensternamens allein bezieht sich auf sämtliche Dokumente, die Angabe von [MIME-Typ]:[Fenstername] be­zieht sich nur auf die Anzeige von Doku­men­ten des erwähnten MIME-Typs. Für den Gebrauch des Parameters siehe auch die Beispiele unten. Standard­mä­ßig werden alle Dokumente im aktuellen Fenster des Browsers geöffnet, erset­zen also die Anzeige der Inhalts­liste.

topitems (optional, Standardwert "")  
Legt die Objekte des aktuellen Ordners fest, die unabhängig von der gewählten Sor­tie­rung als erstes angezeigt werden sollen. Der Wert des Parameters besteht aus einer komma-separierten Liste von Objektnamen.

Beispiele:

[element contents showlayout=True topitems="Erster,Zweiter"]    
Zeigt eine Inhaltsliste an, die auch die Layoutseite einschließt. Die Objekte Erster und Zweiter erscheinen unabhängig von der Sortierung an oberster Stelle der Liste.

[element contents onlynames="*.html"]  
Zeigt eine Inhaltsliste an, die neben Ordnern nur Objekte enthält, deren Namen auf .html endet.

[element contents onlytypes="text/plain, text/html"]       
Zeigt eine Inhaltsliste an, die neben Ordnern nur Text- und HTML-Dokumente enthält.

[element contents metafilterdocs="bscw:keywords=cat,dog"]         
Zeigt eine Inhaltsliste an, in der nur diejenigen Dokumente vorkommen, die die Tags cat oder dog enthalten.

[element contents metafilterdocs="bscw:keywords*=cat,dog"]       
Wie vor, nur werden auch Dokumente ohne Tags angezeigt.

[element contents metafilterfolders="bscw:keywords!cat,dog"]  
Zeigt eine Inhaltsliste an, in der nur diejenigen Ordner vorkommen, die die Tags cat oder dog nicht enthalten.

[element contents target="_blank"]    
Bewirkt, dass alle Dokumente der Inhaltsliste in einem neuen Browserfenster geöffnet werden.

[element contents target="application/pdf:_blank"]
Bewirkt, dass alle PDF-Dokumente der Inhaltsliste in einem neuen Browser­fenster geöffnet werden. Alle anderen Dokumente werden im aktuellen Fenster geöffnet.

[element contents target="_blank, application/pdf:myWindow"]  
Bewirkt, dass alle PDF-Dokumente der Inhaltsliste im Fenster myWindow ge­öffnet werden. Alle anderen Dokumente werden in einem neuen Fenster geöff­net.

Auswahl von Metadatenbezeichnern

Allgemeine Metadaten von BSCW-Objekten    
bscw:category (Kategorie), bscw:description) (Beschreibung), bscw:keywords (Tags), bscw:name (Name), bscw:priority (Priorität)

Dublin-Core-Attribute von Dokumenten
DC:author (Verfasser), DC:coverage (Gebiet), DC:created (Erstellt am), DC:format (Format (MIME-Typ)), DC:language (Sprache), DC:publisher (Verleger), DC:source (Quelle), DC:subject (Gegenstand), DC:title (Titel)

Metadaten von Benutzern und Kontakten       
bscw_contact:givenname (Vorname), bscw_contact:mail (E-Mail-Adresse), bscw_contact:org (Organisation), bscw_contact:surname (Nachname)

Dokumentattribute bei der Dokumentfreigabe
bscw_doc:approval_status (Status), bscw_doc:responsible (Verantwortlich)

Metadaten von Laufmappen     
bscw_flowfolder:responsible (Verantwortlich), bscw_flowfolder:task (Aufga­be)

Für eine vollständige Liste der verfügbaren Metadaten wenden Sie sich an Ihren BSCW-Administrator. Sie erhalten eine Liste von Metadatenbezeichnern eines be­stimmten Metadatenprofils, indem Sie action  Spezifikation  im Aktionsmenü des Profils auswählen.

contentsmetatable Fügt eine Tabelle mit ausgewählten Metadaten aller Objekte, die direkt im aktuellen Website­ordner enthalten sind, in das aktuelle Dokument ein. Diese Inhaltstabelle kann durch den Benutzer nach den angezeigten Metadaten sortiert werden. Die Spalten der Tabelle zeigen standardmäßig die Metadaten Name, Tags und Beschrei­bung der enthaltenen Objekte an. Sie können auch andere Metadaten anzeigen lassen. Metadatenattribute werden durch ihre Bezeichner identifiziert. Sie erhalten eine Liste der Metadatenbezeichner eines Metadatenprofils, indem Sie action  Spezifikation  im Aktionsmenü des Metadatenprofils aufrufen. Beispiele für Metadatenbezeichner finden Sie bei contents oben.

Statisch:  Ja  
Parameter:

columns (optional, Standardwert "bscw:name, bscw:keywords,  
                         bscw:description"
)       
Standardmäßig zeigt die Inhaltstabelle in ihren Spalten die Metadaten Name, Tags und Beschreibung der direkt enthaltenen Objekte in dieser Reihenfolge an. Geben Sie hier eine komma-separierte Liste von Namen von Metadaten an, wenn Sie vom Standard abweichen wollen.

Im übrigen stehen Ihnen die folgenden Parameter zur Verfügung, die dieselbe Wir­kung wie in contents haben, nämlich bestimmte Objekte von der Aufnahme in die In­halts­tabelle auszuschließen.

metafilterdocs (optional, Standardwert None)

metafilterfolders (optional, Standardwert None)

onlynames (optional, Standardwert "*")

onlytypes (optional, Standardwert "text/html")

showfolders (optional, Standardwert "webonly")

showhome (optional Standardwert True)       

showlayout (optional, Standardwert False)

showstyle (optional, Standardwert False)

showtemplatefolders (optional, Standardwert False)

Beispiel:

[element contentsmetatable]         
Zeigt die enthaltenen Dokumente und Webordner tabellarisch mit Namen, Tags und Beschreibung.

date Fügt das aktuelle Datum und die aktuelle Uhrzeit ein.

Statisch:  Ja  
Parameter:

format (optional)
Wenn Ihnen das Standardformat für Datum und Zeit nicht gefällt (Beispiel: 2007-07-10 14:31) und Sie mit Python-Programmierung vertraut sind, können Sie hier Ihr eigenes Format angeben. Konsultieren Sie dazu das Python-Hand­buch unter strftime.

Beispiel:

[element date format="%A, %d. %B, %H:%M"]     
Fügt das aktuelle Datum und die aktuelle Uhrzeit in einem benutzerdefinierten Format ein, das statt des obigen Standardformats Dienstag, 10. Juli, 14:31 er­gibt.

documentactions Fügt ein komplettes Aktionsmenü für das aktuelle Doku­ment ein oder einen Verweis auf eine bestimmte Aktion.

Statisch:  Nein        
Parameter:

action (optional)
Wenn dieser Parameter weggelassen wird, wird ein ganzes Aktionsmenü ein­gefügt. Sonst wird ein direkter Verweis auf die angegebene Aktion erzeugt. Die zulässigen Werte für den Parameter action sind weiter unten aufgeführt. Wenn die angegebene Aktion für den aktuellen Benutzer nicht erlaubt ist, wird das documentactions-Element durch den Wert der Parameter forbiddentext bzw. forbiddenicon oder durch eine leere Zeichenkette ersetzt.

forbiddenicon (optional; wird nur verwendet, wenn action gesetzt ist)       
Wenn die angegebene Aktion für den aktuellen Benutzer nicht erlaubt ist, wird statt dem Verweis auf die Aktion das Symbol angezeigt, auf das der Wert dieses Parameters verweist.

forbiddentext (optional; wird nur verwendet, wenn action gesetzt ist)        
Wenn die angegebene Aktion für den aktuellen Benutzer nicht erlaubt ist, wird der Wert dieses Parameters statt dem Verweis auf die Aktion angezeigt. Wenn der Parameter weggelassen wird, wird in diesem Fall eine leere Zeichenkette an­gezeigt.

icon (optional; wird nur verwendet, wenn action gesetzt ist)
Mit dem Parameter icon kann der Verweis auf die Aktion mit einem Symbol versehen werden. Der Wert des Parameters ist eine URL, die auf das Symbol ver­weist. Wenn der Wert auf True gesetzt wird, wird das BSCW-eigene Sym­bol für die Aktion genommen. Wenn sowohl icon als auch text angegeben wer­den, wird der Aktionsverweis mit dem Symbol unterlegt und der Text fungiert als Tooltip.

onlyif (optional, Standardwert "")       
Definiert eine Bedingung für die Anzeige des Aktionsmenüs. Ist die Bedin­gung nicht erfüllt, bleibt das ganze Element leer. Der Wert des Parameters ist eine Zeichenkette. Aktuell verfügbare Bedingungen prüfen, ob es sich bei der aktu­ellen Seite um die Startseite des Websiteordners handelt (index) oder welches Kompetenzniveau der Benutzer hat (Anfänger, Fortgeschrittener, Experte: profile_ui_beginner, profile_ui_advanced, profile_ui_ex­pert). Das Kompetenzniveau wird im oberen Menü unter  Optionen    Ein­stel­lungen  in der Abteilung „Allgemeines“ festgelegt. Der logische Operator not kann auch ver­wen­det werden. Vergleiche auch die Beispiele unten.

text (optional; wird nur verwendet, wenn action gesetzt ist)
Der Text des Verweises auf die angegebene Aktion entspricht dem Wert des Para­meters text. Wenn der Parameter text weggelassen wird, besteht der Text des Verweises aus dem BSCW-Namen der Aktion in der Sprache des aktuellen Be­nutzers. Denken Sie daran, dass ein Text, der Leerzeichen enthält, in An­füh­rungs­zeichen eingeschlossen werden muss.

Beispiele:

[element documentactions]  
Fügt das Aktionsmenü der Benutzeroberfläche für das aktuelle Do­kument ein.

[element documentactions action=get text="Quelltext"]     
Fügt einen Verweis zum Öffnen des aktuellen Dokuments mit dem Text „Quell­text“ ein. Diese Aktion zeigt den Quelltext des Dokuments an, d.h. BSCW- und Textelemente werden nicht ausgewertet und ersetzt.

[element documentactions action=replace]       
Fügt einen Verweis zum Ersetzen des aktuellen Dokuments mit dem Standard­text, dem Aktionsnamen „Ersetzen“, ein.

[element documentactions action=printweb icon=True onlyif="not index"]     
Fügt das Standardsymbol zum Drucken des aktuellen Dokuments in das aktu­elle Dokument ein, sofern es sich nicht um die Startseite handelt.

[element documentactions action=edit icon=True     onlyif=profile_ui_expert]     
Fügt das Standardsymbol zum Bearbeiten des aktuellen Dokuments in das ak­tu­elle Dokument ein, sofern das Kompetenzniveau des Benutzers auf „Ex­perte“ gesetzt ist.

Mögliche Aktionen:   
attachnote (Notiz anhängen), checkout (Sper­ren), chtype (Typ ändern), copy (Ko­pieren), cut (Aus­schnei­den), cut­attachment (Anhang ausschneiden), duplicate_edit (Kopie bear­bei­ten), edit (Be­ar­bei­ten), editobject (Eigenschaften ändern), export (Exportieren), freeze (Ein­frieren), get (Öffnen), history (Historie zeigen), info (Mehr In­for­mation), link (Ver­weisen in Ablage), printweb (Drucken), rate (Be­wer­ten), replace (Ersetzen), resubmit (Wiedervorlegen), revise (Neue Version).

fileupload Fügt ein Interaktionselement zum Hochladen von Bildern in den aktu­ellen Ordner ein. Pro Seite ist nur ein Element fileupload zulässig.        
Das Interaktionselement besteht aus drei Schaltflächen [Datei(en) zum Hoch­laden auswählen…], [Hochladen] und [Hochladen abbrechen] sowie einem Vor­schau­bereich für die hochzuladenden Dateien. Die erste Schaltfläche initiiert einen Stan­dard­dialog zur Auswahl von Dateien, die zweite Schaltfläche bewirkt das eigent­liche Hochladen, die dritte Schaltfläche bricht den Hochladeprozess ab. Sie können hoch­zuladende Dateien auch über die Schaltfläche [Hochladen] ziehen und dort fallen lassen. Die zum Hochladen ausgesuchten Dateien werden im Vorschaubereich unter­halb der Schaltflächen angezeigt.          
Hinweis: Zur Zeit ist das Element fileupload nur für das Hochladen von Bilddateien vor­gesehen.

Statisch:  Nein                  
Parameter:  Keine

Beispiel:

[element fileupload]

folderactions Wirkt genau wie documentactions, jedoch ist der aktuelle Website­ord­ner der Gegenstand des Aktionsmenüs bzw. der einzelnen Aktionen, auf die verwiesen wird.

Statisch:  Nein        
Parameter:

Dieselben wie für documentactions.

Beispiele:

[element folderactions]     
Fügt das Aktionsmenü der Benutzeroberfläche ohne JavaScript für den aktuel­len Websiteordner ein.

[element folderactions action=get text="Liste aller Objekte im BSCW-Stil"]
Fügt einen Verweis zum Öffnen des aktuellen Websiteordners mit dem Text „Liste aller Objekte im BSCW-Stil“ ein. Diese Aktion zeigt die BSCW-übliche Liste von Einträgen des Websiteordners an.

[element folderactions action=history]
Fügt einen Verweis auf die Historie des aktuellen Websiteordners mit dem Stan­dard­text, dem Aktionsnamen „Historie zeigen“, ein.

Mögliche Aktionen:   
addcal (Neuer Gruppenkalender), addctlist (Neue Kontaktliste), addmember (Mit­glied einladen), add­notes (Neues Diskussionsforum),addpage (neue Seite), addsub­webfolder (Neuer Ordner), addrole (Neue Rolle), add­Search (Neuer Such­ordner), addurl (Neue URL), chbanner (Banner ändern), chrole (Rolle zuweisen), copy (Kopieren), cut (Ausschneiden), editindex (Start­seite be­ar­beiten), editobject (Ei­genschaften ändern), editrole (Rolle ändern), edit­style (Stil­definition bearbei­ten), edittemplate (Layoutseite bearbeiten), export (Ex­por­tieren), get (Öff­nen), getweb (Webansicht zeigen), history (Historie zeigen), info (Mehr In­for­ma­tion), link (Verweisen in Ablage), make (Statische Kopie), pub­access (Öf­fent­lich machen), uploaddoc (Dokument hochladen).

gallery Stellt die im aktuellen Websiteordner enthaltenen Bilder in Form einer Galerie mit miniaturisierten Ansichten dar. Unter Bildern werden Dokumente mit einem ent­sprechenden MIME-Typ (image/jpg, image/png usw.) verstanden.

Statisch:  Ja  
Parameter:

emptymsg (optional, Standardwert True)      
Standardmäßig wird bei leerer Bildergalerie die Nachricht „keine Ergebnisse“ angezeigt. Setzen Sie den Parameter auf "", erscheint diese Nachricht nicht. Setzen Sie den Parameter auf False, bleibt das ganze Element leer. Im letz­teren Fall kann [decoration] (siehe oben) genutzt werden.

hover (optional, Standardwert False)  
Wenn der Parameter auf True gesetzt wird, wird ein Galeriebild, über dem sich der Cursor befindet, geringfügig vergrößert.

lightbox (optional, Standardwert False)        
Wenn der Parameter auf True gesetzt wird, wird bei Klicken auf ein Galeriebild eine Vollbildvorschau angezeigt.

paging (optional, Standardwert False)
Funktioniert grundsätzlich wie bei contents. Nur kann man hier zusätzlich noch die maximale Zahl der Einträge pro Seite direkt als Wert des Parameters an­ge­ben, was die Benutzer­ein­stellung „Maximale Anzahl von sichtbaren Einträgen in Ordneransichten“ ersetzt.

size (optional, Standardwert "small"
Steuert die Größe der angezeigten Galeriebilder. Weitere mögliche Werte sind "medium" und "large".

sort (optional, Standardwert "byType, byName")      
Standardmäßig werden die Bilder nach Typ und Name sortiert. Abweichende Sortierungen werden mit diesem Parameter wie bei contents definiert.

Beispiel:

[element gallery paging=10 sort="byName" lightbox=True]

history Fügt die Liste der zuletzt besuchten Dokumente als klickbare Verweise ein.

Statisch:  Nein        
Parameter:

divider (optional, Standardwert ", ")  
Standardmäßig werden die Verweise in der Liste durch Komma und Leer­zei­chen getrennt. Mit dem Parameter divider können Sie eine andere Zeichenkette als Trenner angeben.

maxdocs (optional, Standardwert 5)    
Standardmäßig werden höchstens fünf Dokumente in der Liste angezeigt. Mit maxdocs können Sie eine andere Höchstzahl festlegen.

showextensions (optional, Standardwert False)       
Standardmäßig werden Dateinamenerweiterungen (so wie .html) nicht in der history-Liste gezeigt. Sie können sich diese Erweiterungen jedoch anzeigen las­sen, indem Sie showextensions auf True setzen.

Beispiel:

[element history divider=" | " maxdocs=7]

lastmod Fügt Datum und Uhrzeit der letzten Änderung des aktuellen Dokuments ein.

Statisch:  Ja  
Parameter:

format (optional)
Sie können hier Ihr eigenes Format angeben, wie es oben bei date erläutert wurde.

Beispiel:

[element lastmod]

lastmodby Fügt den Namen des Benutzers ein, der das aktuelle Dokument zuletzt geändert hat.

Statisch:  Ja  
Parameter:  Keine

Beispiel:

[element lastmodby]

location Fügt den Pfad zum aktuellen Dokument als klickbare Verweise ein.

Statisch:  Ja  
Parameter:  Keine

Beispiel:

[element location]

message Fügt eine BSCW-Systemmeldung ein. Diese Meldungen werden in der vom ak­tuellen Benutzer eingestellten Sprache angezeigt.

Statisch:  Ja  
Parameter:

name (erforderlich)      
Der Name der Meldung, die angezeigt werden soll. Die verfügbaren Meldun­gen sind in der Datei          
   BSCW-Verzeichnis/messages/de/lg_msgconfig.py       
auf Ihrem BSCW-Server enthalten. Fragen Sie Ihren BSCW-Administrator nach dem Inhalt dieser Datei bzw. der genauen Position dieser Datei in Ihrer BSCW-Installation.

Beispiel:

[element message name=location]  
Zeigt die Meldung mit den Namen ‚location‘ an. Auf Deutsch ergibt das „Ihre Position“.

metadata Fügt eine Liste mit den Metadaten des aktuellen Objekts ein, die nach den Gruppen des jeweiligen Metadatenprofils gegliedert ist, und bietet eine Schalt­fläche zum Ändern der Metadaten. Im Unterschied zu contentsmetatable geht es hier um ein Objekt.

Statisch:  Ja  
Parameter:  Keine

Beispiel:

[element metadata]

search Fügt den Eingabebereich für die Volltextsuche im Websiteordner ein. Wenn möglich, erscheint rechts neben dem Suchfeld eine Schaltfläche [Erweitert], die zum vol­len Suchformular führt. Die Er­geb­nisse der Suche erscheinen auf einer Such­ergeb­nis­seite, die Sie mit searchresults zu dem aktuellen Websiteordner definiert haben. Ohne spezielle Suchergebnisseite ersetzen die Suchergebnisse Inhaltslisten bzw. Inhaltsbäume, die mit contents bzw. tree erzeugt wur­den. Die Verwendung von search ist also nur sinnvoll, wenn gleich­zeitig searchresults, con­tents oder tree verwendet werden, weil sonst die Such­ergeb­nisse nicht angezeigt wer­den.

Statisch:  Nein        
Parameter:  Keine

Parameter:

selectscope (optional, Standardwert False)   
Legt fest, ob der Suchbereich (ganzer Websiteordner oder aktueller Ord­ner) an der Benutzerschnittstelle ausgewählt werden kann.

scopeall (optional, Standardwert True)
Legt fest, ob die Suche im ganzen Websiteordner stattfindet oder nicht. Setzen Sie den Parameter auf False, wenn Sie die Suche auf den aktuellen Ordner beschränken wollen.

Beispiel:

[element search]

searchresults Definiert die Suchergebnisseite, die die Ergebnisse von Suchen im aktu­ellen Websiteordner anzeigt.

Statisch:  Nein        
Parameter:

Dieselben wie für contents mit folgenden Zusätzen:

grouping (optional, Standardwert False)       
Erlaubt die Gruppierung von Suchergebnissen nach den Ordnern, in denen sie ent­halten sind. Bei der Standardeinstellung werden die Ergebnisse als normale Liste aufgeführt, die nach den Kriterien des Parameters sort sortiert sind. Wenn Sie den Wert auf True setzen, werden die Suchergebnisse in Gruppen an­ge­zeigt: jede Gruppe enthält alle Treffer in einem bestimmten Ordner; die Grup­pen selbst werden nach dem Pfad sortiert, der zu dem betreffenden Ord­ner führt; innerhalb der Gruppe werden die Suchergebnisse nach den Kriterien des Parameters sort sortiert. Setzen sie den Wert des Parameters grouping auf eine Zahl n>1, dann werden pro Gruppe maximal n Suchergebnisse an­ge­zeigt.

paging (optional, Standardwert False)
Funktioniert grundsätzlich wie bei contents, d.h. die Suchergebnisse werden, wenn nötig, auf mehrere Seiten aufgeteilt, wenn der Parameter nicht den Wert False hat. Man kann hier wie bei gallery die maximale Zahl der Einträge pro Seite auch direkt als Wert des Parameters an­geben, was die Benutzer­ein­stellung „Maximale Anzahl von sichtbaren Ein­trä­gen in Ordneransichten“ er­setzt.
Die Art und Weise, wie die Suchergebnisse auf Seiten aufgeteilt werden, hängt hier noch vom Wert des Parameters grouping ab. Wenn grouping den Stan­dard­wert False hat, werden die Suchergebnisse nach dem Wert von paging auf Seiten auf­geteilt. Wenn der Parameter grouping den Wert True hat, regelt der Parameter paging, wieviel Gruppen (nicht Suchergebnisse) maximal auf einer Seite angezeigt werden. Auch wenn grouping einen Wert n>1 hat, regelt der Wert von paging, wieviel Gruppen auf einer Seite höchstens angezeigt werden, nur dass jetzt nicht alle Ergebnisse pro Ordner erscheinen, sondern maxi­mal n.

showpath (optional, Standardwert False)      
Legt fest, ob der Pfad zum Ordner, der das Suchergebnis enthält, hinter dem Namen des Suchergebnisses angezeigt werden soll.

Beispiel:

[element searchresults grouping=8 paging=4]  
Legt fest, dass die Suchergebnisse nach den Unterordnern, in denen sie ent­halten sind, gruppiert werden, dass pro Gruppe maximal acht Suchergebnisse angezeigt werden und dass pro Seite maximal vier Gruppen angezeigt werden.

size Fügt die Größe eines Objekts ein.

Statisch:  Ja  
Parameter:

filename (optional)       
Standardmäßig wird die Größe des aktuellen Dokuments angezeigt. Sie können ein anderes Objekt bestimmen, dessen Größe angezeigt werden soll, indem Sie seinen Namen im Parameter filename angeben.

unit (optional, Standardwert B)
Die Standardeinheit ist Byte (B). Wenn Ihr Objekt recht groß ist, wäre eine an­dere Einheit vielleicht angemessener. Gültige Einheiten sind B, KB, MB, GB.

Beispiel:

[element size filename="files/dvd-image.iso" unit=GB]     
Fügt die Größe des Objekts dvd-image.iso im Unterordner files des ak­tu­el­len Ordners in Gigabyte ein.

systembanner Fügt das Systembanner ein; standardmäßig handelt es sich dabei um das normale BSCW-Systembanner.

Statisch:  Ja  
Parameter:  Keine

Beispiel:

[element systembanner]

tags Fügt eine Liste der Tags ein, die Objekten des aktuellen Web­site­ordners zu­ge­wie­sen wurden. Durch Klicken auf einen Tag wird die Anzeige von Objekten in der durch contents erzeugten Inhaltsliste auf diejenigen Objekte eingeschränkt, denen dieser Tag zugewiesen wur­de. Beachten Sie, dass das Klicken auf einen Tag keine Wirkung auf hierarchische Listen hat, die mit tree erzeugt wurden.

Statisch:  Nein        
Parameter:  Keine

Beispiel:

[element tags]

toc Zeigt ein Inhaltsverzeichnis des aktuellen Dokuments an, das aus den Über­schrif­ten als klickbaren Verweisen besteht, die eine Navigation im Dokument erlauben.

Statisch:  Nein        
Parameter:

headingcount (optional, Standardwert 1)        
Legt die minimale Anzahl von Überschriften im Inhaltsverzeichnis fest. Bei Unterschreiten dieses Werts wird überhaupt kein Inhaltsverzeichnis angezeigt. Dieser Parameter soll es ermöglichen, das Element toc auch auf Layout­seiten zu verwenden und dabei zu verhindern, dass das Inhaltverzeichnis einge­bet­te­ter Inhaltsseiten zu dürftig ausfällt.

highest (optional, Standardwert 5)      
Legt fest, bis zu welchem Niveau die Überschriften ins Inhaltsverzeichnis auf­ge­nommen werden sollen. Ein Wert von 3 legt z.B. fest, dass Überschriften <h1>, <h2> und <h3> ins Inhaltsverzeichnis aufgenommen werden sollen, nicht jedoch Überschriften <h4>, <h5> usw.

lowest (optional, Standardwert 1)       
Legt fest, ab welchem Niveau die Überschriften ins Inhaltsverzeichnis auf­ge­nom­men werden sollen. Ein Wert von 2 legt z.B. fest, dass Überschriften <h2>, <h3>, usw. ins Inhaltsverzeichnis aufgenommen werden sollen, nicht je­doch Überschriften <h1>.

title (optional, Standardwert None)      
Mit diesem Parameter kann eine Titelzeile für das Inhaltsverzeichnis angege­ben werden.

Beispiel:

[element toc headingcount=5 highest=3 title="Inhalt"]   
Zeigt ein aus mindestens fünf Überschriften bestehendes Inhaltsverzeichnis mit Überschriften <h1>, <h2> und <h3> und der vorangestellten Titelzeile Inhalt an.

tree Fügt eine Baumansicht des aktuellen Ordners und aller übergeordneten Web­site­ordner ein, die aus klickbaren Verweisen besteht. Nach einer Volltextsuche ersetzen die Such­ergeb­nisse den Inhaltsbaum, wenn keine eigene Suchergebnisseite mit searchresults definiert wurde.

Statisch:  Ja  
Parameter:

Dieselben wie für contents mit Ausnahme von paging und einer Ausnahme für den Standardwert.

showhome (optional, Standardverfahren siehe unten)         
Standardmäßig wird die Startseite für den obersten Ordner angezeigt, aber nicht für die Unterordner im Baum. Sie können von diesem Verfahren ab­wei­chen, indem Sie den Para­meter auf True oder False setzen.

Beispiele:

[element tree showlayout=True]    
Zeigt einen Inhaltsbaum mit Layoutseiten an.

[element tree onlynames=*.html]  
Zeigt einen Inhaltsbaum an, der neben Ordnern nur Objekte enthält, deren Na­men auf .html endet.