Variable datatyper

Når du opretter variabler i dine flow, konverterer Power Automate dem til en bestemt type på baggrund af deres indhold.

Nogle af disse datatyper bruges i hele programmet, f.eks. tal, mens andre, f.eks. browserforekomster, kræver eksplicitte handlinger eller grupper af handlinger.

Simple datatyper

Simple datatyper repræsenterer enkelte værdier, f.eks. tekster og tal. Du kan bruge disse datatyper uafhængigt eller bruge dem til at oprette mere komplekse datastrukturer, f.eks. lister og datatabeller.

Tekstværdi

Denne datatype repræsenterer enhver form for tekst fra mailadresser til tekstindholdet i en .txt fil.

Tekstdatatypeegenskaber

Hvis du vil oprette en variabel af typen Tekstværdi , skal du bruge handlingen Angiv variabel og angive den ønskede tekst uden nogen notation.

Skærmbillede af handlingen Angiv variabel, der opretter en tekstværdivariabel.

Numerisk værdi

Numerisk er den type, der anvendes på tal. Det er kun denne datatype, der kan bruges i forbindelse med matematiske operationer.

Brug handlingen Angiv variabel, og angiv et tal uden notation for at oprette en numerisk værdivariabel.

Med undtagelse af hardcodede numeriske værdier kan du bruge udtryk med variabler mellem procenttegn. Du kan få flere oplysninger om matematiske udtryk under Brug variabler og %-notationen.

Skærmbillede af handlingen Angiv variabel, der opretter en variabel af typen numerisk værdi.

Boolsk værdi

Værdien kan enten være Sand eller Falsk.

Hvis du vil oprette en boolesk værdivariabel , skal du bruge handlingen Angiv variabel og angive udtryk %True% eller %False% i inputparameteren.

Du kan også oprette komplekse udtryk ved hjælp af logiske operatorer, variabler og procentnotationen. Du kan få flere oplysninger om logiske udtryk under Brug variabler og notationen %.

Skærmbillede af handlingen Angiv variabel, der opretter en variabel af typen boolesk værdi.

Avancerede datatyper

Avancerede datatyper repræsenterer komplekse datastrukturer. De fungerer som samlinger af andre datatyper, du kan få adgang til som én enhed.

Liste

Lister er samlinger af elementer. Afhængigt af typerne af de enkelte listeelementer kan der være lister over tekstværdier, lister over numeriske værdier osv. Listedatatypen svarer til et array med en enkelt dimension i programmeringssprog.

Du kan oprette en liste ved hjælp af handlingen Opret ny liste og føje et element til listen via handlingen Føj element til liste.

Skærmbillede af et flow, der opretter en liste.

Du kan også oprette en liste via handlinger, der opretter lister som output. Handlingen Læs tekst fra fil kan f.eks. returnere en liste over tekstværdier, og handlingen Hent filer i mappen returnerer en liste over filer.

Hvis du vil hente et bestemt element på en liste, skal du bruge følgende notation: %VariableName[ItemNumber]%

I følgende eksempel nedenfor gemmes det første nummer af den tidligere viste liste til en ny variabel i flowet. Vær opmærksom på, at indekset skal være 0 for det første element på listen.

Skærmbillede af et udtryk, der giver adgang til det første element på en liste.

Almindelig praksis er at bruge en For hver-handling til at iterere gennem elementerne i en liste.

Hvis du kun har brug for at få adgang til en bestemt del af en liste, skal du bruge notationen %VariableName[StartIndex:StopIndex]%. Udtrykket %List[2:4]% henter f.eks. det tredje og fjerde punkt på listen. Elementet i positionen StopIndex er grænsen for udsnittet og hentes ikke.

Hvis du vil lave et udsnit af en liste fra start til et bestemt element, skal du ikke angive værdien StartIndex, f.eks. %List[:4]%. Hvis du vil lave et udsnit af en liste fra et bestemt indeks til slutningen, skal du ikke angive værdien StopIndex, f.eks. %List[2:]%.

Egenskaber for listedatatype

Datatable

datatabeller indeholder data i tabelform og svarer til todimensionelle arrays i programmering.

En datatabel indeholder rækker og kolonner, der beskriver hvert enkelt elements placering entydigt. Du kan betragte datatables som lister, der indeholder datarows, som elementer.

Skærmbillede af indholdet af en variabel af typen datatabel.

Power Automate indeholder handlingen Opret ny datatabel til oprettelse af nye datatabeller. Når du har implementeret handlingen, kan du bruge den visuelle builder til at udfylde værdierne og omdøbe kolonneoverskrifterne.

Skærmbillede af den visuelle builder til handlingen Opret ny datatabel.

Ud over handlingen Opret ny datatabel opretter yderligere tre handlinger datatabler til lagring af udtrukne data: handlingerne Læs fra Excel regneark, Udfør SQL-sætning og Udtræk data fra webside.

Du kan også oprette en datatabel ved hjælp af handlingen Angiv variablen og programmeringsmatrixnotationen. Denne notation består af flere endimensionelle arrays, der er adskilt af kommaer og er lukket i krøllede klammer. Det endelige udtryk skal have følgende form: %{['Product1', '10 USD'], ['Product2', '20 USD']}%.

Skærmbillede af handlingen Angiv variabel, der opretter en datatabel.

Hvis du vil tilføje kolonneoverskrifter, mens du opretter en ny datatabel ved hjælp af matrixnotationen, skal du bruge udtrykket ^['ColumnName1', 'ColumnName2'] for den første række.

Skærmbillede af handlingen Angiv variabel, der opretter en ny datatabel med kolonneoverskrifter.

Hvis du vil føje en ny række til en eksisterende tabel, skal du bruge handlingen Indsæt række i datatabel. Alternativt kan du oprette et udtryk, der indeholder variabelnavnet på datatabellen, et plustegn (+) og de værdier, du vil tilføje, i klammeparenteser.

Skærmbillede af handlingen Indstil variabel, der føjer en ny række til en datatabel.

Ud over at indsætte rækker i datatabeller indeholder skrivebordsforløb forskellige handlinger, der manipulerer datatabeller. Du kan finde en komplet liste over disse handlinger i referencen til variabelhandlinger.

Hvis du vil hente et bestemt element fra en datatabel, skal du bruge følgende notation: %VariableName[RowNumber][ColumnNumber]%. Vær opmærksom på, at RowNumber og ColumnNumber skal være 0 for det første element (række eller kolonne).

Antag f.eks., at et flow henter indholdet i et Excel-regneark og gemmer det i variablen ExcelData. Hvis du vil have adgang til den første celle i den anden række i den hentede tabel, skal du bruge det udtryk, der vises på følgende billede.

Skærmbillede af et udtryk, der får adgang til første rækkes anden celle i en læst Excel-fil.

Bemærk

ExcelData-variablen indeholder en tabel med værdier, der er udtrukket fra et Excel-regneark ved hjælp af handlingen Læs fra Excel regneark. Den indeholder visse værdier fra et bestemt regneark og ikke hele Excel-filen.

Hvis du vil have adgang til en bestemt kolonne i en datatabel, der indeholder kolonneoverskrifter, skal du bruge %ExcelData[rowNumber]['ColumnName']% notation.

Hvis du itererer gennem en datatable ved hjælp af handlingen For Each, anses den variabel, der indeholder den aktuelle gentagelses data, for at være en datarow.

På samme måde som med lister bruger du %VariableName[StartRow:StopRow]% notation til at få adgang til en bestemt del af en datatabel. I udtrykket hentes kun de rækker, der er defineret af de to indeks, mens StopRow-placeringen er grænsen for opskæringen og hentes ikke.

Hvis du vil lave et udsnit af en datatabel fra første række til en bestemt række, må du ikke angive en StartRow-værdi, f.eks. %Datatable[:4]%. Ligeledes skal du heller ikke bruge en StopRow-værdi for at udvælge en del af en datatabel fra en bestemt række til slutningen, f.eks. %Datatable[2:]%.

Egenskaber for datatype i datatabel

Datarække

En datarække indeholder værdierne for en enkelt række i en datatabel. Hvis du itererer gennem en datatable med en For Each-handling, er den variabel, der indeholder den aktuelle gentagelses data, en datarow.

Hvis du vil hente et bestemt element i en datarække, skal du bruge følgende notation: %VariableName[ItemNumber]%

Du kan også bruge notationen %VariableName['ColumnName']%. Navnet på de enkelte kolonner defineres af den datatabel, du har hentet datarækken fra.

Egenskaber for datatypen Datarow

Skærmbillede af indholdet af en variabel af typen DataRow.

Brugerdefineret objekt

Indeholder par med egenskaber og værdier, som du nemt kan konvertere til JSON-format.

Hvis du vil oprette et nyt tomt brugerdefineret objekt, skal du bruge handlingen Angiv variabel og angive udtrykket %{{ }}%. Hvis du vil oprette et nyt brugerdefineret objekt og initialisere det med egenskaber og værdier, skal du bruge et udtryk med følgende struktur: %{ 'Property1': 'Value1', 'Property2': 'Value2', 'Property3': 'Value2' }%.

Skærmbillede af handlingen Angiv variabel, der opretter et nyt brugerdefineret objekt.

Vigtigt

Du kan ikke bruge reserverede nøgleord som brugerdefinerede objektegenskaber. Du kan se en komplet liste over reserverede nøgleord i Reserverede nøgleord i skrivebordsflow.

Hvis du vil opdatere værdien af en eksisterende egenskab eller tilføje en ny, skal du tilføje handlingen Angiv variabel , angive egenskabens navn i feltet Angiv og angive dens værdi i feltet Til .

Skærmbillede af handlingen Angiv variabel, der føjer en ny egenskab til et brugerdefineret objekt.

Ud over konstantværdier kan du bruge variabler til dynamisk at angive egenskaberne og værdierne for brugerdefinerede objekter. I følgende flow bruges for eksempel to variabler til at føje en ny egenskab til et nyt tomt brugerdefineret objekt.

Skærmbillede af et flow, der bruger variabler til at føje en ny egenskab til et brugerdefineret objekt.

Forbinderobjekt

Connector-objekter lagrer oplysninger fra cloud-connectorer og fungerer på samme måde som brugerdefinerede objekter. Deres egenskaber indeholder som regel lister over andre connector-objekter. Adgang til værdier fungerer som i brugerdefinerede objekter, selvom adgang til indlejrede værdier kan kræve mere komplicerede udtryk.

Skærmbillede af en brugerdefineret objektvariabel i fremviseren til variabler.

Liste over PDF-tabeloplysninger

Du kan kun oprette en variabel af denne datatype via handlingen Udtræk tabeller fra PDF .

Hvert punkt på listen beskriver en udtrukket tabel og indeholder alle de vigtigste oplysninger om den. Hvis du vil have adgang til en bestemt oplysningspost i datatabellen, skal du bruge notationen %VariableName[ItemNumber]%.

Skærmbillede af liste over PDF-tabeloplysninger.

Hvert listeelement indeholder fire egenskaber, som du kan bruge til at få specifikke oplysninger. Der er følgende tilgængelige egenskaber:

  • DataTable – Returnerer den ekstraherede tabel.
  • TableStartingPage – Returnerer indekset for den filside, som indeholder starten af tabellen.
  • TableEndingPage – Returnerer indekset for den filside, som indeholder slutningen af tabellen.
  • TableOrderInPage – Returnerer tabels rækkefølge på siden.

Du kan få flere oplysninger om egenskaberne for denne datatype, se Egenskaber for datatype for variabler.

Skærmbillede af egenskaberne for en liste over PDF-tabeloplysninger.

Hvis du vil have adgang til værdien af en bestemt egenskab, skal du bruge notationen %VariableName[ItemNumber].PropertyName%. Følgende udtryk returnerer f.eks. datatabelværdien af det første element i variablen ExtractedPDFTables.

Skærmbillede af datatabellen, indeholdt i en liste over oplysningsvariabler for PDF-tabeller.

Kendte problemer og begrænsninger

  • Problem: Når en datatabel eller en datarækkecelle indeholder en post med flere linjer, viser variabelfremviseren kun den første linje.
  • Midlertidige løsninger: Ingen.

Forekomster

Forbindelser

Andre datatyper

Dette afsnit indeholder alle de tilgængelige datatyper, der ikke tilhører nogen af de tidligere kategorier.

Generel værdi

  • Generel værdi – brug denne datatype i designtiden, når Power Automate ikke kan definere datatypen for en variabel eller en inputparameter. Generelle værdier konverteres til andre datatyper under kørsel på baggrund af deres data.

Active Directory

  • Active Directory-post – Indeholder en forbindelse til en Active Directory-server, der er oprettet via handlingen Opret forbindelse til server.
  • Gruppeoplysninger – Indeholder navn, vist navn, en beskrivelse og medlemmerne af en angivet Active Directory-gruppe.
  • Gruppemedlem – Repræsenterer et medlem af en angivet Active Directory-gruppe.
  • Brugeroplysninger – Indeholder oplysninger om en angivet Active Directory-bruger, f.eks. for- og efternavn, initialer og et distinguished name, arbejdsoplysninger (virksomhed, afdeling og titel), kontaktoplysninger (telefonnummer, lokalnummer og mailadresse) og placering (land/område, by, stat, gadenavn og postnummer).

Egenskaber for Active Directory-datatype

Amazon Web Services (AWS)

  • EC2-klient – Indeholder en EC2-session, der er oprettet via handlingen Opret EC2-session.
  • EC2-forekomst – Repræsenterer en hentet EC2-forekomst.
  • Oplysninger om EC2-instanser – Indeholder oplysninger om en EC2-instans.
  • Ændring af instanstilstand – Indeholder oplysninger om en EC2-instans, der er startet eller standset.
  • EBS-snapshot – Repræsenterer et EBS-snapshot.
  • EBS-diskenhed – Repræsenterer en EBS-diskenhed.

Egenskaber for AWS-datatype

Azure

  • Azure-klient – Indeholder en Azure-session, der er oprettet via handlingen Opret session.
  • Azure-ressourcegruppe – Repræsenterer en hentet Azure-ressourcegruppe.
  • Azure-administreret disk – Repræsenterer en hentet Azure-disk.
  • Azure-snapshot – Repræsenterer et Azure-snapshot.
  • Virtuel Azure-maskine – Repræsenterer en hentet virtuel Azure-maskine.
  • Oplysninger om en virtuel Azure-maskine – Indeholder oplysninger om en virtuel Azure-maskine.
  • Azure-abonnement – Repræsenterer et hentet Azure-abonnement.

Azure-datatypeegenskaber

CMD

  • CMD-session – Indeholder en CMD-session, der er oprettet via handlingen Åbn CMD-session.

Egenskaber for CMD-datatype

Loginoplysninger

  • Legitimationsoplysninger – indeholder en legitimationsoplysning, der er hentet via handlingen Hent legitimationsoplysninger.

Egenskaber for datatype for legitimationsoplysninger

Datoer og klokkeslæt

  • Datetime – Indeholder dato- og klokkeslætsoplysninger. Hvis du vil oprette en datetime-variabel via handlingen Angiv variabel , skal du angive inputparameteren med udtrykkene %d"yyyy-MM-dd HH:mm:ss.ff+zzz"%, hvor:

    Notation Beskrivelse
    yyyy År
    MM Måned
    dd Dag
    HH time
    mm Mødereferat
    ss Sekunder
    ff Millisekunder
    zzz Forskydning fra UTC

    %d"2022-03-25"% tildeler f.eks. den 25. marts 2022-dato til målvariablen.

Egenskaber for dato- og klokkeslætsdatatyper

Email

  • Mailmeddelelse – Repræsenterer en mailmeddelelse. Handlingen Hent e-mails udfylder disse variabler.

Egenskaber for e-maildatatype

Udveksling

  • Exchange-e-mail – Repræsenterer en e-mail, der hentes fra en Exchange Server. Handlingen Hent Exchange-mailbeskeder udfylder disse variabler.

Exchange datatypeegenskaber

Filer og mapper

  • Fil – Repræsenterer en fil.
  • Mappe – Repræsenterer en mappe.
  • FileSystemObject – Repræsenterer enten en mappe eller en fil. Denne datatype bruges i inputparametre, der accepterer mapper og filer.

Egenskaber for datatypen Filer og mapper

FTP

  • FTP-fil – Repræsenterer en FTP-fil.
  • FTP-mappe – repræsenterer en FTP-mappe.

Egenskaber for FTP-datatype

OCR

  • OCR-program - Indeholder et OCR-program, der er oprettet via handlingen Opret OCR-program.

Outlook

  • Outlook-mail – Repræsenterer en Outlook-mail. Handlingen Hent e-mails fra Outlook udfylder disse variabler.

Egenskaber for datatype i Outlook

Følsomme værdier

  • SensitiveValue – indeholder en tekstværdi, der er markeret som følsom. En hemmelig miljøvariabel eller egenskaben Password for en variabel for legitimationsoplysninger er af typen SensitiveValue.

Terminal

  • Terminal-session – Indeholder en terminal-session, der er oprettet via handlingen Åbn terminal-session.

Egenskaber for terminaldatatype

XML

  • XML-node – Indeholder indholdet i et XML-dokument. Handlingen Læs XML fra fil udfylder disse variabler.

Egenskaber for XML-datatype

Error

  • Fejl – Indeholder oplysninger om den seneste fejl i skrivebordsflowet. Handlingen Hent sidste fejl opretter denne type variabler.

Fejlegenskaber

  • Sidst opdateret den