Project Server のエラー コード

このトピックでは、Project Server 2013 の Project Server Interface (PSI) のエラー コード表を示します。 表は、最初に機能領域順、次にエラー コードの範囲順に整理されています。

Project Server 2013 のプロセスと PSI メソッドでは、通常は機能領域によって整理されているエラー コード番号が使用されます。 Microsoft.Office.Project.Server.Library.PSErrorID 列挙は WebSvcProject.PSErrorID で重複しており、エラー コードを名前のアルファベット順で示しています。 ここでは、PSI クラスまたは機能領域、およびエラー ID 番号により整理されている表でエラー コードを示します。

表 1. エラー コードの機能領域と関連する数値の範囲

表 2. 数値の範囲によるエラー コードの表

表 3. 一般的なエラー コード

表 4. アクティブ キャッシュ

表 5. Active Directory の同期

表 6. 管理 Web サービス

表 7. アーカイブ Web サービス

表 8. 割り当て

表 9. カレンダー

表 10. CubeAdmin およびキューブ作成サービス

表 11. チェックインおよびチェックアウト

表 12. ユーザー設定フィールド

表 13. 参照テーブル

表 14 に示すエラー コードには、プロジェクト詳細ページ (PDP)、Exchange の同期、Project Web App タイムライン、およびデータベースのエラーが含まれます。 表 14 の "その他" のエラー コードの多くは、内部で使用されます。

表 14. その他のエラー コード

表15. 通知

表 16 に示すすべてのエラー コードは、プロジェクト ポートフォリオ分析に使用するコンポーネントであるオプティマイザーのエラー コードです。

表 16. オプティマイザー (プロジェクト ポートフォリオ分析)

表 17 に示すエラー コードは、プロジェクト ポートフォリオ分析に使用するコンポーネントであるプランナーのエラー コードです。

表 17. プランナー (プロジェクト ポートフォリオ分析)

表 18. プロジェクト

表 19. レポート データ サービス (RDS)

表 20. リソース

表 21. リソース計画

表 22 のエラー コードは PWA Web サービスの Rules メソッドのものです。 このエラー コードは内部で使用されます。

表 22. Rules

表 23. セキュリティ

表 24. Project Server イベント

表 25. Statusing の Web サービス

表 26 のエラー コードは、PWA Web サービス内の StatusReports メソッドに関するものです。 このエラーは Project Web App の内部で使用されます。

表 26. StatusReports

表 27. タスク

表 28. Timesheet

表 29. ユーザー委任

表 30. ワークフロー

表 31. WssInterop と ObjectLinkProvider (SharePoint 統合)

ASMX のエラー コード例

PSI メソッドを呼び出したときに例外が発生する場合、エラーのリストを取得するには、SoapException オブジェクトを Microsoft.Office.Project.Server.Library.PSClientError クラス コンストラクターに渡します。 続いて、次の例のように、GetAllErrors を使用すると PSErrorInfo 配列にエラー情報を格納し、エラーを列挙できます。

using System;
using System.Collections.Generic;
using System.Text;
using System.Web.Services.Protocols;
using System.Windows.Forms;
using PSLibrary = Microsoft.Office.Project.Server.Library;
. . .
try
{
    /* Call a PSI method. */
}
catch (SoapException ex)
{
    string errAttributeName;
    string errAttribute;
    string errMess = "".PadRight(30, '=') + "\r\n" + "Error: " + "\r\n";
    PSLibrary.PSClientError error = new PSLibrary.PSClientError(ex);
    PSLibrary.PSErrorInfo[] errors = error.GetAllErrors();
    PSLibrary.PSErrorInfo thisError;
    for (int i = 0; i < errors.Length; i++)
    {
        thisError = errors[i];
        errMess += "\n" + ex.Message.ToString() + "\r\n";
        errMess += "".PadRight(30, '=') + "\r\nPSCLientError Output:\r\n \r\n";
        errMess += thisError.ErrId.ToString() + "\n";
        for (int j = 0; j < thisError.ErrorAttributes.Length; j++)
        {
            errAttributeName = thisError.ErrorAttributeNames()[j];
            errAttribute = thisError.ErrorAttributes[j];
            errMess += "\r\n\t" + errAttributeName +
                       ": " + errAttribute;
        }
        errMess += "\r\n".PadRight(30, '=');
    }
    MessageBox.Show(errMess, "Error", MessageBoxButtons.OK,
        MessageBoxIcon.Error);
}

WCF のエラー コード例

WCF ベースのアプリケーションで PSI メソッドを呼び出したときに System.ServiceModel.FaultException が発生する場合、エラーのリストを取得するには、FaultException オブジェクトから PSClientError オブジェクトを抽出します。 続いて、上の ASMX の例のように、GetAllErrors を使用すると PSErrorInfo 配列にエラー情報を格納し、エラーを列挙できます。

using System;
using System.Text;
using System.ServiceModel;
using System.Xml;
using PSLibrary = Microsoft.Office.Project.Server.Library;
. . .
try
{
    /* Call a PSI method. */
}
catch(FaultException fault)
{
    // Use the WCF FaultException, because the ASMX SoapException does not 
    // exist in a WCF-based application.
    WriteFaultOutput(fault);
}
// Get a PSClientError object from the WCF FaultException object, and
// then display the exception details and each error in the PSClientError stack.
private static void WriteFaultOutput(FaultException fault)
{
    string errAttributeName;
    string errAttribute;
    string errOut;
    string errMess = "".PadRight(30, '=') + "\r\n"
        + "Error details: " + "\r\n";
    PSLibrary.PSClientError error = GetPSClientError(fault, out errOut);
    errMess += errOut;
    PSLibrary.PSErrorInfo[] errors = error.GetAllErrors();
    PSLibrary.PSErrorInfo thisError;
    for (int i = 0; i < errors.Length; i++)
    {
        thisError = errors[i];
        errMess += "\r\n".PadRight(30, '=') + "\r\nPSClientError output:\r\n";
        errMess += thisError.ErrId.ToString() + "\n";
        for (int j = 0; j < thisError.ErrorAttributes.Length; j++)
        {
            errAttributeName = thisError.ErrorAttributeNames()[j];
            errAttribute = thisError.ErrorAttributes[j];
            errMess += "\r\n\t" + errAttributeName
                + ": " + errAttribute;
        }
    }
    Console.ForegroundColor = ConsoleColor.Red;
    Console.WriteLine(errMess);
    Console.ResetColor();
}
/// <summary>
/// Extract a PSClientError object from the ServiceModel.FaultException,
/// for use in output of the GetPSClientError stack of errors.
/// </summary>
/// <param name="e"></param>
/// <param name="errOut">Shows that FaultException has more information 
/// about the errors than PSClientError has. FaultException can also contain 
/// other types of errors, such as failure to connect to the server.</param>
/// <returns>PSClientError object, for enumerating errors.</returns>
public static PSLibrary.PSClientError GetPSClientError(FaultException e, 
                                                        out string errOut)
{
    const string PREFIX = "GetPSClientError() returns null: ";
    errOut = string.Empty;
    PSLibrary.PSClientError psClientError = null;
    if (e == null)
    {
        errOut = PREFIX + "Null parameter (FaultException e) passed in.";
        psClientError = null;
    }
    else
    {
        // Get a ServiceModel.MessageFault object.
        var messageFault = e.CreateMessageFault();
        if (messageFault.HasDetail)
        {
            using (var xmlReader = messageFault.GetReaderAtDetailContents())
            {
                var xml = new XmlDocument();
                xml.Load(xmlReader);
                var serverExecutionFault = xml["ServerExecutionFault"];
                if (serverExecutionFault != null)
                {
                    var exceptionDetails = serverExecutionFault["ExceptionDetails"];
                    if (exceptionDetails != null)
                    {
                        try
                        {
                            errOut = exceptionDetails.InnerXml + "\r\n";
                            psClientError = 
                                new PSLibrary.PSClientError(exceptionDetails.InnerXml);
                        }
                        catch (InvalidOperationException ex)
                        {
                            errOut = PREFIX + "Unable to convert fault exception info ";
                            errOut += "a valid Project Server error message. Message: \n\t";
                            errOut += ex.Message;
                            psClientError = null;
                        }
                    }
                    else
                    {
                        errOut = PREFIX + "The FaultException e is a ServerExecutionFault, "
                            + "but does not have ExceptionDetails.";
                    }
                }
                else
                {
                    errOut = PREFIX + "The FaultException e is not a ServerExecutionFault.";
                }
            }
        }
        else // No detail in the MessageFault.
        {
            errOut = PREFIX + "The FaultException e does not have any detail.";
        }
    }
    errOut += "\r\n" + e.ToString() + "\r\n";
    return psClientError;
}

FaultException オブジェクトには、PSClientError オブジェクトのデータ以外に、Project Server への接続の失敗など、他の種類のエラーが含まれることがあります。 上の例の GetPSClientError メソッドの errOut パラメーターは、追加の情報を示します。 たとえば、QueueCreateProject メソッドの CreateProject4Department のコード サンプルには、ProjectCustomFields テーブルでプロパティを設定する場合に、エラーの作成方法を説明するコメントが含まれています。 アプリケーションが実行されると、errOut パラメーターに errinfo 要素とその他のデータが含まれます (コンソール出力のフォーマットをここに示します)。

==============================
Error details:
<errinfo xmlns="">
  <dataset name="ProjectDataSet">
    <table name="ProjectCustomFields">
      <row CUSTOM_FIELD_UID="976d3bd9-95ff-40a2-a938-960c410b0341">
        <error id="11704" name="CustomFieldInvalidTypeColumnFilledIn" 
               uid="aa8a2fab-9262-422f-b022-ca1cb12bc75f"></error>
        <error id="11713" name="CustomFieldRequiredValueNotProvided" 
               uid="dc2e2156-86e9-4aac-bede-d07dc44dfedc"></error>
      </row>
    </table>
  </dataset>
</errinfo>
System.ServiceModel.FaultException`1[SvcProject.ServerExecutionFault]: 
ProjectServerError(s) LastError=CustomFieldRequiredValueNotProvided Instructions: 
Pass this into PSClientError constructor to access all error information 
(Fault Detail is equal to SvcProject.ServerExecutionFault).
============================
PSClientError output:
CustomFieldInvalidTypeColumnFilledIn
============================
PSClientError output:
CustomFieldRequiredValueNotProvided

関連項目

• プロジェクトの概念と方法に関する記事
• SQL Server Profiler
• Project Server 2010: Unexpected を取得した場合に想定すること
• ULS ビューアー