Creare un nuovo report con SQL Server Data Tools
SQL Server Data Tools è un ambiente per la creazione di report che consente di creare o modificare i report SQL Server Reporting Services in Visual Studio. Il risultato finale è un file RDL che contiene la definizione dei report che è possibile pubblicare per visualizzare i report.
In alternativa, è possibile creare report con un comune editor di testo. Per ridurre il lavoro necessario per creare un report personalizzato, modificare un file .rdl che offre la maggior parte della funzionalità desiderata e modificarlo. Per ulteriori informazioni sul formato degli elementi XML in un file .rdl, vedere Riferimento RDL (Report Definition Language). È possibile verificare il report modificato XML utilizzando lo schema XML specificato. Reporting Services verificherà inoltre la definizione report e rifiuterà un report se la definizione non è valida quando si tenta di caricare il report.
Nota
Se nel file .rdl è contenuta una query FetchXML, la query in RDL viene convalidata da Estensione per la creazione dei report di Microsoft Dynamics CRM 2016 che convalida internamente lo schema FetchXML.
Creare un report basato su Fetch personalizzato
Per creare un report personalizzato basato su Fetch:
Verificare che sia installata una versione supportata di Visual Studio, SQL Server Data Tools, l'estensione per la creazione di report di Microsoft Dynamics CRM 2016 e di disporre dei privilegi necessari. Altre informazioni: Ambiente di scrittura report utilizzando SQL Server Data Tools
Aprire Visual Studio e creare un progetto server di report.
In Esplora soluzioni fai clic con il pulsante destro del mouse sulla cartella Report, quindi seleziona Aggiungi nuovo report.
Seleziona Avanti.
Nella pagina Selezione origine dati, seleziona Nuova origine dati e specifica i dettagli seguenti:
Nome: Digitare un nome per l'origine dati.
Tipo: seleziona Microsoft Dynamics 365 Fetch.
Stringa di connessione: Specificare la stringa di connessione. La stringa di connessione deve essere specificata nel formato seguente:
URLServer;NomeOrganizzazione;URLRealmHome
In questa stringa di connessione, solo URLServer è obbligatorio. Se non viene specificato NomeOrganizzazione, viene utilizzata la prima organizzazione a cui appartiene l'utente che esegue la query. HomeRealmURL corrisponde all'URL dell'area di autenticazione principale del provider di identità utilizzato dall'organizzazione e non è necessario se l'organizzazione utilizza la federazione per la gestione delle identità. Contattare l'amministratore di rete per determinare l'URL dell'area di autenticazione principale.
Seleziona Credenziali per specificare le credenziali per connettersi alle app Dynamics 365 for Customer Engagement o alle app Dynamics 365 for Customer Engagement, quindi seleziona Avanti.
Nella pagina Progettazione query immettere la query FetchXML nella casella Query. Per ottenere questa query, è possibile eseguire una delle operazioni seguenti:
Ottenere la query FetchXML da una query di ricerca avanzata. A tale scopo, apri un'app Customer Engagement (on-premises), seleziona Ricerca avanzata, crea la query desiderata e nella scheda Ricerca avanzata, seleziona Scarica FetchXML. Copiare la query FetchXML nella casella Query delle proprietà del set di dati in Visual Studio.
Immettere manualmente la query FetchXML. Questo esempio mostra come creare un report che visualizza tutti gli account da 5.000 o più dipendenti.
<fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="false"> <entity name="account"> <attribute name="name" /> <attribute name="numberofemployees" /> <attribute name="accountnumber" /> <order attribute="name" descending="false" /> <filter type="and"> <condition attribute="numberofemployees" operator="gt" value="5000" /> </filter> </entity> </fetch>
Seleziona Avanti.
Verifica i campi che verranno inclusi nel report, quindi seleziona Avanti.
- L'estensione di creazione report aggiunge campi aggiuntivi a seconda del tipo di dati. Numeri, date, ricerche e set di opzioni hanno un campo fieldNameValue aggiuntivo. Ad esempio, se FetchXML include l'attributo createdon, sono disponibili due campi: createdon e creatosuValore.
-
fieldName (esempio: createdon)
- Questo campo è una stringa formattata in base alle impostazioni di formato dell'utente. È inteso al solo scopo di visualizzazione. La conversione del valore nel tipo di dati originale potrebbe causare un errore. Ad esempio, un'espressione come
=CDate(Fields!createdon.Value)
potrebbe non riuscire o fornire una data errata se il formato della data non corrisponde alle impostazioni locali nel server di report. - Per i campi del set di opzioni il valore è il testo visualizzato del valore del set di opzioni.
- Per i campi di ricerca il valore è il campo del nome principale del record collegato.
- Questo campo è una stringa formattata in base alle impostazioni di formato dell'utente. È inteso al solo scopo di visualizzazione. La conversione del valore nel tipo di dati originale potrebbe causare un errore. Ad esempio, un'espressione come
-
fieldNameValue (esempio: createdonValue)
- Questo campo è il valore grezzo non formattato del campo in base al tipo di dati. I campi possono essere regolati e formattati per la visualizzazione specifica dell'utente utilizzando i parametri di formato CRM_ nascosti.
- Per i campi data/ora, è il valore UTC.
- Per i campi numerici o valutari, è il valore numerico non formattato.
- Per i campi del set di opzioni è il valore del numero dell'opzione.
- Per i campi di ricerca è il Guid del campo di ricerca.
-
fieldName (esempio: createdon)
- L'estensione di creazione report aggiunge campi aggiuntivi a seconda del tipo di dati. Numeri, date, ricerche e set di opzioni hanno un campo fieldNameValue aggiuntivo. Ad esempio, se FetchXML include l'attributo createdon, sono disponibili due campi: createdon e creatosuValore.
Selezionare uno stile da applicare al report, quindi seleziona Avanti.
Verificare i campi che verranno inclusi nel report e immettere un nome per il report, ad esempio Account con più di 5000 dipendenti. Selezionare Fine.
Se si desidera vedere come il report viene visualizzato quando viene eseguito, seleziona la scheda Anteprima.
Verrà generato un file .rdl con il nome del report specificato. È possibile utilizzare questo file per pubblicare il report personalizzato nelle app Dynamics 365 for Customer Engagement utilizzando la Creazione guidata report. Ulteriori informazioni: Pubblicare report