ความสามารถและคุณสมบัติของวิชวล Power BICapabilities and properties of Power BI visuals

คุณใช้ความสามารถในการให้ข้อมูลกับโฮสต์เกี่ยวกับวิชวลของคุณYou use capabilities to provide information to the host about your visual. คุณสมบัติทั้งหมดบนแบบจำลองความสามารถเป็น optionalAll properties on the capabilities model are optional.

ออบเจ็กต์รูทของความสามารถของวิชวลคือ dataRoles, dataViewMappings และอื่น ๆThe root objects of a visual's capabilities are dataRoles, dataViewMappings, and so on.

{
    "dataRoles": [ ... ],
    "dataViewMappings": [ ... ],
    "objects":  { ... },
    "supportsHighlight": true|false,
    "advancedEditModeSupport": 0|1|2,
    "sorting": { ... }
}

กำหนดเขตข้อมูลที่วิชวลของคุณคาดหวัง: dataRolesDefine the data fields that your visual expects: dataRoles

เพื่อกำหนดเขตข้อมูลที่สามารถผูกกับข้อมูล ให้คุณใช้ dataRolesTo define fields that can be bound to data, you use dataRoles. dataRoles รับอาร์เรย์ของออบเจ็กต์ DataViewRole ซึ่งกำหนดคุณสมบัติที่จำเป็นทั้งหมดdataRoles takes an array of DataViewRole objects, which defines all the required properties.

คุณสมบัติProperties

  • ชื่อ: ชื่อภายในของเขตข้อมูลนี้ (ต้องไม่ซ้ำกัน)name: The internal name of this data field (must be unique).
  • ชนิด: ชนิดของเขตข้อมูล:kind: The kind of field:
    • Grouping: ค่าไม่ต่อเนื่องที่ใช้ในการจัดกลุ่มเขตข้อมูลหน่วยวัดGrouping: Discrete values that are used to group measure fields.
    • Measure: ค่าข้อมูลตัวเลขMeasure: Numeric data values.
    • GroupingOrMeasure: ค่าที่สามารถใช้เป็นการจัดกลุ่มหรือหน่วยวัดGroupingOrMeasure: Values that can be used as either a grouping or a measure.
  • displayName: ชื่อที่แสดงให้กับผู้ใช้ในบานหน้าต่างคุณสมบัติdisplayName: The name displayed to the user in the Properties pane.
  • คำอธิบาย: คำอธิบายแบบสั้นของเขตข้อมูล (เป็นทางเลือก)description: A short description of the field (optional).
  • requiredTypes: ชนิดของข้อมูลที่จำเป็นสำหรับบทบาทข้อมูลนี้requiredTypes: The required type of data for this data role. ค่าที่ไม่ตรงกันถูกตั้งค่าเป็น null (เป็นทางเลือก)Values that don't match are set to null (optional).
  • preferredTypes: ชนิดของข้อมูลที่ต้องการสำหรับบทบาทข้อมูลนี้ (เป็นทางเลือก)preferredTypes: The preferred type of data for this data role (optional).

ชนิดข้อมูลที่ถูกต้องใน requiredTypes และ preferredTypesValid data types in requiredTypes and preferredTypes

  • bool: ค่าบูลีนbool: A boolean value
  • integer: ค่าจำนวนเต็ม (จำนวนเต็ม)integer: An integer (whole number) value
  • numeric: ค่าตัวเลขnumeric: A numeric value
  • text: ค่าข้อความtext: A text value
  • geography: ข้อมูลทางภูมิศาสตร์geography: A geographic data

ตัวอย่าง:Example

"dataRoles": [
    {
        "displayName": "My Category Data",
        "name": "myCategory",
        "kind": "Grouping",
        "requiredTypes": [
            {
                "text": true
            },
            {
                "numeric": true
            },
            {
                "integer": true
            }
        ],
        "preferredTypes": [
            {
                "text": true
            }
        ]
    },
    {
        "displayName": "My Measure Data",
        "name": "myMeasure",
        "kind": "Measure",
        "requiredTypes": [
            {
                "integer": true
            },
            {
                "numeric": true
            }
        ],
        "preferredTypes": [
            {
                "integer": true
            }
        ]
    },
    {
        "displayNameKey": "Visual_Location",
        "name": "Locations",
        "kind": "Measure",
        "displayName": "Locations",
        "requiredTypes": [
            {
                "geography": {
                    "address": true
                }
            },
            {
                "geography": {
                    "city": true
                }
            },
            {
                "geography": {
                    "continent": true
                }
            },
            {
                "geography": {
                    "country": true
                }
            },
            {
                "geography": {
                    "county": true
                }
            },
            {
                "geography": {
                    "place": true
                }
            },
            {
                "geography": {
                    "postalCode": true
                }
            },
            {
                "geography": {
                    "region": true
                }
            },
            {
                "geography": {
                    "stateOrProvince": true
                }
            }
        ]
    }
]

บทบาทข้อมูลก่อนหน้านี้จะสร้างเขตข้อมูลที่แสดงในรูปภาพต่อไปนี้:The preceding data roles would create the fields that are displayed in the following image:

เขตข้อมูลบทบาทข้อมูล

กำหนดวิธีที่คุณต้องการแมปข้อมูล - dataViewMappingsDefine how you want the data mapped: dataViewMappings

คุณสมบัติ DataViewMapping จะอธิบายว่าบทบาทข้อมูลเกี่ยวข้องกันอย่างไรและอนุญาตให้คุณระบุข้อกำหนดเงื่อนไขสำหรับบทบาทดังกล่าวได้A DataViewMappings property describes how the data roles relate to each other and allows you to specify conditional requirements for the them.

การแสดงภาพส่วนใหญ่ให้การแมปเดียวแต่คุณสามารถใส่หลาย dataViewMappings ได้Most visuals provide a single mapping, but you can provide multiple dataViewMappings. การแมปที่ถูกต้องแต่ละครั้งจะสร้างมุมมองข้อมูลEach valid mapping produces a data view.

"dataViewMappings": [
    {
        "conditions": [ ... ],
        "categorical": { ... },
        "table": { ... },
        "single": { ... },
        "matrix": { ... }
    }
]

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ ทำความเข้าใจเกี่ยวกับการแมปมุมมองข้อมูลในวิชวล Power BIFor more information, see Understand data view mapping in Power BI visuals.

กำหนดตัวเลือกบานหน้าต่างคุณสมบัติ: ออบเจ็กต์Define property pane options: objects

ออบเจ็กต์อธิบายคุณสมบัติแบบปรับแต่งได้ที่เกี่ยวข้องกับวิชวลObjects describe customizable properties that are associated with the visual. ออบเจ็กต์แต่ละชนิดสามารถมีคุณสมบัติได้หลายรายการและแต่ละคุณสมบัติมีชนิดที่สัมพันธ์กันEach object can have multiple properties, and each property has a type that's associated with it. ชนิดอ้างอิงถึงสิ่งที่คุณสมบัติจะเป็นTypes refer to what the property will be.

"objects": {
    "myCustomObject": {
        "displayName": "My Object Name",
        "properties": { ... }
    }
}

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ ออบเจ็กต์และคุณสมบัติของวิชวล Power BIFor more information, see Objects and properties of Power BI visuals.

จัดการการเน้นบางส่วน: supportsHighlightHandle partial highlighting: supportsHighlight

ตามค่าเริ่มต้น ค่านี้จะถูกตั้งค่าเป็น false ซึ่งหมายความว่าค่าของคุณจะถูกกรองโดยอัตโนมัติเมื่อมีการเลือกบางสิ่งในหน้าBy default, this value is set to false, which means that your values are automatically filtered when something on the page is selected. การกรองอัตโนมัตินี้จะอัปเดตวิชวลของคุณให้แสดงเฉพาะค่าที่เลือกเท่านั้นThis automatic filtering in turn updates your visual to display only the selected value. หากคุณต้องการแสดงข้อมูลทั้งหมด แต่เน้นเฉพาะรายการที่คุณเลือกเท่านั้น คุณต้องตั้งค่า supportsHighlight เป็น true ในไฟล์ capabilities.json ของคุณIf you want to display the full data but highlight only the selected items, you need to set supportsHighlight to true in your capabilities.json file.

สำหรับข้อมูลเพิ่มเติม โปรดดูหัวข้อ การเน้นจุดข้อมูลในวิชวล Power BIFor more information, see Highlight data points in Power BI visuals.

จัดการโหมดแก้ไขขั้นสูง: advancedEditModeSupportHandle advanced edit mode: advancedEditModeSupport

วิชวลสามารถประกาศการสนับสนุนของโหมดแก้ไขขั้นสูงได้A visual can declare its support of advanced edit mode. ตามค่าเริ่มต้น วิชวลไม่สนับสนุนโหมดแก้ไขขั้นสูง เว้นแต่ว่าจะมีการระบุไว้เป็นอย่างอื่นในไฟล์ capabilities.jsonBy default, a visual doesn't support advanced edit mode, unless stated otherwise in the capabilities.json file.

สำหรับข้อมูลเพิ่มเติม โปรดดูหัวข้อ โหมดแก้ไขขั้นสูงในวิชวล Power BIFor more information, see Advanced edit mode in Power BI visuals.

ตัวเลือกการเรียงลำดับข้อมูลสำหรับวิชวล: การเรียงลำดับData sorting options for visual: sorting

การแสดงผลด้วยภาพสามารถกำหนดพฤติกรรมการเรียงลำดับผ่านความสามารถA visual can define its sorting behavior via its capabilities. ตามค่าเริ่มต้น วิชวลไม่รองรับการแก้ไขคำสั่งการเรียงลำดับเว้นแต่จะระบุไว้เป็นอย่างอื่นในไฟล์ capabilities.jsonBy default, a visual doesn't support modifying its sorting order, unless stated otherwise in the capabilities.json file.

สำหรับข้อมูลเพิ่มเติม โปรดดูหัวข้อ ตัวเลือกการเรียงลำดับสำหรับวิชวล Power BIFor more information, see Sorting options for Power BI visuals.