Im Ribbon-Register "ProIT Cobra-Reporting" kann der Einstellungsdialog gestartet werden.
Reporttypen
Reports können an verschiedenen Stellen / Eingabemasken in cobra ausgegeben werden. Damit Reports logisch gruppiert werden können, gibt es sogenannte Reporttypen. Diese können im Register "Reporttypen" im Einstellungsdialog erfasst werden.
Reports
Um eine neue Reportvorlage zu erstellen, klicken Sie auf den Button "Neuer Report" im Ribbon. Im nachfolgenden Dialog können Sie die Bezeichnung für die Reportvolage angeben sowie den Reporttyp auswählen. Wird kein Reporttyp ausgewählt, ist diese Reportvorlage überall in cobra verfügbar.
Nach einem Klick auf OK wird der Report-Editor gestartet und Sie können mit dem Designen des Reports anfangen.
Folgende Parameter werden standardmässig zur Verfügung gestellt:
Parametername |
Bedeutung |
|---|---|
CurrentAddressId |
Adress-ID der aktuell ausgewählten Adresse |
CurrentUserShortName |
Benutzerkürzel des aktuell angemeldeten Benutzers |
CurrentUserLongName |
Vollständiger Name des aktuell angemeldeten Benutzers |
QueriedAddressIds |
Kommaseparierte Liste der aktuell recherchierten Adressen |
Zusätzlich werden alle Benutzerattribute ebenfalls zur Verfügung gestellt. Sind für einzelne Attribute keine Werte definiert, werden diese leer übergeben.
Kontakteintrag
Hier kann definiert werden, ob nach jedem Generieren des Report ein Kontakteintrag und der entsprechende Report als Dokument zum Kontakt hinzugefügt werden soll. Folgende Optionen stehen zur Verfügung:
Kein Kontakteintrag erzeugen: Es wird kein Eintrag erstellt
Immer Kontakteintrag erzeugen: Es wird automatisch nach jedem Generieren des Reports ein Kontakteintrag erstellt
Nachfragen: Bei jedem Generieren wird der Benutzer gefragt, ob ein Kontakteintrag erstellt werden soll oder nicht
Export-Format
Hier kann das Format angegeben werden, in dem der Bericht für den Kontakteintrag exportiert werden soll.
Dokument öffnen
Nachdem der generierte Report exportiert und ein Kontakteintrag erstellt wurde, kann das exportierte Dokument weiterbearbeitet oder zum Beispiel versendet werden. Um den Prozess zu vereinfachen kann mit dieser Auswahlliste definiert werden, ob nach dem Export bzw. nach dem Generieren des Reports das Dokument geöffnet werden soll. Folgende Optionen stehen zur Verfügung:
Nachfragen: Bei jedem Generieren wird der Benutzer gefragt, ob das Dokument anschliessend geöffnet werden soll oder nicht
Immer automatisch öffnen: Das Dokument wird immer nach dem Generieren bzw. Schliessen der Vorschau geöffnet
Nicht automatisch öffnen: Das Dokument wird nicht automatisch geöffnet
Ohne Vorschau
Mit der Option "Ohne Vorschau" kann definiert werden, dass der Bericht nicht zuerst in einer Vorschau angezeigt wird sondern direkt generiert und allenfalls exportiert wird. Diese Option ist unwirksam, wenn der Report Parameter enthält, die vom Benutzer abgefragt werden (Option "Benutzerabfrage" ist gesetzt). Ist ein solcher Parameter im Report vorhanden, wird immer zuerst die Vorschau angezeigt.
Parameter erfassen
Für jeden Report können zusätzliche Parameter erfasst werden. Dazu muss im Einstellungsdialog die gewünschte Reportvorlage ausgewählt werden. Anschliessend kann auf den Button "Neuer Parameter" im Ribbon geklickt werden.
Feld |
Bedeutung |
Bezeichnung |
Unter dieser Bezeichnung ist der Parameter im Report verfügbar |
Wert |
Es können fixe Werte vergeben werden oder auf Werte aus einer cobra-Tabelle verwiesen werden. Soll ein Wert aus einer cobra-Tabelle gelesen werden ist immer folgendes Format zu verwenden: [LOGISCHER {TABELLENNANME}.{LOGISCHE FELDBEZEICHNUNG}], als Beispiel: [{ADDITIONAL}.{TEXT2}] |
Datentyp |
Der Datentyp des Parameters |
Benutzerabfrage |
Ist diese Option aktiviert, wird beim Erstellen des Reports der Benutzer nach dem Wert für diesen Parameter gefragt |
Kontakteinstellungen
Pro Report kann definiert werden, ob ein Kontakteintrag erstellt werden soll oder nicht. Im Register Kontakteinstellungen können die nötigen Feldzuweisungen gemacht werden. Der Report kann nur zum Kontakt abgelegt werden, sofern die Dokumentenverwaltung aktiviert ist.
Erweiterte Einstellungen Word
Ist als Export-Format "Word (2007-Version)" ausgewählt, können diverse zusätzliche Optionen definiert werden.
Allgemeine Einstellungen
Einstellung |
Bedeutung |
Kopf- und Fusszeile exportieren |
Ist diese Option aktiviert, werden die Header- und Footer-Bänder als Kopf- bzw. Fusszeile ins Word exportiert |
Dynamische Tabellenhöhe |
Ist diese Option aktiviert, wird für jede Zeile die Höhe als dynamische Höhe definiert --> Wird anschliessend im Word weiterer Text eingegeben, wächst die Zeile entsprechend mit |
Individueller Header / Footer |
Ist diese Option aktiviert, können eigene Header und Footer definiert werden, bereits im Dokument bestehende Header und Footer werden entfernt |
1. Seite unterschiedliche Header / Footer |
Für die erste Seite des Word-Dokuments kann sowohl ein unterschiedlicher Header wie auch Footer definiert werden |
Seitenabstand aus Report übernehmen |
Übernimmt den Seitenabstand, der im Report definiert wurde. Ist diese Option deaktiviert, wird der Standard-Seitenabstand von Word verwendet. |
Header / Footer-Einstellungen
Die Einstellungen gelten für "Header 1. Seite", "Header restliche Seiten", "Footer 1. Seite" sowie "Footer restliche Seiten"
Einstellung |
Bedeutung |
Abstand zum Text |
Der Abstand in cm, welche der Header bzw. Footer zum Text haben soll |
Schriftart |
Die zu verwendende Schriftart |
Schritgrösse |
Die zu verwendende Schriftgrösse |
Bild |
Pfad zu einem Bild, das anstelle von Text in den Header bzw. Footer eingefügt werden soll. Die Bildausrichtung wird anhand der Werte in den Tab-Positionen bestimmt. Ist die Tab-Position Links grösser als 0, wird das Bild links ausgerichtet. Ist die Tab-Position Links 0, die Tab-Position Mitte aber grösser als 0, wird das Bild zentriert ausgerichtet. Entsprechend wird das Bild rechts ausgerichtet, wenn die Tab-Position Rechts grösser als 0 ist, die Felder Mitte und Links jedoch 0 sind. Im Pfad zum Bild können ebenfalls die Benutzerattribute verwendet werden. Diese müssen analog zu den Textfeldern eingegeben werden (z.B. C:\temp\Benutzer\${UserLastname}_Unterschrift.png) |
Tab-Position Links |
Position des ersten Tabs im Header bzw. Footer (links ausgerichtet, Angabe in cm) |
Tab-Position Mitte |
Position des zweiten Tabs im Header bzw. Footer (zentriert ausgerichtet, Angabe in cm) |
Tab-Position Rechts |
Position des dritten Tabs im Header bzw. Footer (rechts ausgerichtet, Angabe in cm) |
Text Links |
Text, der an der ersten Tab-Position im Header bzw. Footer eingefügt werden soll |
Text Mitte |
Text, der an der zweiten Tab-Position im Header bzw. Footer eingefügt werden soll |
Text Rechts |
Text, der an der dritten Tab-Position im Header bzw. Footer eingefügt werden soll |
Rahmen link / Dicke / Abstand zu Text |
Ist die Checkbox aktiv, wird ein Rahmen links im Header bzw. Footer gezeichnet. Der Wert für "Dicke" bestimmt, wie dick der Rahmen gezeichnet werden soll. Mit dem Wert "Abstand zu Text" kann definiert werden, welcher Abstand der Text zum Rahmen haben soll. |
Rahmen oben / Dicke / Abstand zu Text |
Ist die Checkbox aktiv, wird ein Rahmen oben im Header bzw. Footer gezeichnet. Der Wert für "Dicke" bestimmt, wie dick der Rahmen gezeichnet werden soll. Mit dem Wert "Abstand zu Text" kann definiert werden, welcher Abstand der Text zum Rahmen haben soll. |
Rahmen rechts / Dicke / Abstand zu Text |
Ist die Checkbox aktiv, wird ein Rahmen rechts im Header bzw. Footer gezeichnet. Der Wert für "Dicke" bestimmt, wie dick der Rahmen gezeichnet werden soll. Mit dem Wert "Abstand zu Text" kann definiert werden, welcher Abstand der Text zum Rahmen haben soll. |
Rahmen unten / Dicke / Abstand zu Text |
Ist die Checkbox aktiv, wird ein Rahmen unten im Header bzw. Footer gezeichnet. Der Wert für "Dicke" bestimmt, wie dick der Rahmen gezeichnet werden soll. Mit dem Wert "Abstand zu Text" kann definiert werden, welcher Abstand der Text zum Rahmen haben soll. |
In den Textfeldern können die folgenden Felder verwendet werden:
Feld |
Bedeutung |
CurrentPageNumber |
Aktuelle Seitenzahl |
TotalNumberOfPages |
Total Anzahl der Seiten im Dokument |
Damit die Feldwerte korrekt aufgelöst werden können, müssen diese in geschweifte Klammern gesetzt werden. Um z.B. in einer Kopfzeile rechts den Text "Seite 3 von 7" anzuzeigen, ist folgende Konfiguration notwendig:
Benutzerattribute
In den Textfeldern "Text Links", "Text Mitte" und "Text Rechts" können sogenannte Benutzerattribute verwendet werden. Diese Platzhalter werden dann jeweils beim Generieren des Dokuments mit den aktuellen Werten ersetzt. Ebenfalls können im Dateinamen für die Bilder diese Benutzerattribute verwendet werden.
Folgende Benutzerattribute stehen zur Verfügung:
Benutzerattribut |
Bedeutung |
${UserLastname} |
Nachname des cobra-Benutzers |
${UserFirstname} |
Vorname des cobra-Benutzers |
${UserEmail} |
Email-Adresse des cobra-Benutzers |
${UserTelephoneNumber} |
Telefonnummer des cobra-Benutzers |
${UserStreetAddress} |
Strasse des cobra-Benutzers |
${UserPostOfficeBox} |
Postfach des cobra-Benutzers |
${UserPostalcode} |
Postleitzahl (PLZ) des cobra-Benutzers |
${UserLocation} |
Ort/Stadt des cobra-Benutzers |
${UserCountry} |
Land des cobra-Benutzers |
${UserTelephoneHome} |
Private Telefonnummer des cobra-Benutzers |
${UserTelephoneMobile} |
Mobile Telefonnummer des cobra-Benutzers |
${UserFax} |
Faxnummer des cobra-Benutzers |
Die Felder müssen immer innerhalb von einem Dollarzeichen ($) und geschweiften Klammern ({}) stehen. Um also den Nachnamen des cobra-Benutzers zu verwenden muss folgender Wert eingetragen werden: ${UserLastname}
Reportdaten ändern
Mit Hilfe des Befehls können die Bezeichnung und der Reporttyp eines bestehenden Reports geändert werden.
