Moduli Salesforce
In uno scenario Adobe Workfront Fusion, è possibile automatizzare i flussi di lavoro che utilizzano Salesforce e collegarlo a più applicazioni e servizi di terze parti.
Per un video introduttivo sul connettore Salesforce, vedi:
Per istruzioni sulla creazione di uno scenario, consulta gli articoli in Creare scenari: indice degli articoli.
Per informazioni sui moduli, consulta gli articoli in Moduli: indice degli articoli.
- Non tutte le edizioni di Salesforce dispongono dell'accesso API. Per informazioni dettagliate, vedere le informazioni sulle edizioni Salesforce con accesso API sul sito della community Salesforce.
- Per informazioni su errori specifici restituiti dall'API Salesforce, vedere i documenti API Salesforce. È inoltre possibile controllare lo stato dell'API Salesforce per individuare eventuali interruzioni del servizio.
Requisiti di accesso
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Pacchetto Adobe Workfront |
Qualsiasi pacchetto Workflow di Adobe Workfront, e qualsiasi pacchetto Automation and Integration di Adobe Workfront. Workfront Ultimate Pacchetti Workfront Prime e Select, con un ulteriore acquisto di Workfront Fusion. |
| Licenze Adobe Workfront |
Standard Work o successiva |
| Licenza di Adobe Workfront Fusion |
Basata sulle operazioni: nessun requisito di licenza Workfront Fusion Basata su connettore (precedente): Workfront Fusion for Work Automation and Integration |
| Prodotto | Se la tua organizzazione dispone di un pacchetto Workfront Select o Prime che non include Workfront Automation and Integration, dovrà acquistare Adobe Workfront Fusion. |
Per ulteriori dettagli sulle informazioni contenute in questa tabella, consulta Requisiti di accesso nella documentazione.
Per informazioni sulle licenze di Adobe Workfront Fusion, consulta Licenze di Adobe Workfront Fusion.
Prerequisiti
Per utilizzare i moduli Salesforce, è necessario disporre di un account Salesforce.
Informazioni API di Salesforce
Il connettore Salesforce utilizza quanto segue:
Informazioni sulla ricerca di Salesforce oggetti
Durante la ricerca di oggetti, è possibile immettere singole parole di ricerca o creare una query più complessa utilizzando caratteri jolly e operatori:
- Utilizza il carattere jolly asterisco (*) in sostituzione di zero o più caratteri. Ad esempio, la ricerca di Ca* trova gli elementi che iniziano con Ca
- Utilizza un carattere jolly con punto interrogativo (?) come sostituto di un singolo carattere. Ad esempio, la ricerca di Jo?n consente di trovare elementi con il termine John o Joan ma non Jon
- Utilizza l’operatore tra virgolette (“”) per trovare una corrispondenza esatta della frase. Ad esempio: “Riunione del lunedì”
Per ulteriori informazioni sulle possibilità di ricerca, vedere la documentazione per gli sviluppatori Salesforce su SOQL e SOSL.
Creare una connessione ad Salesforce
Per creare una connessione per i moduli Salesforce:
-
In qualsiasi modulo di Salesforce, fai clic su Aggiungi accanto alla casella Connessione.
-
Compila i seguenti campi:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header Connection name (Nome della connessione) Inserisci un nome per la nuova connessione. Ambiente Seleziona se ti connetti a un ambiente di produzione o non di produzione. Tipo Specifica se ti connetti a un account di servizio o a un account personale. ID client Immetti l'ID client di Salesforce. Client Secret (Segreto client) Immetti il segreto del client Salesforce. Sandbox Abilita questa opzione se si tratta di un ambiente Sandbox. Versione API Immetti la versione dell’API Salesforce che desideri utilizzare. La versione predefinita è 62.0. -
Fai clic su Continue (Continua) per salvare la connessione e tornare al modulo.
Moduli Salesforce e relativi campi
Trigger
Osserva un campo
Questo modulo trigger avvia uno scenario quando un campo viene aggiornato in Salesforce.
Controlla i record
Questo modulo trigger esegue uno scenario quando viene creato o aggiornato un record in un oggetto. Il modulo restituisce tutti i campi standard associati al record oppure ai record, insieme a tutti i campi e i valori personalizzati a cui accede la connessione. Puoi mappare queste informazioni nei moduli successivi dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
Guarda i messaggi in uscita
Questo modulo di attivazione esegue uno scenario quando un utente invia un messaggio. Il modulo restituisce tutti i campi standard associati al record oppure ai record, insieme a tutti i campi e i valori personalizzati a cui accede la connessione. Puoi mappare queste informazioni nei moduli successivi dello scenario.
Questo modulo richiede una configurazione aggiuntiva. È necessario configurare un flusso per i messaggi in uscita.
- Per istruzioni sui flussi in Salesforce, vedi Automatizzare le attività con flussi nella documentazione di Salesforce.
- Per informazioni sulla configurazione di un messaggio in uscita in Salesforce, vedi Inviare un messaggio in uscita dal flusso attivato dal record nella documentazione di Salesforce
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
Azioni
Crea un record
Questo modulo di azione crea un nuovo record in un oggetto.
Il modulo ti consente di selezionare i campi dell’oggetto disponibili nel modulo. Questo riduce il numero di campi da scorrere durante la configurazione del modulo.
Il modulo restituisce l’ID del record e gli eventuali campi associati, insieme a eventuali campi e valori personalizzati a cui ha accesso la connessione. Puoi mappare queste informazioni nei moduli successivi dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
Chiamata API personalizzata
Questo modulo di azione consente di effettuare una chiamata autenticata personalizzata all’API Salesforce. In questo modo puoi creare un’automazione del flusso di dati che non può essere eseguita dagli altri moduli Salesforce.
Il modulo restituisce quanto segue:
-
Codice di stato (numero): indica il completamento o il mancato completamento della richiesta HTTP. I valori restituiti sono codici standard che puoi cercare su Internet.
-
Intestazioni (oggetto): un contesto più dettagliato per il codice di risposta/stato non correlato al corpo dell’output. Non tutte le intestazioni visualizzate in una risposta sono intestazioni di risposta, pertanto alcune potrebbero non risultarti utili.
Le intestazioni di risposta dipendono dalla richiesta HTTP che hai scelto durante la configurazione del modulo.
-
Corpo (oggetto): a seconda della richiesta HTTP che hai scelto al momento della configurazione del modulo, potresti ricevere alcuni dati. Tali dati, ad esempio i dati di una richiesta GET, sono contenuti in questo oggetto.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
Inserisci un percorso relativo a <Instance URL>/services/data/v62.0/.
Per l'elenco degli endpoint disponibili, fare riferimento alla Guida per gli sviluppatori di API REST di Salesforce.
{"Content-type":"application/json"}. Workfront Fusion aggiunge automaticamente le intestazioni di autorizzazione.{"name":"something-urgent"}Aggiungi il contenuto del corpo della chiamata API sotto forma di oggetto JSON standard.
Nota:
Quando utilizzi istruzioni condizionali come if nel codice JSON, racchiudi l’istruzione condizionale tra virgolette.
Esempio: La seguente chiamata API restituisce l’elenco di tutti gli utenti nel tuo account Salesforce:
-
URL:
query -
Metodo: GET
-
Stringa di query:
-
Chiave:
q -
Valore:
SELECT Id, Name, CreatedDate, LastModifiedDate FROM User LIMIT 10
Le corrispondenze della ricerca si trovano nell’output del modulo in Bundle > Corpo > record.
Nel nostro esempio, sono stati restituiti 6 utenti:
Eliminare un record
Questo modulo di azione elimina un record esistente in un oggetto.
Specifica l’ID del record.
Il modulo restituisce l’ID del record e gli eventuali campi associati, insieme a eventuali campi e valori personalizzati a cui ha accesso la connessione. Puoi mappare queste informazioni nei moduli successivi dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
Scarica Allegato/Documento
Questo modulo di azione scarica un documento o un allegato da un record.
Specificare l’ID del record e il tipo di download desiderato.
Il modulo restituisce l’ID dell’allegato o del documento e tutti i campi associati, insieme a eventuali campi e valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
Leggi un record
Questo modulo di azione legge i dati da un singolo oggetto in Salesforce.
Specifica l’ID del record.
Il modulo restituisce l’ID del record e gli eventuali campi associati, insieme a eventuali campi e valori personalizzati a cui ha accesso la connessione. Puoi mappare queste informazioni nei moduli successivi dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
Aggiorna un record
Questo modulo di azione modifica un record in un oggetto.
Il modulo ti consente di selezionare i campi dell’oggetto disponibili nel modulo. Questo riduce il numero di campi da scorrere durante la configurazione del modulo.
Il modulo restituisce l’ID del record e gli eventuali campi associati, insieme a eventuali campi e valori personalizzati a cui ha accesso la connessione. Puoi mappare queste informazioni nei moduli successivi dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
Carica allegato/documento
Questo modulo di azione carica un file e lo allega a un record specificato oppure carica un documento.
Il modulo restituisce l’ID dell’allegato o del documento e tutti i campi associati, insieme a eventuali campi e valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.
Carica file
Questo modulo di azione carica un singolo file in Salesforce.
Ricerche
Ricerca
Questo modulo di azione recupera tutti i record che soddisfano un determinato criterio.
Cerca con query
Questo modulo di ricerca cerca i record in un oggetto in Salesforce che corrispondono alla query di ricerca specificata. Puoi mappare queste informazioni nei moduli successivi dello scenario.
Durante la configurazione di questo modulo, vengono visualizzati i seguenti campi.