Przejdź do treści
Uwaga: Tłumaczenie tego artykułu jest podane wyłącznie dla wygody. Tłumaczenie jest tworzone automatycznie za pomocą oprogramowania tłumaczącego i mogło nie zostać sprawdzone. W związku z tym, angielska wersja tego artykułu powinna być uważana za wersję obowiązującą, zawierającą najnowsze informacje. Możesz uzyskać do niej dostęp tutaj.
Workflows

Używanie akcji kodu niestandardowego w przepływach pracy

Data ostatniej aktualizacji: listopada 5, 2021

Dotyczy:

Operacje Hub Professional

W przepływach pracy można używać akcji kodu niestandardowego do pisania i wykonywania skryptów JavaScript w przepływach pracy. Za pomocą akcji kodu niestandardowego można rozszerzyć funkcjonalność przepływu zarówno w obrębie HubSpota, jak i poza nim. Aby zobaczyć przykłady typowych akcji kodu niestandardowego, zapoznaj się z przypadkami użycia programowalnej automatyzacji w HubSpot.

Akcje z kodem niestandardowym obsługują JavaScript, korzystając z frameworka runtime Node 12.x. Kiedy akcja jest wykonywana, obliczenia runtime są zarządzane przez funkcję bezserwerową HubSpot i AWS Lambda.

Aby uzyskać więcej informacji technicznych na temat budowania niestandardowych akcji kodowych, zapoznaj się z dokumentacją dla programistów HubSpot.

Uwaga: akcje kodu niestandardowego muszą zakończyć działanie w ciągu 20 sekund i mogą wykorzystywać tylko do 128 MB pamięci. Jeśli działanie kodu niestandardowego przekroczy te limity, HubSpot będzie ponawiał próby wykonania działania przez maksymalnie trzy dni, począwszy od jednej minuty po niepowodzeniu. Kolejne niepowodzenia będą ponawiane w coraz większych odstępach czasu, przy czym maksymalna przerwa między próbami może wynosić osiem godzin.

Dodawanie akcji z kodem niestandardowym

Aby dodać niestandardową akcję kodu do przepływu pracy:

  • W koncie HubSpot przejdź do Automatyzacja > Przepływy pracy.
  • Kliknijnazwę przepływu pracy lub utwórz nowy przepływ pracy.
  • Kliknąćikonęplusa+, aby dodać akcję przepływu.
  • W prawym panelu wybierz opcjęKod niestandardowy.

    custom-code-action-select
  • Aby użyć sekretu w kodzie niestandardowym, kliknij menu rozwijane Sekrety, a następnie wybierz istniejący sekret lub dodaj nowy sekret:
    • Aby dodać nowy sekret, np. klucz API, kliknij przycisk Dodaj sekret. Dowiedz się więcej o tym, jak uzyskać dostęp do klucza API HubSpot i jak go odzyskać. Więcej informacji na temat sekretów można również znaleźć w dokumentacji deweloperskiej HubSpot.
    • W oknie dialogowym wprowadźnazwę sek retu iwartość sekretu.
    • Kliknij przyciskZapisz. Teraz możesz wybrać ten sekret w przyszłych działaniach kodu niestandardowego.
    • Aby zmodyfikować lub usunąć istniejące sekrety, kliknij przycisk Zarządzaj sekretami.

      workflow-custom-code-secrets-menu0
  • Aby włączyć właściwości do swojego kodu niestandardowego, kliknij menu rozwijane Wybierz właściwość, a następnie wybierz właściwość. W przepływie można użyć istniejących właściwości lub wcześniej sformatowanych wartości właściwości. Po wybraniu właściwości należy wprowadzić jej nazwę , która będzie używana w kodzie. Dowiedz się, jak odwoływać się do właściwości w kodzie niestandardowym.
      • Aby dodać kolejną właściwość, kliknij przycisk Dodaj właściwość. Każda właściwość może być dodana tylko raz i musi mieć unikalny identyfikator zmiennej. W kodzie niestandardowym można użyć maksymalnie 50 właściwości.
      • Aby usunąć właściwość, kliknij ikonęusuniętej właściwości.

  • W polu kodu wpisz swój kod JavaScript. Aby dowiedzieć się więcej o kodowaniu akcji, zapoznaj się z dokumentacją programisty HubSpot.
    • Aby edytować kod w trybie ciemnym, kliknij menu rozwijaneŚwiatło w edytorze kodu, a następnie wybierz opcjęCiemny.

      workflow-custom-code-action-test0
  • Aby zdefiniować dane wyjściowe, które mogą zostać użyte jako dane wejściowe w dalszej części przepływu, na przykład za pomocą Kopiowanie wartości właściwości akcji:
    • W zakładceDane wyjściowe kliknij przyciskTypdanych z menu rozwijanego i wybierz typ danych.
    • W poluNazwa wpisz nazwę wyjścia danych.
    • Aby dodać wiele wyjść, kliknij przyciskDodaj wyjście
      .

      workflow-custom-code-action-data-ouputs
  • Kliknij przycisk Zapisz.

Testowanie akcji

Po dodaniu do przepływu pracy akcji z kodem niestandardowym można ją przetestować, aby upewnić się, że kod działa zgodnie z oczekiwaniami, a następnie włączyć przepływ.

Testowanie akcji z kodem niestandardowym należy rozpocząć od wybrania rekordu, na którym testowany będzie kod, a następnie uruchomić go. Test ten uruchomi jedynie kod własnej akcji, a nie innych akcji przepływu. Gdy kod zostanie uruchomiony, będzie można zobaczyć wyniki działania kodu oraz log z testu.

Aby przetestować akcję kodu niestandardowego:

  • Na osi czasu przepływu pracy kliknij akcję kodu niestandardowego.
  • Na dole prawego paska bocznego kliknij przycisk Testuj akcję, aby rozwinąć sekcję testowania
    .



    workflow-custom-code-test-expand
  • Wybierz rekord, na którym chcesz przetestować swój kod, klikając menu rozwijane[Obiekt], a następnie wybierając rekord
    .



    workflow-custom-code-action-test2
  • Jeśli w przepływie używasz wcześniej sformatowanych wartości właściwości, podaj wartość test ową dla sformatowanych danych.


Uwaga: podczas testowania własnego kodu, zostanie on uruchomiony, a wszelkie zmiany zostaną zastosowane do wybranego rekordu testowego. Zaleca się utworzenie dedykowanego rekordu testowego, jeśli chcemy uniknąć aktualizacji rekordów bieżących.

  • Aby uruchomić kod, kliknij przyciskTestuj.
  • W oknie dialogowym potwierdź chęć wykonania testu kodu dla wybranego rekordu klikającTestuj.
  • Gdy Twój kod zostanie uruchomiony, na pasku bocznym wyświetlone zostaną wyniki testu:
    • Status: status powodzenia lub niepowodzenia akcji kodu niestandardowego.
    • Dane wyjściowe: wartości, które powstały dla zdefiniowanych przez Ciebie danych wyjściowych. Obok wszystkich danych wyjściowych wygenerowanych przez kod, które nie zostały zdefiniowane ani w sekcji Dane wyjściowe, ani w edytorze kodu, zostanie wyświetlony alert. Należy je dodać, aby móc z nich skorzystać w dalszej części przepływu pracy.
    • Logi: informacje o samym teście, takie jak ilość pamięci potrzebnej do wykonania akcji oraz całkowity czas wykonania.

      workflow-custom-code-action-test0results0
  • Aby zaktualizować swoją niestandardową akcję kodu, kliknij przyciskUtwórz akcję, aby rozwinąć edytor akcji. W razie potrzeby kontynuuj aktualizację i testowanie kodu.
  • Po zakończeniu testowania akcji, kliknij przyciskZapisz, aby zapisać zmiany.

Obsługiwane biblioteki

Akcja kodu niestandardowego obsługuje następujące biblioteki JavaScript i wersje: