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:

• Statische Funktionen: Diese Funktionen liefern unabhängig von der Datenquelle eines Berichtes immer die gleichen Informationen, meistens Systemwerte wie Datum und Uhrzeit, den Namen des aktuell angemeldeten Benutzers o.ä.
• Dynamische Funktionen: Diese Funktionen werden mit Parametern aufgerufen, die sich aus der Datenquelle des Berichtes speisen lassen und liefern zum Beispiel das Vorschaubild eines Objektes, einen Barcode oder die Summe aller Werte einer Datenspalte im aktuellen Datensatz.
• Steuerfelder: Mit diesen Funktionen lassen sich die Wechsel zwischen den Datensätzen der Datenquelle eines Berichtes steuern. Darüber hinaus erlauben sie, praktisch beliebig viele Datenquellen in einen Bericht zu integrieren und zu steuern.

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:

• <module_id>: Die interne Nummer des Moduls, aus dem das Vorschaubild ausgegeben werden soll. Momentan werden Vorschaubilder in den Bereichen Sammlung (21), Ausstellungsbereiche (41100) und Ausstellungsobjekte (41) unterstützt. Die übliche Angabe für diesen Parameter lautet „21“ für das Modul Sammlung.
• <primary_key>: Die Datensatznummer, zu dem das entsprechende Vorschaubild ausgegeben werden soll. An dieser Stelle kann beispielsweise als Datenfeld die Objekt-ID aus dem Modul Sammlung zum Einsatz kommen (siehe Beispiel).
• <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.

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:

• <file>: Der Dateiname inklusive vollständigem Pfad und der Dateierweiterung des einzubettenden Bildes.
• <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_size_x>: Optional: Numerischer Wert für die Breite des Bildes im Dokument.
• <scale_size_y>: Optional: Numerischer Wert für die Höhe des Bildes im Dokument.

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:

• <catalog_id>: Der Schlüssel / die ID des jeweiligen Kataloges im DAMS.
• <asset_id>: Die ID des Mediums im angegebenen Katalog des DAMS.
• <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_size_x>: Optional: Numerischer Wert für die Breite des Bildes im Dokument.
• <scale_size_y>: Optional: Numerischer Wert für die Höhe des Bildes im Dokument.

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:

• 0: AZTEC
• 1: CODABAR
• 2: CODE_128
• 3: CODE_39
• 4: CODE_93
• 5: DATA_MATRIX
• 6: EAN_13
• 7: EAN_8
• 8: ITF
• 9: MAXICODE
• 10: MSI
• 11: PDF_417
• 12: PLESSEY
• 13: QR_CODE
• 14: RSS_14
• 15: RSS_EXPANDED
• 16: UPC_A
• 17: UPC_E
• 18: UPC_EAN_EXTENSION

<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:

• <value>: Erwartet den bei einem Datensatz zugeordneten Gefahrgut-Code.
• <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.

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:

• <id>: Die Datensatznummer der auszugebenden Adresse. An dieser Stelle kann beispielsweise als Datenfeld die Adress-ID aus dem Modul Adresse zum Einsatz kommen (siehe Beispiel).
• <showdepartment>: Soll die Abteilungsbezeichnung ausgegeben werden? (0: Nein, 1: Ja)
• <showfunction>: Soll die Funktion der im Adressdatensatz erfassten Person ausgegeben werden? (0: Nein, 1: Ja)
• <titlelinebreak>: Soll bei Privatanschriften zwischen Anrede und Titel sowie Vorname und Name ein Zeilenumbruch eingefügt werden? (0: Nein, 1: Ja)

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:

• <id>: Die Datensatznummer der auszugebenden Adresse. An dieser Stelle kann beispielsweise als Datenfeld die Adress-ID aus dem Modul Adresse zum Einsatz kommen (siehe Beispiel).

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:

• <type>: Der Typ der Kommunikationsangabe. Die Angabe muss mit dem Typ im Modul Adresse, Sektion Kommunikation exakt übereinstimmen und wird ohne Anführungszeichen angegeben (siehe Beispiel).
• <id>: Die Datensatznummer der entsprechenden Adresse. An dieser Stelle kann beispielsweise als Datenfeld die Adress-ID aus dem Modul Adresse zum Einsatz kommen (siehe Beispiel).

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:

• <table>: Der Name der Tabelle, in welcher sich das zu summierende Datenfeld befindet. Dieser muss dem Namen einer Tabelle aus der dem Bericht zugrundeliegenden Abfrage entsprechen.
• <column@„format“>: Der Name des zu summierenden Datenfeldes innerhalb der Tabelle. Optional kann hinter dem Namen des Datenfeldes noch eine Formatierungsvorschrift angegeben werden. Diese ist – anders als bei den direkt im Bericht verwendeten Datenfeldern – jedoch in doppelte Anführungszeichen zu setzen. HINWEIS: Beim Schreiben in Microsoft Word werden doppelte Anführungszeichen standardmäßig automatisch in typografische Anführungszeichen umgewandelt. Der Format-Parameter erfordert jedoch die Angabe doppelter Anführungszeichen, um zum Beispiel Zeichenketten zu umschließen. Daher ist die Autokorrektur in Microsoft Word ggf. temporär zu deaktivieren oder das Anführungszeichen über das externe Programm Zeichentabelle einzufügen.
• <optional condition>: Eine einschränkende Bedingung, welche die Anzahl der zu summierenden Datensätze begrenzt. Die Bedingung muss in SQL-Notation angegeben werden. Wird keine Bedingung gewünscht, kann diese Angabe auch weggelassen werden, in diesem Falle werden die Werte aller Datensätze summiert.

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:

• <table>: Der Name der Tabelle, deren Datensätze gezählt werden sollen. Dieser muss dem Namen einer Tabelle aus der dem Bericht zugrundeliegenden Abfrage entsprechen.
• <optional condition>: Eine einschränkende Bedingung, welche die Anzahl der zu zählenden Datensätze begrenzt. Die Bedingung muss in SQL-Notation angegeben werden. Wird keine Bedingung gewünscht, kann diese Angabe auch weggelassen werden, in diesem Falle wird die Gesamtanzahl der Datensätze in der Datenquelle angegeben.

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:

• <number>: Der in Worten auszugebende Wert. Dieser kann auch das Ergebnis einer zum Beispiel aus den Funktionen [Sum] oder [Count] errechneter Wert oder der Inhalt eines numerischen Datenfelds sein.
• <de|en>: Die auszugebende Sprache. Unterstützt werden derzeit Deutsch und Englisch.

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:

• <table>: Der Name der Tabelle. Dieser muss dem Namen einer Tabelle aus der dem Bericht zugrundeliegenden Abfrage entsprechen.
• <optional condition>: Eine einschränkende Bedingung, welche die Anzahl auszugebenden Datensätze begrenzt. Die Bedingung muss in SQL-Notation angegeben werden. Wird keine Bedingung gewünscht, kann diese Angabe auch weggelassen werden, in diesem Falle werden alle Datensätze in der Datenquelle ausgegeben.

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:

• <table>: Der Name der Tabelle. Dieser muss dem Namen einer Tabelle aus der dem Bericht zugrundeliegenden Abfrage entsprechen.
• <optional condition>: Eine einschränkende Bedingung, welche die Anzahl auszugebenden Datensätze begrenzt. Die Bedingung muss in SQL-Notation angegeben werden. Wird keine Bedingung gewünscht, kann diese Angabe auch weggelassen werden, in diesem Falle werden alle Datensätze in der Datenquelle ausgegeben.

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.

Syntax: [NL:<table>;<optional condition>;<optional sort order>;<optional limit>]

Parameter:

• <table>: Der Name der Datenquelle. Dieser muss dem Namen einer Tabelle aus der dem Bericht zugrundeliegenden Abfrage entsprechen.
• <optional condition>: Eine einschränkende Bedingung, welche die Anzahl der auszugebenden Datensätze begrenzt. Die Bedingung muss in SQL-Notation angegeben werden. Wird keine Bedingung gewünscht, kann diese Angabe auch weggelassen werden. HINWEIS: Beim Schreiben in Microsoft Word werden einfache Anführungszeichen standardmäßig automatisch in typografische Anführungszeichen umgewandelt. Die SQL-Notation erfordert jedoch die Angabe einfacher Anführungszeichen, um zum Beispiel Zeichenketten zu umschließen. Daher ist die Autokorrektur in Microsoft Word ggf. temporär zu deaktivieren oder das Anführungszeichen über das externe Programm Zeichentabelle einzufügen.
• <optional sort order>: Die Sortierreihenfolge, in der die Datenquelle ausgegeben werden soll. Die Angabe erfolgt in SQL-Notation als durch Komma separierte Liste von gültigen Feldnamen, ggf. jeweils gefolgt vom Suffix ASC (für aufsteigende Sortierung) oder DESC (für absteigende Sortierung). Wird keine Sortierung gewünscht, kann diese Angabe auch weggelassen werden.
• <optional limit>: Numerischer Wert zwischen 1 und 65535, welche die maximale Anzahl der auszugebenden Datensätze angibt. Wird kein Limit gewünscht, werden alle (ggf. die unter „condition“ angegebenen Bedingungen erfüllenden) Datensätze der Datenquelle ausgegeben.

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:

• <id>: Die Datensatznummer der auszugebenden Adresse. An dieser Stelle kann beispielsweise als Datenfeld die Adress-ID aus dem Modul Adresse zum Einsatz kommen (siehe Beispiel).
• <abteilung>: Soll die Abteilungsbezeichnung ausgegeben werden? (0: Nein, 1: Ja)
• <funktion>: Soll die Funktion der im Adressdatensatz erfassten Person ausgegeben werden? (0: Nein, 1: Ja)
• <zeilenumbruch_vor_titel>: Soll bei Privatanschriften zwischen Anrede und Titel sowie Vorname und Name ein Zeilenumbruch eingefügt werden? (0: Nein, 1: Ja)

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:

• <type>: Der Typ der Kommunikationsangabe. Die Angabe muss mit dem Typ im Modul Adresse, Sektion Kommunikation exakt übereinstimmen und wird ohne Anführungszeichen angegeben (siehe Beispiel).
• <id>: Die Datensatznummer der entsprechenden Adresse. An dieser Stelle kann beispielsweise als Datenfeld die Adress-ID aus dem Modul Adresse zum Einsatz kommen (siehe Beispiel).

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>]

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.

Syntax: [NL:<tabelle>;<bedingung>;<sortierung>;<limit>]

Parameter:

• <table>: Der Name der Datenquelle. Dieser muss dem Namen einer Tabelle aus der dem Bericht zugrundeliegenden Abfrage entsprechen.
• <bedingung>: Eine einschränkende Bedingung, welche die Anzahl der auszugebenden Datensätze begrenzt. Die Bedingung muss in SQL-Notation angegeben werden. Wird keine Bedingung gewünscht, kann diese Angabe auch weggelassen werden.
• <sortierung>: Die Sortierreihenfolge, in der die Datenquelle ausgegeben werden soll. Die Angabe erfolgt in SQL-Notation als durch Komma separierte Liste von gültigen Feldnamen, ggf. jeweils gefolgt vom Suffix ASC (für aufsteigende Sortierung) oder DESC (für absteigende Sortierung). Wird keine Sortierung gewünscht, kann diese Angabe auch weggelassen werden.
• <limit>: Numerischer Wert zwischen 1 und 65535, welche die maximale Anzahl der auszugebenden Datensätze angibt. Wird kein Limit gewünscht, werden alle (ggf. die unter „condition“ angegebenen Bedingungen erfüllenden) Datensätze der Datenquelle ausgegeben.

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]