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

F12 ในเบราว์เซอร์สำหรับการแก้ไขปัญหาโปรแกรมเสริมหน้า (Front-end)
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 จะบอกถึงสิทธิ์ที่ไม่เพียงพอ หากต้องการลงทะเบียนแอปพลิเคชัน คุณต้องเป็นผู้ดูแลระบบในผู้เช่า Azure AD หรือต้องเปิดใช้งานการลงทะเบียนแอปพลิเคชันสำหรับผู้ใช้ที่ไม่ใช่ผู้ดูแลระบบ
บริการ Power BI ไม่ปรากฏในพอร์ทัล Azure เมื่อลงทะเบียนแอปใหม่
ต้องมีผู้ใช้อย่างน้อยหนึ่งรายลงทะเบียนสำหรับ Power BI ถ้าคุณไม่เห็น บริการ Power BI แสดงอยู่ภายในรายการ API แสดงว่าไม่มีผู้ใช้ที่ลงทะเบียนสำหรับ Power BI
ID ออบเจ็กต์ของแอปพลิเคชันและ ID ออบเจ็กต์หลักแตกต่างกันอย่างไร
เมื่อคุณลงทะเบียนแอป Azure AD มีพารามิเตอร์สองตัวที่เรียกว่า ID ออบเจ็กต์ ส่วนนี้อธิบายวัตถุประสงค์ของแต่ละพารามิเตอร์และวิธีการขอรับพารามิเตอร์
ID ออปเจ็กต์ของแอปพลิเคชัน
ID ออบเจ็กต์แอปพลิเคชัน หรือทราบเพียงแค่เป็น ID ออบเจ็กต์ เป็น ID เฉพาะของออบเจ็กต์แอปพลิเคชัน Azure AD ของคุณ
หากต้องการรับ ID ออปเจ็กต์ของแอปพลิเคชัน ให้นําทางไปยังแอป Azure AD ของคุณ และ คัดลอกจาก ภาพรวม
ID ออบเจ็กต์หลัก
ID ออบเจ็กต์หลักหรือที่เรียกว่า ID ออบเจ็กต์ คือ ID เฉพาะของออบเจ็กต์ บริการหลัก ที่เชื่อมโยงกับแอปพลิเคชัน Azure AD ของคุณ
หากต้องการรับ ID ออบเจ็กต์หลักของคุณ ให้นําทางไปยังแอป Azure AD ของคุณ และจาก ภาพรวม เลือกลิงก์แอปใน แอปพลิเคชันที่จัดการแล้ว ในไดเรกทอรีภายใน เครื่อง
จาก ส่วน คุณสมบัติ ให้คัดลอก ID ออบเจ็กต์
REST API
API เรียกให้ส่งกลับ 401
อาจต้องมีการจับภาพ Fiddler เพื่อการตรวจสอบเพิ่มเติม ขอบเขตการอนุญาตสิทธิ์ที่จำเป็นอาจสูญหายสำหรับแอปพลิเคชันที่ลงทะเบียนไว้ภายใน Azure AD ตรวจสอบให้แน่ใจว่าขอบเขตที่จำเป็นต้องมีปรากฏอยู่ภายในการลงทะเบียนแอปฯสำหรับ Azure AD ภายในพอร์ทัล Azure
API เรียกให้ส่งกลับ 403
อาจต้องมีการจับภาพ Fiddler เพื่อการตรวจสอบเพิ่มเติม อาจมีหลายสาเหตุสำหรับข้อผิดพลาด 403
- ผู้ใช้มีจำนวนโทเค็นแบบฝังเกินจำนวนที่สามารถสร้างขึ้นได้ในความจุที่ใช้ร่วมกัน ซื้อความจุ Azure เพื่อสร้างโทเค็นแบบฝัง และกำหนดพื้นที่ทำงานให้กับขีดความจุนั้น ดูขีดความสามารถในการสร้าง Power BI แบบฝังในพอร์ทัล Azure
- โทเค็นรับรองความถูกต้องของ Azure AD หมดอายุแล้ว
- ผู้ใช้ที่ได้รับการรับรองความถูกต้องไม่เป็นสมาชิกของกลุ่ม (พื้นที่ทำงาน)
- ผู้ใช้ที่ได้รับการรับรองความถูกต้องไม่เป็นผู้ดูแลระบบของกลุ่ม (พื้นที่ทำงาน)
- ผู้ใช้ที่ผ่านการรับรองความถูกต้องแล้วไม่มีสิทธิ์ จะสามารถอัปเดตสิทธิ์ได้โดยใช้refreshUserPermissions API
- หัวข้อการรับรองความถูกต้องอาจไม่อยู่ในรายการอย่างถูกต้อง ตรวจสอบให้แน่ใจว่าไม่มีการพิมพ์ผิด
ส่วนหลังของแอปพลิเคชันอาจจำเป็นต้องรีเฟรชโทเค็นการรับรองความถูกต้องก่อนที่จะเรียก GenerateToken โปรดดูที่รีเฟรชโทเค็นการเข้าถึงเพื่อ ดูรายละเอียดเพิ่มเติม
GET https://wabi-us-north-central-redirect.analysis.windows.net/metadata/cluster HTTP/1.1
Host: wabi-us-north-central-redirect.analysis.windows.net
...
Authorization: Bearer eyJ0eXAiOi...
...
HTTP/1.1 403 Forbidden
...
{"error":{"code":"TokenExpired","message":"Access token has expired, resubmit with a new access token"}}
วิธีการแก้ไขข้อยกเว้นการหมดเวลาเมื่อใช้ API นําเข้าและส่งออก API
เมื่อคุณส่งการร้องขอ power BI REST API อาจมาถึงคลัสเตอร์ที่ไม่มีข้อมูลของผู้เช่าของคุณ ในกรณีเช่นนี้ การเปลี่ยนเส้นทางการร้องขออาจล้มเหลวเนื่องจากการหมดเวลา
เมื่อต้องการแก้ไขข้อยกเว้นการหมดเวลา คุณสามารถส่งการร้องขออีกครั้งด้วย preferClientRouting พารามิเตอร์ที่ตั้งค่า true เป็น ถ้าการร้องขอของคุณมาถึงคลัสเตอร์ที่ไม่ถูกต้อง การส่งกลับบริการของ Power BIการตอบสนอง HTTP เปลี่ยนเส้นทางชั่วคราว 307 ในกรณีดังกล่าว คุณจึงต้องเปลี่ยนเส้นทางการร้องขอของคุณไปยังที่อยู่ใหม่ที่ระบุไว้ในส่วนหัว ที่อยู่ HTTPS การตอบสนอง
การรับรองความถูกต้อง
การรับรองความถูกต้องล้มเหลวเนื่องจาก AADSTS90002 ไม่พบผู้เช่าที่ได้รับ 'การอนุญาต'
หากคุณได้รับข้อความการลงชื่อเข้าใช้ เช่น error: invalid_request, error_description: AADSTS90002: ไม่พบผู้เช่าที่ได้รับ 'การอนุญาต' ซึ่งก็คือเนื่องจากไม่สนับสนุน ADAL 4.x "https://login.microsoftonline.com/{Tenant}/oauth2/authorize/" เป็น url ผู้มีสิทธิ์
ในการแก้ไขปัญหานี้คุณควรตัด "oauth2/authorize/" จากท้าย URL ผู้มีสิทธิ์ของคุณ โปรดดู ตัวอย่างนักพัฒนา Power BI สำหรับการอ้างอิง
ตรวจสอบ การตรวจสอบความถูกต้องผู้มีสิทธิ์ที่ดีขึ้น จากบันทึกย่อประจำรุ่น ADAL 4.x
การรับรองความถูกต้องล้มเหลวเนื่องจาก AADSTS70002 หรือ AADSTS50053
(AADSTS70002: ข้อมูลประจำตัวผิดพลาด AADSTS50053: คุณได้พยายามลงชื่อเข้าใช้หลายครั้งเกินไปด้วยรหัสผู้ใช้หรือรหัสผ่านที่ไม่ถูกต้อง)
หากคุณใช้งาน Power BI Embeddedการรับรองความถูกต้องโดยตรงของ Azure AD และคุณได้รับข้อความที่เข้าสู่ระบบ เช่น ข้อผิดพลาด:unauthorized_client, error_description:AADSTS70002: ข้อมูลรับรองผิดพลาด AADSTS50053: คุณได้พยายามลงชื่อเข้าใช้หลายครั้งเกินไป ด้วยรหัสผู้ใช้หรือรหัสผ่านที่ไม่ถูกต้อง นั่นเป็นเพราะว่าการรับรองความถูกต้องโดยตรงไม่ได้ใช้งานอีกต่อไป
นั่นคือวิธีการเปลี่ยนไปใช้ นโยบาย Azure AD ที่กำหนดขอบเขตสำหรับองค์กรหรือผู้ให้บริการหลัก
เราขอแนะนำให้คุณเปิดใช้งานนโยบายนี้เป็นแบบต่อแอปเท่านั้น
เมื่อต้องสร้างนโยบายนี้ คุณจำเป็นต้องเป็น ผู้ดูแลระบบส่วนกลาง สำหรับไดเรกทอรีที่คุณกำลังสร้างนโยบายและกำหนดสิ่งต่างๆ นี่คือสคริปต์ตัวอย่างสำหรับการสร้างนโยบาย และกำหนดนโยบายให้กับ SP สำหรับแอปพลิเคชันนี้:
เรียกใช้คำสั่ง Powershell แบบบรรทัดต่อบรรทัดต่อไปนี้ (ตรวจสอบให้แน่ใจว่าตัวแปร $sp ไม่มีแอปพลิเคชันมากกว่าหนึ่งรายการเป็นผลลัพธ์)
Connect-AzureAD
$sp = Get-AzureADServicePrincipal -SearchString "Name_Of_Application"
$policy = New-AzureADPolicy -Definition @("{`"HomeRealmDiscoveryPolicy`":{`"AllowCloudPasswordValidation`":true}}") -DisplayName EnableDirectAuth -Type HomeRealmDiscoveryPolicy -IsOrganizationDefault $false
Add-AzureADServicePrincipalPolicy -Id $sp.ObjectId -RefObjectId $policy.Id
หลังจากกำหนดนโยบาย โปรดรอประมาณ 15-20 วินาทีสำหรับการเผยแพร่ก่อนการทดสอบ
การสร้างโทเค็นล้มเหลวเมื่อระบุข้อมูลประจำตัวที่ใช้ได้
GenerateToken สามารถล้มเหลวได้เมื่อใช้งานข้อมูลประจำตัวที่ให้มาด้วยเหตุผลสองสามประการ
- ชุดข้อมูลไม่รองรับข้อมูลประจำตัวที่ใช้ได้
- ไม่ได้ระบุชื่อผู้ใช้
- ไม่ได้ระบุบทบาท
- ไม่ได้ระบุรหัสชุดข้อมูล
- ผู้ใช้ไม่มีสิทธิ์ที่ถูกต้อง
เพื่่อตรวจสอบว่ามีสาเหตุจากอะไร ให้ลองทำตามขั้นตอนต่อไปนี้
- ดำเนินการรับชุดข้อมูล คุณสมบัติ IsEffectiveIdentityRequired เป็นจริงหรือไม่?
- ชื่อผู้ใช้เป็นข้อบังคับสำหรับ EffectiveIdentity ใด ๆ
- ถ้า IsEffectiveIdentityRolesRequired เป็นจริง ดังนั้นต้องมีบทบาท
- รหัสชุดข้อมูลเป็นข้อบังคับสำหรับ EffectiveIdentity ใด ๆ
- สำหรับ Analysis Services ผู้ใช้หลักจะต้องเป็นผู้ดูแลระบบเกตเวย์
AADSTS90094: การอนุมัติต้องใช้สิทธิของผู้ดูแลระบบ
ปัญหา:
เมื่อผู้ใช้ที่ไม่ใช่ผู้ดูแลระบบพยายามลงชื่อเข้าใช้แอปพลิเคชันเป็นครั้งแรกในขณะที่ให้การยินยอม จากนั้นจะเกิดข้อผิดพลาดอย่างใดอย่างหนึ่งต่อไปนี้:
ConsentTest ต้องการสิทธิ์ในการเข้าถึงทรัพยากรในองค์กรของคุณที่ผู้ดูแลระบบเท่านั้นสามารถมอบหมายได้ สอบถามผู้ดูแลระบบเพื่อขอสิทธิการใช้งานแอปนี้ก่อนที่คุณสามารถใช้งาน
AADSTS90094: การอนุมัติต้องได้รับสิทธิ์จากผู้ดูแลระบบ

ผู้ใช้ที่เป็นผู้ดูแลระบบสามารถลงชื่อเข้าใช้ และให้การยินยอมเรียบร้อยแล้ว
สาเหตุ:
การอนุมัติของผู้ใช้ถูกปิดใช้งานสำหรับผู้เช่า
แก้ไขปัญหาได้ดังนี้้:
เปิดใช้งานการอนุมัติของผู้ใข้สำหรับผู้เช่าทั้งหมด (ผู้ใช้ทั้งหมด แอปพลิเคชั้นทั้งหมด)
ในพอร์ทัล Azure ไปที่ "Azure Active Directory" = > "ผู้ใช้และกลุ่ม" = > "การตั้งค่าผู้ใช้"
เปิดใช้งานการตั้งค่า “ผู้ใช้สามารถยินยอมให้แอปเข้าถึงข้อมูลของบริษัทในนามของพวกเขา” แล้วเลือก บันทึก การเปลี่ยนแปลง

ให้สิทธิ ในแอปพลิเคชันโดยผู้ดูแลระบบบ - สำหรับผู้เช่าทั้งหมดหรือผู้ใช้ที่ระบุ
ข้อผิดพลาด CS1061
ดาวน์โหลด Microsoft.IdentityModel.Clients.ActiveDirectory ถ้าคุณพบข้อผิดพลาด "'AuthenticationContext' ไม่มีคำจำกัดความของ 'AcquireToken' และไม่พบการเข้าถึง 'AcquireToken' ที่ยอมรับอาร์กิวเมนต์แรกในประเภท 'AuthenticationContext' (คุณไม่ได้ใช้คำสั่งหรือการอ้างอิงแอสเซมบลีใช่ไหม)"
โทเค็น AD Azure ของผู้เช่าอื่น (ผู้ใช้ที่เป็นแขก)
เมื่อคุณ ฝังเพื่อองค์กรของคุณ เพื่อ อนุญาตให้ผู้ใช้ที่เป็นแขกของ Azure AD เข้าถึงเนื้อหาของคุณ คุณต้องระบุรหัสผู้เช่า authorityUri ในพารามิเตอร์
URL เพื่อการรับรองความถูกต้องในผู้เช่าขององค์กรของคุณ:
https://login.microsoftonline.com/common/v2.0URL เพื่อรับรองความถูกต้องผู้ใช้ที่เป็นแขกของ Azure AD:
https://login.microsoftonline.com/<tenant ID>
เพื่อค้นหา ID ผู้เช่า คุณสามารถใช้คําแนะนําใน ค้นหาMicrosoft Azure ADผู้เช่าและชื่อโดเมนหลัก
โปรดดูที่วิธีการ:ลงชื่อเข้าใช้ ผู้ใช้อื่น ๆ Azure Active Directoryแอปพลิเคชันแบบหลายผู้เช่า
แหล่งข้อมูล
ISV ต้องการข้อมูลประจำตัวอื่นสำหรับแหล่งข้อมูลเดียวกัน
แหล่งข้อมูลสามารถมีหนึ่งชุดข้อมูลประจำตัวสำหรับผู้ใช้หลักหนึ่งราย ถ้าคุณจำเป็นต้องใช้ข้อมูลประจำตัวอื่น ให้สร้างผู้ใช้หลักเพิ่มเติม จากนั้น กำหนดข้อมูลประจำตัวอื่นในบริบทผู้ใช้หลักแต่ละคน จากนั้นฝังโดยใช้โทเค็น Azure AD ของผู้ใช้นั้น
แก้ไขปัญหาแอปพลิเคชันแบบฝังตัวของคุณด้วยออบเจ็กต์ IError
ใช้ วัตถุ IError ถูกส่งกลับด้วยเหตุการณ์ ข้อผิดพลาด จาก JavaScript SDKเพื่อแก้จุดบกพร่องของแอปพลิเคชันของคุณ และทำความเข้าใจสาเหตุของข้อผิดพลาดของคุณได้ดียิ่งขึ้น
หลังจากการรับวัตถุ IError คุณควรดูที่ตารางข้อผิดพลาดทั่วไปที่เหมาะสมกับชนิดฝังตัวที่คุณกำลังใช้ เปรียบเทียบ คุณสมบัติ IError ด้วยคุณสมบัติที่อยู่ในตารางและค้นหาเหตุผลสำหรับความล้มเหลวที่เป็นไปได้
ข้อผิดพลาดทั่วไปเมื่อมีการฝังสำหรับผู้ใช้ Power BI
| ข้อความ | ข้อความรายละเอียด | รหัสข้อผิดพลาด | เหตุผลที่เป็นไปได้ |
|---|---|---|---|
| TokenExpired | โทเค็นการเข้าถึงหมดอายุแล้ว ส่งอีกครั้งด้วยโทเค็นการเข้าถึงใหม่ | 403 | โทเค็นหมดอายุแล้ว |
| PowerBIEntityNotFound | รับรายงานล้มเหลว | 404 | |
| พารามิเตอร์ไม่ถูกต้อง | ไม่ได้ระบุพารามิเตอร์ powerbiToken | N/A | |
| LoadReportFailed | การเตรียมใช้งานล้มเหลว - ไม่สามารถแก้ไขคลัสเตอร์ได้ | 403 | |
| PowerBINotAuthorizedException | รับรายงานล้มเหลว | 401 | |
| TokenExpired | โทเค็นการเข้าถึงหมดอายุ ให้ส่งอีกครั้งด้วยโทเค็นการเข้าถึงใหม่ ไม่สามารถแสดงชื่อเรื่องภาพรายงานได้: ชื่อเรื่องภาพ | N/A | โทเค็นที่หมดอายุแล้วของข้อมูลการสอบถาม |
| OpenConnectionError | ไม่สามารถแสดงภาพได้ ไม่สามารถแสดงชื่อเรื่องภาพรายงานได้: ชื่อเรื่องภาพ | N/A | หยุดกำลังการผลิตชั่วคราว หรือลบในขณะที่รายงานที่เกี่ยวข้องกับความจุถูกเปิดในเซสชัน |
| ExplorationContainer_FailedToLoadModel_DefaultDetails | ไม่สามารถโหลด schema สำหรับโมเดลที่เกี่ยวข้องกับรายงานนี้ ตรวจสอบให้แน่ใจว่าคุณมีการเชื่อมต่อไปยังเซิร์ฟเวอร์ แล้วลองอีกครั้ง | N/A |
เกิดข้อผิดพลาดทั่วไปเมื่อมีการฝังสำหรับผู้ใช้ที่ไม่ใช่ Power BI (โดยใช้โทเค็นแบบฝัง)
| ข้อความ | ข้อความรายละเอียด | รหัสข้อผิดพลาด | เหตุผล |
|---|---|---|---|
| TokenExpired | โทเค็นการเข้าถึงหมดอายุแล้ว ส่งอีกครั้งด้วยโทเค็นการเข้าถึงใหม่ | 403 | โทเค็นหมดอายุแล้ว |
| LoadReportFailed | รับรายงานล้มเหลว | 404 | |
| LoadReportFailed | รับรายงานล้มเหลว | 403 | รหัสรายงานไม่ตรงกับโทเค็น |
| LoadReportFailed | รับรายงานล้มเหลว | 500 | รหัสที่ระบุในรายงานไม่ใช่รหัสเฉพาะ |
| พารามิเตอร์ไม่ถูกต้อง | ไม่ได้ระบุพารามิเตอร์ powerbiToken | N/A | |
| LoadReportFailed | การเตรียมใช้งานล้มเหลว - ไม่สามารถแก้ไขคลัสเตอร์ได้ | 403 | ชนิดโทเค็นไม่ถูกต้อง โทเค็นไม่เหมาะสม |
| PowerBINotAuthorizedException | การรับรายงานล้มเหลว | 401 | รหัสกลุ่มไม่ถูกต้อง/ไม่ได้รับอนุญาต |
| TokenExpired | โทเค็นการเข้าถึงหมดอายุ ให้ส่งอีกครั้งด้วยโทเค็นการเข้าถึงใหม่ ไม่สามารถแสดงชื่อเรื่องภาพรายงานได้: ชื่อเรื่องภาพ | N/A | โทเค็นที่หมดอายุแล้วของข้อมูลการสอบถาม |
| OpenConnectionError | ไม่สามารถแสดงภาพได้ ไม่สามารถแสดงชื่อเรื่องภาพรายงานได้: ชื่อเรื่องภาพ | N/A | หยุดกำลังการผลิตชั่วคราว หรือลบในขณะที่รายงานที่เกี่ยวข้องกับความจุถูกเปิดในเซสชัน |
| ExplorationContainer_FailedToLoadModel_DefaultDetails | ไม่สามารถโหลด schema สำหรับโมเดลที่เกี่ยวข้องกับรายงานนี้ ตรวจสอบให้แน่ใจว่าคุณมีการเชื่อมต่อไปยังเซิร์ฟเวอร์ แล้วลองอีกครั้ง | N/A |
ชุดข้อมูล
จัดการว่าผู้ใช้ของคุณสามารถดูส่วนใดของข้อมูลได้
ผู้ใช้ใด ๆ ที่มีสิทธิ์การอ่านชุดข้อมูลสามารถดูสคีมาทั้งหมด (ตาราง คอลัมน์ และหน่วยวัด) และข้อมูลทั้งหมด คุณไม่สามารถควบคุมสิทธิ์ในการดูไปยังข้อมูลดิบและรวมในชุดข้อมูลเดียวกันได้แยกกัน
หากต้องการจัดการว่าผู้ใช้ของคุณสามารถดูส่วนใดของข้อมูลได้ ให้ใช้หนึ่งในวิธีเหล่านี้:
การกรองระดับแถวโดยใช้การรักษาความปลอดภัยระดับ แถว (RLS) ของPower BI
แยกข้อมูลลงในชุดข้อมูลที่แตกต่างกัน ตัวอย่างเช่น คุณสามารถสร้างชุดข้อมูลที่มีข้อมูลรวมเท่านั้น และให้ผู้ใช้ของคุณเข้าถึงชุดข้อมูลนั้นเท่านั้น
แสดงเนื้อหา
หากต้องการแก้ไขปัญหาการแสดงผลในรายการ Power BI แบบฝังตัว (เช่น รายงานและแดชบอร์ด) ให้ตรวจทานส่วนนี้
ตรวจสอบว่ารายการ Power BI โหลดบริการของ Power BI
หากต้องการตัดออกปัญหา กับแอปพลิเคชันของคุณหรือ API ที่ ฝัง ไว้ ให้ตรวจสอบว่ารายการสามารถดูได้ในมุมมองบริการของ Power BI (powerbi.com)
ตรวจสอบว่าการโหลดรายการ Power BI ในเครื่องมือวิเคราะห์แบบฝังตัวของ Power BI นั้น
หากต้องการตัดปัญหากับแอปพลิเคชันของคุณ ให้ตรวจสอบว่ารายการ Power BI สามารถดูได้ในเครื่องมือวิเคราะห์ที่ฝังตัว ของ Power BIหรือไม่
ตรวจสอบว่าโทเค็นการเข้าถึงของคุณไม่หมดอายุ
เพื่อวัตถุประสงค์ด้านความปลอดภัย โทเค็นการเข้าถึง (โทเค็น Azure AD หรือโทเค็นแบบฝังตัว) มีอายุการใช้งานที่จํากัด คุณควรตรวจสอบโทเค็นการเข้าถึงของคุณอย่างต่อเนื่องและรีเฟรชถ้ามีความเป็นที่ต้องการ โปรดดูที่รีเฟรชโทเค็นการเข้าถึงเพื่อ ดูรายละเอียดเพิ่มเติม
ประสิทธิภาพการทำงาน
หากต้องการรับเนื้อหาแบบฝังตัวที่มีประสิทธิภาพสูงสุด เราขอแนะแนวให้คุณปฏิบัติตาม แนวทางปฏิบัติที่ดีที่สุดเกี่ยวกับการวิเคราะห์แบบฝังตัวของ Power BI
เครื่องมือตั้งค่าแบบฝัง
คุณสามารถเข้าถึงเครื่องมือตั้งค่าการฝังตัว เพื่อดาวน์โหลดแอปพลิเคชันตัวอย่างได้อย่างรวดเร็ว จากนั้น คุณสามารถเปรียบเทียบแอปพลิเคชันของคุณกับตัวอย่าง
ข้อกำหนดเบื้องต้น
ตรวจสอบว่าคุณผ่านข้อกำหนดเบื้องต้นทั้งหมด ก่อนที่จะใช้เครื่องมือตั้งค่าการฝังตัว คุณต้องมีบัญชี Power BI Pro และการสมัครใช้งาน Microsoft Azure
- ถ้าคุณยังไม่ได้ลงทะเบียนสำหรับ Power BI Proลงทะเบียนทดลองใช้ฟรีก่อนที่คุณจะเริ่ม
- ถ้าคุณยังไม่มีการสมัครใช้งาน Azure สร้างบัญชีฟรีก่อนที่คุณจะเริ่ม
- คุณจำเป็นต้องตั้งค่าผู้เช่า Azure Active Directory ของคุณเอง
- คุณต้องติดตั้ง Visual Studio (เวอร์ชัน 2013 หรือใหม่กว่า)
ปัญหาที่พบบ่อย
ปัญหาทั่วไปที่คุณอาจพบขณะทดสอบเครื่องมือตั้งค่าแบบฝังตัวคือ:
การใช้แอปพลิเคชันตัวอย่าง การฝังตัวสำหรับของลูกค้าคุณ
ถ้าคุณกำลังทำงานกับประสบการณ์ ฝังตัวสำหรับลูกค้าของคุณ บันทึกและคลายการบีบอัดไฟล์ 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: ผู้ใช้จะต้องใช้การรับรองความถูกต้องแบบหลายปัจจัย
จำเป็นต้องใช้บัญชี AAD ที่ไม่ได้เปิดใช้งาน 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 เปลี่ยนเส้นทาง
หากคุณต้องการแก้ไขแอปพลิเคชันที่ลงทะเบียนไว้ ให้เรียนรู้วิธี อัปเดตแอปพลิเคชัน Azure AD ที่ลงทะเบียนไว้ เพื่อที่แอปพลิเคชันจะสามารถให้สิทธิ์เข้าถึง API ของเว็บได้
ถ้าคุณต้องการแก้ไขโปรไฟล์หรือข้อมูลผู้ใช้ Power BI ของคุณ เรียนรู้วิธีการแก้ไขข้อมูล Power BI ของคุณ
ถ้าคุณได้รับข้อผิดพลาด - AADSTS50079: ผู้ใช้จะต้องใช้การรับรองความถูกต้องแบบหลายปัจจัย
จำเป็นต้องใช้บัญชี AAD ที่ไม่ได้เปิดใช้งาน MFA
สำหรับข้อมูลเพิ่มเติม โปรดดู คำถามที่ถามบ่อยของ Power BI Embedded
มีคำถามเพิ่มเติมหรือไม่ ลองไปที่ชุมชน Power BI
หากคุณต้องการความช่วยเหลือเพิ่มเติม โปรด ติดต่อฝ่ายสนับสนุน หรือ สร้างตั๋วการสนับสนุนผ่านพอร์ทัล Azure และระบุข้อความแสดงข้อผิดพลาดที่คุณพบ
ขั้นตอนถัดไป
สำหรับข้อมูลเพิ่มเติม ให้ดู คำถามที่พบบ่อย
มีคำถามเพิ่มเติมหรือไม่ ลองไปที่ชุมชน Power BI