錯誤報告 error-reporting

概觀 overview

Adobe Pass驗證中的錯誤報告目前以兩種不同的方式實施：

進階錯誤報告 advanced-error-reporting

AccessEnabler JavaScript SDK accessenabler-javascript-sdk

新的錯誤報告系統保留為選擇性，因此實作人員可以明確登入錯誤處理常式回呼，以接收進階錯誤報告。 此系統包含動態註冊及取消註冊多個錯誤回呼的功能。 此外，一旦AccessEnabler JavaScript SDK載入，您就可以註冊任何新的錯誤回呼，而不需要執行任何其他初始化（在呼叫之前） setRequestor())，這表示您能夠接收關於初始化和設定錯誤的進階報告。

實施 access-enab-js-imp

yourErrorHandler(errorData：Object)

您的錯誤處理常式回呼函式將接收具有以下結構的單一物件（對應）：

    {
      errorId: "CFG410",
      level: "error",
      message: "This a fancy message",  // Optional
      .
      .                                 // Optional key/value pairs
      .
    }

1.繫結 bind

.bind(eventType:String, handlerName:String):void

附加事件的處理常式。

eventType — 僅限"errorEvent「值會導致AccessEnabler JavaScript SDK觸發進階錯誤報表回呼。

handlerName — 指定錯誤處理常式函式名稱的字串。

兩個繫結引數只能使用下列集合中的字元： [0-9a-zA-Z][-._a-zA-Z0-9]；也就是說，引數必須以數字或字母開頭，然後只能包含連字型大小、句號、底線和英數字元。 此外，引數不可超過1024個字元。

範例 連結錯誤處理常式的：

accessEnabler.bind('errorEvent', 'myCustomErrorHandler');
accessEnabler.bind('errorEvent', 'errorLogger');

由於技術限制，您無法繫結關閉或匿名函式。 您必須在第二個引數中指定方法的名稱。

2.解除繫結 unbind

.unbind(eventType:String, handlerName:String=null):void

移除先前附加的事件處理常式。

eventType — 僅'errorEvent'值會導致AccessEnabler JavaScript SDK觸發進階錯誤報表回呼。

handlerName — 指定錯誤處理常式函式名稱的字串，如果為null或遺失指定之所有附加的處理常式 eventType 將被移除。

兩個繫結引數只能使用下列集合中的字元： [0-9a-zA-Z][-._a-zA-Z0-9]；也就是說，引數必須以數字或字母開頭，然後只能包含連字型大小、句號、底線和英數字元。 此外，引數不可超過1024個字元。

範例 移除單一錯誤處理常式時：

accessEnabler.unbind('errorEvent', 'errorLogger');

範例 移除所有錯誤處理常式：

accessEnabler.unbind('errorEvent');

AccessEnabler iOS/tvOS SDK accessenabler-ios-tvos-sdk

新的錯誤報告系統是強制性的，因此實作人員必須明確遵循新的Objective C「EntitlementStatus」通訊協定。 這個新方法可讓程式設計師接收進階錯誤報告。

實施 accessenab-ios-tvossdk-imp

實作者必須符合下列條件 EntitlementStatus 通訊協定：

EntitlementStatus.h

    #import <Foundation/Foundation.h>

    @protocol EntitlementStatus <NSObject>
    - (void)status:(NSDictionary *)statusDictionary;
    @end

您的 狀態 函式將接收單一物件(一個 NSDictionary)下)，並具備下列結構：

    {
          errorId: "CFG410",
          level: "error",
          message: "This a fancy message",  // Optional
      .
      .                                 // Optional key/value pairs
      .
    }

1. 宣告

    @interface MyEntitlementStatusDelegate : NSObject <EntitlementStatus>

2. 實施

    @implementation DemoAppAppDelegate
    // very simple implementation
    - (void)status:(NSDictionary *)statusDict {
        NSLog(@"%@:\n%@", statusDict[@"level"], statusDict);
    }

AccessEnabler Android SDK accessenabler-android-sdk

新的錯誤報告系統是強制性的，因為實作人員必須明確遵守 IAccessEnablerDelegate 介面定義的通訊協定。 這個新方法可讓程式設計師接收進階錯誤報告。

實施 access-enablr-androidsdk-imp

實作者需要處理新的 status 來自介面的方法IAccessEnablerDelegate. 此 status 函式將收到單一 AdvancedStatus 具有下列模型的物件：

    class AdvancedStatus {

    String id; // Not Null
    String level; // Not Null
    String message; // Might be null
    String resource; // Might be null

    AdvancedStatus(String id, String level, String message, String resource) {
        this.id = id;
        this.level = level;
        this.message = message;
        this.resource = resource;
    }

    //other private/public methods
    }

範例

    @Override
    public void status(AdvancedStatus advancedStatus) {
        String status = "status(" + advancedStatus.id + ", " + advancedStatus.level + ", " + advancedStatus.message + ", " + advancedStatus.resource + ")";

        Log.i(LOG_TAG, status);
    }

AccessEnabler FireOS SDK accessenabler-fireos-sdk

新的錯誤報告系統是強制性的，因為實作人員必須明確遵守 IAccessEnablerDelegate 介面定義的通訊協定。 這個新方法可讓程式設計師接收進階錯誤報告。

實施 access-enab-fireos-sdk-

實作者需要處理新的 status來自介面的方法IAccessEnablerDelegate. 此 status 函式將收到單一 AdvancedStatus 具有下列模型的物件：

    class AdvancedStatus {

    String id; // Not Null
    String level; // Not Null
    String message; // Might be null
    String resource; // Might be null

    AdvancedStatus(String id, String level, String message, String resource) {
        this.id = id;
        this.level = level;
        this.message = message;
        this.resource = resource;
    }

    //other private/public methods
    }

範例

    @Override
    public void status(AdvancedStatus advancedStatus) {
        String status = "status(" + advancedStatus.id + ", " + advancedStatus.level + ", " + advancedStatus.message + ", " + advancedStatus.resource + ")";

        Log.i(LOG_TAG, status);
    }

進階錯誤代碼參考 advanced-error-codes-reference

下表列出並描述較新的錯誤API所公開的錯誤代碼，以及更正錯誤的建議動作：

原始錯誤報告 original-error-reporting

本節說明原始的錯誤報告系統，以及原始的錯誤代碼。 在原始錯誤報告系統中，AccessEnabler會將錯誤傳遞給這兩個回呼函式： setAuthenticationStatus() 在呼叫之後 checkAuthentication()； tokenRequestFailed()，在對的呼叫失敗後 checkAuthorization() 或 getAuthorization().

原始錯誤報告和狀態API會繼續如常運作。 不過，日後不會更新原始的錯誤報告API。 所有新的錯誤報告及舊錯誤的更新只會反映在新的錯誤報告中 進階錯誤報告系統.

如需使用原始錯誤報告系統的範例，請參閱 JavaScript API參考：setAuthenticationStatus() 和 tokenRequestFailed() 函式， iOS/tvOS API參考： setAuthenticationStatus()和 tokentRequestFailed()， Android API參考： setAuthenticationStatus() 和 tokenRequestFailed().

原始回呼錯誤代碼 original-callback-error-codes