Power BI:n visualisointien toiminnot ja ominaisuudet

Jokaisella visualisoinnilla on capabilities.json-tiedosto , joka luodaan automaattisesti, kun suoritat komennon pbiviz new <visual project name> uuden visualisoinnin luomiseksi. capabilities.json tiedosto kuvaa visualisoinnin isännälle.

capabilities.json-tiedosto kertoo isännälle, millaisia tietoja visualisointi hyväksyy, mitä mukautettavia määritteitä ominaisuudet-ruutuun lisätään ja mitä muita tietoja visualisoinnin luomiseen tarvitaan. Ohjelmointirajapinnan versiosta 4.6.0 alkaen kaikki ominaisuusmallin ominaisuudet ovat valinnaisia lukuun ottamatta privileges-ominaisuuksia.

capabilities.json tiedosto näyttää pääobjektit seuraavassa muodossa:

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

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

• Oikeudet
• dataRoles
• dataViewMappings
• Objektit

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

Seuraavat muut pääobjektit ovat valinnaisia, ja ne voidaan lisätä tarvittaessa:

• työkaluvihjeet
• supportsHighlight
• lajittelu
• poraudu alaspäin
• expandCollapse
• supportsKeyboardFocus
• supportsSynchronizingFilterState
• advancedEditModeSupport
• supportsLandingPage
• supportsEmptyDataView
• supportsMultiVisualSelection
• Välisummat
• keepAllMetadataColumns
• muuttoliike

Löydät kaikki nämä objektit ja niiden parametrit capabilities.json rakenteesta

Oikeudet ovat erityisiä toimintoja, joihin visualisointi edellyttää käyttöoikeutta toimiakseen. Oikeudet ottavat objektien privilege matriisin, joka määrittää kaikki oikeusominaisuudet. Seuraavissa osioissa kuvataan oikeudet, jotka ovat käytettävissä Power BI:ssä.

JSON-oikeusmääritys sisältää seuraavat osat:

• name - (merkkijono) Oikeuden nimi.
• essential - (totuusarvo) Ilmaisee, edellyttääkö visualisointitoiminto tätä oikeutta. -arvo true tarkoittaa, että oikeus on pakollinen. false Se tarkoittaa, että oikeus ei ole pakollinen.
• parameters - (merkkijonomatriisi)(valinnainen) Argumentit. Jos parameters puuttuu, sitä pidetään tyhjänä matriisina.

Seuraavat ovat käyttöoikeustyyppejä, jotka on määritettävä:

• Ulkoisten resurssien käyttö
• Lataa tiedostoon
• Paikallisen tallennustilan oikeudet

Jos haluat sallia visualisoinnille ulkoisen resurssin tai verkkosivuston käyttämisen , lisää nämä tiedot oikeudena Ominaisuudet-osioon. Oikeuden määritys sisältää valinnaisen URL-osoitteiden luettelon, jota visualisointi voi käyttää muodossa http://xyz.com tai https://xyz.com. Jokainen URL-osoite voi sisältää yleismerkin alitoimialueiden määrittämiseen.

Seuraava koodi on esimerkki käyttöoikeusasetuksesta, joka sallii ulkoisten resurssien käytön:

{
    "name": "WebAccess",
    "essential": true,
    "parameters": [ "https://*.microsoft.com", "http://example.com" ]
}

Edellä oleva WebAccess oikeus tarkoittaa sitä, että visualisoinnin on käytettävä toimialueen alitoimialuetta microsoft.com vain HTTPS-protokollan kautta ja example.com ilman alitoimialueita HTTP:n kautta ja että tämä käyttöoikeusoikeus on välttämätön visualisoinnin toimimiseksi.

Jos haluat sallia käyttäjän viedä tietoja visualisoinnista tiedostoon, määritä ExportContent arvoksi true.

Tämän ExportContent asetuksen avulla visualisointi voi viedä tietoja tiedostoihin seuraavissa muodoissa:

• .txt
• .csv
• .json
• .tmplt
• .xml
• .pdf
• .xlsx

Tämä asetus on erilainen kuin organisaation vienti- ja jakamisasetuksissa käyttöön otetut latausrajoitukset.

Seuraava koodi on esimerkki oikeusasetuksesta, joka sallii lataamisen tiedostoon:

"privileges": [
    {
        "name": "ExportContent",
        "essential": true
    }
]

Tämän oikeuden avulla mukautettu visualisointi voi tallentaa tietoja käyttäjän paikalliseen selaimeen.

Seuraavassa on esimerkki käyttöoikeusasetuksesta, joka sallii paikallisen tallennustilan käytön:

"privileges": [
    {
        "name": "LocalStorage",
        "essential": true
    }
]

Jos visualisointi ei edellytä erityisiä käyttöoikeuksia, privileges -matriisin pitäisi olla tyhjä:

  "privileges": []

Seuraavassa esimerkissä näytetään, miten voit määrittää useita oikeuksia mukautetulle visualisoinnille.

"privileges": [
    {
        "name": "WebAccess",
        "essential": true,
        "parameters": [ "https://*.virtualearth.net" ]
    },
    {
        "name": "ExportContent",
        "essential": false
    }
]

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

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

Määritä DataRoles seuraavilla ominaisuuksilla:

• 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).

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

"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:

Objektit dataViewMappings kuvaavat, miten tietoroolit liittyvät toisiinsa, ja antavat sinun määrittää ehdollisia vaatimuksia näytettäville tietonäkymille.

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.

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 kuhunkin ominaisuuteen liittyy tyyppi.

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

Jos haluat esimerkiksi tukea dynaamisia muotoilumerkkijonoja mukautetussa visualisoinnissa, määritä seuraava objekti:

"objects": {
        "general": {
            "properties": {
                "formatString": {
                    "type": {
                        "formatting": {
                            "formatString": true
                        }
                    }
                }
            }
        },

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

• Power BI -visualisointien tietonäkymän yhdistämismääritykset
• Power BI:n visualisointien objektit ja ominaisuudet
• Power BI:n visualisointien lajitteluasetukset