Power BI:n visualisointien toiminnot ja ominaisuudet

Jokaisessa visualisoinnissa on capabilities.json-tiedosto , joka kuvaa visualisoinnin isännälle. capabilities.json-tiedosto kertoo isännälle, millaisia tietoja visualisointi hyväksyy, mitä mukautettavia määritteitä ominaisuudet-ruutuun asetetaan ja mitä muita tietoja visualisoinnin luomiseen tarvitaan. Kaikki capabilities.json-tiedoston ominaisuudet ovat valinnaisia.

capabilities.json-tiedoston muoto on seuraava:

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

Kun luot uuden visualisoinnin, capabilities.json-oletustiedosto sisältää seuraavat pääobjektit:

Edellä olevat objektit tarvitaan tietojen sidonnassa. Niitä voidaan muokata visualisoinnin tarpeen mukaan.

Seuraavat pääobjektit voidaan lisätä tarpeen mukaan:

Kaikki nämä objektit ja niiden parametrit löytyvät capabilities.json-rakenteen avulla

data roles: määritä tietokentät, joita visualisointi odottaa

Tietoihin sidottavien kenttien määrittämisessä käytetään kohdetta dataRoles. dataRoles on objektien DataViewRole matriisi, joka määrittää kaikki vaaditut ominaisuudet. Objektit dataRoles ovat kenttiä , jotka näkyvät Ominaisuudet-ruudussa.

Käyttäjä vetää tietokentät niihin sitoakseen tiedot tietokenttiin objekteihin.

DataRole-ominaisuudet

DataRoles määritetään seuraavien ominaisuuksien avulla:

  • name: Tämän tietokentän sisäinen nimi (oltava yksilöivä).
  • displayName: Nimi, joka näytetään käyttäjälle Ominaisuudet-ruudussa.
  • kind: Kentän tyyppi:
    • Grouping: Joukko erillisiä arvoja, joita käytetään mittarikenttien ryhmittelemiseen.
    • Measure: Yksittäiset numeeriset arvot.
    • GroupingOrMeasure: Arvoja, joita voidaan käyttää joko ryhmittelynä tai mittarina.
  • description: Kentän lyhyt tekstin kuvaus (valinnainen).
  • requiredTypes: Tämän tietoroolin vaadittu tietotyyppi. Arvot, jotka eivät täsmää, saavat tyhjäarvon (valinnainen).
  • preferredTypes: Tämän tietoroolin ensisijainen tietotyyppi (valinnainen).

Kelvolliset tietotyypit tyypeille requiredTypes ja preferredTypes

  • bool: Totuusarvo
  • integer: Kokonaislukuarvo
  • numeric: Numeerinen arvo
  • text: Tekstiarvo
  • geography: Maantieteellinen tieto

esimerkki dataRolesista

"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
            }
        ]
    }
]
...
}

Edellä olevat tietoroolit loisivat kentät, jotka näkyvät seuraavassa kuvassa:

Data role fields

dataViewMappings: miten haluat yhdistää tiedot

Objektit dataViewMappings kuvaavat, miten tietoroolit liittyvät toisiinsa, ja niiden avulla voit määrittää ehdollisia vaatimuksia tietonäkymien näyttämiselle.

Useimmat visualisoinnit tarjoavat yhden yhdistämismäärityksen, mutta voit tehdä useita dataViewMapping-määrityksiä. Jokainen kelvollinen yhdistäminen tuottaa tietonäkymän.

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

Lisätietoja on artikkelissa Power BI -visualisointien tietonäkymän yhdistämismääritykset.

objects: määritä ominaisuusruudun asetukset

Objektit kuvailevat visualisointiin liittyviä mukautettavia ominaisuuksia. Tässä osiossa määritetyt objektit ovat objekteja, jotka näkyvät Muotoilu-ruudussa. Jokaisella objektilla voi olla useita ominaisuuksia, ja jokaiseen ominaisuuteen liittyy tyyppi.

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

Lisätietoja on artikkelissa Power BI:n visualisointien objektit ja ominaisuudet.

Seuraavat vaiheet