Guida all'implementazione › Implementazione › Creazione dei risultati finali (responsabile contratti) › Creazione di report › Report in formato libero

Report in formato libero

I report in formato libero consentono agli utenti di generare report basati su query SQL del database CA Business Service Insight o da qualsiasi altra origine dati esterna cui è possibile accedere tramite una connessione dal server CA Business Service Insight. Sono inoltre inclusi altri tipi di origine dati cui è possibile accedere tramite ODBC, ad esempio Excel, Access, Lotus Notes, file di testo e così via. I report in formato libero vengono comunemente utilizzati per configurare report statistici basati su dati creati con comandi di business logic Tools.SaveRecord e Tools.SaveFields.

I report in formato libero si connettono tramite una stringa di connessione a un database selezionato ed eseguono una query SQL sul database utilizzando una stringa di query. I parametri possono essere aggiunti a entrambe le stringhe per creare report dinamici che consentono all'utente di immettere o selezionare valori specifici da includere nella query, quali il nome utente e la password per la connessione al database.

I report in formato libero vengono visualizzati nelle schede Diagramma, Dati e Filtro analogamente ai report generati tramite la procedura guidata di creazione report.

Nota: i report in formato libero possono includere diagrammi solo se tutte le colonne, esclusa la prima colonna, hanno un valore numerico. I dati nella prima colonna vengono utilizzati per i titoli dell'asse X. I nomi di colonna sono utilizzati per altri titoli.

A causa del fatto che i report in formato libero utilizzano l'accesso diretto a un database e una query SQL aperta, la manutenzione è difficile. È necessario prestare attenzione per non compromettere i dati di base che vengono utilizzati come origine per i report in formato libero. Quando i report vengono generati da un'origine dati esterna, è consigliabile impostare un processo di notifica per garantire che tali origini dati non siano modificate senza consultare prima il responsabile contratti per i report sui dati in formato libero.

Informazioni generali da considerare durante la creazione di report in formato libero.

• A causa di problemi di formattazione della data internazionale, spesso è utile specificare il formato esatto di data con la creazione di una formula personalizzata nella business logic. Questa formula consente di convertire la data in una stringa con lo stesso formato ogni volta e di evitare problemi con la formattazione data americana rispetto a quella europea. Deve essere utilizzata per le date che verranno scritte nella tabella T_SLALOM_OUTPUTS tramite i comandi Tools.SaveFields o Tools.SaveRecord. Di seguito è riportato un esempio della formula:

Funzione 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

• Quando si utilizza il parametro di tempo dai gestori eventi di business logic, o qualsiasi altra data/ora dall'oggetto eventDetails, considerare sempre l'impatto delle ore di differenza di fuso orario. Tenere presente che le date, quando vengono scritte nella tabella, potrebbero essere nell'ora UTC invece che nell'ora locale. Potrebbe essere necessario utilizzare la funzione Tools.GetLocaleTime() per correggere il problema.
• È possibile usare l'utility di Report Designer (quando un report in formato libero produce un grafico) per personalizzare l'aspetto.
• Le opzioni di esportazione PDF per il report in formato libero sono personalizzabili utilizzando la sezione Report Parameters (Parametri report) della schermata di configurazione in formato libero, per elementi quali il layout di pagina (orientamento orizzontale, verticale).
• L'HTML può essere incorporato nei report per eseguire diverse funzionalità, ad esempio l'aggiunta di collegamenti ipertestuali o la modifica dei colori di riga e di colonna, i tipi di carattere o le impostazioni di visualizzazione.
• È possibile creare visualizzazioni di database (funzionalità Oracle) sulla tabella T_SLALOM_OUTPUTS per semplificare l'SQL richiesto per i report.
• Quando si specificano i parametri per i report, è possibile che siano impostati in vari modi: testo libero, numerico (convalida), password (caratteri nascosti, utili per le password delle connessioni di database), data (utilizzando l'utility di selezione data) ed elenchi (creati specificando un'istruzione SQL per popolare l'elenco).
• I valori di parametro specificati nella sezione SQL del report in formato libero devono essere sostituiti dal nome del parametro, preceduto dal simbolo @. Ad esempio, @PARAM1. L'utilizzo delle virgolette che racchiudono il valore di questo parametro è obbligatorio se i valori sono stringhe.