แชร์ผ่าน


แก้ไขปัญหาแอปพลิเคชันแบบฝังตัวของคุณ

บทความนี้อธิบายถึงปัญหาทั่วไปบางอย่างที่อาจเกิดขึ้นเมื่อมีการฝังเนื้อหาจาก Power BI

เครื่องมือการแก้ไขปัญหา

ติดตาม Fiddler

Fiddler เป็นเครื่องมือฟรีจาก Telerik ที่ติดตามปริมาณการใช้งาน HTTP คุณสามารถดูปริมาณการใช้งานได้ด้วย API ของ Power BI จากเครื่องไคลเอ็นต์ เครื่องมือนี้อาจแสดงข้อผิดพลาดและข้อมูลอื่น ๆ ที่เกี่ยวข้อง

สกรีนช็อตของหน้าต่างเอาต์พุตเครื่องมือ Fiddler ซึ่งแสดงปริมาณการใช้งาน API ของ Power BI HTTP

F12 ในเบราว์เซอร์สําหรับการแก้ไขจุดบกพร่อง frontend

คีย์ F12 จะเปิดใช้หน้าต่างนักพัฒนาภายในเบราว์เซอร์ของคุณ เครื่องมือนี้ช่วยให้คุณดูปริมาณการใช้งานเครือข่ายและดูข้อมูลที่มีประโยชน์อื่น ๆ

สกรีนช็อตของแท็บเครือข่ายของหน้าต่างนักพัฒนาเว็บเบราว์เซอร์ซึ่งแสดงปริมาณการใช้งานเครือข่าย

แยกรายละเอียดข้อผิดพลาดจากคําตอบของ Power BI

ส่วนย่อยของโค้ดนี้แสดงวิธีการแยกรายละเอียดข้อผิดพลาดจากข้อยกเว้น HTTP:

public static string GetExceptionText(this HttpOperationException exc)
{
    var errorText = string.Format("Request: {0}\r\nStatus: {1} ({2})\r\nResponse: {3}",
    exc.Request.Content, exc.Response.StatusCode, (int)exc.Response.StatusCode, exc.Response.Content);
    if (exc.Response.Headers.ContainsKey("RequestId"))
    {
        var requestId = exc.Response.Headers["RequestId"].FirstOrDefault();
        errorText += string.Format("\r\nRequestId: {0}", requestId);
    }

    return errorText;
}

เราขอแนะนําให้บันทึกรหัสคําขอ (และรายละเอียดข้อผิดพลาดสําหรับการแก้ไขปัญหา) ระบุรหัสคําขอเมื่อติดต่อฝ่ายสนับสนุนของ Microsoft

การลงทะเบียนแอป

การลงทะเบียนแอปล้มเหลว

ข้อความข้อผิดพลาดภายในพอร์ทัล Azure หรือหน้าการลงทะเบียนแอป Power BI จะแจ้งให้คุณทราบถ้าคุณมีสิทธิ์ไม่เพียงพอที่จะลงทะเบียนแอปของคุณ เมื่อต้องการลงทะเบียนแอปพลิเคชัน คุณต้องเป็นผู้ดูแลระบบในผู้เช่า Microsoft Entra หรือต้องเปิดใช้งานการลงทะเบียนแอปพลิเคชันสําหรับผู้ใช้ที่ไม่ใช่ผู้ดูแลระบบ

บริการของ Power BI ไม่ปรากฏในพอร์ทัล Azure เมื่อลงทะเบียนแอปใหม่

ต้องมีผู้ใช้อย่างน้อยหนึ่งรายลงทะเบียนสําหรับ Power BI ถ้าคุณไม่เห็นบริการของ Power BI แสดงอยู่ภายในรายการ API แสดงว่าไม่มีผู้ใช้ที่ลงทะเบียนสําหรับ Power BI

ID ออบเจ็กต์ของแอปพลิเคชันและ ID ออบเจ็กต์หลักแตกต่างกันอย่างไร

เมื่อคุณลงทะเบียนแอป Microsoft Entra มีสองพารามิเตอร์ที่เรียกว่า ID ออบเจ็กต์ ส่วนนี้อธิบายวัตถุประสงค์ของแต่ละพารามิเตอร์และวิธีการรับข้อมูล

ID ออปเจ็กต์ของแอปพลิเคชัน

ID ออปเจ็กต์ของแอปพลิเคชัน หรือที่เรียกว่า ID ออบเจ็กต์ คือ ID เฉพาะของออบเจ็กต์แอปพลิเคชัน Microsoft Entra ของคุณ

เมื่อต้องการรับ ID ออปเจ็กต์ของแอปพลิเคชัน ให้นําทางไปยังแอป Microsoft Entra ของคุณ และคัดลอกจาก ภาพรวม

สกรีนช็อตของหน้าต่างพอร์ทัล Azure ซึ่งแสดง ID ออบเจ็กต์ใน Blade ภาพรวมของแอปพลิเคชัน Microsoft Entra

ID ออบเจ็กต์ขององค์ประกอบหลัก

ID ออบเจ็กต์หลักหรือที่เรียกว่า ID ออบเจ็กต์ คือ ID ที่ไม่ซ้ํากันของ ออบเจ็กต์ บริการหลักที่เชื่อมโยงกับแอปพลิเคชัน Microsoft Entra ของคุณ

หากต้องการรับ ID ออบเจ็กต์หลักของคุณ ให้นําทางไปยังแอป Microsoft Entra ของคุณ และจาก ภาพรวม ให้เลือกลิงก์แอปใน แอปพลิเคชันที่มีการจัดการในไดเรกทอรีภายในเครื่อง

สกรีนช็อตของหน้าต่างพอร์ทัล Azure ซึ่งแสดงตัวเลือกแอปพลิเคชันที่มีการจัดการในไดเรกทอรีภายในเครื่องใน Blade ภาพรวมของแอปพลิเคชัน Microsoft Entra

จากส่วน คุณสมบัติ ให้ คัดลอก ID ออบเจ็กต์

ภาพหน้าจอของหน้าต่างพอร์ทัล Azure ซึ่งแสดง ID ออบเจ็กต์หลักในส่วนคุณสมบัติในพาเนลภาพรวมของแอปพลิเคชัน Microsoft Entra

การรับรองความถูกต้อง

การรับรองความถูกต้องล้มเหลวโดยมี AADSTS70002 หรือ AADSTS50053

(AADSTS70002: ข้อมูลประจําตัวผิดพลาด AADSTS50053: คุณได้พยายามลงชื่อเข้าใช้หลายครั้งเกินไปด้วยรหัสผู้ใช้หรือรหัสผ่านที่ไม่ถูกต้อง)

ถ้าคุณกําลังใช้ Power BI Embedded และการรับรองความถูกต้องโดยตรงของ Microsoft Entra คุณอาจได้รับข้อความเหมือนข้อความก่อนหน้าเมื่อคุณพยายามลงชื่อเข้าใช้ เนื่องจากไม่ได้เปิดใช้งานการรับรองความถูกต้องโดยตรง

คุณสามารถเปิดการรับรองความถูกต้องโดยตรงอีกครั้งโดยใช้นโยบาย Microsoft Entra ที่กําหนดขอบเขตในองค์กรหรือบริการหลัก

เราขอแนะนําให้คุณเปิดใช้งานนโยบายนี้ในแต่ละแอปเท่านั้น

เมื่อต้องสร้างนโยบายนี้ คุณจําเป็นต้องเป็น ผู้ดูแลระบบ ส่วนกลางสําหรับไดเรกทอรีที่คุณกําลังสร้างนโยบายและกําหนดนโยบายนั้น นี่คือสคริปต์ตัวอย่างสําหรับการสร้างนโยบาย และกําหนดนโยบายให้กับ SP สําหรับแอปพลิเคชันนี้:

  1. ติดตั้ง Microsoft Graph PowerShell SDK

  2. เรียกใช้คําสั่ง PowerShell แบบบรรทัดต่อบรรทัดต่อไปนี้ (ตรวจสอบให้แน่ใจว่าตัวแปร $sp ไม่มีแอปพลิเคชันมากกว่าหนึ่งรายการเป็นผลลัพธ์)

    Connect-MgGraph -Scopes "Directory.Read.All","Policy.ReadWrite.ApplicationConfiguration"
    
    $sp = Get-MgServicePrincipal -Filter "DisplayName eq 'Name_Of_Application'"
    
    $policy = New-MgBetaPolicyActivityBasedTimeoutPolicy -Definition @("{`"AllowCloudPasswordValidation`":true}") `
       -DisplayName EnableDirectAuth -IsOrganizationDefault:$false
    
    $params = @{
       "@odata.id" = "https://graph.microsoft.com/v1.0/policies/claimsMappingPolicies/$policy.Id"
    }
    New-MgBetaServicePrincipalClaimMappingPolicyByRef -ServicePrincipalId $sp.Id `
       -BodyParameter $params
    

หลังจากกําหนดนโยบาย ให้รอประมาณ 15-20 วินาทีสําหรับการเผยแพร่ก่อนการทดสอบ

การสร้างโทเค็นล้มเหลวเมื่อให้ข้อมูลประจําตัวที่ใช้ได้

GenerateToken อาจล้มเหลวด้วยข้อมูลประจําตัวที่มีประสิทธิภาพที่ให้มาด้วยเหตุผลสองสามประการที่แตกต่างกัน:

  • แบบจําลองความหมายไม่สนับสนุนข้อมูลประจําตัวที่มีผลบังคับใช้
  • ไม่ได้ระบุชื่อผู้ใช้
  • ไม่ได้ระบุบทบาท
  • DatasetId ไม่ได้ระบุ
  • ผู้ใช้ไม่มีสิทธิ์ที่ถูกต้อง

เมื่อต้องตรวจสอบปัญหา ให้ทําตามขั้นตอนต่อไปนี้:

  • เรียกใช้รับชุดข้อมูล คุณสมบัติ IsEffectiveIdentityRequired เป็นจริงหรือไม่?
  • ต้องมีชื่อผู้ใช้สําหรับ ใด ๆEffectiveIdentity
  • ถ้า IsEffectiveIdentityRolesRequired เป็นจริง จําเป็นต้องมีบทบาท
  • DatasetIdจําเป็นสําหรับEffectiveIdentity
  • สําหรับ Analysis Services ผู้ใช้หลักจะต้องเป็นผู้ดูแลระบบเกตเวย์

AADSTS90094: การอนุมัติต้องใช้สิทธิ์ระดับผู้ดูแลระบบ

อาการ:

เมื่อผู้ใช้ที่ไม่ใช่ผู้ดูแลระบบพยายามลงชื่อเข้าใช้แอปพลิเคชันเป็นครั้งแรกในขณะที่ให้การยินยอม จากนั้นจะเกิดข้อผิดพลาดอย่างใดอย่างหนึ่งต่อไปนี้:

  •   ConsentTest needs permission to access resources in your organization that only an admin can grant. Ask an admin to grant permission to this app before you can use it.
    
  •   AADSTS90094: The grant requires admin permission.
    

    ภาพหน้าจอของกล่องโต้ตอบการลงชื่อเข้าใช้หน้าต่างพอร์ทัล Azure ซึ่งแสดงข้อผิดพลาดสิทธิ์การทดสอบความยินยอม

ผู้ใช้ที่เป็นผู้ดูแลระบบสามารถลงชื่อเข้าใช้และให้การยินยอมได้สําเร็จ

สาเหตุ:

การอนุมัติของผู้ใช้ถูกปิดใช้งานสําหรับผู้เช่า

สามารถแก้ไขได้หลายวิธี:

  • เปิดใช้งานความยินยอมของผู้ใช้สําหรับผู้เช่าทั้งหมด (ผู้ใช้ทั้งหมด แอปพลิเคชันทั้งหมด):
  1. ในพอร์ทัล Azure นําทางไปยังผู้ใช้รหัส>Microsoft Entra และจัดกลุ่ม>การตั้งค่าผู้ใช้
  2. เปิดใช้งาน ผู้ใช้สามารถยินยอมให้แอปเข้าถึงข้อมูลของบริษัทในการตั้งค่าในนามของพวกเขา และบันทึกการเปลี่ยนแปลงได้

ภาพหน้าจอของพอร์ทัล Azure

  • ผู้ดูแลระบบสามารถให้สิทธิ์กับแอปพลิเคชัน สําหรับผู้เช่าทั้งหมดหรือผู้ใช้ที่ระบุ

ข้อผิดพลาด CS1061

ดาวน์โหลด Microsoft.IdentityModel.Clients.ActiveDirectory ถ้าคุณพบข้อผิดพลาดต่อไปนี้:

'AuthenticationContext' does not contain a definition for 'AcquireToken' and no accessible 'AcquireToken' accepting a first argument of type 'AuthenticationContext' could be found (are you missing a using directive or an assembly reference?)

โทเค็น Microsoft Entra สําหรับผู้เช่าอื่น (ผู้ใช้ที่เป็นผู้เยี่ยมชม)

เมื่อคุณ ฝังสําหรับองค์กรของคุณ เพื่ออนุญาตให้ผู้ใช้ที่เป็นผู้เยี่ยมชมของ Microsoft Entra เข้าถึงเนื้อหาของคุณ คุณจําเป็นต้องระบุ ID ผู้เช่าใน authorityUri พารามิเตอร์

  • URL สําหรับการรับรองความถูกต้องในผู้เช่าขององค์กรของคุณ:

    https://login.microsoftonline.com/common/v2.0

  • URL สําหรับการรับรองความถูกต้องผู้ใช้ Microsoft Entra ที่เป็นผู้เยี่ยมชม:

    https://login.microsoftonline.com/<tenant ID>

เมื่อต้องการค้นหา ID ผู้เช่า ของคุณ คุณสามารถใช้คําแนะนําใน ค้นหา ID ผู้เช่า Microsoft Entra และชื่อโดเมนหลัก

สําหรับข้อมูลเพิ่มเติม ดูการทําให้แอปพลิเคชันของคุณมีหลายผู้เช่า

แหล่งข้อมูล

ISV ต้องการข้อมูลประจําตัวอื่นสําหรับแหล่งข้อมูลเดียวกัน

แหล่งข้อมูลสามารถมีชุดข้อมูลประจําตัวเดียวสําหรับผู้ใช้หลักหนึ่งราย ถ้าคุณจําเป็นต้องใช้ข้อมูลประจําตัวอื่น ให้สร้างผู้ใช้หลักเพิ่มเติม จากนั้นกําหนดข้อมูลประจําตัวที่แตกต่างกันให้กับบริบทของผู้ใช้หลักแต่ละคน แล้วฝังโดยใช้โทเค็น Microsoft Entra ของผู้ใช้รายนั้น

แก้ไขปัญหาแอปพลิเคชันแบบฝังตัวของคุณด้วยวัตถุ IError

ใช้วัตถุ IError ที่ส่งกลับโดยเหตุการณ์ข้อผิดพลาดจาก JavaScript SDK เพื่อแก้จุดบกพร่องของแอปพลิเคชันของคุณ และทําความเข้าใจสาเหตุของข้อผิดพลาดของคุณได้ดียิ่งขึ้น

หลังจากการรับวัตถุ IError คุณควรดูที่ตารางข้อผิดพลาดทั่วไปที่เหมาะสมกับชนิดฝังตัวที่คุณกําลังใช้ เปรียบเทียบคุณสมบัติ IError กับคุณสมบัติที่อยู่ในตารางและค้นหาเหตุผลสําหรับความล้มเหลวที่เป็นไปได้

ข้อผิดพลาดทั่วไปเมื่อมีการฝังสําหรับผู้ใช้ Power BI

ข้อความ ข้อความรายละเอียด รหัสข้อผิดพลาด เหตุผลที่เป็นไปได้
TokenExpired โทเค็นการเข้าถึงหมดอายุให้ส่งอีกครั้งด้วยโทเค็นการเข้าถึงใหม่ 403 โทเค็นหมดอายุแล้ว
PowerBIEntityNotFound การรับรายงานล้มเหลว 404
  • รหัสรายงานไม่ถูกต้อง
  • ไม่มีรายงาน
  • พารามิเตอร์ไม่ถูกต้อง ไม่ได้ระบุพารามิเตอร์ powerbiToken ไม่ระบุ
  • ไม่มีโทเค็นการเข้าถึงให้
  • ไม่มีรหัสรายงานให้
  • LoadReportFailed การเตรียมใช้งานล้มเหลว - ไม่สามารถแก้ไขคลัสเตอร์ได้ 403
  • โทเค็นการเข้าถึงไม่ดี
  • ชนิดที่ฝังไม่ตรงกับชนิดโทเค็น
  • PowerBINotAuthorizedException การรับรายงานล้มเหลว 401
  • รหัสกลุ่มไม่ถูกต้อง
  • กลุ่มที่ไม่ได้รับอนุญาต
  • TokenExpired โทเค็นการเข้าถึงหมดอายุ ให้ส่งอีกครั้งด้วยโทเค็นการเข้าถึงใหม่ ไม่สามารถแสดงชื่อเรื่องภาพรายงานได้: ชื่อเรื่องภาพ ไม่ระบุ
  • ข้อมูลคิวรี
  • โทเค็นหมดอายุแล้ว
  • Open เชื่อมต่อ ionError ไม่สามารถแสดงวิชวลได้ ไม่สามารถแสดงชื่อเรื่องภาพรายงานได้: ชื่อเรื่องภาพ ไม่ระบุ หยุดกําลังการผลิตชั่วคราวหรือลบในขณะที่รายงานที่เกี่ยวข้องกับความจุถูกเปิดในเซสชัน
    ExplorationContainer_FailedToLoadModel_DefaultDetails ไม่สามารถโหลด Schema สําหรับแบบจําลองที่เกี่ยวข้องกับรายงานนี้ ตรวจสอบให้แน่ใจว่าคุณมีการเชื่อมต่อไปยังเซิร์ฟเวอร์ แล้วลองอีกครั้ง ไม่ระบุ
  • หยุดกําลังการผลิตชั่วคราว
  • ลบกําลังการผลิตแล้ว
  • ข้อผิดพลาดทั่วไปเมื่อมีการฝังสําหรับผู้ใช้ที่ไม่ใช่ Power BI (โดยใช้โทเค็นที่ฝัง)

    ข้อความ ข้อความรายละเอียด รหัสข้อผิดพลาด เหตุผล
    TokenExpired โทเค็นการเข้าถึงหมดอายุให้ส่งอีกครั้งด้วยโทเค็นการเข้าถึงใหม่ 403 โทเค็นหมดอายุแล้ว
    LoadReportFailed การรับรายงานล้มเหลว 404
  • รหัสรายงานไม่ถูกต้อง
  • ไม่มีรายงาน
  • LoadReportFailed การรับรายงานล้มเหลว 403 รหัสรายงานไม่ตรงกับโทเค็น
    LoadReportFailed การรับรายงานล้มเหลว 500 รหัสที่ระบุในรายงานไม่ใช่ GUID
    พารามิเตอร์ไม่ถูกต้อง ไม่ได้ระบุพารามิเตอร์ powerbiToken ไม่ระบุ
  • ไม่มีโทเค็นการเข้าถึงให้
  • ไม่มีรหัสรายงานให้
  • LoadReportFailed การเตรียมใช้งานล้มเหลว - ไม่สามารถแก้ไขคลัสเตอร์ได้ 403 ชนิดโทเค็นไม่ถูกต้องหรือโทเค็นไม่ตรงกัน
    PowerBINotAuthorizedException การรับรายงานล้มเหลว 401 รหัสกลุ่มไม่ถูกต้อง/ไม่ได้รับอนุญาต
    TokenExpired โทเค็นการเข้าถึงหมดอายุ ให้ส่งอีกครั้งด้วยโทเค็นการเข้าถึงใหม่ ไม่สามารถแสดงชื่อเรื่องภาพรายงานได้: ชื่อเรื่องภาพ ไม่ระบุ
  • ข้อมูลคิวรี
  • โทเค็นหมดอายุแล้ว
  • Open เชื่อมต่อ ionError ไม่สามารถแสดงวิชวลได้ ไม่สามารถแสดงชื่อเรื่องภาพรายงานได้: ชื่อเรื่องภาพ ไม่ระบุ หยุดกําลังการผลิตชั่วคราวหรือลบในขณะที่รายงานที่เกี่ยวข้องกับความจุถูกเปิดในเซสชัน
    ExplorationContainer_FailedToLoadModel_DefaultDetails ไม่สามารถโหลด Schema สําหรับแบบจําลองที่เกี่ยวข้องกับรายงานนี้ ตรวจสอบให้แน่ใจว่าคุณมีการเชื่อมต่อไปยังเซิร์ฟเวอร์ แล้วลองอีกครั้ง ไม่ระบุ
  • หยุดกําลังการผลิตชั่วคราว
  • ลบกําลังการผลิตแล้ว
  • รับรายงานล้มเหลว - ข้อผิดพลาด 401 - แก้ไขปัญหาด้วยตนเอง

    ใน สถานการณ์ผู้ใช้เป็นเจ้าของข้อมูล บางครั้งผู้ใช้จะได้รับข้อผิดพลาด 401 ที่แก้ไขตัวเองหลังจากที่พวกเขาเข้าถึงพอร์ทัล Power BI เมื่อเกิดข้อผิดพลาด 401 ให้เพิ่มการเรียก สิทธิ์ RefreshUser ในแอปตามที่อธิบายไว้ใน อัปเดตสิทธิ์ผู้ใช้

    แบบจําลองความหมาย

    จัดการว่าผู้ใช้ของคุณสามารถดูส่วนใดของข้อมูลที่ผู้ใช้ของคุณสามารถดูได้

    ผู้ใช้ใดๆ ที่มีสิทธิ์ในการอ่านสําหรับแบบจําลองเชิงความหมายสามารถดู Schema ทั้งหมด (ตาราง คอลัมน์ และหน่วยวัด) และข้อมูลทั้งหมดได้ คุณไม่สามารถควบคุมการดูสิทธิ์ในการดูดิบและรวมข้อมูลที่แยกต่างหากในแบบจําลองความหมายเดียวกัน

    หากต้องการจัดการข้อมูลส่วนที่ผู้ใช้ของคุณสามารถดู ให้ใช้วิธีใดวิธีหนึ่งต่อไปนี้:

    • การกรองระดับแถวโดยใช้การรักษาความปลอดภัยระดับแถว (RLS) ของ Power BI

    • การรักษาความปลอดภัยระดับวัตถุ (OLS)

    • แยกข้อมูลออกเป็นแบบจําลองความหมายต่าง ๆ ตัวอย่างเช่น คุณสามารถสร้างแบบจําลองความหมายที่ประกอบด้วยข้อมูลรวมเท่านั้น และให้ผู้ใช้ของคุณเข้าถึงเฉพาะแบบจําลองความหมายดังกล่าว

    การแสดงเนื้อหา

    หากต้องการแก้ไขปัญหาการแสดงผลในรายการ Power BI แบบฝังตัว (เช่น รายงานและแดชบอร์ด) ให้ตรวจสอบส่วนนี้

    ตรวจสอบว่ารายการ Power BI โหลดอยู่ในบริการของ Power BI

    เมื่อต้องการไม่มีปัญหากับแอปพลิเคชันของคุณหรือ API การฝัง ให้ตรวจสอบว่าสามารถดูรายการได้ในบริการของ Power BI (powerbi.com)

    ตรวจสอบว่ารายการ Power BI โหลดใน playground การวิเคราะห์แบบฝังตัวของ Power BI

    ในการไม่มีปัญหากับแอปพลิเคชันของคุณ ให้ตรวจสอบว่ารายการ Power BI สามารถดูได้ใน playground การวิเคราะห์แบบฝังตัวของ Power BI

    ตรวจสอบว่าโทเค็นการเข้าถึงของคุณไม่หมดอายุ

    เพื่อวัตถุประสงค์ด้านความปลอดภัย โทเค็นการเข้าถึง (โทเค็น Microsoft Entra หรือโทเค็นแบบฝังตัว) มีอายุการใช้งานที่จํากัด คุณควรตรวจสอบโทเค็นการเข้าถึงของคุณอย่างต่อเนื่องและรีเฟรชหากจําเป็น สําหรับข้อมูลเพิ่มเติม ดู รีเฟรชโทเค็นการเข้าถึง

    ผลการปฏิบัติงาน

    เพื่อให้ได้เนื้อหาแบบฝังตัวที่มีประสิทธิภาพดีที่สุด เราขอแนะนําให้คุณทําตามแนวทางปฏิบัติที่ดีที่สุดสําหรับการวิเคราะห์แบบฝังตัวของ Power BI

    เครื่องมือตั้งค่าแบบฝังตัว

    คุณสามารถเข้าถึง เครื่องมือ ตั้งค่าการฝังตัวเพื่อดาวน์โหลดแอปพลิเคชันตัวอย่างได้อย่างรวดเร็ว จากนั้น คุณสามารถเปรียบเทียบแอปพลิเคชันของคุณกับตัวอย่าง

    ข้อกำหนดเบื้องต้น

    ตรวจสอบว่า คุณมีคุณสมบัติเบื้องต้นทั้งหมดก่อนที่จะใช้เครื่องมือตั้งค่าการฝังตัว คุณต้องมีบัญชี Power BI Pro และการสมัครใช้งาน Microsoft Azure

    ปัญหาที่พบบ่อย

    ปัญหาทั่วไปที่คุณอาจพบขณะทดสอบเครื่องมือตั้งค่าแบบฝังตัวคือ:

    การใช้แอปพลิเคชันตัวอย่างการฝังตัวสําหรับลูกค้าของคุณ

    ถ้าคุณกําลังทํางานกับประสบการณ์ฝังตัวสําหรับลูกค้าของคุณ บันทึกและคลายการบีบอัดไฟล์ PowerBI-Developer-Samples.zip จากนั้น เปิดโฟลเดอร์ PowerBI-Developer-Samples-master\App Owns Data และเรียกใช้ไฟล์ PowerBIEmbedded_AppOwnsData.sln

    • เมื่อเลือก ให้สิทธิ์ (ขั้นตอนการให้สิทธิ์) คุณได้รับข้อผิดพลาดต่อไปนี้:
    AADSTS70001: Application with identifier <client ID> wasn't found in the directory <directory ID>
    

    การแก้ไขปัญหาคือปิดป็อปอัพ รอสักครู่ แล้วลองอีกครั้ง คุณอาจต้องทําซ้ําหลายครั้ง ระยะเวลาจากการเสร็จสิ้นกระบวนการลงทะเบียนแอปพลิเคชันจนถึงเวลาที่พร้อมใช้งานสําหรับ API ภายนอกคือต้นเหตุของปัญหา

    • ข้อความแสดงข้อผิดพลาดต่อไปนี้ปรากฏขึ้นเมื่อเรียกใช้แอปตัวอย่าง:
    Password is empty. Please fill password of Power BI username in web.config.
    

    ข้อผิดพลาดนี้เกิดขึ้นเนื่องจากค่ารหัสผ่านผู้ใช้ของคุณยังไม่ได้ใส่เข้าไปในแอปพลิเคชันตัวอย่าง เปิด ไฟล์ Web.config ในโซลูชัน และกรอกข้อมูล pbiPassword เขตข้อมูลด้วยรหัสผ่านของผู้ใช้ของคุณ

    • ถ้าคุณได้รับข้อผิดพลาด:
    AADSTS50079: The user is required to use multi-factor authentication.
    

    คุณจําเป็นต้องใช้บัญชี Microsoft Entra ที่ไม่ได้เปิดใช้งาน MFA

    การใช้แอปพลิเคชันตัวอย่างการฝังตัวสําหรับองค์กรของคุณ

    ถ้าคุณกําลังทํางานกับประสบการณ์ฝังตัวสําหรับองค์กรของคุณ บันทึกและคลายการบีบอัดไฟล์ PowerBI-Developer-Samples.zip จากนั้นเปิดโฟลเดอร์ PowerBI-Developer-Samples-master\User Owns Data\integrate-report-web-app และเรียกใช้ไฟล์ pbi-saas-embed-report.sln

    • เมื่อคุณเรียกใช้ แอปตัวอย่างการฝังตัวสําหรับองค์กรของคุณ คุณได้รับข้อผิดพลาดต่อไปนี้:
    AADSTS50011: The reply URL specified in the request doesn't match the reply URLs configured for the application: <client ID>
    

    ข้อผิดพลาดนี้เกิดเนื่องจาก URL เปลี่ยนเส้นทางที่ระบุสําหรับเว็บเซิร์ฟเวอร์แอปพลิเคชันแตกต่างจาก URL ของตัวอย่าง ถ้าคุณต้องการลงทะเบียนแอปพลิเคชันตัวอย่าง ให้ใช้ https://localhost:13526/ เป็น URL เปลี่ยนเส้นทาง

    หากคุณต้องการแก้ไขแอปพลิเคชันที่ลงทะเบียนแล้ว ให้ อัปเดตแอปพลิเคชันที่ลงทะเบียนของ Microsoft Entra เพื่อให้แอปพลิเคชันสามารถเข้าถึง API ของเว็บได้

    ถ้าคุณต้องการแก้ไขโปรไฟล์หรือข้อมูลผู้ใช้ Power BI ของคุณ เรียนรู้วิธีการแก้ไขข้อมูล Power BI ของคุณ

    • ถ้าคุณได้รับข้อผิดพลาด:
    AADSTS50079: The user is required to use multi-factor authentication.
    

    คุณจําเป็นต้องใช้บัญชี Microsoft Entra ที่ไม่ได้เปิดใช้งาน MFA

    สําหรับข้อมูลเพิ่มเติม โปรดดู คําถามที่ถามบ่อยของ Power BI Embedded

    สําหรับความช่วยเหลือ เพิ่มเติม ให้ติดต่อฝ่ายสนับสนุน หรือ สร้างตั๋วการสนับสนุนผ่านพอร์ทัล Azure และระบุข้อความแสดงข้อผิดพลาดที่คุณพบ

    มีคำถามเพิ่มเติมหรือไม่? ถามชุมชน Power BI