De schakelactiviteit gebruiken om de uitvoering van voorwaardelijke vertakkingen in een pijplijn uit te voeren

De switchactiviteit in Microsoft Fabric werkt als een switch-instructie in een programmeertaal. Het evalueert een expressie, vergelijkt het resultaat met een case en voert de activiteiten in die case uit.

Voorwaarden

Voordat u begint, moet u deze vereisten voltooien:

Een switchactiviteit toevoegen aan een pijplijn in de gebruikersinterface

Voer de volgende stappen uit om een switchactiviteit toe te voegen:

  1. De switchactiviteit maken
  2. De evaluatie-expressie en cases voor de switchactiviteit instellen
  3. De caseactiviteiten configureren

De switchactiviteit maken

  1. Maak een nieuwe pijplijn in uw werkruimte.

  2. Zoek op de werkbalk Activiteiten van de pijplijn naar Switch en selecteer deze om deze toe te voegen aan het canvas. Als u deze niet ziet, selecteert u + om de lijst met activiteiten uit te vouwen.

    Schermopname van de Fabric UI met het deelvenster Activiteiten en de gemarkeerde wisselactiviteit.

  3. Selecteer de nieuwe schakelactiviteit op het canvas als deze nog niet is geselecteerd.

    Schermopname van het tabblad Algemene instellingen van de schakelactiviteit.

Zie Algemene instellingen voor meer informatie over het tabblad Algemeen.

De evaluatie-expressie en cases voor de switchactiviteit instellen

Selecteer het tabblad Activiteiten . De standaardcase staat al in de lijst met cases.

Voer in Expressie de waarde in die door de schakelactiviteit moet worden geëvalueerd. U kunt dynamische inhoud gebruiken, zoals parameters, systeemvariabelen, functies en lokale variabelen.

Zie het overzicht van de expressietaal voor informatie over onze expressietaal en ondersteunde functies.

Ga als volgt te werk om te configureren wat elke case uitvoert:

  1. Selecteer op het tabblad Activiteiten het potloodpictogram naast een zaak.
  2. Voeg de activiteiten toe die moeten worden uitgevoerd wanneer dat geval overeenkomt met de expressie.
  3. Als u meer cases wilt toevoegen, selecteert u + Case toevoegen.

U kunt ook gevallen toevoegen en activiteiten configureren vanaf de switchactiviteitskaart op het pijplijncanvas door + of het potloodpictogram naast elke case te selecteren.

Schermopname van het tabblad Activiteitsinstellingen wisselen waarin het tabblad wordt gemarkeerd en waar u een nieuwe verbinding kunt kiezen.

De caseactiviteiten configureren

Wanneer u het potloodpictogram voor een case selecteert, opent Fabric de editor voor caseactiviteiten. Deze editor ziet eruit als de pijplijneditor, maar is alleen van toepassing op de geselecteerde case.

Voeg de activiteiten toe die u voor dat geval wilt uitvoeren. In dit voorbeeld bevat de standaardcase een kopieeractiviteit. Fabric voert die kopieeractiviteit uit wanneer er geen andere case overeenkomt met het expressieresultaat .

Schermopname van het deelvenster case-activiteiteneditor voor de standaard case met een voorbeeld van een Kopie-activiteit die eraan is toegevoegd.

In de linkerbovenhoek van de editor voor caseactiviteiten ziet u de huidige pijplijn en case. Wanneer u klaar bent, selecteert u de naam van de pijplijn om terug te keren naar de hoofdpijplijneditor.

De pijplijn opslaan en uitvoeren of plannen

Schakel over naar het tabblad Home boven aan de pijplijneditor en selecteer de knop Opslaan om uw pijplijn op te slaan. Selecteer Uitvoeren om deze rechtstreeks uit te voeren of Planning om uitvoeringen op specifieke tijdstippen of intervallen te plannen. Zie voor meer informatie over pijplijnuitvoeringen: pijplijnuitvoeringen plannen.

Schermopname waarin het tabblad Start in de pijplijneditor met de tabbladnaam, Opslaan-, Uitvoeren- en Plannen-knoppen gemarkeerd zijn.

Nadat u de pijplijn heeft uitgevoerd, kunt u de pijplijnuitvoering bewaken en de uitvoeringsgeschiedenis bekijken op het Uitvoer tabblad onder het canvas.

Basisvoorbeeld

In dit voorbeeld wordt gegevensverwerking gerouteerd op basis van een pijplijnparameter met de naam v_string_input.

Onze switchactiviteit ROYGBIV switch evalueert de waarde van v_string_input en voert de activiteiten uit in het geval dat overeenkomt met die waarde. Als er geen overeenkomst is, wordt er geen activiteit uitgevoerd, omdat de standaardcase leeg is.

In dit voorbeeld zijn er zeven gevallen, één voor elke kleur (rood, oranje, geel, groen, blauw, violet). Elk geval bevat één Set-variabele-activiteit waarin de waarde van v_output wordt ingesteld op de naam van de kleur in dat geval. De expressie is een eenvoudige intake van de invoerparameter v_string_input, in dit geval @pipeline().parameters.v_string_input, maar het kan elke expressie zijn die resulteert in een waarde.

Schermopname van een voorbeeld van activiteiten voor het instellen van variabelen die worden gebruikt om waarden voor te bereiden voordat de evaluatie van de schakeling plaatsvindt.

Wanneer we de pijplijn uitvoeren, voeren we een waarde in voor de v_string_input. Als we 'blauw' invoeren, evalueert de switchactiviteit die expressie, komt deze overeen met de case 'Blauw' en wordt de activiteit in dat geval uitgevoerd, die is ingesteld op v_output 'Blauw'. Als we 'lime' invoeren, is er geen overeenkomende case, dus de switchactiviteit voert de standaardcase uit, wat niets doet.

Schermopname van invoer voor pijplijnuitvoering met parameterwaarden die worden gebruikt door de switch-expressie. De invoer is 'blauw' in dit voorbeeld.

Na een geslaagde uitvoering van de pijplijn met 'blauw' als invoer, kunnen we in de uitvoer van de activiteit Variabele instellen in de "Blauw" case zien dat v_output is ingesteld op 'Blauw', wat bevestigt dat de switch-activiteit de expressie heeft geëvalueerd en de juiste case heeft uitgevoerd.

Schermopname van een voorbeeld van een geslaagde pijplijnuitvoering na evaluatie van een switchcase, waarin wordt weergegeven dat de juiste (blauwe) activiteit is uitgevoerd na een invoer van blauw.