A Power BI-vizualizációk objektumai és tulajdonságai

Az objektumok a vizualizációhoz társított testreszabható tulajdonságokat írják le. Egy objektum több tulajdonsággal is rendelkezhet, és mindegyik tulajdonsághoz tartozik egy társított típus, amely leírja, hogy mi lesz a tulajdonság. Ez a cikk az objektumokról és a tulajdonságtípusokról nyújt tájékoztatást.

myCustomObject az a belső név, amely a belső objektumra dataViewvaló hivatkozáshoz használatos.

"objects": {
    "myCustomObject": {
        "properties": { ... }
    }
}

Megjelenített név és leírás

displayName a tulajdonságpanelen megjelenő név. description a formázási tulajdonság leírása, amely elemleírásként jelenik meg a felhasználó számára.

Tulajdonságok

properties a fejlesztő által definiált tulajdonságok térképe.

"properties": {
    "myFirstProperty": {
        "type": ValueTypeDescriptor | StructuralTypeDescriptor
    }
}

Példa:

"properties": {
    "show": {
        "type": {"bool": true}
    }
}

Tulajdonságtípusok

Két tulajdonságtípus létezik: ValueTypeDescriptor és StructuralTypeDescriptor.

Értéktípus-leíró

ValueTypeDescriptor típusok többnyire primitívek, és általában statikus objektumként használják.

Íme néhány gyakori ValueTypeDescriptor elem:

export interface ValueTypeDescriptor {
    text?: boolean;
    numeric?: boolean;
    integer?: boolean;
    bool?: boolean;
}

Szerkezeti típusleíró

StructuralTypeDescriptor a típusokat többnyire adathoz kötött objektumokhoz használják. A leggyakoribb StructuralTypeDescriptor típus a kitöltés.

export interface StructuralTypeDescriptor {
    fill?: FillTypeDescriptor;
}

Színátmenet tulajdonság

A színátmenet tulajdonság olyan tulajdonság, amely nem állítható be standard tulajdonságként. Ehelyett be kell állítania egy szabályt a színválasztó tulajdonság (kitöltés típusa) helyettesítéséhez.

Egy példa látható a következő kódban:

"properties": {
    "showAllDataPoints": {
        "type": {
            "bool": true
        }
    },
    "fill": {
        "type": {
            "fill": {
                "solid": {
                    "color": true
                }
            }
        }
    },
    "fillRule": {
        "type": {
            "fillRule": {}
        },
        "rule": {
            "inputRole": "Gradient",
            "output": {
                "property": "fill",
                    "selector": [
                        "Category"
                    ]
            }
        }
    }
}

Ügyeljen a kitöltési és fillRule-tulajdonságokra. Az első a színválasztó, a második pedig a kitöltési tulajdonságot lecserélő színátmenet helyettesítési szabálya, visuallyamikor teljesülnek a szabályfeltételek.

A kitöltési tulajdonság és a helyettesítési szabály közötti kapcsolat a"rule">"output" fillRule tulajdonság szakaszában van beállítva.

"Rule" > "InputRole" tulajdonság azt határozza meg, hogy melyik adatszerepkör aktiválja a szabályt (feltétel). Ebben a példában, ha az adatszerepkör "Gradient" adatokat tartalmaz, a szabály a "fill" tulajdonságra lesz alkalmazva.

A kitöltési szabályt (the last item) aktiváló adatszerepkörre az alábbi kódban látható példa:

{
    "dataRoles": [
            {
                "name": "Category",
                "kind": "Grouping",
                "displayName": "Details",
                "displayNameKey": "Role_DisplayName_Details"
            },
            {
                "name": "Series",
                "kind": "Grouping",
                "displayName": "Legend",
                "displayNameKey": "Role_DisplayName_Legend"
            },
            {
                "name": "Gradient",
                "kind": "Measure",
                "displayName": "Color saturation",
                "displayNameKey": "Role_DisplayName_Gradient"
            }
    ]
}

Formázás panel

A formázási panel tulajdonságainak testreszabásához használja az alábbi módszerek egyikét attól függően, hogy milyen API-verziót használ.

 const myCustomCard: powerbi.visuals.FormattingCard = {
            displayName: "My Custom Object Card",
            uid: "myCustomObjectCard_uid",
            groups: [{
                displayName: undefined,
                uid: "myCustomObjectGroup_uid",
                slices: [
                    {
                        uid: "myCustomProperty_uid",
                        displayName: "My Custom Property",
                        control: {
                            type: powerbi.visuals.FormattingComponent.ColorPicker,
                            properties: {
                                descriptor: {
                                    objectName: "myCustomObject",
                                    propertyName: "myCustomProperty",
                                    selector: null // selector is optional
                                },
                                value: { value: "#000000" }
                            }
                        }
                    }
                ],
            }],
        };

    "objects": {
        "myCustomObject": {
            "properties": {
                "myCustomProperty": {
                    "type": {
                         "fill": {
                            "solid": {
                                "color": true
                            }
                        }
                    }
                }
            }
        }
    }           

public enumerateObjectInstances(options: EnumerateVisualObjectInstancesOptions): VisualObjectInstanceEnumeration {
    let objectName: string = options.objectName;
    let objectEnumeration: VisualObjectInstance[] = [];

    switch( objectName ) {
        case 'myCustomObject':
            objectEnumeration.push({
                objectName: objectName,
                properties: { ... },
                selector: { ... }
            });
            break;
    };

    return objectEnumeration;
}

objectEnumeration.push({
    objectName: "customColor",
    displayName: "Custom Color",
    properties: {
        fill: {
            solid: {
                color: dataPoint.color
            }
        }
    },
    selector: null
});

Objektumválasztók típusai

A választó határozza enumerateObjectInstances meg, hogy az egyes objektumok hol vannak kötve a dataView-ban. Négy különböző lehetőség közül választhat:

• static
• Oszlopok
• szelektor
• hatókör identitása

static

Ez az objektum metaadatokhoz dataviews[index].metadata.objectsvan kötve, ahogy az itt látható.

selector: null

eltávolítása

Ez az objektum az egyező QueryNameoszlopokkal rendelkező oszlopokhoz van kötve.

selector: {
    metadata: 'QueryName'
}

szelektor

Ez az objektum a létrehozott selectionID elemhez van kötve. Ebben a példában feltételezzük, hogy létrehoztunk selectionIDnéhány adatpontot, és végighaladunk rajtuk.

for (let dataPoint in dataPoints) {
    ...
    selector: dataPoint.selectionID.getSelector()
}

Hatókör identitása

Ez az objektum bizonyos értékekhez van kötve a csoportok metszéspontjában. Ha például vannak kategóriái és adatsorai ["Jan", "Feb", "March", ...]["Small", "Medium", "Large"], érdemes lehet egy objektumot használnia az értékek metszéspontjában.FebLarge Ehhez lekérheti mindkét oszlopot, leküldheti őket a DataViewScopeIdentity változóba identities, és használhatja ezt a szintaxist a választóval.

selector: {
    data: <DataViewScopeIdentity[]>identities
}

Kapcsolódó tartalom

Teljesítménnyel kapcsolatos tippek