Doorgaan naar artikel
Let op: De Nederlandse vertaling van dit artikel is alleen bedoeld voor het gemak. De vertaling wordt automatisch gemaakt via een vertaalsoftware en is mogelijk niet proefgelezen. Daarom moet de Engelse versie van dit artikel worden beschouwd als de meest recente versie met de meest recente informatie. U kunt het hier raadplegen.
Workflows

Gebruik aangepaste codeacties in workflows

Laatst bijgewerkt: november 5, 2021

Geldt voor:

Operations Hub Professional

In workflows kunt u de actie Aangepaste code gebruiken om JavaScript in uw workflow te schrijven en uit te voeren. Met aangepaste code acties, kunt u workflow functionaliteit uitbreiden binnen en buiten HubSpot. Bekijk HubSpot's Programmeerbare Automatisering Use Cases om voorbeelden van veelvoorkomende aangepaste code-acties te zien.

Aangepaste code acties ondersteunen JavaScript met behulp van het Node 12.x runtime framework. Wanneer de actie wordt uitgevoerd, wordt de runtime compute beheerd via een serverloze functie door HubSpot en AWS Lambda.

Voor meer technische informatie over het bouwen van custom code actions, bekijk de developer documentatie van HubSpot.

Let op: aangepaste code-acties moeten binnen 20 seconden klaar zijn met uitvoeren, en kunnen slechts maximaal 128 MB geheugen gebruiken. Als een custom code actie deze limieten overschrijdt, zal HubSpot tot drie dagen lang opnieuw proberen uw actie uit te voeren, vanaf één minuut na mislukking. Latere mislukkingen zullen opnieuw worden geprobeerd met toenemende intervallen, met een maximale tussenpoos van acht uur.

Een aangepaste code-actie toevoegen

Om een aangepaste code-actie aan je workflow toe te voegen:

  • Navigeer in uw HubSpot account naar Automatisering > Workflows.
  • Klik op denaam van een workflow, of maak een nieuwe workflow.
  • Klik op hetplusicoon +om een workflow actie toe te voegen.
  • Selecteer in het rechterpaneelAangepaste code.

    custom-code-action-select
  • Om een geheim te gebruiken in uw aangepaste code, klikt u op het vervolgkeuzemenu Geheimen en selecteert u een bestaand geheim, of u voegt een nieuw geheim toe:
    • Om een nieuw geheim toe te voegen, zoals een API sleutel, klik op Geheim toevoegen. Leer meer over hoe u uw HubSpot API-sleutel kunt openen en ophalen. U kunt ook meer te weten komen over geheimen in HubSpot's documentatie voor ontwikkelaars.
    • Voer in het dialoogvenster deSecret-naam enSecret-waarde in.
    • Klik opOpslaan. U kunt deze secret nu selecteren in toekomstige acties met aangepaste code.
    • Om bestaande geheimen te bewerken of te verwijderen, klik op Beheer geheimen.

      workflow-custom-code-secrets-menu0
  • Om eigenschappen in uw aangepaste code op te nemen, klikt u op het vervolgkeuzemenu Kies eigenschap en selecteert u vervolgens een eigenschap. U kunt bestaande eigenschappen of eerder opgemaakte waarden van eigenschappen in de workflow gebruiken. Nadat u uw eigenschap hebt geselecteerd, voert u eeneigenschapsnaam in om in uw code te gebruiken. Leer hoe u naar eigenschappen kunt verwijzen in uw aangepaste code.
      • Om nog een eigenschap toe te voegen, klik op Add property. Elke eigenschap kan slechts eenmaal worden toegevoegd en moet een unieke Variabele-ID hebben. U kunt tot 50 eigenschappen gebruiken met uw aangepaste code.
      • Om een eigenschap te verwijderen, klik op het verwijder icoon.

  • In het code veld, voer uw JavaScript in. Om meer te leren over het coderen van uw actie, bekijk HubSpot's developer documentatie.
    • Om uw code in donkere modus te bewerken, klik op hetLight dropdown menu in de code editor, selecteer danDark.

      workflow-custom-code-action-test0
  • Om gegevensoutputs te definiëren die later in de workflow als inputs kunnen worden gebruikt, bijvoorbeeld met een Waarde van eigenschap kopiëren actie:
    • Klik onderGegevensuitvoer op het vervolgkeuzemenuGegevenstype en selecteer een gegevenstype.
    • Voer in het veldNaam een naam in voor de gegevensuitvoer.
    • Als u meerdere uitgangen wilt toevoegen, klikt u opUitgang toevoegen
      .

      workflow-custom-code-action-data-ouputs
  • Klik op Opslaan.

De actie testen

Als u een actie met aangepaste code aan een workflow toevoegt, kunt u de actie testen om er zeker van te zijn dat uw code wordt uitgevoerd zoals verwacht voordat u de workflow inschakelt.

Bij het testen van een aangepaste code-actie, begint u met het selecteren van een record om de code mee te testen, en voert u vervolgens de code uit. Deze test zal alleen de code in uw aangepaste actie uitvoeren, niet een van de andere acties in de workflow. Wanneer de code klaar is met draaien, kunt u de code-uitvoer en het logboek van uw test bekijken.

Zo test u een actie met aangepaste code:

  • Klik in de tijdlijn van de workflow op de aangepaste codeactie.
  • Onderaan in de rechter zijbalk, klik op Test actie om de test sectie uit te vouwen
    .



    workflow-custom-code-test-expand
  • Selecteer een record om uw code mee te testen door op het vervolgkeuzemenu[Object] te klikken en vervolgens een record te selecteren
    .



    workflow-custom-code-action-test2
  • Als u eerder opgemaakte waarden van eigenschappen in de workflow gebruikt, voer dan een testwaarde in voor de opgemaakte gegevens.


Let op: bij het testen van uw aangepaste code, zal de code worden uitgevoerd en eventuele wijzigingen zullen van toepassing zijn op het geselecteerde testrecord. Het is aan te raden om een speciaal testrecord aan te maken als u wilt voorkomen dat uw live records worden bijgewerkt.

  • Om de code uit te voeren, klik opTest.
  • In het dialoogvenster bevestigt u dat u uw code wilt testen tegen het geselecteerde record door opTest te klikken.
  • Zodra uw code klaar is met draaien, toont de zijbalk de resultaten van uw test:
    • Status: de succes- of faalfactiestatus van uw aangepaste codeactie.
    • Gegevensoutputs: de waarden die het resultaat waren van de door u gedefinieerde gegevensoutputs. Een waarschuwing zal verschijnen naast alle outputs die de code genereerde en die niet gedefinieerd waren in de Data outputs sectie of in de code editor. U zult deze uitgangen moeten toevoegen om ze later in de workflow te kunnen gebruiken.
    • Logs: informatie over de test zelf, zoals hoeveel geheugen het duurde om de actie uit te voeren en de totale runtime.

      workflow-custom-code-action-test0results0
  • Om uw aangepaste codeactie bij te werken, klikt u op Actiemakenom de actie-editor uit te vouwen. Ga door met het bijwerken en testen van uw code indien nodig.
  • Als u klaar bent met het testen van de actie, klikt u opOpslaan om uw wijzigingen op te slaan.

Ondersteunde bibliotheken

De actie Aangepaste code ondersteunt de volgende JavaScript-bibliotheken en versies: