Migliorare le prestazioni dei report utilizzando i filtri

Microsoft Dynamics 365 passerà una query al parametro P1 a seconda di come si esegue il filtro del report. In altre parole, il filtro preliminare dei dati automatico funge da query secondari in una query esistente.

Negli esempi seguenti viene illustrato come Microsoft Dynamics 365 passa due query al parametro (P1) secondo diversi requisiti di filtro. In questo esempio, si presuppone che si esegua il report dall'area Report in Microsoft Dynamics 365 e che si utilizzi l'opzione di filtro di dati.

Esempio 1: Per visualizzare solo gli account attivi, la query risultante dovrebbe essere la seguente:

SELECT <column1>, <column2>, <columnN>
FROM (SELECT FilteredAccount.* FROM FilteredAccount WHERE statecode = 0)
AS CRMAF_FilteredAccount

Esempio 2: Se ci si trova in un account specifico e si esegue il report, la query risultante sarebbe la seguente:

SELECT <column1>, <column2>, <columnN>
FROM (SELECT FilteredAccount.* FROM FilteredAccount WHERE AccountId = '<CurrentAccountId>')
AS CRMAF_FilteredAccount

Esempio 3: Se si sta cercando un elenco di tre account selezionati e si sceglie l'opzione per eseguire il report nei record selezionati, la query risultante sarà la seguente:

SELECT <column1>, <column2>, <columnN>
FROM  (SELECT FilteredAccount.* FROM FilteredAccount WHERE AccountId in ('<1stAccountId>', '<2ndAccountId>', '<3rdAccountId>') 
AS CRMAF_FilteredAccount

Quando viene effettuato l'aliasing di tutti i nomi della tabella di entità, l'interfaccia utente Ricerca avanzata viene automaticamente inclusa nel report distribuito quando viene eseguita da Microsoft Dynamics 365.

Per effettuare l'aliasing di un nome tabella di entità nel Generatore di query, fare clic con il pulsante destro del mouse su ogni tabella nel report, selezionare Proprietà e quindi immettere il valore dell'alias nel modulo CRMAF_FilteredEntity, ad esempio CRMAF_FilteredAccount.

Limitazione del filtro preliminare automatico

Quando utilizzare il prefisso CRMAF_ per abilitare il filtro preliminare automatico, in Microsoft Dynamics 365 viene aggiunto un parametro nella query. Con una query più complessa, ad esempio una query che utilizza le istruzioni UNION, ciò potrebbe portare a risultati non previsti poiché Microsoft Dynamics 365 può aggiungere solo il parametro alla prima query.

Ad esempio, prendere in considerazione la seguente query che include le istruzioni UNION :

SELECT <column1>, <column2>, <columnN>
FROM FilteredAccount AS CRMAF_FilteredAccount
WHERE address1_stateorprovince = ‘FL'
UNION
SELECT <column1>, <column2>, <columnN>
FROM FilteredAccount AS CRMAF_FilteredAccount
WHERE address1_stateorprovince = 'CA'

Durante il caricamento del report, Microsoft Dynamics 365 potrebbe filtrare solo la prima query utilizzando il parametro. Ciò comporterà che il filtro non verrà applicato alla seconda query:

SELECT <column1>, <column2>, <columnN>
FROM  (@P1) AS CRMAF_FilteredAccount WHERE address1_stateorprovince = 'FL'
UNION
SELECT <column1>, <column2>, <columnN>
FROM FilteredAccount AS CRMAF_FilteredAccount
WHERE address1_stateorprovince = 'CA'

Nell'esempio precedente, mentre si esegue il report dall'area Report in Microsoft Dynamics 365 e si sceglie il filtro come fatturato annuale maggiori di 1.000.000, Microsoft Dynamics 365 passerà una query al parametro P1 nel modo seguente:

SELECT <column1>, <column2>, <columnN>
FROM  (SELECT FilteredAccount.* from FilteredAccount where AnnualRevenue > 1000000) AS CRMAF_FilteredAccount
WHERE address1_stateorprovince = 'FL'
UNION
SELECT <column1>, <column2>, <columnN>
FROM FilteredAccount AS CRMAF_FilteredAccount
WHERE address1_stateorprovince = 'CA'

Ciò implica che la query restituisce solo gli account in Florida con ricavi annuali maggiori di $1.000.000 e tutti gli account In California e questa non era l'opzione desiderata. Si desiderava visualizzare tutti gli account in Florida e in California con ricavi annuali maggiori di $1.000.000.

Se si scarica il report da Microsoft Dynamics 365 e lo si apre in Microsoft Visual Studio, verrà visualizzata la versione originale del report caricata in Microsoft Dynamics 365. Se si scarica il report direttamente da Microsoft SQL Server Reporting Services, si noterà che Microsoft Dynamics 365 ha modificato la query ma non ha posizionato il parametro dove si desiderava.

Per le query complesse, è necessario utilizzare il filtro preliminare esplicito.

Filtro preliminare esplicito

Per query complesse come quelle che utilizzano le istruzioni UNION, potrebbe essere necessario utilizzare il filtro preliminarmente esplicito. A differenza del filtro preliminare automatico, Microsoft Dynamics 365 non riscrive la query di report passando i valori ai parametri durante il filtro preliminare esplicito quando questo report viene caricato in Microsoft Dynamics 365. È necessario apportare le modifiche desiderate al report in modo esplicito aggiungendo il parametro del filtro preliminare al report e quindi facendo riferimento al parametro nella query. È quindi possibile eseguire la query utilizzando SQL dinamico.

Quando si utilizza SQL dinamico, il filtro tramite la Ricerca avanzata viene abilitato creando un parametro nascosto denominato CRM_FilteredEntity, ad esempio CRM_FilteredAccount e utilizza questo parametro di un'espressione della query SQL dinamica. Questo parametro consente il filtro dei dati della tabella ottenuti dalla visualizzazione filtrata specificata.

Facendo lo stesso esempio illustrato in precedenza per evidenziare il limite del filtro preliminare automatico, nella tabella seguente viene mostrata una query con il filtro preliminare automatico modificato per utilizzare il filtro preliminare esplicito con SQL dinamico. Si presuppone inoltre che durante l'esecuzione del report nell'area Report in Microsoft Dynamics 365, il filtro è stato applicato come fatturato annuale maggiore di 1.000.000.