Hoppa till innehåll
Observera: Översättningen av denna artikel är endast avsedd att underlätta för dig. Översättningen har skapats automatiskt med hjälp av en översättningsprogramvara och har eventuellt inte korrekturlästs. Den engelska versionen av denna artikel bör därför betraktas som den gällande versionen med den senaste informationen. Du kan komma åt den här.
Workflows

Använd anpassade kodåtgärder i arbetsflöden

Senast uppdaterad: november 5, 2021

Gäller för:

Verksamhet Hub Professional

I arbetsflöden kan du använda åtgärden Anpassad kod för att skriva och köra JavaScript i arbetsflödet. Med anpassade kodåtgärder kan du utöka arbetsflödesfunktionaliteten inom och utanför HubSpot. Om du vill se exempel på vanliga åtgärder för anpassad kod kan du se HubSpot-användningsfall för programmerbar automatisering.

Anpassade kodåtgärder stöder JavaScript med hjälp av Node 12.x runtime-ramverket. När åtgärden utförs hanteras körtidsberäkningen via en serverlös funktion av HubSpot och AWS Lambda.

Mer teknisk information om hur du bygger åtgärder med anpassad kod finns i HubSpot:s dokumentation för utvecklare.

Observera: Åtgärder med anpassad kod måste sluta köras inom 20 sekunder och kan endast använda upp till 128 MB minne. Om en åtgärd med anpassad kod överskrider dessa gränser kommer HubSpot att försöka utföra din åtgärd på nytt i upp till tre dagar, med början en minut efter misslyckandet. Efterföljande misslyckanden kommer att försöka igen med ökande intervall, med ett maximalt intervall på åtta timmar mellan försöken.

Lägg till en anpassad kodåtgärd

Om du vill lägga till en anpassad kodåtgärd i ditt arbetsflöde:

  • I ditt HubSpot-konto, navigera till Automatisering > Arbetsflöden.
  • Klicka pånamnet på ett arbetsflöde eller skapa ett nytt arbetsflöde.
  • Klicka påplusikonen +för att lägga till en arbetsflödesåtgärd.
  • I den högra panelen väljer duAnpassad kod.

    custom-code-action-select
  • Om du vill använda en hemlighet i din anpassade kod klickar du på rullgardinsmenyn Hemligheter och väljer sedan en befintlig hemlighet eller lägger till en ny hemlighet:
    • Om du vill lägga till en ny hemlighet, till exempel en API-nyckel, klickar du på Lägg till hemlighet. Läs mer om hur du kan få tillgång till och hämta din HubSpot API-nyckel. Du kan också läsa mer om hemligheter i HubSpot:s dokumentation för utvecklare.
    • I dialogrutan anger duSecret-namnet ochSecret-värdet.
    • Klicka påSpara. Du kan nu välja den här hemligheten i framtida åtgärder för anpassad kod.
    • Om du vill redigera eller radera befintliga hemligheter klickar du på Manage secrets.

      workflow-custom-code-secrets-menu0
  • Om du vill inkludera egenskaper i din anpassade kod klickar du på rullgardinsmenyn Välj egenskap och väljer sedan en egenskap. Du kan använda befintliga egenskaper eller tidigare formaterade egenskapsvärden i arbetsflödet. När du har valt din egenskap anger du ettegenskapsnamn som du vill använda i din kod. Lär dig hur du refererar till egenskaper i din anpassade kod.
      • Om du vill lägga till en annan egenskap klickar du på Lägg till egenskap. Varje egenskap kan bara läggas till en gång och måste ha ett unikt Variabel-ID. Du kan använda upp till 50 egenskaper med din anpassade kod.
      • Om du vill ta bort en egenskap klickar du på ikonendeletedelete.

  • Ange din JavaScript i kodfältet. Om du vill veta mer om hur du kodar din åtgärd kan du läsa HubSpot-dokumentationen för utvecklare.
    • Om du vill redigera din kod i mörkt läge klickar du på rullgardinsmenynLjus i kodredigeraren och väljer sedanMörk.

      workflow-custom-code-action-test0
  • Om du vill definiera datautgångar som kan användas som indata senare i arbetsflödet, till exempel med en Kopiera egenskapsvärdet åtgärd:
    • UnderDatautgångar klickar du på rullgardinsmenynDatatyp och väljer en datatyp.
    • Ange ett namn för datautmatningen i fältetNamn.
    • Om du vill lägga till flera utdata klickar du påLägg till utdata
      .

      workflow-custom-code-action-data-ouputs
  • Klicka på Spara.

Testa åtgärden

När du lägger till en åtgärd med anpassad kod i ett arbetsflöde kan du testa åtgärden för att se till att koden körs som förväntat innan du aktiverar arbetsflödet.

När du testar en åtgärd med anpassad kod börjar du med att välja en post att testa koden med och kör sedan koden. Det här testet kör endast koden i din anpassade åtgärd, inte någon av de andra åtgärderna i arbetsflödet. När koden har körts färdigt kan du visa kodutgångarna och loggen för testet.

Så här testar du en åtgärd med anpassad kod:

  • Klicka på den anpassade kodåtgärden i tidslinjen för arbetsflödet.
  • Längst ner i den högra sidofältet klickar du på Testa åtgärd för att expandera testningsavsnittet
    .



    workflow-custom-code-test-expand
  • Välj en post att testa koden med genom att klicka på rullgardinsmenyn[Objekt] och sedan välja en post
    .



    workflow-custom-code-action-test2
  • Om du använder tidigare formaterade egenskapsvärden i arbetsflödet anger du ett testvärde för de formaterade uppgifterna.


Observera: När du testar din anpassade kod kommer koden att köras och eventuella ändringar kommer att gälla för den valda testposten. Det rekommenderas att skapa en dedikerad testpost om du vill undvika att uppdatera dina liveposter.

  • För att köra koden klickar du påTest.
  • I dialogrutan bekräftar du att du vill testa koden mot den valda posten genom att klicka påTest.
  • När koden har körts visar sidofältet resultatet av testet:
    • Status: Status för framgång eller misslyckande för din anpassade kodåtgärd.
    • Datauppgifter: de värden som resulterade för dina definierade datauppgifter. En varning visas bredvid alla utdata som koden genererade och som inte definierades antingen i avsnittet Datautdata eller i kodredigeraren. Du måste lägga till dessa utdata för att kunna använda dem senare i arbetsflödet.
    • Loggar: Information om själva testet, t.ex. hur mycket minne åtgärden tog i anspråk för att utföras och den totala körtiden.

      workflow-custom-code-action-test0results0
  • Om du vill uppdatera din anpassade kodåtgärd klickar du påSkapa åtgärd för att expandera åtgärdsredigeraren. Fortsätt att uppdatera och testa din kod vid behov.
  • När du är klar med att testa åtgärden klickar du påSpara för att spara ändringarna.

Bibliotek som stöds

Åtgärden Anpassad kod stöder följande JavaScript-bibliotek och versioner: