Project Server 錯誤碼

本主題包含 Project Server 2013 中 Project Server 介面 (PSI) 的錯誤碼表格。 數據表會依功能區域和錯誤碼範圍排列。

Project Server 2013 進程和 PSI 方法具有通常依功能區域排列的錯誤碼編號。 Microsoft.Office.Project.Server.Library.PSErrorID 列舉在 WebSvcProject.PSErrorID 中重複;它們會依名稱依字母順序列出錯誤碼。 本主題列出 PSI 類別或功能區域所排列之數據表中的錯誤碼，以及錯誤標識子 (識別碼) 編號。

表 1. 錯誤碼功能區域和相關號碼範圍

表 2. 依編號範圍的錯誤碼數據表

表格 3 一般錯誤碼

表格 4 作用中快取

表格 5 Active Directory 同步處理

表格 6 管理員 Web 服務

表格 7 封存 Web 服務

表格 8 指派

表格 9 行事曆

表 10. CubeAdmin 和 Cube 建置服務

表 11. 簽入並簽出

表 12. 自訂欄位

表 13. 查閱表格

表 14 中的錯誤碼包括專案詳細數據頁面的專案 (PDP) 、Exchange 同步處理、Project Web App 時間軸和資料庫錯誤。 表格 14 中的許多其他錯誤碼會在內部使用。

表 14. 其他錯誤碼

表 15. 通知

數據表 16 中的所有錯誤碼都適用於優化工具，這是項目組合分析中使用的元件。

表 16. 優化工具 (項目組合分析)

表格 17 中的錯誤碼適用於 Planner，這是項目組合分析中使用的元件。

表 17. Planner (項目組合分析)

表 18. Project

表 19. Reporting Data Service (RDS)

表 20. 資源

表 21. 資源計劃

表格 22 中的錯誤碼適用於 PWA Web 服務中的 Rules 方法。 它們會在內部使用。

表 22. 規則

表 23. 安全性

表 24. Project Server 事件

表 25. 狀態 Web 服務

表格 26 中的錯誤碼適用於 PWA Web 服務中的 StatusReports 方法。 它們會在內部用於 Project Web App。

表 26. StatusReports

表 27. 工作

表 28. 時程表

表 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 物件。 然後，您可以使用 GetAllErrors 將錯誤資訊儲存在 PSErrorInfo 陣列中，並列舉錯誤，如先前的 ASMX 範例所示。

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

除了 PSClientError 物件中的數據之外， FaultException 物件還可以包含其他類型的錯誤，例如無法連線到 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：當您收到非預期的 時，會發生什麼事
• ULS 查看器