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:

• Vihjeet
• supportsHighlight
• Lajittelu
• poraudu alaspäin
• expandCollapse
• supportsKeyboardFocus
• supportsSynchronizingFilterState
• advancedEditModeSupport
• supportsLandingPage
• supportsEmptyDataView
• supportsMultiVisualSelection
• Välisummat
• keepAllMetadataColumns
• Siirron

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

oikeudet: määritä visualisointisi edellyttämät erityisoikeudet

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ä.

Muistiinpano

Ohjelmointirajapinnan versiossa 4.6.0 käyttöoikeudet on määritettävä capabilities.json -tiedostossa. Aiemmissa versioissa etäkäyttöoikeus myönnetään automaattisesti, eikä tiedostojen lataaminen ole mahdollista. Jos haluat tietää, mitä versiota käytät, tarkista apiVersionpbiviz.json .

Määritä oikeudet

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

Muistiinpano

Vaikka nämä visualisoinnissa annetut oikeudet myönnetään, järjestelmänvalvojan on otettava käyttöön valitsin järjestelmänvalvojan asetuksissa, jotta organisaation käyttäjät voivat hyötyä näistä asetuksista.

Salli verkkokäyttö

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.

Lataa tiedostoon

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

Paikallisen tallennustilan oikeudet

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

Oikeuksia ei tarvita

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

  "privileges": []

Useita käyttöoikeuksia

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

dataroles: määritä tietokentät, joita visualisointi odottaa

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.

DataRole-ominaisuudet

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

Kelvolliset tietotyypit tyypeille requiredTypes ja preferredTypes

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

esimerkki dataRoles

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

dataViewMappings: miten haluat yhdistää tiedot

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.

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

Liittyvä sisältö

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