Utilizzare azioni di codice personalizzate nei flussi di lavoro

Nei flussi di lavoro, è possibile utilizzare l'azione Codice personalizzato per scrivere ed eseguire JavaScript nel flusso di lavoro. Con le azioni di codice personalizzate, puoi estendere le funzionalità del flusso di lavoro all'interno e all'esterno di HubSpot. Per vedere esempi di azioni di codice personalizzate comuni, visualizza i casi d'uso dell'automazione programmabile di HubSpot.

Le azioni di codice personalizzate supportano JavaScript utilizzando il framework runtime Node 12.x. Quando l'azione viene eseguita, il calcolo runtime è gestito attraverso una funzione serverless da HubSpot e AWS Lambda.

Per maggiori informazioni tecniche sulla costruzione di azioni di codice personalizzate, visualizza la documentazione per gli sviluppatori di HubSpot.

Nota: le azioni di codice personalizzate devono terminare l'esecuzione entro 20 secondi e possono utilizzare solo fino a 128 MB di memoria. Se un'azione di codice personalizzato supera questi limiti, HubSpot tenterà nuovamente di eseguire l'azione per un massimo di tre giorni, a partire da un minuto dopo il fallimento. I fallimenti successivi saranno riprovati a intervalli crescenti, con un intervallo massimo di otto ore tra i tentativi.

Aggiungere un'azione di codice personalizzata

Per aggiungere un'azione di codice personalizzata al tuo flusso di lavoro:

• Nel tuo account HubSpot, naviga su Automazione > Flussi di lavoro.
• Fai clic sulnome di un flusso di lavoro o crea un nuovo flusso di lavoro.
• Fai clic sull'iconapiù+per aggiungere un'azione del flusso di lavoro.
• Nel pannello di destra, selezionareCustom code.
  
  
• Per utilizzare un segreto nel tuo codice personalizzato, fai clic sul menu a discesa Secrets, quindi seleziona un segreto esistente o aggiungi un nuovo segreto:
  • Per aggiungere un nuovo segreto, come una chiave API, fai clic su Aggiungi segreto. Scopri di più su come puoi accedere e recuperare la tua chiave API di HubSpot. Puoi anche saperne di più sui segreti nella documentazione per gli sviluppatori di HubSpot.
  • Nella finestra di dialogo, inserisci ilnome del segreto e ilvalore del segreto.
  • Fai clic suSalva. Ora puoi selezionare questo segreto in future azioni di codice personalizzato.
  • Per modificare o cancellare i segreti esistenti, clicca su Manage secrets.
    
    
• Nelcampo del codice, inserisci il tuo JavaScript. Per saperne di più sulla codifica della tua azione, controlla la documentazione per gli sviluppatori di HubSpot.
  • Per modificare il tuo codice in modalità oscura, fai clic sul menu a discesaLight nell'editor di codice, quindi selezionaDark.
    
    

• Per definire output di dati che possono essere usati come input in seguito nel flusso di lavoro, per esempio con un Copiare il valore della proprietà azione:
  • SottoUscite di dati, fai clic sul menu a discesaTipo di dati e seleziona un tipo di dati.
  • Nel campoName, inserisci un nome per l'uscita dati.
  • Per aggiungere più uscite, fai clic suAdd output
    .
    
    
    
• Fai clic su Save.

Testare l'azione

Quando si aggiunge un'azione di codice personalizzata a un flusso di lavoro, è possibile testare l'azione per garantire che il codice venga eseguito come previsto prima di attivare il flusso di lavoro.

Quando si testa un'azione di codice personalizzata, si inizia selezionando un record con cui testare il codice, quindi si esegue il codice. Questo test eseguirà solo il codice della tua azione personalizzata, non le altre azioni del flusso di lavoro. Quando il codice ha finito di essere eseguito, sarai in grado di visualizzare i risultati del codice e il registro del tuo test.

Per testare un'azione di codice personalizzata:

• Nella timeline del flusso di lavoro, clicca sull'azione di codice personalizzata.
• In fondo alla barra laterale destra, clicca su Test action per espandere la sezione di test.
  
  
• Seleziona un record con cui testare il tuo codice cliccando sul menu a tendina[Object], quindi selezionando un record.
  
  

Nota: quando si testa il codice personalizzato, il codice verrà eseguito e qualsiasi modifica verrà applicata al record di test selezionato. Si raccomanda di creare un record di prova dedicato se si vuole evitare di aggiornare i record live.

• Per eseguire il codice, clicca suTest.
• Nella finestra di dialogo, conferma che vuoi testare il tuo codice contro il record selezionato facendo clic suTest.
• Una volta che il tuo codice è stato eseguito, la barra laterale mostrerà i risultati del tuo test:
  • Stato: lo stato di successo o fallimento dell'azione del codice personalizzato.
  • Uscite dati: i valori risultanti per le uscite dati definite. Un avviso verrà visualizzato accanto a qualsiasi output generato dal codice che non è stato definito nella sezione Uscite dati o nell'editor di codice. Avrai bisogno di aggiungere questi output per poterli utilizzare in seguito nel flusso di lavoro.
  • Logs: informazioni sul test stesso, come ad esempio quanta memoria ha richiesto l'azione per essere eseguita e il tempo totale di esecuzione.
    
    
• Per aggiornare la tua azione di codice personalizzata, clicca suCreate action per espandere l'editor di azioni. Continua ad aggiornare e testare il tuo codice come necessario.
• Quando hai finito di testare l'azione, clicca suSave per salvare le tue modifiche.

Librerie supportate

L'azione Codice personalizzato supporta le seguenti librerie e versioni JavaScript:

• @hubspot/api-client 3.4.1
• async 3.2.0
• aws-sdk 2.858.0
• axios 0.20.0
• lodash 4.17.21
• mangusta 5.11.19
• mysql 2.18.1
• redis 3.0.2
• request 2.88.2
• bluebird 3.7.2
• random-number-csprng 1.0.2
• googleapis 67.1.1