Der folgende Artikel beschreibt die Verwendung von Berichtsfunktionen für das WORD-Format in BeeCollect Professional.
Der Berichtsgenerator von BeeCollect Professional unterstützt eine Reihe von Funktionen, welche den Abruf spezieller Informationen erlauben, die Aufbereitung von Informationen vor dem Ausdruck ermöglichen und das Erscheinungsbild einer Druckausgabe zu beeinflussen helfen.
Diese Funktionen sind in ihrer Parametrierung hier beschrieben.
Es wird grundsätzlich zwischen den folgenden Funktionstypen unterschieden:
Sämtliche Funktionsnamen sind innerhalb der Berichte in korrekter Groß- und Kleinschreibung anzugeben wie in der folgenden Dokumentation beschrieben:
Richtig: [ApplicationVersion]
Falsch: [applicationversion]
Viele der folgenden Funktionen erwarten einen oder mehrere Parameter. Diese Parameter werden durch ein definiertes Trennzeichen (meistens ein Komma oder ein Semikolon) voneinander getrennt. Bitte beachten Sie, dass keine Leerzeichen vor und/oder hinter den Trennzeichen erlaubt sind. Insbesondere bei Einsatz der Zwischenablage werden oft unbemerkt Leerzeichen eingefügt. Diese sind für die korrekte Erkennung der Funktionen zu entfernen.
Richtig: [PreviewImage:21,«ObjId»,250,250]
Falsch: [PreviewImage: 21, «OnjId», 250, 250]
Die folgenden statischen Funktionen stehen für Berichte in allen Modulen zur Verfügung und erlauben die Ausgabe verschiedener Systemwerte.
Gibt den Namen der aktuellen Applikation aus.
Syntax: [Application]
Parameter: Keine
Gibt die Versionsnummer der aktuellen Applikation aus.
Syntax: [ApplicationVersion]
Parameter: Keine
Gibt den Kurznamen des aktuell angemeldeten Benutzers aus. Der Kurzname wird u.a. gemeinsam mit dem jeweiligen Datum dafür verwendet, bearbeitete Datensätze zu kennzeichnen.
Syntax: [UserShort]
Parameter: Keine
Gibt den Namen des aktuell angemeldeten Benutzers aus. Der hier ausgegebene Name entspricht auch dem Anmeldenamen bei BeeCollect Professional.
Syntax: [UserLong]
Parameter: Keine
Gibt die im Modul Benutzer hinterlegte Abteilungsbezeichnung des aktuell angemeldeten Benutzers aus.
Syntax: [UserDepartment]
Parameter: Keine
Gibt das Datum der Berichtserstellung aus. Das Datum wird in kurzer Schreibweise mit Tag, Monat und Jahr jeweils entsprechend der landesspezifischen Einstellungen des Clientcomputers, auf dem BeeCollect Professional ausgeführt wird formatiert.
Syntax: [Date]
Parameter: Keine
Gibt die Uhrzeit der Berichtserstellung aus. Die Uhrzeit wird in kurzer Schreibweise mit Stunden, Minuten und Sekunden jeweils entsprechend der landesspezifischen Einstellungen des Clientcomputers, auf dem BeeCollect Professional ausgeführt wird formatiert.
Syntax: [Time]
Parameter: Keine
Die folgenden Funktionen liefern dynamisch berechnete Werte abhängig von den übergebenen Parametern. Die Parameter können dabei auch Datenfelder aus der aktuellen Datenquelle eines Berichtes sein. Nicht alle Funktionen stehen in allen Modulen uneingeschränkt zur Verfügung oder liefern in allen Modulen sinnvolle Ausgabewerte.
Liefert das Vorschaubild eines Sammlungsobjektes in der angegebenen Größe als JPG-Image.
Syntax: [PreviewImage:<module_id>,<primary_key>,<size_x>,<size_y>]
Parameter:
Beispiel:
Ausgabe des Vorschaubildes aus dem Modul Sammlung für das aktuell vom Bericht verarbeitete Sammlungsobjekt in der Größe 250×250 Pixel.
[PreviewImage:21,«ObjId»,250,250]
Liefert das Originalbild welches in einem Multimediadatensatz verknüpft ist, in der angegebenen Größe als JPG-Image.
Syntax:
[Image:<file>,<size_x>,<size_y>,optional scale_size_x>,<optional scale_size_y]
Parameter:
Beispiel:
Ausgabe des Vorschaubildes aus dem Modul Sammlung für das aktuell vom Bericht verarbeitete Sammlungsobjekt in der Bildgröße 500×500 Pixel, skaliert auf 75×75 Pixel.
[Image:«MulPfadS»\«MulDateiS».«MulExtentS»,500,500,75,75]
Liefert das Asset aus dem Digital-Asset-Management-System, welches in einem Multimediadatensatz verknüpft ist, in der angegebenen Größe als JPG-Image. Als Basis für die Verarbeitung des Bildes wird aus dem DAMS dazu ein Bild mittlerer Auflösung heruntergeladen. Je nach DAMS kann die tatsächliche Größe dieses Basisbildes unterschiedlich sein und damit auch die Qualität der Druckausgabe.
Syntax:
[Asset:<catalog_id>,<asset_id>,<size_x>,<size_y>,optional scale_size_x>,<optional scale_size_y]
Parameter:
Beispiel:
Ausgabe des Vorschaubildes aus dem Modul Sammlung für das aktuell vom Bericht verarbeitete Sammlungsobjekt in der Bildgröße 500×500 Pixel, skaliert auf 75×75 Pixel.
[Asset:«MulAssetCatalogIdS»,«MulAssetIdS»,500,500,75,75]
Liefert den optoelektronisch lesbaren Code eines Sammlungsobjektes in der angegebenen Größe als JPG-Image.
Syntax:
[BarCode:<type>,<content>,<size_x>,<size_y>,<scale|crop>]
Parameter:
<type>: Der Typ des zu erstellenden Barcodes/2D-Codes als numerischer Wert zwischen 0 und 18. Folgende Codes werden von BeeCollect Professional unterstützt:
<content>: Der in den Barcode/2D-Code zu verschlüsselnde Inhalt. An dieser Stelle kann beispielsweise als Datenfeld die Inventarnummer oder Objekt-ID aus dem Modul Sammlung zum Einsatz kommen (siehe Beispiel). Achtung: Bacodes/2D-Codes unterliegen hinsichtlich der darstellbaren Zeichenmenge und Datentypen (Zeichen, Ziffern, Sonderzeichen) Einschränkungen.
<size_x>: Numerischer Wert zwischen 1 und 500 für die Breite des Bildes in Pixeln. Die tatsächliche Ausgabegröße im Dokument ist von verschiedenen Dokumenteinstellungen abhängig.
<size_y>: Numerischer Wert zwischen 1 und 500 für die Höhe des Bildes in Pixeln. Die tatsächliche Ausgabegröße im Dokument ist von verschiedenen Dokumenteinstellungen abhängig.
<scale|crop>: Optionaler Paramter, der angibt, ob der ausgegebene Code auf die angegebene Größe skaliert (scale) oder entsprechend der Größe abgeschnitten werden soll (crop). Die Option crop sollte nur bei 1D-Codes gewählt werden, da die bei 2D-Codes unter Umständen relevante Teile des Codes abgeschnitten werden würden.
Beispiel:
Ausgabe eines QR-Codes aus dem Modul Sammlung für das aktuell vom Bericht verarbeitete Sammlungsobjekt in der Größe 250×250 Pixel. Im QR-Code verschlüsselt wird die Inventarnummer des Objektes mit Präfix „OBJ_“.
[BarCode:13,Obj_«ObjInventarNrS»,250,250]
Liefert das oder die Gefahrstoffsymbole eines Sammlungsobjektes in der angegebenen Größe als JPG-Image.
Syntax: [HazardIcon:<value>,<size_x>,<size_y>]
Parameter:
Beispiel:
Ausgabe der Gefahrstoffsymbole aus dem Modul Sammlung für das aktuell vom Bericht verarbeitete Sammlungsobjekt in der Größe 25×25 Pixel.
[HazardIcon:«ObjBC_HazardState_L»,25,25]
Liefert das formatierte Adressetikett zur angegebenen Adresse. Die Formatierung kann durch verschiedene Parameter beeinflusst werden.
Syntax: [AddressLabel:<id>,<showdepartment>,<showfunction>,<titlelinebreak>]
Parameter:
HINWEIS: Bei Adressen mit angegebener Institution wird niemals ein Zeilenumbruch an dieser Stelle eingefügt (unabhängig von dieser Einstellung)
Beispiel:
Ausgabe des Adressetiketts für die aktuell vom Bericht verarbeitete Adresse mit Abteilung, ohne Funktion und ohne Zeilenumbruch zwischen Titel und Name.
[AddressLabel:«AdrId»,1,0,0]
Liefert eine Textinformation zur angegebenen Adresse, bestehend aus Institution, Vorname, Name, Ort und Land.
Syntax: [AddressInfo:<id>]
Parameter:
Beispiel:
Ausgabe einer Adressinformation für die aktuell vom Bericht verarbeitete Adresse.
[AddressInfo:«AdrId»]
Liefert die Kommunikationsangaben des angegebenen Typs zur ebenfalls anzugebenden Adresse.
Syntax: [Communication:<type>,<id>]
Parameter:
Beispiel:
Ausgabe der E-Mail-Adresse für die aktuell vom Bericht verarbeitete Adresse.
[Communication:E-Mail,«AdrId»]
Liefert die Summe aller Werte eines Datenfeldes innerhalb einer Datenquelle des Berichtes.
Syntax: [Sum:<table>,<column@„format“>,<optional condition>]
Parameter:
Beispiel:
Gesamtversicherungswert eines Leihvertrags, gebildet aus der Summe der Einzelversicherungswerte der Objekte mit dem Entscheid „Positiv“ und formatiert als Währungsangabe.
[Sum:Ausstellung_Obj,AobVersicherungWertF@„#,##0.00“,AobEntscheidS='Positiv']
Liefert die Anzahl der Datensätze innerhalb einer Datenquelle des Berichtes.
Syntax: [Count:<table>,<optional condition>]
Parameter:
Beispiel:
Anzahl der Objekte einer Ausstellung mit dem Entscheid „Positiv“.
[Sum:Ausstellung_Obj,AobVersicherungWertF@„#,##0.00“,AobEntscheidS='Positiv']
Liefert einen in Worten ausgegebenen numerischen Wert.
Syntax: [NumberInWords:<number>,<de|en>]
Parameter:
Beispiel:
Einzelversicherungswert eines Sammlungsobjektes in Worten in Deutsch.
[NumberInWords:«AobVersicherungWertS»,de]
Die folgenden Funktionen dienen der Steuerung der Datenquellen eines Berichts. Abhängig vom gewählten Berichtslayout markieren diese Funktionen das Ende eines Bereichs, der von einer bestimmten Datenquelle gefüllt wird. Dieser Bereich kann ein Absatz, eine Tabellenzeile oder eine Tabellenzelle sein.
Es existieren Funktionen mit einer einfachen Parametrierung und solche mit einer erweiterten Parametrierung, die verwendet werden kann, wenn Sortierung und Anzahl der auszugebenden Datensätze in einer spezifischen Datenquelle beeinflusst werden sollen.
Dieses Steuerfeld markiert das Ende einer Tabellenzeile innerhalb einer Tabelle, die an eine bestimmte Datenquelle gebunden sein soll.
Das Steuerfeld muss immer in der letzten Zeile der Tabelle, und dort in der letzten Zelle ganz rechts als letzter Eintrag vor dem Zellenende platziert werden. An jeder anderen Position wird das Steuerfeld vom Berichtsgenerator nicht erkannt und nicht ausgewertet.
Innerhalb der auf diese Weise an eine Datenquelle gebundenen Tabelle können nun alle Datenfelder aus der entsprechenden Datenquelle verwendet werden.
Jede Tabelle darf dabei nur eine Datenbindung besitzen. Es ist jedoch möglich, Tabellen ineinander zu verschachteln und den einzelnen verschachtelten Tabellen unterschiedliche Datenquellen zuzuweisen.
Es ist auch möglich, innerhalb einer Tabellenzelle beispielsweise mehrere Steuerfelder [NextLine] oder [NL] einzusetzen, um auf weitere Datenquellen zuzugreifen.
Syntax: [NextRow:<table>,<optional condition>]
Parameter:
Beispiele:
Ausgabe aller Objekte der Hauptdatenquelle des Berichtes im Modul Sammlung.
[NextRow:ObjDaten]
Ausgabe der Maßangaben eines Sammlungsobjektes mit den Typen Objektmaß, Bildmaß oder Durchmesser.
[NextRow:ObjMass,ObmTypMasseS IN ('Objektmaß','Bildmaß','Durchmesser')]
Dieses Steuerfeld bindet eine Tabellenzelle an eine bestimmte Datenquelle. Es wird ausschließlich beim Berichtslayout Etikett unterstützt und muss dort am Ende der ersten Tabellenzelle ganz links oben in der den Etikettenbericht bildenden Tabelle platziert werden.
Syntax: [NextCell:<table>,<optional condition>]
Parameter:
Beispiel:
Ausgabe aller Objekte der Hauptdatenquelle des Berichtes im Modul Sammlung.
[NextCell:ObjDaten]
Dieses Steuerfeld markiert das Ende einer Datenquelle mit erweiterter Parametrierung, die sich über den Absatz erstreckt, in welchem sich das Steuerfeld befindet.
HINWEIS: Nach dem Steuerfeld darf nur noch das Absatzende-Zeichen folgen.
HINWEIS: Als Trennzeichen wird bei diesem Steuerfeld das Semikolon verwendet (nicht wie bei den einfachen Steuerfeldern das Komma).
Syntax: [NL:<table>;<optional condition>;<optional sort order>;<optional limit>]
Parameter:
Beispiele:
Ausgabe der ersten 3 Maßangaben eines Sammlungsobjektes, sortiert nach Maßtyp.
[NL:ObjMass;;ObmTypMasseS;3]
Ausgabe des aktuellsten Versicherungswertes eines Sammlungsobjektes.
[NL:ObjHandel;OweAktionS='Vers. Ausstellung';OweId DESC;1]
Der folgende Artikel beschreibt die Verwendung von Berichtsfunktionen für das EXCEL-Format in BeeCollect Professional.
Der Berichtsgenerator von BeeCollect Professional unterstützt eine Reihe von Funktionen, welche den Abruf spezieller Informationen erlauben, die Aufbereitung von Informationen vor dem Ausdruck ermöglichen und das Erscheinungsbild einer Druckausgabe zu beeinflussen helfen.
Mit Version 1.6.15.4 oder höher stehen in BeeCollect Professional für die direkte Ausgabe in Excel nicht nur die Datenfelder der Hauptdatenquelle zur Verfügung, sondern weitere Berichtsfunktionen, welche die Ausgabe verknüpfter Tabellen und Bilder ermöglichen.
Diese Funktionen sind in ihrer Parametrierung hier beschrieben.
Die folgenden Funktionen liefern dynamisch berechnete Werte abhängig von den übergebenen Parametern. Die Parameter können dabei auch Datenfelder aus der aktuellen Datenquelle eines Berichtes sein. Nicht alle Funktionen stehen in allen Modulen uneingeschränkt zur Verfügung oder liefern in allen Modulen sinnvolle Ausgabewerte.
Liefert das Vorschaubild eines Sammlungsobjektes. Die Schreibweise der Funktion weicht für Excel etwas von der Ausgabe in MS Word ab. Es ist lediglich die Angabe der Objekt-Id erforderlich - der Parameter für das Modul entfällt, da ohnehin nur im Modul Sammlung Vorschaubilder existieren. Weitere Parameter sind nicht notwendig, da sich die Größe des Vorschaubilds an der Größe der umgebenden Zelle orientiert.
Syntax: [PreviewImage:<id>]
Beispiel:
Ausgabe des Vorschaubildes aus dem Modul Sammlung für das aktuell vom Bericht verarbeitete Sammlungsobjekt.
[PreviewImage:«ObjId»]
Diese Funktion kann zur Ausgabe eines formatierten Adress-Etiketts verwendet werden. Die Formatierung kann durch verschiedene Parameter beeinflusst werden.
Syntax: [AddressLabel:<adress_id>,<abteilung>,<funktion>,<zeilenumbruch_vor_titel>]
Parameter:
HINWEIS: Bei Adressen mit angegebener Institution wird niemals ein Zeilenumbruch an dieser Stelle eingefügt (unabhängig von dieser Einstellung)
Beispiel:
Ausgabe des Adressetiketts für die aktuell vom Bericht verarbeitete Adresse mit Abteilung, ohne Funktion und ohne Zeilenumbruch zwischen Titel und Name.
[AddressLabel:«AdrId»,1,0,0]
Liefert die Kommunikationsangaben des angegebenen Typs zur ebenfalls anzugebenden Adresse.
Syntax: [Communication:<typ>,<adress_id>]
Parameter:
Beispiel:
Ausgabe der E-Mail-Adresse für die aktuell vom Bericht verarbeitete Adresse.
[Communication:E-Mail,«AdrId»]
Diese Funktion steuert das Excel-Zellenformat über die Angabe der folgenden Format-Angaben:
number: Formatierung als Ganzzahl currency: Formatierung als Fließkommazahl text: Formatierung als Text
Syntax: [FORMAT:<formatierung>]
HINWEIS: Die Zelle darf dazu nur Werte enthalten, die mit dem angegebenen Zellentyp kompatibel sind.
Beispiel:
Ausgabe eines Wertes als Fließkommazahl.
[FORMAT:currency]
Diese Funktion kann zum Abruf zusammengesetzter Referenzinformationen zu einem gegebenen Schlüssel aus dem angegebenen Modul verwendet werden. Die Referenzinformation wird dabei identisch zusammengesetzt wie eine Referenz auf einen Datensatz des entsprechenden Moduls im Programm angezeigt werden würde. Das Modul kann wahlweise mit dem internen Modulnamen oder der internen Modul-ID angegeben werden.
Syntax: [Ref:<module>;key]
Beispiel:
Ausgabe der zugeordneten Ausstellung aus dem Modul Sammlung für das aktuell vom Bericht verarbeitete Sammlungsobjekt.
[Ref:exhibitions,«AobAusId»]
Dieses Steuerfeld markiert das Ende einer Datenquelle mit erweiterter Parametrierung, die sich über den Absatz erstreckt, in welchem sich das Steuerfeld befindet. Diese Funktion kann zur Abfrage von untergeordneten Tabellen verwendet werden. Felder aus der entsprechend abgerufenen Tabelle werden zur Ausgabe unter Angabe des internen Datenbanknamens in der Schreibweise «DatenFeld» im gleichen Absatz vor die Funktion gesetzt.
HINWEIS: Nach dem Steuerfeld darf nur noch das Absatzende-Zeichen folgen.
HINWEIS: Als Trennzeichen wird bei diesem Steuerfeld das Semikolon verwendet (nicht wie bei den einfachen Steuerfeldern das Komma).
Syntax: [NL:<tabelle>;<bedingung>;<sortierung>;<limit>]
Parameter:
Beispiele:
Ausgabe der ersten 3 Maßangaben eines Sammlungsobjektes, sortiert nach Maßtyp.
[NL:ObjMass;;ObmTypMasseS;3]
Ausgabe des aktuellsten Versicherungswertes eines Sammlungsobjektes.
[NL:ObjHandel;OweAktionS='Vers. Ausstellung';OweId DESC;1]