Signaler les optimisations de service de données relatives aux champs personnalisés

Créer des affichages personnalisés

Pour créer des affichages personnalisés, vous devez savoir où sont stockées les valeurs de champ. Une fois que vous savez quelle table de liste de colonnes et quel numéro de colonne pointent vers le champ souhaité, vous pouvez utiliser une instruction Join pour récupérer les valeurs dans votre affichage. Toutes les tables de liste de colonnes contiennent une colonne EntityUID dans laquelle se trouve l’identificateur unique de l’entité à laquelle une ligne de données particulière fait référence.

Fonction d’application auxiliaire

La fonction suivante renvoie des informations utiles sur les champs personnalisés.

FUNCTION MFN_Epm_GetAllCustomFieldsInformation();

Valeurs renvoyées

La fonction renvoie un DataSet contenant les informations des champs personnalisés (une ligne pour chaque champ personnalisé). Si aucun champ personnalisé n’est détecté, un DataSet vide est renvoyé.

Le DataSet renvoyé contient une ligne pour chaque champ personnalisé, ainsi que les colonnes suivantes :

Exemple

Voici un exemple qui montre comment créer un affichage personnalisé simple affichant deux valeurs de champ personnalisé de projet.

Dans cet exemple, supposons que nous disposons de deux champs personnalisés de ressource prédéfinis (RBS et Cost Type), que nous souhaitons afficher aux côtés du nom de la ressource, de son ID, de son tarif standard, de son tarif d’heures supplémentaires et de son nom de compte Windows NT. Si vous êtes certain que les noms des champs personnalisés sont uniques et qu’ils ne seront pas modifiés, vous pouvez utiliser la colonne CustomFieldName pour filtrer les données. Cependant, il est préférable de commencer par exécuter une opération SELECT similaire à l’opération ci-dessous.

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

Dans les résultats, assurez-vous que vous avez identifié les champs personnalisés souhaités, puis notez leurs valeurs CustomFieldTypeUID. Il s’agit de leur ID unique.

Imaginons que dans cet exemple, les deux identificateurs uniques détectés sont :

• {0000783FDE84434B9564284E5B7B3F49} pour RBS

• {000039B78BBE4CEB82C4FA8C0C400284} pour Cost Type

Maintenant que vous disposez des deux identificateurs uniques RBS et Cost Type ci-dessus, vous pouvez écrire le script suivant :

--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

Créer des index de champ personnalisé

Il est parfois difficile de déterminer dans quelle colonne et quelle table sont stockées les valeurs d’un champ personnalisé. Par conséquent, Project Server offre deux procédures stockées permettant de créer un index dans la colonne appropriée, à partir du champ personnalisé et des paramètres d’index.

Cohérence des affichages et des index

Vous pouvez optimiser les processus de création de rapports à l’aide des méthodes ci-dessus en appliquant des index sur les champs personnalisés et en créant des affichages ciblés ou limités, comme expliqué dans les sections précédentes. Sachez cependant que pendant l’actualisation d’une base de données de création de rapports, il peut arriver que les index et les affichages personnalisés soient invalidés.

En effet, pendant l’actualisation, toutes les tables de liste de colonnes de champ personnalisé sont effacées et tous les champs personnalisés sont supprimés de la base de données de création de rapports. Pendant le processus de resynchronisation, l’ordre d’affectation des champs personnalisés peut être modifié. Par conséquent, les valeurs de champ personnalisé sont susceptibles d’être enregistrées dans une autre colonne, voire dans une autre table.

Supposons par exemple que deux champs personnalisés ont été créés dans l’ordre suivant : CF1 en premier, puis CF2. Ces deux champs personnalisés sont de type texte. CF1 récupère la colonne CFVal0 dans la table et CF2 récupère la colonne CFVal1. La table de la liste de colonnes est similaire à l’exemple suivant :

Si CF1 est supprimé, la table se présente désormais comme ceci :

Cependant, après actualisation, les colonnes de la liste de colonnes sont à nouveau remplies, en recommençant à zéro. CF1 n’existe plus et CF2 occupe désormais la colonne CFVal0. Le tableau se présente alors comme ceci :

Si vous avez déjà créé un affichage personnalisé ou un index pointant vers CFVal1, après l’actualisation de la base de données de création de rapports, au lieu de pointer vers CF2, il pointe maintenant vers un autre champ personnalisé. Au final, l’index se retrouve dans la mauvaise colonne et ce problème doit être résolu. Pour ce faire, si vous créez des affichages personnalisés ou des index pour améliorer les performances de création de rapports, pensez à créer également une procédure stockée :

PROCEDURE MSP_OnRefreshCompleted();

Si cette procédure stockée existe, elle est appelée automatiquement après une actualisation de la base de données de création de rapports. Elle recrée les index de champ personnalisé et/ou les affichages personnalisés.

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