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

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

หมายเหตุ

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

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

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

สําหรับบานหน้าต่าง การวิเคราะห์ วัตถุถูกกําหนดดังต่อไปนี้:

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 และการ์ดจะถูกเพิ่มไปยังบานหน้าต่างการจัดรูปแบบ ดูการใช้งานต่อไปนี้:

การใช้ FormattingModel Utils

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

โดยไม่มี FormattingModel Utils

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

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

หมายเหตุ

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

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

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

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

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