Share via

Gegevenstypen voor variabelen

  • Artikel

Wanneer u variabelen in uw stromen maakt, converteert Power Automate ze naar een specifiek type op basis van hun inhoud.

Sommige van deze gegevenstypen worden veel gebruikt in de toepassing, zoals nummers, terwijl anderen, zoals browserinstanties, expliciete acties of groepen acties vereisen.

Eenvoudige gegevenstypen

Eenvoudige gegevenstypen vertegenwoordigen afzonderlijke waarden, zoals tekst en getallen. U kunt deze gegevenstypen zelfstandig gebruiken of om complexere gegevensstructuren te maken, zoals lijsten en datatabellen.

Tekstwaarde

Dit is een willekeurig type tekst, van e-mailadressen tot de tekstinhoud van een TXT-bestand.

Eigenschappen van gegevenstype Tekst

Als u een variabele Tekstwaarde wilt maken, gebruikt u de actie Variabele instellen en vult u de invoerparameter met de gewenste tekst zonder enige notatie.

Schermopname van een actie Variabele instellen waarmee een variabele voor tekstwaarde wordt gemaakt.

Numerieke waarde

Numeriek is het type dat op getallen wordt toegepast. Alleen dit gegevenstype kan worden gebruikt in wiskundige bewerkingen.

Als u een variabele Numerieke waarde wilt maken, gebruikt u de actie Variabele instellen en vult u de invoerparameter met een numerieke waarde zonder enige notatie.

Behalve hard gecodeerde numerieke waarden kunt u wiskundige expressies gebruiken met variabelen binnen procenttekens. Ga naar Variabelen en de %-notatie gebruiken voor meer informatie over wiskundige expressies.

Schermopname van een actie Variabele instellen waarmee een variabele voor een numerieke waarde wordt gemaakt.

Booleaanse waarde

De waarde kan Waar of Onwaar zijn.

Als u een variabele Booleaanse waarde wilt maken, gebruikt u de actie Variabele instellen en vult u de invoerparameter met de expressie %True% of %False%.

Bovendien kunt u complexe expressies maken met behulp van logische operatoren, variabelen en de percentagenotatie. Ga naar Variabelen en de %-notatie gebruiken voor meer informatie over logische expressies.

Schermopname van een actie Variabele instellen waarmee een variabele voor een Boole waarde wordt gemaakt.

Geavanceerde gegevenstypen

Geavanceerde datatypes vertegenwoordigen complexe gegevensstructuren. Ze fungeren als verzamelingen van andere gegevenstypen die u als één entiteit kunt openen.

Lijst

Lijsten zijn verzamelingen van items. Afhankelijk van het type van de afzonderlijke lijstitems, kunnen er lijsten met tekstwaarden, lijsten met numerieke waarden, enzovoort zijn. Het lijstgegevenstype is het equivalent van een array met één dimensie in programmeertermen.

U kunt een lijst maken via de actie Nieuwe lijst maken en een item toevoegen aan die lijst via de actie Item aan lijst toevoegen.

Schermopname van een stroom die een lijst maakt.

U kunt ook een lijst maken door middel van acties die lijsten genereren als uitvoer. De actie Tekst uit bestand lezen kan een lijst met tekstwaarden retourneren en de actie Bestanden in de map ophalen retourneert een lijst met bestanden.

Gebruik de volgende notatie om een specifiek item uit een lijst op te halen: %VariableName[ItemNumber]%

In het onderstaande voorbeeld slaat de stroom het eerste nummer van de eerder weergegeven lijst op in een nieuwe variabele. De index moet 0 zijn voor het eerste item van de lijst.

Schermopname van een expressie die toegang geeft tot het eerste item van een lijst.

Het is gebruikelijk om een actie Voor elk te gebruiken om de items van een lijst te doorlopen.

Als u alleen toegang wilt tot een specifiek deel van een lijst, gebruikt u de notatie %VariableName[StartIndex:StopIndex]%. Bijvoorbeeld de uitdrukking %List[2:4]% haalt het derde en vierde item van de lijst op. Het item in de positie StopIndex is de grens van de segmentering en wordt niet opgehaald.

Om een lijst van het begin tot een specifiek item te segmenteren, stelt u geen waarde voor StartIndex in, bijvoorbeeld %List[:4]%. Om een lijst van een specifieke index tot het eind te segmenteren, stelt u geen waarde voor StopIndex in, bijvoorbeeld %List[2:]%.

Eigenschappen van gegevenstype Lijst

Gegevenstabel

Gegevenstabellen bevatten gegevens in een tabelvorm en zijn het equivalent van tweedimensionale matrices in programmeertermen.

Een gegevenstabel bevat rijen en kolommen die de positie van elk item uniek beschrijven. Gegevenstabellen kunnen worden beschouwd als lijsten die gegevensrijen als items bevatten.

Schermopname van de inhoud van een gegevenstabelvariabele.

Power Automate biedt de actie Nieuwe gegevenstabel maken om nieuwe gegevenstabellen te genereren. Nadat u de actie hebt geïmplementeerd, kunt u de visuele opbouwfunctie gebruiken om waarden in te vullen en de naam van de kolomkoppen te wijzigen.

Schermopname van de visuele opbouwfunctie van de actie Nieuwe gegevenstabel maken.

Naast de actie Nieuwe gegevenstabel maken kunt u met nog drie acties gegevenstabellen maken om geëxtraheerde gegeven op te slaan: de acties Lezen uit Excel-werkblad, SQL-instructie uitvoeren en Gegevens extraheren uit webpagina.

U kunt ook een gegevenstabel maken met de actie Variabele instellen en de notatie voor programmeernotatie voor arrays. Deze notatie bestaat uit meerdere arrays met enkele dimensie, gescheiden door komma's en tussen accolades. De definitieve expressie moet de volgende vorm hebben %{['Product1', '10 USD'], ['Product2', '20 USD']}%.

Schermopname van een actie Variabele instellen waarmee een gegevenstabel wordt gemaakt.

Als u kolomkoppen wilt toevoegen terwijl u een nieuwe gegevenstabel maakt met de matrixnotatie, gebruikt u de expressie ^['ColumnName1', 'ColumnName2'] voor de eerste rij.

Schermopname van een actie Variabele instellen waarmee een nieuwe gegevenstabel met kolomkoppen wordt gemaakt.

Om een nieuwe rij aan een bestaande tabel toe te voegen, gebruik de actie Rij invoegen in gegevenstabel. U kunt ook een expressie maken met de variabelenaam van de gegevenstabel, een plusteken (+) en de waarden die u wilt toevoegen tussen haakjes.

Schermopname van een actie Variabele instellen waarmee een nieuwe rij aan een gegevenstabel wordt toegevoegd.

Naast het invoegen van rijen in gegevenstabellen, bieden bureaubladstromen verschillende acties om gegevenstabellen te manipuleren. U vindt een complete lijst met deze acties in de naslaginformatie over variabele-acties.

Gebruik de volgende notatie: %VariableName[RowNumber][ColumnNumber]% om een specifiek item van een gegevenstabel op te halen. RowNumber en ColumnNumber moeten 0 zijn voor het eerste item (rij of kolom).

Stel dat een stroom de inhoud van een Excel-werkblad ophaalt en opslaat in de variabele ExcelData. Gebruik de onderstaande uitdrukking om toegang te krijgen tot de eerste cel op de tweede rij van de opgehaalde tabel.

Schermopname van een expressie om toegang te krijgen tot de tweede cel van de eerste rij van een gelezen Excel-bestand.

Opmerking

De variabele ExcelData bevat een tabel met waarden die zijn geëxtraheerd uit een Excel-werkblad met de actie Lezen van Excel-werkblad. Het bevat enkele waarden van een specifiek werkblad en niet het hele Excel-bestand.

Als u toegang wilt tot een specifieke kolom in een gegevenstabel met kolomkoppen, gebruikt u de notatie %ExcelData[rowNumber]['ColumnName']%.

Als u een gegevenstabel doorloopt met de actie Voor elk, wordt de variabele die de gegevens van de huidige iteratie bevat, beschouwd als een gegevensrij.

Net als bij lijsten, gebruikt u de notatie %VariableName[StartRow:StopRow]% om toegang te krijgen tot een specifiek deel van een gegevenstabel. De expressie haalt alleen de rijen op die zijn gedefinieerd door de twee indexen, terwijl de positie StopRow de grens van de segmentering is en niet wordt opgehaald.

Om een gegevenstabel vanaf de eerste rij tot een specifieke rij te segmenteren, gebruikt u geen waarde voor StartRow, bijvoorbeeld %Datatable[:4]%. Om een gegevenstabel vanaf de eerste rij tot het einde te segmenteren, gebruikt u geen waarde voor StopRow, bijvoorbeeld %Datatable[2:]%.

Eigenschappen van gegevenstype Gegevenstabel

Gegevensrij

Een gegevensrij bevat de waarden van een enkele rij van een gegevenstabel. Als u een gegevenstabel doorloopt met de actie Voor elk, is de variabele die de gegevens van de huidige iteratie bevat, een gegevensrij.

Gebruik de volgende notatie: %VariableName[ItemNumber]% om een specifiek item van een gegevensrij op te halen.

U kunt ook de notatie %VariableName['ColumnName']% gebruiken. De naam van elke kolom wordt bepaald door de gegevenstabel waaruit u de gegevensrij hebt opgehaald.

Eigenschappen van gegevenstype Gegevensrij

Schermopname van de inhoud van een gegevensrijvariabele.

Aangepast object

Bevat paren van eigenschappen en waarden, die eenvoudig kunnen worden geconverteerd naar de JSON-indeling.

Als u een nieuw leeg aangepast object wilt maken, gebruikt u de actie Variabele instellen en vult u de volgende expressie %{{ }}%. Als u een nieuw aangepast object wilt maken en het wilt initialiseren met eigenschappen en waarden, gebruikt u een expressie van de volgende structuur: %{ 'Property1': 'Value1', 'Property2': 'Value2', 'Property3': 'Value2' }%.

Schermopname van een actie Variabele instellen waarmee een nieuw aangepast object wordt gemaakt.

Belangrijk

Gereserveerde trefwoorden kunnen niet worden gebruikt als aangepaste objecteigenschappen. Ga voor de volledige lijst met gereserveerde zoekwoorden naar Gereserveerde zoekwoorden in bureaubladstromen.

Om de waarde van een bestaande eigenschap bij te werken of een nieuwe toe te voegen, implementeert u een actie Variabele instellen, vult u de naam van de eigenschap in het veld Instellen en voert u de waarde ervan in het veld Op in.

Schermopname van een actie Variabele instellen waarmee een nieuwe eigenschap aan een aangepast object wordt toegevoegd.

Naast letterlijke waarden kunt u variabelen gebruiken om de eigenschappen en waarden van aangepaste objecten dynamisch in te stellen. De volgende stroom gebruikt bijvoorbeeld twee variabelen om een nieuwe eigenschap toe te voegen aan een nieuw leeg aangepast object.

Schermopname van een stroom die variabelen gebruikt waarmee een nieuwe eigenschap aan een aangepast object wordt toegevoegd.

Connectorobject

Connectorobjecten slaan informatie op van cloudconnectors en werken op dezelfde manier als aangepaste objecten. De eigenschappen ervan bevatten meestal lijsten met andere connectorobjecten. Toegang tot waarden werkt net als bij aangepaste objecten, hoewel voor toegang tot geneste waarden mogelijk ingewikkelder expressies nodig zijn.

Schermopname van een aangepaste objectvariabele in de viewer voor variabelen.

Lijst met PDF-tabelinformatie

Een variabele van dit gegevenstype kan alleen worden geproduceerd via de actie Tabellen extraheren uit PDF.

Elk item in de lijst beschrijft een geëxtraheerde tabel en biedt alle essentiële informatie hierover. Als u toegang wilt krijgen tot een specifiek informatie-item in een gegevenstabel, gebruikt u de notatie %VariableName[ItemNumber]%.

Schermopname van een lijst met PDF-tabelinformatie.

Elk lijstitem biedt vier eigenschappen waarmee u onafhankelijk een specifiek detail kunt ophalen. De volgende eigenschappen zijn beschikbaar:

  • DataTable: retourneert de geëxtraheerde tabel.
  • TableStartingPage: retourneert de index van de bestandspagina die het begin van de tabel bevat.
  • TableEndingPage: retourneert de index van de bestandspagina die het einde van de tabel bevat.
  • TableOrderInPage: retourneert de volgorde van de tabel op de pagina.

U kunt meer informatie over de eigenschappen van dit gegevenstype vinden in Eigenschappen van gegevenstypen voor variabelen.

Schermopname van de eigenschappen van een lijst met PDF-tabelinformatie.

Als u toegang wilt krijgen tot de waarde van een specifieke eigenschap, gebruikt u de notatie %VariableName[ItemNumber].PropertyName%. De volgende expressie retourneert bijvoorbeeld de gegevenstabelwaarde van het eerste item van de variabele ExtractedPDFTables.

Schermopname van de gegevenstabel in een lijst met variabelen voor PDF-tabelinformatie.

Bekende problemen en beperkingen

  • Probleem: wanneer een gegevenstabel of gegevensrijcel een item met meerdere regels bevat, geeft de viewer voor variabelewaarden alleen de eerste regel ervan weer.
  • Oplossingen: geen.

Exemplaren

Connecties

Overige

In deze sectie worden alle beschikbare gegevenstypen weergegeven die niet tot een van de voorgaande categorieën behoren.

Algemene waarde

  • Algemene waarde: dit gegevenstype wordt gebruikt tijdens het ontwerpen wanneer Power Automate het gegevenstype van een variabele of een invoerparameter niet kan definiëren. Algemene waarden worden tijdens runtime geconverteerd naar andere gegevenstypen op basis van hun gegevens.

Active Directory

  • Active Directory-vermelding: bevat een verbinding met een Active Directory-server die tot stand is gebracht via de actie Verbinding maken met server.
  • Groepsinfo: bevat de naam, de weergavenaam, een beschrijving en de leden van een opgegeven Active Directory-groep.
  • Groepslid: vertegenwoordigt een lid van een opgegeven Active Directory-groep.
  • Gebruikersinformatie: bevat informatie over een opgegeven Active Directory-gebruiker, zoals voornaam en achternaam, initialen en een DN-naam, werkgegevens (bedrijf, afdeling en titel), contactgegevens (telefoonnummer, toestelnummer en e-mailadres) en locatie (land/regio, stad, staat, adres en postcode).

Eigenschappen van gegevenstype Active Directory

Amazon Web Services (AWS)

  • EC2-client: bevat een EC2-sessie die is gemaakt via de actie EC2-sessie maken.
  • EC2-exemplaar: vertegenwoordigt een opgehaald EC2-exemplaar.
  • EC2-exemplaren informatie: bevat informatie over een EC2-exemplaar.
  • Statuswijziging exemplaar: bevat informatie over een EC2-exemplaar dat is gestart of gestopt.
  • EBS-momentopname: vertegenwoordigt een EBS-momentopname.
  • EBS-volume: vertegenwoordigt een EBS-volume.

Eigenschappen van gegevenstype AWS

Azure

  • Azure-client: bevat een Azure-sessie die is gemaakt via de actie Sessie maken.
  • Azure-resourcegroep: vertegenwoordigt een opgehaalde Azure-resourcegroep.
  • Beheerde Azure-schijf: vertegenwoordigt een opgehaalde Azure-schijf.
  • Azure-momentopname: vertegenwoordigt een Azure-momentopname.
  • Virtuele Azure-machine: vertegenwoordigt een opgehaalde virtuele Azure-machine.
  • Info over virtuele Azure-machine: bevat informatie over een virtuele Azure-machine.
  • Azure-abonnement: vertegenwoordigt een opgehaald Azure-abonnement.

Eigenschappen van gegevenstype Azure

CMD

  • CMD-sessie: bevat een CMD-sessie die is gemaakt via de actie CMD-sessie openen.

Eigenschappen van gegevenstype CMD

Datums en tijd

  • Datum/tijd: bevat datum- en tijdinformatie. Als u een datum-/tijdvariabele wilt maken via de actie Variabele instellen, vult u de invoerparameter met de expressies %d"dd-MM-yyyy HH:mm:ss.ff+zzz"%, waarbij:

    Notatie Beschrijving
    yyyy Jaar
    MM Maand
    dd Dag
    HH Uur
    mm Minuten
    ss Seconden
    ff Milliseconden
    zzz UTC-offset

    Met %d"2022-03-25"% wordt bijvoorbeeld de datum 25 maart 2022 toegewezen aan de doelvariabele.

Eigenschappen van gegevenstype van Datums en tijd

Email

  • E-mailbericht: vertegenwoordigt een e-mailbericht. De actie E-mails ophalen vult deze variabelen.

Eigenschappen van gegevenstype E-mail

Exchange

  • E-mailbericht van Exchange: vertegenwoordigt een e-mailbericht dat is opgehaald van een Exchange-server. De actie E-mailbericht van Exchange vult deze variabelen.

Eigenschappen van gegevenstype Exchange

Bestanden en mappen

  • Bestand: vertegenwoordigt een bestand.
  • Map: vertegenwoordigt een map.
  • FileSystemObject: vertegenwoordigt een map of een bestand. Dit gegevenstype wordt gebruikt in invoerparameters die mappen en bestanden accepteren.

Eigenschappen van gegevenstype Bestanden en mappen

FTP

  • FTP-bestand: vertegenwoordigt een FTP-bestand.
  • FTP-map: vertegenwoordigt een FTP-map

Eigenschappen van gegevenstype FTP

OCR

  • OCR-engine - Bevat een OCR-engine die is gemaakt via de actie OCR-engine maken.

Outlook

  • Outlook-e-mailbericht: vertegenwoordigt een Outlook-e-mailbericht. De actie E-mailberichten ophalen uit Outlook vult deze variabelen.

Eigenschappen van gegevenstype Outlook

Terminal

  • Terminalsessie: bevat een terminalsessie die is gemaakt via de actie Terminalsessie openen.

Eigenschappen van gegevenstype Terminal

XML

  • XML-knooppunt: bevat de inhoud van een XML-document. De actie XML-bestand uit bestand lezen vult deze variabelen.

Eigenschappen van gegevenstype XML

Error

  • Fout: bevat informatie over de laatst opgetreden fout in de bureaubladstroom. De actie Laatste fout ophalen maakt dit type variabele.

Fouteigenschappen