Word und Excel Auswertungen
Eingabewerte
Bezeichnung | Datentyp | Richtung | Word/Email/Excel/Macro | Beschreibung |
---|---|---|---|---|
ID | Diverse ID's | in | Word/Email/Excel/Macro | Nur für Einzelauswertungen: |
IDList | [Diverse ID's] | in | Word/Email/Excel/Macro | Für alle Auswertungen: |
OrigID | Diverse ID's | in | Word/Email/Excel/Macro | Nur für Einzelauswertungen: Diese Variable sollte nicht verändert werden |
OrigIDList | [Diverse ID's] | in | Word/Email/Excel/Macro | Für alle Auswertungen: Diese Variable sollte nicht verändert werden |
Skip | out | Word/Email/Excel/Macro | Wird mit 0 initialisiert. Wird dieser Wert auf 1 gesetzt, dann wird die aktuell verarbeitete Auswertung nicht berücksichtigt, also ausgelassen. Falls anschliessend noch weitere Kommentare zu verarbeiten wären, werden diese nicht mehr ausgeführt. Andere Werte als -1, 0 und 1 sind nicht definiert und können zu einem undefinierten Resultat führen. Beachte auch die Variable Suppress. | |
Suppress | integer | out | Word/Email/Excel/Macro | Wird mit 0 initialisiert. Wird dieser Wert auf != 0 gesetzt, dann wird das Resultat der aktuellen Einzelauswertung ignoriert. Dies geschieht unabhängig von Skip |
Date | datetime | in | Word/Email/Excel/Macro | Aktuelles Datum oder Datum, welches bei CreateReport() übergeben wurde |
SignatureTextID | SSD_SignatureTextID | in | Word/Email/Excel/Macro | ID der ausgewählten Signatur in Form von i_SSD_SignatureTextID.. Hat der Report keine Signatur, ist dieser Wert 0. |
SignatureLanguageID | SSD_SignatureLanguageID | in | Word/Email/Excel/Macro | Sprache der Signatur.. Hat der Report keine Signatur, ist dieser Wert 0. |
SignaturePictureID | SSE_DatasetPictureID | in | Word/Email/Excel/Macro | Unterschriftsbild (i_SSE_DatasetPictureID).. Hat der Report keine Signatur, ist dieser Wert 0. |
SignatureDate | datetime | in | Word/Email/Excel/Macro | Ausgewähltes Datum bei der Signaturauswahl.. Hat der Report keine Signatur, ist dieser Wert gleich, wie die Variable Date. |
SalutationTypeID | SSP_SalutationTypeID | in | Word(Email/Excel/Macro | Auf dem Report definierter Anredetyp, zur Verwendung mit GetSignatureTextID (Opus Funktion). |
LanguageID | SSE_LanguageID | in | Word/Email/Excel/Macro | |
CompanyID | SSE_CompanyID | in | Word/Email/Excel/Macro | |
SeminarCenterID | SSE_SeminarCenterID | in | Word/Email/Excel/Macro | |
OrgUnitID | SSE_OrganizationalUnitID | in | Word/Email/Excel/Macro | |
PlanningPeriodID | SSE_PlanningPeriodID | in | Word/Email/Excel/Macro | |
ReportID | SSD_ReportID | in | Word/Email/Excel/Macro | |
UserRoleID | SSE_UserRoleID | in | Word/Email/Excel/Macro | |
EmailFrom | [string] | out | Rückgabe der Absender Emailadresse im Format ["EmailAdresse","Name des Absenders"] | |
EmailTo | [string] | out | Rückgabe der "To" Emailadresse(n) im Format ["EmailAdresse1","Name 1", ...]. Das Array muss immer zwei Einträge pro Adresse haben. | |
EmailCC | [string] | out | Rückgabe der "CC" Emailadresse(n) im Format ["EmailAdresse1","Name 1", ...]. Das Array muss immer zwei Einträge pro Adresse haben. | |
EmailBCC | [string] | out | Rückgabe der "BCC" Emailadresse(n) im Format ["EmailAdresse1","Name 1", ...]. Das Array muss immer zwei Einträge pro Adresse haben. | |
EmailReplyTo | [string] | out | Rückgabe der Rücksende-Emailadresse im Format ["EmailAdresse","Name des Absenders"] | |
EmailServer | [string] | out | Serverangaben mit folgendem Inhalt (eine der folgenden Möglichkeiten): ["Exchangeserver"] ["SMTP Servername/Adresse", "Benutzername", "Passwort"] ["SMTP Servername/Adresse", "Benutzername", "Passwort", "Domain"] | |
EmailAttachmentNames | [string] | out | Array mit Namen der Anhänge. | |
EmailAttachments | [blob] | out | Array mit binären Inhalten der Anhänge. Ist ein blob leer (Länge 0), dann gilt der entsprechende Eintrag in EmailAttachmentNames als Dateiname interpretiert und diese Datei wird als Anhang geladen. | |
EmailSubject | string | out | Betreff des Emails | |
EmailPort | integer | in/out | Zu verwendender Port für den Email Versand. Default = 25 | |
EmailReadReceiptAddress | string | out | Wird hier eine Email Adresse eingefüllt, wird eine Lesebestätigung verlangt, welche an die angegebene Adresse gesendet wird. Es ist zu beachten, dass der Email Client diese Benachrichtigung auch unterdrücken kann. | |
EmailDeliveryReceiptAddress | string | out | Wird hier eine Email Adresse eingefüllt, wird eine Empfangsbestätigung verlangt, welche an die angegebene Adresse gesendet wird. Es ist zu beachten, dass der Email Client diese Benachrichtigung auch unterdrücken kann. | |
DocumentName | string | in/out | Word/Email/Excel/Macro | Default = Name der Auswertung |
ArchiveID | [integer] | out | Word/Email/Excel | ID des Datensatzes, bei welchem das Dokument abgelegt werden soll |
ArchiveType | [string] | out | Word/Email/Excel | Name der Tabelle, welche zur ID gehört |
ArchiveReferenceDataset | [string] | out | Word/Email/Excel | Hier kann ein String eingetragen werden, welcher z.B. für Fremdsysteme oder Webschnittstellen verwendet werden kann um eine externe Beziehung zu identifizieren, |
ArchiveReferenceRecord1ID | [integer] | out | Word/Email/Excel | Hier kann eine ID eingetragen werden, welche z.B. für Fremdsysteme oder Webschnittstellen verwendet werden kann um eine externe Beziehung zu identifizieren, |
ArchiveReferenceRecord2ID | [integer] | out | Word/Email/Excel | Hier kann eine ID eingetragen werden, welche z.B. für Fremdsysteme oder Webschnittstellen verwendet werden kann um eine externe Beziehung zu identifizieren, |
ArchiveReferenceRecord3ID | [integer] | out | Word/Email/Excel | Hier kann eine ID eingetragen werden, welche z.B. für Fremdsysteme oder Webschnittstellen verwendet werden kann um eine externe Beziehung zu identifizieren, |
ArchiveDocumentName | [string] | out | Word/Email/Excel | Name, mit welchem das Dokument abgelegt werden soll (ohne Extension, diese wird automatisch anhand des Archivierungstyps vergeben) |
ArchiveInfoType | [integer] | out | Word/Email/Excel | Informationstyp ID der zu archivierenden Dokumente |
ArchiveReportData | JSON | out | Word/Email/Email | Inhalt wie der Wert "ReportData" (siehe weiter unten). |
PageCode | string | in/out | Word/Email | RTF Code, der verwendet werden soll zwischen generierten Dokumenten. Default ist "\\sect" Eine neue Seite "erzwingen" (falls der break nicht gemacht wird: PageCode = "\\sbkpage "; |
PageEndCode | string | in/out | Word/Email | RTF Code, der verwendet werden soll am Ende von generierten Dokumenten. Default ist "\\pgnstarts1\\pgnrestart" |
PageCodes | [string] | out | Word/Email | Default ist ein leeres Array. Hier können verschiedene PageCodes abgelegt werden, welche nacheinander vor die in Result zurückgegebenen vollständigen Dokumente gesetzt werden. Bleibt es leer oder ist es zu klein für alle Dokumente, dann wird der Code aus "PageCode" genommen. Leere Seite am Anfang vermeiden: PageCodes := [""]; |
PageEndCodes | [string] | out | Word/Email | Default ist ein leeres Array. Hier können verschiedene PageEndCodes abgelegt werden, welche nacheinander an das Ende der in Result zurückgegebenen vollständigen Dokumente gesetzt werden. Bleibt es leer oder ist es zu klein für alle Dokumente, dann wird der Code aus "PageEndCode" genommen. |
HeaderR | string | in/out | Word/Email | Definition der Kopfzeile für rechte Seiten. Dies wird auch verwendet für alle Seiten, wenn keine unterschiedlichen Kopfzeilen eingestellt sind. |
HeaderL | string | in/out | Word/Email | Definition der Kopfzeile für linke Seiten. |
HeaderF | string | in/out | Word/Email | Definition der Kopfzeile für erste Seiten. |
FooterR | string | in/out | Word/Email | Definition der Fusszeile für rechte Seiten. Dies wird auch verwendet für alle Seiten, wenn keine unterschiedlichen Fusszeilen eingestellt sind. |
FooterL | string | in/out | Word/Email | Definition der Fusszeile für linke Seiten. |
FooterF | string | in/out | Word/Email | Definition der Fusszeile für erste Seiten. |
GlobalDefinitions | string | out | Word/Email | Diese Variable wird leer erzeugt und kann mit zusätzlich benötigten globalen RTF Definitionen befüllt werden |
FontTable | string | in | Word/Email | Schriftentabelle als RTF Code |
Fonts | [string] | in/out | Word/Email | Array mit den einzelnen Schriftdefinitionen in RTF Code. Fonts und FontNumbers müssen immer dieselbe Grösse haben. |
FontNumbers | [integer] | in/out | Word/Email | Array mit den Schriftnummern. Fonts und FontNumbers müssen immer dieselbe Grösse haben. |
ColorTable | string | in | Word/Email | Farbtabelle als RTF Code |
Colors | [string] | in/out | Word/Email | Array mit den Farbdefinitionen in RTF. Colors und ColorNumbers müssen immer dieselbe Grösse haben. |
ColorNumbers | [integer] | in/out | Word/Email | Array mit den Farbnummern. Colors und ColorNumbers müssen immer dieselbe Grösse haben. |
TableWidths | [string] | in | Word/Email | Array mit kommagetrannten Wertereihen. Jeder Wert enthält eine Spaltenbreite. Pro in der Vorlage enthaltene Tabelle ist ein Eintrag im String-Array. |
TablePositions | [integer] | in | Word/Email | Pro in der Vorlage enthaltene Tabelle ist ein Eintrag mit der Textposition. Dies kann verwendet werden, um die Tabellen zu unterscheiden. Um herauszufinden, welche Tabelle sich z.B. gleich vor dem Makro befindet, kann die Variable MacroPosition nützlich sein. |
MacroPosition | integer | in | Word/Email | Position des Makros in der Vorlage. |
MacroName | string | in | Word/Email | Name des Makros |
MacroCode | string | in | Word/Email | Programmcode des Makros |
Tags | [string] | out | Word/Email | Namen der Tags, welche am Ende der Verarbeitung ersetzt werden sollen. Dieses Array muss gleich gross sein, wie TagTexts Es ist zu beachten, dass die Tags im Word als Ganzes ohne Unterbrechnung geschrieben werden müssen, damit sie dann richtig erkannt werden. Das heisst, dass bei Schreibfehlern der ganze Tag neu geschrieben werden sollte. |
TagTexts | [string] | out | Word/Email | Ersatztexte für die Tags, dieses Array muss gleich gross sein, wie Tags |
Result | string | [string] | out | Word/Email | Für Word Auswertungen: Wird hier eines oder mehrere unmittelbar aufeinander folgende gesamte RTF Dokumente zurückgegeben, dann wird dieses oder werden diese korrekt eingefügt. Ein solches Dokument beginnt mit "{\\rtf1". Vor diesem oder diesen Dokumenten wird der PageCode eingefügt oder wenn vorhanden nacheinander die Inhalte der Variable PageCodes. Wird in Result ein Array zurückgegeben werden die Resultate nacheinander auf die selbe Weise behandelt, wobei der Index in PageCodes weiter hochgezählt wird. |
Weitere | in/out | Weitere Variablen werden je nach Auswertungstyp verwendet (Rechnung, Leistungsnachweis) | ||
TableResult | out | Excel | Für Excel Auswertungen: Tabelleninhaltsdefinition für das Excel Worksheet. | |
StyleResult | out | Excel | Für Excel Auswertungen: Definition der verwendeten Styles. | |
Tables | [string] | in/out | Excel | Für Excel Auswertungen: Damit können auch mehrere Worksheets auf einmal generiert werden. Dazu müssen die Variablennamen der einzelnen Worksheets (welche vom Typ ExcelTableObject sein müssen) als String Array zurückgegeben werden. Dieser Array muss gleich gross sein wie „Styles". Initialwert: [„TableResult"] Eine Neudefinition des Arrays muss mit dem Operator := erfolgen. |
Styles | [string] | in/out | Excel | Für Excel Auswertungen: Dies ist das Pendant zu „Tables". Damit werden die Styles (welche vom Typ ExcelStyleObject sein müssen) pro Worksheet definiert. Es darf auch mehrmals der selbe Variablenname vorkommen (z.B. wenn alle Worksheets die selben Styles verwenden). Dieser Array muss gleich gross sein wie „Tables". Initialwert: [„StyleResult"] Eine Neudefinition des Arrays muss mit dem Operator := erfolgen. |
ReportData | JSON | in | Word/Email/Excel/Macro | JSON Obejkt mit Daten, welche zum Ausführen des Reports benötigt werden. Diese Daten werden entweder bei CreateReport (Opus Funktion) mitgegeben oder im SSE_DatasetDocument gespeichert und von dort übernommen. Standardfelder sind: "IDList": Array mit den IDs Die Standardfelder werden ebenfalls in die Eingangsvariablen übernommen und müssen meistens nicht weiter berücksichtigt werden. Weitere Felder können nach Belieben hinzugefügt werden. |
Einzel- und Listenauswertungen
Die Listenauswertungen werden so aufgerufen, dass eine Variable IDList mit einem Array aus allen ID's definiert wird und die Auswertung genau einmal aufgerufen wird. Diese muss dann ein Dokument erstellen, welches entsprechend der gewünschten Funktion alle ID's berücksichtigt.
Einzelauswertungen werden entsprechend viel mal aufgerufen mit je einer ID (Variable ID). Jedes mal muss die Auswertung für genau eine ID gemacht werden.
Word Auswertungen
In Word Auswertungen können als Texte auch beliebige (gültige) RTF Strings zurückgegeben werden. Entsprechende Möglichkeiten sind einer Rich-Text Format Dokumentation zu entnehmen.
Rechnungen
Für Rechnungsvorlagen gelten zusätzliche Informationen, Insbesondere der Archivierungsmechanismus ist durch einen Default Mechanismus gesteuert, (nur) wenn keine Archiv-Daten zurückgegeben werden. Siehe dazu die entsprechende Information unter Rechnungen.
Leistungsnachweise
Für Leistungsnachweise gelten zusätzliche Informationen. Siehe dazu Leistungsnachweise.
Excel Auswertungen
Bei Excel Auswertungen muss immer eine vollständige Excel-Datenstruktur zurückgegeben werden. Diese wird dann nach der Ausführung in ein Excel-Workbook (XML Format) umgewandelt.