บานหน้าต่างการวิเคราะห์ในวิชวล Power BI

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

โน้ต

บานหน้าต่าง การวิเคราะห์ พร้อมใช้งานใน API เวอร์ชัน 2.5.0 เมื่อต้องการตรวจสอบเวอร์ชันที่คุณกําลังใช้ ตรวจสอบ apiVersion ในไฟล์ pbiviz.json

จัดการบานหน้าต่างการวิเคราะห์

การจัดการคุณสมบัติในบานหน้าต่าง การวิเคราะห์ คล้ายกับการจัดการคุณสมบัติในบานหน้าต่าง รูปแบบ คุณสามารถกําหนด วัตถุ ในไฟล์ capabilities.json ของวิชวล

สําหรับบานหน้าต่าง Analytics ที่กําหนดวัตถุดังนี้:

API 5.1+

ภายใต้ข้อกําหนดของวัตถุ ให้เพิ่มเฉพาะชื่อวัตถุ ชื่อคุณสมบัติ และชนิดตามที่อธิบายไว้ ที่นี่ ตัวอย่าง:

{
  "objects": {
    "YourAnalyticsPropertiesCard": {
      "properties": {
        "show": {
          "type": {
            "bool": true
          }
        },
        "displayName": {
          "type": {
            "text": true
          }
        },
      ... //any other properties for your Analytics card
      }
    }
  ...
  }
}

API ที่เก่ากว่า (ก่อน 5.1)

1. ภายใต้ข้อกําหนดของวัตถุ ให้เพิ่ม displayName และเขตข้อมูล objectCategory ด้วยค่าของ 2

   โน้ต

   เขตข้อมูล objectCategory จะกําหนดลักษณะของวิชวลที่ตัวควบคุมออบเจ็กต์ (1=การจัดรูปแบบ, 2=การวิเคราะห์) ใช้ Formatting สําหรับองค์ประกอบ เช่น รูปลักษณ์และความรู้สึก สี แกน และป้ายชื่อ ใช้ Analytics สําหรับองค์ประกอบ เช่น การคาดการณ์ เส้นอ้างอิง และรูปร่าง

   หากไม่ได้ระบุค่า objectCategory ค่าเริ่มต้นจะ Formatting

2. เพิ่มคุณสมบัติสองประการต่อไปนี้ลงในวัตถุ:

   • show ชนิด bool ที่มีค่าเริ่มต้นเป็น true
   • displayName ชนิด text ที่มีค่าเริ่มต้นเป็น true

{
  "objects": {
    "YourAnalyticsPropertiesCard": {
      "displayName": "Your analytics properties card's name",
      "objectCategory": 2,
      "properties": {
        "show": {
          "type": {
            "bool": true
          }
        },
        "displayName": {
          "type": {
            "text": true
          }
        },
      ... //any other properties for your Analytics card
      }
    }
  ...
  }
}

ในการ์ดการตั้งค่าการจัดรูปแบบ ให้ระบุว่าการ์ดนี้เป็นของบานหน้าต่างการวิเคราะห์โดยการตั้งค่าพารามิเตอร์ set card analyticsPane เป็น true ตามค่าเริ่มต้น พารามิเตอร์ analyticsPane เป็น false และการ์ดจะถูกเพิ่มไปยังบานหน้าต่างการจัดรูปแบบ ดูการใช้งานต่อไปนี้:

การใช้

class YourAnalyticsCardSettings extends FormattingSettingsCard {
    show = new formattingSettings.ToggleSwitch({
        name: "show",
        displayName: undefined,
        value: false,
        topLevelToggle: true
    });

    displayNameProperty = new formattingSettings.TextInput({
        displayName: "displayName",
        name: "displayName",
        placeholder: "",
        value: "Analytics Instance",
    });

    name: string = "YourAnalyticsPropertiesCard";
    displayName: string = "Your analytics properties card's name";
    analyticsPane: boolean = true; // <===  Add and set analyticsPane variable to true 
    slices = [this.show, this.displayNameProperty];
}

ที่ไม่มี

      const show: powerbi.visuals.EnabledSlice = {
          uid: "enableAxisCard_topLevelToggle_show_uid",
          suppressDisplayName: true,
          control: {
              type: powerbi.visuals.FormattingComponent.ToggleSwitch,
              properties: {
                  descriptor: {
                      objectName: "YourAnalyticsPropertiesCard",
                      propertyName: "show"
                  },
                  value: false
              }
          }
      }
        
      const displayNameProperty: powerbi.visuals.FormattingSlice = {
          uid: "enableAxisCard_displayName_uid",
          suppressDisplayName: true,
          control: {
              type: powerbi.visuals.FormattingComponent.TextInput,
              properties: {
                  descriptor: {
                      objectName: "YourAnalyticsPropertiesCard",
                      propertyName: "displayName"
                  },
                  value: "Analytics Instance",
                  placeholder: ""
              }
          }
      }

      const averageLineCard: powerbi.visuals.FormattingCard = {
          displayName: "Your analytics properties card's name",
          uid: "yourAnalyticsCard_uid",
          analyticsPane: true, // <===  Add and set analyticsPane variable to true 
          topLevelToggle: show,
          groups: [{
              displayName: undefined,
              uid: "yourAnalyticsCard_group_uid",
              slices: [displayNameProperty],
          }]
      };

กําหนดคุณสมบัติอื่น ๆ ในลักษณะเดียวกับที่คุณดําเนินการกับวัตถุ รูปแบบ และแจกแจงวัตถุเหมือนกับที่คุณทําในบานหน้าต่าง รูปแบบ

โน้ต

• ใช้บานหน้าต่าง Analytics สําหรับวัตถุที่เพิ่มข้อมูลใหม่หรือฉายแสงใหม่ในข้อมูลที่นําเสนอ (ตัวอย่างเช่น เส้นอ้างอิงแบบไดนามิกที่แสดงแนวโน้มที่สําคัญ)
• ตัวเลือกใดก็ตามที่ควบคุมรูปลักษณ์และความรู้สึกของวิชวล (นั่นคือ การจัดรูปแบบ) ควรถูกจํากัดไว้ที่บานหน้าต่าง การจัดรูปแบบ

ข้อควรพิจารณาและข้อจํากัด

• บานหน้าต่าง Analytics ยังไม่มีการสนับสนุนหลายอินสแตนซ์ ตัวเลือก เดียว วัตถุสามารถมีได้คือ แบบคงที่ (นั่นคือ selector: null) และวิชวล Power BI ไม่สามารถมีอินสแตนซ์ของการ์ดที่ผู้ใช้กําหนดเองได้หลายอินสแตนซ์
• คุณสมบัติของชนิด integer แสดงอย่างไม่ถูกต้อง เนื่องจากเป็นการแก้ไขปัญหาชั่วคราว ให้ใช้ชนิด numeric แทน

เนื้อหาที่เกี่ยวข้อง

เพิ่ม การจัดรูปแบบตามเงื่อนไข