Share via

Werkmapparameters

  • Artikel

Met behulp van parameters kunt u invoer van consumenten verzamelen en ernaar verwijzen in andere delen van een werkmap. Deze wordt meestal gebruikt om het bereik van de resultatenset te bepalen of de juiste visual in te stellen. U kunt interactieve rapporten en ervaringen maken met behulp van deze belangrijke mogelijkheid.

Wanneer u werkmappen gebruikt, kunt u bepalen hoe uw parameterbesturingselementen worden gepresenteerd aan consumenten. Dit kunnen tekstvakken versus vervolgkeuzelijsten, enkele of meervoudige selectie en waarden uit tekst, JSON, KQL of Azure Resource Graph zijn.

Ondersteunde parametertypen zijn onder andere:

  • Tijd: hiermee kunt u kiezen uit vooraf ingevulde tijdsbereiken of een aangepast bereik selecteren
  • Vervolgkeuzelijst: hiermee kunt u een keuze maken uit een waarde of een set waarden
  • Groep Opties: hiermee kunt u één waarde selecteren uit een bekende set
  • Tekst: hiermee kunt u willekeurige tekst invoeren
  • Criteria: hiermee kunt u een set criteria definiëren op basis van eerder opgegeven parameters, die worden geëvalueerd om een dynamische waarde op te geven
  • Resource: hiermee kunt u een of meer Azure-resources selecteren
  • Abonnement: hiermee kunt u een of meer Azure-abonnementsresources selecteren
  • Meerdere waarden: hiermee kunt u een of meer willekeurige tekstwaarden instellen
  • Resourcetype: hiermee kunt u een of meer azure-resourcetypewaarden selecteren
  • Locatie: hiermee kunt u een of meer Azure-locatiewaarden selecteren

Naar een parameter verwijzen

U kunt verwijzen naar parameterwaarden uit andere delen van werkmappen met behulp van bindingen of waarde-uitbreidingen.

Verwijzen naar een parameter met bindingen

In dit voorbeeld ziet u hoe u verwijst naar een tijdsbereikparameter met bindingen:

  1. Selecteer Query toevoegen om een query-besturingselement toe te voegen en selecteer vervolgens een Application Insights-resource.

  2. Open de vervolgkeuzelijst Tijdsbereik en selecteer de optie Tijdsbereik in de sectie Parameters onderaan:

    • Met deze optie wordt de parameter tijdsbereik gekoppeld aan het tijdsbereik van de grafiek.
    • Het tijdsbereik van de voorbeeldquery is nu Afgelopen 24 uur.

  3. Voer de query uit om de resultaten te zien.

    Schermopname van een tijdsbereikparameter waarnaar wordt verwezen via bindingen.

Verwijzen naar een parameter met KQL

In dit voorbeeld ziet u hoe u verwijst naar een tijdsbereikparameter met KQL:

  1. Selecteer Query toevoegen om een query-besturingselement toe te voegen en selecteer vervolgens een Application Insights-resource.

  2. Voer in de KQL een tijdsbereikfilter in met behulp van de parameter | where timestamp {TimeRange}:

    • Met deze parameter wordt de evaluatietijd van de query uitgebreid naar | where timestamp > ago(1d).
    • Deze optie is de waarde van het tijdsbereik van de parameter.

  3. Voer de query uit om de resultaten te zien.

    Schermopname van een tijdsbereik waarnaar wordt verwezen in de KQL-query.

Naar een parameter verwijzen met tekst

In dit voorbeeld ziet u hoe u met tekst naar een parameter voor een tijdsbereik verwijst:

  1. Voeg een tekst besturingselement toe aan de werkmap.
  2. Voer in markdown in The chosen time range is {TimeRange:label}.
  3. Selecteer Klaar met bewerken.
  4. Het tekst besturingselement toont de tekst Het gekozen tijdsbereik is Afgelopen 24 uur.

Opties voor het opmaken van parameters

Elk parametertype heeft zijn eigen opmaakopties. Gebruik de sectie Voorbeelden van het deelvenster Parameter bewerken om de opmaakuitbreidingsopties voor uw parameter te bekijken.

Schermopname van parameteropties voor tijdsbereik.

U kunt deze opties gebruiken om alle parametertypen op te maken, met uitzondering van tijdsbereikkiezer. Zie Opties voor tijdparameters voor voorbeelden van opmaaktijden.

Andere parametertypen zijn:

  • Resourcekiezer: Resource-id's zijn opgemaakt.
  • Abonnementkiezer: Abonnementswaarden worden opgemaakt.

Toml converteren naar json

Syntaxis: {param:tomltojson}

Oorspronkelijke waarde:

name = "Sam Green"

[address]
state = "New York"
country = "USA"

Opgemaakte waarde:

{
  "name": "Sam Green",
  "address": {
    "state": "New York",
    "country": "USA"
  }
}

Escape JSON

Syntaxis: {param:escapejson}

Oorspronkelijke waarde:

{
	"name": "Sam Green",
	"address": {
		"state": "New York",
		"country": "USA"
  }
}

Opgemaakte waarde:

{\r\n\t\"name\": \"Sam Green\",\r\n\t\"address\": {\r\n\t\t\"state\": \"New York\",\r\n\t\t\"country\": \"USA\"\r\n  }\r\n}

Tekst coderen naar base64

Syntaxis: {param:base64}

Oorspronkelijke waarde:

Sample text to test base64 encoding

Opgemaakte waarde:

U2FtcGxlIHRleHQgdG8gdGVzdCBiYXNlNjQgZW5jb2Rpbmc=

Parameters opmaken met behulp van JSONPath

Voor tekenreeksparameters die JSON-inhoud zijn, kunt u JSONPath gebruiken in de tekenreeks voor parameterindeling.

U hebt bijvoorbeeld een tekenreeksparameter met de naam selection die het resultaat is van een query of selectie in een visualisatie met de volgende waarde:

{ "series":"Failures", "x": 5, "y": 10 }

Met behulp van JSONPath kunt u afzonderlijke waarden ophalen uit dat object:

Indeling Resultaat
{selection:$.series} Failures
{selection:$.x} 5
{selection:$.y} 10

Notitie

Als de parameterwaarde geen geldige JSON is, is het resultaat van de indeling een lege waarde.

Parameterstijl

De volgende stijlen zijn beschikbaar voor de parameters.

Pillen

De stijl van de pillen is de standaardstijl. De parameters zien eruit als tekst en vereisen dat de gebruiker deze eenmaal selecteert om in de bewerkingsmodus te gaan.

Schermopname van de leesmodus in pillenstijl van Azure Workbooks.

Schermopname van de bewerkingsmodus in pillenstijl van Azure Workbooks.

Standard

In de standaardstijl zijn de besturingselementen altijd zichtbaar, met een label boven het besturingselement.

Schermopname van de standaardstijl Azure Workbooks.

Formulier horizontaal

In horizontale vormstijl zijn de besturingselementen altijd zichtbaar, met het label aan de linkerkant van het besturingselement.

Schermopname van de horizontale stijl Van Azure Workbooks.

Formulier verticaal

In verticale vormstijl zijn de besturingselementen altijd zichtbaar, met het label boven het besturingselement. In tegenstelling tot de standaardstijl is er slechts één label of besturingselement in één rij.

Schermopname van de verticale stijl azure-werkmappen.

Notitie

In standaard-, horizontale en formulier verticale indelingen is er geen concept van inline bewerken. De besturingselementen staan altijd in de bewerkingsmodus.

Globale parameters

Nu u hebt geleerd hoe parameters werken en de beperkingen voor het alleen kunnen gebruiken van een parameter 'downstream' van waar deze is ingesteld, is het tijd om meer te weten te komen over globale parameters, die deze regels wijzigen.

Met een globale parameter moet de parameter nog steeds worden gedeclareerd voordat deze kan worden gebruikt. Maar elke stap waarmee een waarde voor die parameter wordt ingesteld, is van invloed op alle exemplaren van die parameter in de werkmap.

Notitie

Omdat het wijzigen van een globale parameter dit 'alles bijwerken'-gedrag heeft, moet de globale instelling alleen worden ingeschakeld voor parameters waarvoor dit gedrag is vereist. Een combinatie van globale parameters die van elkaar afhankelijk zijn, kan een cyclus of oscillatie creëren waarbij de concurrerende werelden elkaar steeds opnieuw veranderen. Om cycli te voorkomen, kunt u een parameter die is gedeclareerd als globaal niet opnieuw declareren. Eventuele volgende declaraties van een parameter met dezelfde naam maken een parameter met het kenmerk Alleen-lezen die niet op die plaats kan worden bewerkt.

Algemeen gebruik van globale parameters:

  1. Tijdsbereiken synchroniseren tussen een groot aantal grafieken:

    • Zonder een globale parameter wordt een tijdsbereikpenseel in een grafiek alleen na die grafiek geëxporteerd. Als u dus een tijdsbereik selecteert in de derde grafiek, wordt alleen de vierde grafiek bijgewerkt.
    • Met een globale parameter kunt u een globale timeRange-parameter maken, deze een standaardwaarde geven en alle andere grafieken deze laten gebruiken als hun gebonden tijdsbereik en tijdspenseeluitvoer. Stel bovendien de instelling Alleen de parameter exporteren wanneer een bereik wordt geborsteld in. Elke wijziging van het tijdsbereik in een grafiek werkt de algemene parameter timeRange boven aan de werkmap bij. Deze functionaliteit kan worden gebruikt om een werkmap te laten fungeren als een dashboard.

  2. Het wijzigen van het geselecteerde tabblad in een koppelingsstap toestaan via koppelingen of knoppen:

    • Zonder een globale parameter wordt met de koppelingsstap alleen een parameter voor het geselecteerde tabblad uitgevoerd.
    • Met een globale parameter kunt u een globale parameter selectedTab maken. Vervolgens kunt u die parameternaam gebruiken in de tabselecties in de koppelingsstap. U kunt die parameterwaarde doorgeven aan de werkmap via een koppeling of door een andere knop of koppeling te gebruiken om het geselecteerde tabblad te wijzigen. Het gebruik van knoppen uit een koppelingsstap op deze manier kan een wizard-achtige ervaring zijn, waarbij knoppen onder aan een stap invloed kunnen hebben op de zichtbare secties erboven.

Een globale parameter maken

Wanneer u de parameter in een parameterstap maakt, gebruikt u de optie Deze parameter behandelen als een globale optie in Geavanceerde instellingen. De enige manier om een globale parameter te maken, is door deze te declareren met een parameterstap. De andere methoden voor het maken van parameters, via selecties, borstelen, koppelingen, knoppen en tabbladen, kunnen alleen een globale parameter bijwerken. Ze kunnen er zelf geen verklaren.

Schermopname van het instellen van globale parameters in een werkmap.

De parameter is beschikbaar en werkt zoals normale parameters doen.

De waarde van een bestaande globale parameter bijwerken

Voor het grafiekvoorbeeld is de meest voorkomende manier om een globale parameter bij te werken met behulp van time brushing.

In dit voorbeeld wordt de parameter timerange gedeclareerd als globaal. Maak in een querystap eronder een query die gebruikmaakt van die tijdsbereikparameter in de query en retourneert een tijddiagramresultaat. Schakel in Geavanceerde instellingen voor de querystap de instelling voor het borstelen van tijdsbereik in. Gebruik dezelfde parameternaam als de uitvoer voor de parameter time brush. Selecteer ook de optie Alleen de parameter exporteren wanneer een bereik wordt geborsteld .

Schermopname van de algemene tijdpenseelinstelling in een werkmap.

Wanneer een tijdsbereik in deze grafiek wordt geborsteld, wordt ook de parameter timerange boven deze query en de querystap zelf bijgewerkt, omdat deze ook afhankelijk is van tijdsbereik.

  1. Voordat u gaat borstelen:

    • Het tijdsbereik wordt weergegeven als Afgelopen uur.
    • In de grafiek ziet u het laatste uur aan gegevens.

    Schermopname van het instellen van globale parameters voordat u gaat poetsen.

  2. Tijdens het borstelen:

    • Het tijdsbereik is nog steeds het laatste uur en de borstelcontouren worden getekend.
    • Er zijn geen parameters gewijzigd. Nadat u het penseel hebt losgelaten, wordt het tijdsbereik bijgewerkt.

    Schermopname van het instellen van globale parameters tijdens het borstelen.

  3. Na het borstelen:

    • Het tijdsbereik dat is opgegeven door het tijdspenseel, wordt door deze stap ingesteld. Hiermee wordt de globale waarde overschreven. In de vervolgkeuzelijst tijdsbereik wordt nu dat aangepaste tijdsbereik weergegeven.
    • Omdat de globale waarde bovenaan is gewijzigd en omdat deze grafiek afhankelijk is van tijdsbereik als invoer, wordt het tijdsbereik van de query die in de grafiek wordt gebruikt, ook bijgewerkt. Als gevolg hiervan worden de query en de grafiek bijgewerkt.
    • Alle andere stappen in de werkmap die afhankelijk zijn van tijdsbereik , worden ook bijgewerkt.

    Schermopname van het instellen van globale parameters na het poetsen.

    Notitie

    Als u geen globale parameter gebruikt, wordt de parameterwaarde timerange alleen gewijzigd onder deze querystap. Items boven deze stap of dit item zelf worden niet bijgewerkt.