Ottimizzazioni del servizio Dati report per campi personalizzati

Creare visualizzazioni personalizzate

Per creare visualizzazioni personalizzate, è necessario innanzitutto trovare il percorso di memorizzazione dei valori di campo. Dopo aver identificato la tabella del pool di colonne e il numero di colonna per il campo di interesse, è possibile utilizzare un'istruzione Join per trascinare valori nella visualizzazione. In tutte le tabelle del pool di colonne esiste una colonna EntityUID contenente l'identificatore univoco dell'entità a cui fa riferimento una determinata riga di dati.

Funzione di supporto

La funzione seguente restituisce informazioni interessanti su tutti i campi personalizzati.

FUNCTION MFN_Epm_GetAllCustomFieldsInformation();

Valori restituiti

La funzione restituisce un set di dati contenente le informazioni sui campi personalizzati (una riga per ogni campo personalizzato). Se non viene trovato nessun campo personalizzato, la funzione restituisce un set di dati vuoto.

Il set di dati restituito dispone di una riga per ogni campo personalizzato con le colonne seguenti:

Esempio

Nell'esempio seguente viene illustrato come creare una semplice visualizzazione personalizzata contenente due valori campo personalizzato progetto.

Per questo esempio si presume di disporre di due campi personalizzati risorsa predefiniti (RBS e Cost Type) che si desidera mostrare nella visualizzazione insieme al nome della risorsa, all'ID risorsa, alla tariffa standard della risorsa, alla tariffa straordinario della risorsa e al nome account Windows NT della risorsa. Se si è certi che i nomi dei campi personalizzati sono univoci e che non verranno modificati, è possibile filtrare in base alla colonna CustomFieldName. Tuttavia, una soluzione migliore implica l'esecuzione di un'operazione SELECT come indicato di seguito.

SELECT * FROM MFN_EpmGetAllCustomFieldsInformation() WHERE EntityName='Resource'

Nei risultati, verificare di aver identificato i campi personalizzati desiderati, quindi prendere nota dei valori CustomFieldTypeUID (corrispondenti agli ID univoci).

Questo esempio si basa sull'ipotesi che i due identificatori univoci trovati siano:

• {0000783FDE84434B9564284E5B7B3F49} per RBS

• {000039B78BBE4CEB82C4FA8C0C400284} per Cost Type

Utilizzando i due identificatori univoci per RBS e Cost Type dell'esempio precedente, è possibile utilizzarli per scrivere lo script seguente:

--Declare the variables used
DECLARE @CommandTextnvarchar(4000)-- This is the buffer where 
--  the command will be created

-- Declare the variables used 
DECLARE
-- This is the information necessary about each custom field:
DECLARE @TableNameForCF1 nvarchar(100) 
DECLARE @ColumnNameForCF1 nvarchar(100) 
DECLARE @TableNameForCF2 nvarchar(100) 
DECLARE @ColumnNameForCF2 nvarchar(100) 
-- Get the information about RBS custom field: 
SELECT
@TableNameForCF1  = ColumnPoolTableName,
@ColumnNameForCF1 = ColumnPoolColumnName
FROMMFN_Epm_GetAllCustomFieldsInformation()
WHERE
CustomFieldTypeUID = '{0000783F-DE84-434B-9564-284E5B7B3F49}'--RBS ID
-- Get the information about Cost Type custom field: 
SELECT
@TableNameForCF2 = ColumnPoolTableName, 
@ColumnNameForCF2 = ColumnPoolColumnName
FROMMFN_Epm_GetAllCustomFieldsInformation()
WHERE 
CustomFieldTypeUID = '{000039B7-8BBE-4CEB-82C4-FA8C0C400284}'-- Cost Type ID
--Now we can build the SELECT command that will get the data in the view
SET @CommandText = 'SELECT ResourceUID, ResourceName, ResourceNTAccount, '  +
'ResourceStandardRate, ResourceOvertimeRate,'
--If both custom fields are allocated in the same column pool table, 
--  we just need to join with it once 
IF @TableNameForCF1 = @TableNameForCF2 
SET @CommandText = @CommandText + ' RCFV.' + @ColumnNameForCF1 + ', ' +
'RCFV.'+ @ColumnNameForCF2 + '' +
'FROM MSP_EpmResource' +
'INNER JOIN ' + @TableNameForCF1 + ' AS RCFV' +
'  ON MSP_EpmResource.ResourceUID = RCFV.EntityUID'
ELSE 
SET @CommandText = @CommandText + ' RCF1V.' + @ColumnNameForCF1 + ', ' +
'RCF2V.'+ @ColumnNameForCF2 + '' +
'FROM MSP_EpmResource' +
'INNER JOIN ' + @TableNameForCF1 + ' AS RCFV1' +
'  ON MSP_EpmResource.ResourceUID = RCFV1.EntityUID' +
'INNER JOIN ' + @TableNameForCF2 + ' AS RCFV2' +
'ON MSP_EpmResource.ResourceUID = RCFV2.EntityUID'
--Now we have the command, we can execute it 
SET @CommandText = 'CREATE VIEW MySampleView AS ' + @CommandText 
EXECsp_executesql @CommandText

Creare indici di campo personalizzato

Individuare la colonna della tabella in cui sono salvati i valori di un campo personalizzato specifico può essere un'operazione complessa. A tale scopo, Project Server dispone di due stored procedure che creano un indice nella colonna appropriata, utilizzando come input il campo personalizzato e i parametri dell'indice.

Come "incollare" visualizzazioni e indici

L'uso dei metodi sopra specificati consente di ottimizzare la generazione dei rapporti applicando indici a campi personalizzati e creando visualizzazioni mirate/regolate come descritto nelle sezioni precedenti. Si noti, tuttavia, che durante un aggiornamento del database delle relazioni, indici e visualizzazioni personalizzate che utilizzano campi personalizzati potrebbero essere invalidate.

Questo si verifica perché durante un aggiornamento tutte le tabelle del pool di colonne campi personalizzati vengono cancellate e tutti i campi personalizzati vengono eliminati dal database delle relazioni. Durante il processo di sincronizzazione l'ordine di allocazione dei campi personalizzati potrebbe cambiare. Questo significa che i valori dei campi personalizzati possono essere salvati in una colonna diversa o persino in una tabella diversa.

Si supponga, ad esempio, che esistano due campi personalizzati testo CF1 e CF2 creati nell'ordine seguente: prima CF1, quindi CF2. CF1 riceve il valore CFVal0 nella tabella, mentre CF2 riceve il valore CFVal1. L'aspetto della tabella del pool di colonne è simile al seguente:

Se CF1 viene eliminato, l'aspetto della tabella sarà simile al seguente:

Tuttavia, dopo un aggiornamento le colonne nel pool di colonne vengono nuovamente ripopolate: CF1 non esisterà più e CF2 occuperà la colonna CFVal0. L'aspetto della tabella sarà simile al seguente:

Se in precedenza è stata creata una visualizzazione personalizzata o un indice che fa riferimento a CFVal1, dopo un aggiornamento del database delle relazioni, anziché a CF2 si farà riferimento a un campo personalizzato diverso. Il risultato finale è che l'indice termina nella colonna errata. Per risolvere il problema, se si creano visualizzazioni personalizzate o indici per migliorare le prestazioni di segnalazione, è necessario anche valutare la creazione di una stored procedure:

PROCEDURE MSP_OnRefreshCompleted();

Se questa stored procedure esiste, viene chiamata automaticamente dopo un aggiornamento del database delle relazioni. Gli indici dei campi personalizzati e/o le visualizzazioni personalizzate verranno ricreati automaticamente.

CREATE PROCEDUREMSP_OnRefreshCompleted 
AS 
BEGIN
-- Declare the variables used
DECLARE @CommandTextnvarchar(4000)-- This is the buffer where the commandwill be created
-- This is the information necessary about each custom field: 
DECLARE @TableNameForCF1 nvarchar(100)
DECLARE @ColumnNameForCF1 nvarchar(100)
DECLARE @TableNameForCF2 nvarchar(100)
DECLARE @ColumnNameForCF2 nvarchar(100) 
DECLARE@ViewNamenvarchar(100)SET @ViewName ='MySampleView'
--Drop the old view, if one exists 
IFEXISTS(SELECT*FROMdbo.sysobjects WHEREid =OBJECT_ID('[dbo].['+@ViewName +']') AND 
OBJECTPROPERTY(id,'IsView')= 1) 
BEGIN 
SET@CommandText ='DROP VIEW [dbo].['+ @ViewName +']' 
EXECsp_executesql@CommandText 
END
-- Get the information about RBS custom field: 
SELECT
@TableNameForCF1  = ColumnPoolTableName,    
@ColumnNameForCF1 = ColumnPoolColumnName
FROMMFN_Epm_GetAllCustomFieldsInformation()
WHERE 
CustomFieldTypeUID = '{0000783F-DE84-434B-9564-284E5B7B3F49}'--RBS ID
-- Get the information about Cost Type custom field:
SELECT
@TableNameForCF2 = ColumnPoolTableNam
@ColumnNameForCF2 = ColumnPoolColumnName e, 
FROMMFN_Epm_GetAllCustomFieldsInformation()
WHERE
CustomFieldTypeUID = '{000039B7-8BBE-4CEB-82C4-FA8C0C400284}'-- Cost Type ID
--Now we can build the SELECT command that will get the data in the view
SET @CommandText = 'SELECT ResourceUID, ResourceName, ResourceNTAccount, '  +
'ResourceStandardRate, ResourceOvertimeRate,'
--If both custom fields are allocated in the same column pool table, we just need to join with it once 
IF @TableNameForCF1 = @TableNameForCF2 
SET @CommandText = @CommandText + ' RCFV.' + @ColumnNameForCF1 + ', ' +
'RCFV.'+ @ColumnNameForCF2 + '' +
'FROM MSP_EpmResource' +
'INNER JOIN ' + @TableNameForCF1 + ' AS RCFV' +
'  ON MSP_EpmResource.ResourceUID = RCFV.EntityUID' 
ELSE 
SET @CommandText = @CommandText + ' RCF1V.' + @ColumnNameForCF1 + ', ' +
'RCF2V.'+ @ColumnNameForCF2 + '' +
'FROM MSP_EpmResource' +
'INNER JOIN ' + @TableNameForCF1 + ' AS RCFV1' +
'  ON MSP_EpmResource.ResourceUID = RCFV1.EntityUID' +
'INNER JOIN ' + @TableNameForCF2 + ' AS RCFV2' +
'ON MSP_EpmResource.ResourceUID = RCFV2.EntityUID'
--Now we have the command, we can execute it 
SET @CommandText = 'CREATE VIEW MySampleView AS ' + @CommandText 
EXECsp_executesql @CommandText
-- Clear all the custom field indexes
EXECMSP_Epm_ClearAllCustomFieldIndexes
-- Re-Create all the indexes
EXECMSP_Epm_CreateCustomFieldIndexByUID'{000039B7-8BBE-4CEB-82C4-FA8C0C400284}' 
END 
GO 
GRANTEXECONdbo.MSP_OnRefreshCompleted_TestTOProjectServerRole 
GO