ユーザー設定フィールドのレポート データ サービスの最適化

カスタム ビューを作成する

独自のカスタム ビューを作成するには、まず、フィールドの値が格納される場所を検出する必要があります。該当するフィールドをポイントするカラム プール テーブルと列番号を確認し、Join ステートメントを使用して値をカスタム ビューにプルします。すべてのカラム プール テーブルには、特定のデータ行が参照するエンティティの一意の識別子を含む [EntityUID] 列があります。

ヘルパー関数

次の関数は、すべてのユーザー設定フィールドに関する該当する情報を返します。

FUNCTION MFN_Epm_GetAllCustomFieldsInformation();

戻り値

この関数はユーザー設定フィールド情報 (ユーザー設定フィールドあたり 1 行) を含むデータセットを返します。ユーザー設定フィールドが見つからない場合、この関数は空のデータセットを返します。

返されたデータセットは、ユーザー設定フィールドあたり 1 行ずつを持ち、以下の列を含みます。

例

次に 2 つのプロジェクト ユーザー設定フィールドの値を表示する単純なカスタム ビューを作成する方法を例を挙げて説明します。

この例では、2 つの定義済みリソース ユーザー設定フィールド (RBS とコストの種類) に加えて、リソース名、リソース ID、リソースの標準単価、リソースの超過単価、およびリソースの Windows NT アカウント名をビューに表示すると仮定します。ユーザー設定フィールド名が一意であり、変更されることがない場合、[CustomFieldName] 列を使用してフィルタ処理を行うことができます。ただし、まず次に示す SELECT 操作を実行することをお勧めします。

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

この結果から、対象のユーザー設定フィールドが識別されていることを確認して、それぞれの CustomFieldTypeUID 値を記録します (この値は、それぞれの一意の識別子です)。

この例では、次の 2 つの一意の識別子が検出されると仮定します。

• RBS 用の {0000783FDE84434B9564284E5B7B3F49}

• コストの種類用の {000039B78BBE4CEB82C4FA8C0C400284}

上記の例より RBS およびコストの種類用の 2 つの一意の識別子を使用して、次のスクリプトを記述できます。

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

ユーザー設定フィールドのインデックスを作成する

特定のユーザー設定フィールドの値がどのテーブルのどの列に保存されているか、検出することが難しい場合があります。このため、Project Server には、ユーザー設定フィールドとインデックス パラメータを入力として使用して、該当する列にインデックスを作成する 2 つのストアド プロシージャが用意されています。

ビューおよびインデックスを "固定" する

上記のメソッドを使用して、(前述のセクションの説明に従って) ユーザー設定フィールドにインデックスを適用し、対象設定済みのビューおよびトリミングされたビューを作成することにより、レポートの生成を最適化できます。ただし、RDB 更新時に、ユーザー設定フィールドを使用する、インデックス付きビューおよびカスタマイズされたビューが無効になる場合があります。

これは、更新時にすべてのユーザー設定フィールドのカラム プール テーブルが消去され、すべてのユーザー設定フィールドが RDB から削除されるために発生します。再同期プロセス中に、ユーザー設定フィールドの割り当て順が変わる可能性があります。つまり、ユーザー設定フィールドの値が別の列または別のテーブルに保存される可能性があります。

たとえば、最初に CF1、次に CF2 の順序で作成され、CF1 と CF2 が両方とも テキスト ユーザー設定フィールドである 2 つのユーザー設定フィールドが存在すると仮定します。 CF1 はテーブルの CFVal0 列に、CF2 は CFVal1 に保存されます。カラム プール テーブルは次のようになります。

CF1 が削除された場合、テーブルは次のようになります。

ただし、更新後、カラム プール内の列が再設定された場合 (最初から作成され、CF1 がもはや存在せず、CF2 が CFVal0 列をとる場合)、テーブルは次のようになります。

CFVal1 をポイントするようにカスタマイズされたビューまたはインデックスをあらかじめ作成している場合は、RDB 更新後、CF2 をポイントするのではなく、異なるユーザー設定フィールドをポイントします。つまり、このような場合、インデックスが予期しない間違った列を示します。この問題を解決するには、レポート パフォーマンスを改善するためにカスタマイズされたビューまたはインデックスを作成している場合、ストアド プロシージャの作成も考慮する必要があります。

PROCEDURE MSP_OnRefreshCompleted();

このストアド プロシージャが存在する場合は、RDB 更新が正常に完了した後、自動的に呼び出されます。ストアド プロシージャは、ユーザー設定フィールドのインデックスおよびカスタマイズされたビューを再作成します。

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