USM Content
Utility di Bridge: JavaScript
L'utilità JavaScript in Bridge include solo un modulo: Esegui script. Usa questo modulo per scrivere funzioni JavaScript e avviare quelle che hai scritto.
Configura l‘utility JavaScript
- Accedi a Bridge.
- Vai alla pagina Integrazioni.
- Trova e seleziona JavaScript.
Modulo Esegui script
Il modulo contiene i seguenti campi, puoi utilizzare riferimenti ai dati in tutti loro:
- Nome script:Il nome dello script da eseguire.
- Parametri script:i parametri che lo script si aspetta durante l'esecuzione, rappresentati come una mappa dell'oggetto key:value.
- Chiave: Il nome del parametro che appare nello script.
- Valore: Il valore assegnato alla chiave che lo script utilizza durante l'esecuzione dello script.
Il numero di parametri dello script consentiti è illimitato e viene aggiunto dinamicamente.
Per impostare lo script che desideri eseguire:
- Seleziona l'icona dell'ingranaggio in alto nel modulo.
- Espandi la sezione Script.
- Seleziona Aggiungi a Script.
- Compila i campi Nome script e Corpo script.
- Seleziona Salva.
Una volta che Bridge esegue il modulo Esegui script, queste informazioni saranno disponibili nel riquadro Log di esecuzione:
- Dati
- risultato: L'output di JavaScript
- Stato: Sezione che indica se il modulo ha funzionato o meno
- Codice: il codice di successo/errore che il modulo estrae da Smartsheet
- Messaggio: un messaggio generato dal sistema che il modulo estrae da Smartsheet. Ad esempio, se il modulo non riesce a trovare un valore, il messaggio che appare è Not found
- Stato: lo stato che il modulo estrae da Smartsheet. Le etichette di stato che potresti incontrare sono Successo e Fallito
Esempi
Esempio 1: Hello world
- Crea uno script in cui il Corpo Script è: return “Hello” + a.
Devi inserire return in ogni script per produrre una risposta.
- Nel modulo, aggiungi il parametro a con il valore mondo.
- Esegui flusso di lavoro:
Assicurati che il Key nel generatore di moduli corrisponda al parametro nel campo Corpo Script.
Valore è l’input intercambiabile. Ad esempio, può provenire da un output di una risposta precedente del modulo.
Il Nome Script non richiede virgolette per gli input di stringa, ma il Corpo Script sì. Altrimenti, ricevi un messaggio di errore.
Esempio 2: Operazioni di base
Per concatenare due stringhe:
- Crea uno script con il Corpo Script: return a + b.
- Nel modulo, aggiungi i parametri a e b con i valori 3 e 2, rispettivamente.
- Esegui flusso di lavoro:
Questo metodo concatena i due valori ma non li somma.
Le variabili impostate tramite Bridge sono trattate come stringhe.
Per sommare numeri:
- Crea uno script con il Corpo Script campo: return Number(a) + Number(b).
- Esegui flusso di lavoro:
Con gli stessi parametri dell'esempio qui sotto, il risultato questa volta è 5.
Esempio 3: iterazione su un array
Per questo esempio, abbiamo un flusso di lavoro con il modulo Elenco Fogli. Quando il flusso di lavoro viene eseguito, il registro delle esecuzioni fornisce i risultati qui sotto, dove dati è contrassegnato come Array [100]. Questo significa che il campo è un array.
Devi eseguire il flusso di lavoro per ottenere le informazioni dal registro delle esecuzioni.
- Seleziona i tre punti accanto a dati, quindi seleziona Copia Riferimento Dati.
- Aggiungi un nuovo modulo Esegui Script al flusso di lavoro.
- Crea un nuovo script JavaScript. Per questo esempio, lo chiamiamo ottieniPrimoElementoDiElencoFogli, e il Corpo dello Script è returnlistSheets[0]. Questo restituisce il primo elemento dell'array dati.
Il numero tra parentesi quadre definisce quale elemento dell'array viene restituito. 0 restituisce il primo, 1 restituisce il secondo, e così via.
Nel modulo JavaScript:
- Imposta ottieniPrimoElementoDiElencoFogli come Nome dello Script.
- Aggiungi un parametro di script con Chiave #1 chiamato elencoFogli.
- Incolla il riferimento dati copiato nel Passo 1 in Valore #1
Se eseguiamo il flusso di lavoro, il registro delle esecuzioni fornisce i risultati qui sotto.
Gli elementi qui sotto risultato fanno parte del primo elemento nell'array.
Limitazioni del prodotto/delle funzionalità
È possibile elaborare solo richieste e risposte del payload da 6 MB.
Con i prossimi aggiornamenti ciò potrebbe essere sottoposto a modifiche.
- Non vi è alcuna convalida dello script al momento della sua creazione. Se uno script presenta errori, è responsabilità dello sviluppatore eseguire il debug/correggere eventuali problemi ed errori restituiti durante l’esecuzione dello script.
- Il team Smartsheet non tiene traccia né gestisce le versioni e la cronologia degli script.
- Bridge è adatto a flussi di lavoro di tipo evento o basati su programmazioni fisse. Non sostituisce la funzionalità di sincronizzazione del mirror a uno o due canali fornita dai connettori. Per design, Bridge non fornisce garanzie di ordine né detiene alcuno stato sulle modifiche apportate in un sistema o nell’altro. Pertanto, le configurazioni simili a connettori sono inaffidabili e fortemente sconsigliate.