Implementierungshandbuch › Implementierung › Erstellen von lieferbaren Ergebnissen (Vertragsmanager) › Erstellen von Berichten › Freiformberichte

Freiformberichte

Freiformberichte ermöglichen es Benutzern, Berichte zu generieren, die auf SQL-Abfragen der CA Business Service Insight-Datenbank oder von einer anderen externen Datenquelle, auf die über einer Verbindung vom CA Business Service Insight-Server zugegriffen werden kann, basieren. Dies schließt auch andere Arten von Datenquellen ein, auf die über ODBC zugegriffen werden kann, wie Excel, Access, Lotus Notes, Textdateien etc. Freiformberichte werden üblicherweise benutzt, um statistische Berichte zu konfigurieren, die auf Daten, die mit den Business-Logik-Befehlen "Tools.SaveRecord" und "Tools.SaveFields" erstellt wurden, basieren.

Freiformberichte schließen über einem Verbindungsstring an einer ausgewählten Datenbank an, und führen eine SQL-Abfrage auf der eine Abfragezeichenfolge verwendenden Datenbank aus. Sie können beiden Strings Parameter hinzufügen, um dynamische Berichte zu erstellen, die es dem Benutzer ermöglichen, bestimmte Werte in die Abfrage durch Eingeben oder Auswählen aufzunehmen, etwa den Benutzernamen und das Passwort für die Verbindung mit der Datenbank.

Freiformberichte werden in den Registerkarten "Diagramm", "Daten" und "Filter" angezeigt, ähnlich den Berichten, die bei der Verwendung des Berichtassistenten generiert werden.

Hinweis: Freiformberichte können nur Diagramme einschließen, wenn alle Spalten, außer der ersten Spalte, numerisch sind. Die Daten in der ersten Spalte dienen als Überschriften in der X-Achse. Die Spaltennamen werden für andere Überschriften verwendet.

Aufgrund der Tatsache, dass Freiformberichte direkten Zugriff auf eine Datenbank und eine offene SQL-Abfrage verwenden, ist die Wartung problematisch. Große Sorgfalt sollte dafür aufgebracht werden, nicht die zugrunde liegenden Daten zu beeinträchtigen, die als eine Quelle für die Freiformberichte dienen. Wenn Berichte von einer externen Datenquelle generiert werden, wird empfohlen, dass ein Benachrichtigungsprozess eingerichtet wird, um sicherzustellen, dass jene Datenquellen nicht verändert werden, ohne zuerst den für die Freitextdatenberichte verantwortlichen Vertragsmanager zu konsultieren.

Beim Erstellen von Freiformberichten sind allgemeine Informationen zu beachten.

• Aufgrund internationaler Datumsformatierungsprobleme ist es oft nützlich, das genaue Format für das Datum durch das Erstellen einer benutzerspezifischen Formel in der Business-Logik anzugeben. Dies konvertiert zu jeder Zeit das Datum in eine Zeichenfolge mit dem gleichen Format und vermeidet Probleme bei der US- und EU-Datumsformatierung. Sie sollte für Daten verwendet werden, die aus der Tabelle T_SLALOM_OUTPUTS über die Befehle "Tools.SaveFields" oder "Tools.SaveRecord" entnommen werden. Die Beispielformel wird unten angegeben:

Funktion "FormatDate(DateField)"

    If DateField = "" Then
      FormatDate = ""
    Else
      Dim PeriodYear, PeriodMonth, PeriodDay, PeriodHour,
  PeriodMinute, Periodsecond
      PeriodYear    = DatePart("yyyy",DateField)
      PeriodMonth   = DatePart("m",DateField)
      PeriodDay     = DatePart("d",DateField)
      PeriodHour    = DatePart("h",DateField)
      PeriodMinute  = DatePart("n",DateField)
      Periodsecond  = DatePart("s",DateField)
      FormatDate  = PeriodDay&"/"&PeriodMonth&"/"&PeriodYear& _
 " "&PeriodHour&":"&PeriodMinute&":"&Periodsecond
    End If
End Function

• Bei der Verwendung der "Uhrzeit"-Parameter vom Business-Logik-Ereignis-Handler, oder eines Zeitstempels vom eventDetails-Objekt, sollten Sie sich immer über die Auswirkungen auf die Zeitzonenverschiebung bewusst sein. Bedenken Sie, dass die Daten beim Schreiben in die Tabelle eher in UTC-Zeit als Ortszeit sein können. Vielleicht müssen Sie die Funktion "Tools.GetLocaleTime()" verwenden, um dies zu korrigieren.
• Sie können weiterhin das Berichts-Designerhilfsprogramm (wenn ein Freiformbericht ein Diagramm erzeugt) verwenden, um die Anzeige anzupassen.
• Die PDF-Exportoptionen für den Freiformbericht sind über die Verwendung des Abschnitts "Berichtsparameter" des Freiform-Setupfensters benutzerdefinierbar. Dinge wie das Seitenlayout (Landschaft, Porträt)
• HTML kann in die Berichte eingebettet werden, um unterschiedliche Funktionen auszuführen, wie Hyperlinks hinzuzufügen oder Spalten- und Linienfarben, Schriften oder Anzeigeneinstellungen zu verändern.
• Datenbankansichten (Oracle-Funktionalität) können in der T_SLALOM_OUTPUTS-Tabelle erstellt werden, um das benötigte SQL für die Berichte zu vereinfachen.
• Bei der Angabe der Parameter für die Berichte ist es möglich, dass eine Reihe an Art und Weisen festgelegt werden, einschließlich: Freitext, Numerisch (gültig), Kennwort (ausgeblendete Zeichen - nützlich für Kennwörter zu DB-Verbindungen), Datum (bei Verwendung des mitgelieferten Datenabgriffshilfsprogramms) und Listen (erstellt durch Angeben einer SQL-Anweisung, um die Liste auszufüllen)
• Die im SQL-Abschnitt des Freiformberichts angegebenen Parameterwerte müssen durch den Parameternamen ersetzt werden, gefolgt von dem "@"-Symbol. Z. B. @PARAM1. Die Verwendung von Anführungszeichen um diesen Parameterwert kann dann erforderlich werden, wenn die Werte Zeichenfolgen sind.