Del via


Transformere data med en ForEach-aktivitet

ForEach-aktiviteten definerer en gjentatt kontrollflyt i et Microsoft Fabric-datasamlebånd. Denne aktiviteten brukes til å gjenta en samling og utfører angitte aktiviteter i en løkke. Sløyfeimplementeringen av denne aktiviteten ligner på en ForEach-løkkestruktur på programmeringsspråk.

Legge til en ForEach-aktivitet i et datasamlebånd

Denne delen beskriver hvordan du bruker en ForEach-aktivitet i et datasamlebånd.

Forutsetninger

Du må fullføre følgende forutsetninger for å komme i gang:

Opprette aktiviteten

  1. Opprett et nytt datasamlebånd i arbeidsområdet.

  2. Søk etter ForEach- i datasamlebåndet Aktiviteter-ruten, og velg den for å legge den til i datasamlebåndlerret. Hvis du ikke kan se den i utgangspunktet, kan du bruke pilen på høyre side av aktivitetsverktøylinjen til å bla til høyre for å finne den.

    Skjermbilde av stoffgrensesnittet med Aktiviteter-ruten og ForEach-aktivitet uthevet.

  3. Velg den nye ForEach-aktiviteten på lerretet hvis den ikke allerede er valgt.

    Skjermbilde som viser fanen Generelle innstillinger i ForEach-aktiviteten.

  4. Skriv inn et navn på aktiviteten i navnegenskapen på fanen Generelt nederst på lerretet.

  5. (Valgfritt) Du kan også skrive inn en beskrivelse.

Innstillinger for Foreach

Velg fanen Innstillinger, der du kan angi om behandling av elementene i gruppen skal være sekvensiell (eller på annen måte parallelt). Du kan også angi maksimalt antall elementer som skal behandles samtidig med bunkeantall. Til slutt må du angi en liste over kommadelte elementer, som kan parameteres eller inkludere dynamisk innhold. Legg til noen elementer i Elementer-listen som vist i eksemplet.

Skjermbilde som viser ForEach-innstillinger-fanen med flere elementer lagt til i elementer-listen.

ForEach-aktiviteter

Du definerer også en aktivitet eller aktiviteter som skal utføres på hvert av elementene i listen, i ruten ForEach Aktiviteter.

Skjermbilde som viser ForEach-aktivitetsruten.

Velg +-knappen for å legge til en ny aktivitet i ruten. Du ser en liste over aktiviteter du kan velge. Du kan legge til flere aktiviteter i ForEach-aktiviteten, og hver av dem kjøres på hvert av elementene i listen Elementer. Enten alternativet sekvensiell er valgt i Foreach-innstillingene eller ikke, behandles hver av de underordnede aktivitetene i foreach-aktivitetsruten sekvensielt til hverandre for hvert element. Hvis sekvensiell ikke er valgt, behandles imidlertid flere elementer parallelt, og hver av dem kjører sekvensielt gjennom listen over underordnede aktiviteter som er angitt.

Skjermbilde som viser en ForEach-aktivitet med flere underordnede aktiviteter angitt, og +-knappen uthevet som viser en liste over underordnede aktiviteter du kan velge mellom når du legger til nye aktiviteter i ruten.

Referere til et element i en aktivitet

Velg én av de underordnede aktivitetene i ruten ForEach Aktiviteter, og bytt til Innstillinger-fanen. I dette eksemplet ble en lagret prosedyre aktivitet valgt. Fyll ut innstillingene for aktiviteten slik du normalt ville valgt en tilkobling og lagret prosedyre. Du kan bruke @item() gjentakelse til å referere til gjeldende element som behandles hvor som helst i en aktivitet som støtter dynamisk innhold. Her ble @item() brukt som verdi for FruitName-parameteren som sendes til en lagret prosedyre.

Skjermbilde som viser en underordnet aktivitet for en lagret prosedyre med en parameter ved hjelp av gjeldende @item() fra listen over Foreach-elementer for verdien.