Salesforce moduli

In uno scenario Adobe Workfront Fusion, puoi automatizzare i flussi di lavoro che utilizzano Salesforce, oltre a 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 Creare uno scenario in Adobe Workfront Fusion.

Per informazioni sui moduli, consulta Moduli in Adobe Workfront Fusion.

NOTE
  • Non tutte le edizioni di Salesforce disporre dell’accesso API. Per ulteriori informazioni, vedere Salesforce edizioni con accesso API su Salesforce Sito della community.
  • Per informazioni su errori specifici restituiti dal Salesforce API, consulta Salesforce Documenti API. Puoi anche controllare lo stato del Salesforce API per eventuali interruzioni del servizio.

Requisiti di accesso

Per utilizzare le funzionalità di questo articolo, è necessario disporre dei seguenti diritti di accesso:

Adobe Workfront piano*
Pro o versione successiva
Adobe Workfront licenza*
Plan, Work
Adobe Workfront Fusion licenza**

Fabbisogno di licenza corrente: No Workfront Fusion requisito di licenza.

Oppure

Requisito licenza legacy: Workfront Fusion per l'automazione e l'integrazione del lavoro

Prodotto

Fabbisogno prodotto corrente: se si dispone di Select o Prime Adobe Workfront Pianifica, la tua organizzazione deve acquistare Adobe Workfront Fusion nonché Adobe Workfront per utilizzare la funzionalità descritta in questo articolo. Workfront Fusion è incluso in Ultimate Workfront piano.

Oppure

Requisiti del prodotto legacy: la tua organizzazione deve acquistare Adobe Workfront Fusion nonché Adobe Workfront per utilizzare la funzionalità descritta in questo articolo.

Per conoscere il piano, il tipo di licenza o l'accesso di cui si dispone, contattare Workfront amministratore.

Per informazioni su Adobe Workfront Fusion licenze, consulta Adobe Workfront Fusion licenze.

Prerequisiti

Da utilizzare Salesforce moduli, è necessario disporre di un Salesforce account.

Informazioni sulla ricerca 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, vedi Salesforce documentazione per gli sviluppatori su SOQL e SOSL.

Salesforce moduli e relativi campi

Triggers

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 o ai record, insieme a tutti i campi e i valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.

Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.

Connection
Per istruzioni sulla connessione Salesforce account a Workfront Fusion, vedi Creare una connessione a Adobe Workfront Fusion - Istruzioni di base
Type
Seleziona il tipo di Salesforce registrare che si desidera che il modulo controlli.
Campi Record
Selezionare i campi che si desidera controllare nel modulo. I campi disponibili dipendono dal tipo di record.
Conteggio massimo dei record
Immettere o mappare il numero massimo di record che il modulo deve restituire durante ogni ciclo di esecuzione dello scenario.
Watch
Determinare se si desidera che lo scenario controlli solo i nuovi record del tipo selezionato o i nuovi record del tipo selezionato e tutte le altre modifiche apportate ai record di tale tipo.

Osservare 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 o ai record, insieme a tutti i campi e i valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.

Questo modulo richiede una configurazione aggiuntiva:

  1. Vai a Salesforce pagina di impostazione.

    Per accedere alla pagina di impostazione, individuare e fare clic sul pulsante "Configurazione" nell’angolo in alto a destra del Salesforce account. Dalla sezione Salesforce , individua la "Ricerca rapida" barra a sinistra. Cerca "Regole flusso di lavoro."

  2. Clic Regole flusso di lavoro.

  3. Nella sezione Regole flusso di lavoro pagina visualizzata, fai clic su Nuova regola e seleziona il tipo di oggetto a cui applicare la regola (ad esempio "opportunità" se stai monitorando gli aggiornamenti dei record Opportunità).

  4. Clic Successivo.

  5. Imposta un nome di regola, criteri di valutazione e criteri di regola, quindi fai clic su Salva e Successivo.

  6. Clic Fine.

  7. Dalla regola del flusso di lavoro appena creata, fai clic su Modifica

  8. Dalla sezione Azione Aggiungi flusso di lavoro elenco a discesa, seleziona Nuovo messaggio in uscita.

  9. Specifica nome, descrizione, URL endpoint e campi da includere nel nuovo messaggio in uscita, quindi fai clic su Salva.

    Il URL endpoint contiene l'URL fornito sul Salesforce Messaggio in uscita in Workfront Fusion.

  10. Configurare uno scenario che inizia con Messaggio in uscita evento.

  11. Fai clic su </> in basso a destra e copia l’URL fornito.

  12. Torna a Regole flusso di lavoro , individuare la regola appena creata, quindi fare clic su Attiva.

Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.

Webhook

Seleziona il webhook che desideri utilizzare per guardare i messaggi in uscita. Per aggiungere un webhook, fai clic su Add e inserisci il nome e la connessione del webhook.

Per istruzioni sulla connessione Salesforce account a Workfront Fusion, vedi Creare una connessione a Adobe Workfront Fusion - Istruzioni di base

Tipo di record
Seleziona il tipo di Salesforce registrare che si desidera che il modulo controlli i messaggi in uscita.
Fields
Seleziona i campi che desideri che il modulo controlli per i messaggi in uscita. I campi disponibili dipendono dal tipo di record.

Osserva un campo

Questo modulo trigger avvia uno scenario quando un campo viene aggiornato in Salesforce.

Connection
Per istruzioni sulla connessione Salesforce account a Workfront Fusion, vedi Creare una connessione a Adobe Workfront Fusion - Istruzioni di base
Tipo di record
Selezionare il tipo di record contenente il campo che si desidera controllare nel modulo. È necessario scegliere un tipo di record in cui sia attivato Field History Salesforce configurazione. Per ulteriori informazioni, consulta Tracciamento cronologia campi nel Salesforce documentazione.
Field
Selezionare i campi che si desidera che il modulo controlli per verificare le modifiche.
Limit
Immettere o mappare il numero massimo di campi che il modulo deve restituire durante ogni ciclo di esecuzione dello scenario.

Azioni

Crea un record

Questo modulo di azione crea un nuovo record in un oggetto.

Il modulo consente di selezionare quale dei campi dell’oggetto è disponibile nel modulo. Questo riduce il numero di campi da scorrere durante la configurazione del modulo.

Il modulo restituisce l’ID del record ed eventuali campi associati, insieme a eventuali campi e valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.

Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.

Connection
Per istruzioni sulla connessione Salesforce account a Workfront Fusion, vedi Creare una connessione a Adobe Workfront Fusion - Istruzioni di base
Tipo di record
Seleziona il tipo di Salesforce che si desidera creare nel modulo. I campi diventano disponibili in base al tipo di record selezionato nel campo Tipo di record. Questi campi si basano su Salesforce API.
Seleziona campi da mappare

Selezionare i campi che si desidera configurare nel modulo durante la creazione del nuovo record. I campi obbligatori si trovano all’inizio dell’elenco.

I campi selezionati vengono aperti sotto questo campo. È ora possibile immettere valori in questi 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 ed eventuali campi associati, insieme a eventuali campi e valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.

Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.

Connection
Per istruzioni sulla connessione Salesforce account a Workfront Fusion, vedi Creare una connessione a Adobe Workfront Fusion - Istruzioni di base
Tipo di record
Seleziona il tipo di Salesforce record che si desidera impostare come [action] per il modulo.leggi.
Campi Record
Seleziona i campi che desideri che il modulo legga. Selezionare almeno un campo.
ID

Inserisci o mappa l’univoco Salesforce ID del record che desideri che il modulo legga.

Per ottenere l’ID, apri la Salesforce nel browser e copia il testo alla fine dell’URL dopo l’ultima barra (/). Ad esempio: https://eu5.salesforce.com/<object ID>

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 ed eventuali campi associati, insieme a eventuali campi e valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.

Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.

Connection
Per istruzioni sulla connessione Salesforce account a Workfront Fusion, vedi Creare una connessione a Adobe Workfront Fusion - Istruzioni di base
Tipo di record
Seleziona il tipo di Salesforce che si desidera eliminare dal modulo.
ID

Inserisci o mappa l’univoco Salesforce ID del record che desideri eliminare dal modulo.

Per ottenere l’ID, apri la Salesforce nel browser e copia il testo alla fine dell’URL dopo l’ultima barra (/). Ad esempio: https://eu5.salesforce.com/<object ID>

Chiamata API personalizzata

Questo modulo di azione consente di effettuare una chiamata autenticata personalizzata al Salesforce API. In questo modo, puoi creare un’automazione del flusso di dati che non può essere eseguita dall’altro Salesforce moduli.

Il modulo restituisce quanto segue:

  • Codice di stato (numero): indica l’esito positivo o negativo della richiesta HTTP. Si tratta di codici standard che puoi cercare su Internet.

  • Intestazioni (oggetto): contesto più dettagliato per il codice di risposta/stato che non è correlato al corpo di output. Non tutte le intestazioni visualizzate in un’intestazione di risposta sono intestazioni di risposta, quindi alcune potrebbero non essere utili.

    Le intestazioni di risposta dipendono dalla richiesta HTTP scelta durante la configurazione del modulo.

  • Corpo (oggetto): a seconda della richiesta HTTP scelta durante la configurazione del modulo, alcuni dati potrebbero essere restituiti. Tali dati, come i dati provenienti da un GET richiesta, è contenuto in questo oggetto.

Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.

Seleziona il metodo di richiesta HTTP necessario per configurare la chiamata API. Per ulteriori informazioni, consulta Metodi di richiesta HTTP in Adobe Workfront Fusion.

Connection
Per istruzioni sulla connessione Salesforce account a Workfront Fusion, vedi Creare una connessione a Adobe Workfront Fusion - Istruzioni di base
URL

Inserisci un percorso relativo a <Instance URL>/services/data/v46.0/.

Per l’elenco degli endpoint disponibili, consulta Guida per gli sviluppatori API REST di Salesforce.

Method
Headers
Aggiungi le intestazioni della richiesta sotto forma di oggetto JSON standard. Ad esempio, {"Content-type":"application/json"}. Workfront Fusion aggiunge automaticamente le intestazioni di autorizzazione.
Stringa Di Query
Aggiungi la query per la chiamata API sotto forma di oggetto JSON standard. Ad esempio: {"name":"something-urgent"}
Body

Aggiungi il contenuto body per la chiamata API sotto forma di oggetto JSON standard.

Nota:

Quando si utilizzano istruzioni condizionali quali if nel JSON, inserisci le virgolette al di fuori dell’istruzione condizionale.

INFO
Esempio: La seguente chiamata API restituisce l’elenco di tutti gli utenti nel tuo Salesforce account:
  • 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:

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 nello scenario.

Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.

Connection
Per istruzioni sulla connessione Salesforce account a Workfront Fusion, vedi Creare una connessione a Adobe Workfront Fusion - Istruzioni di base
Tipo di caricamento
Seleziona se vuoi che il modulo carichi un allegato o un documento.
ID
Immettere o mappare l'ID dell'oggetto a cui si desidera caricare un allegato.
Folder
Seleziona la cartella contenente il file da caricare nel modulo.
File di origine
Selezionare un file di origine da un modulo precedente o mappare il nome e i dati del file di origine.

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 nello scenario.

Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.

Connection
Per istruzioni sulla connessione Salesforce account a Workfront Fusion, vedi Creare una connessione a Adobe Workfront Fusion - Istruzioni di base
Tipo di download

Specifica il tipo di file da scaricare da Salesforce.

  • Attachment
  • Documento
  • ContentDocument (documento caricato in una raccolta in Saleforce CRM Content o Salesforce Files.)

ID /

ID allegato /

ID ContentDocument

Inserisci o mappa l’univoco Salesforce ID del record che desideri scaricare dal modulo.

Per ottenere l’ID, apri la Salesforce nel browser e copia il testo alla fine dell’URL dopo l’ultima barra (/). Ad esempio: https://eu5.salesforce.com/<object ID>

Aggiornare un record

Questo modulo di azione modifica un record in un oggetto.

Il modulo consente di selezionare quale dei campi dell’oggetto è disponibile nel modulo. Questo riduce il numero di campi da scorrere durante la configurazione del modulo.

Il modulo restituisce l’ID del record ed eventuali campi associati, insieme a eventuali campi e valori personalizzati a cui la connessione accede. Puoi mappare queste informazioni nei moduli successivi nello scenario.

Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.

Connection
Per istruzioni sulla connessione Salesforce account a Workfront Fusion, vedi Creare una connessione a Adobe Workfront Fusion - Istruzioni di base
ID
Immetti o mappa l’ID del record da aggiornare.
Tipo di record
Seleziona il tipo di Salesforce che desideri aggiornare il modulo. I campi diventano disponibili in base al tipo di record selezionato nel campo Tipo di record. Questi campi si basano su Salesforce API.
Seleziona campi da mappare

Selezionare i campi che si desidera configurare nel modulo durante la creazione del nuovo record. I campi obbligatori si trovano all’inizio dell’elenco.

I campi selezionati vengono aperti sotto questo campo. È ora possibile immettere valori in questi campi.

Ricerche

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 nello scenario.

Durante la configurazione di questo modulo, vengono visualizzati i campi seguenti.

Connection
Per istruzioni sulla connessione Salesforce account a Workfront Fusion, vedi Creare una connessione a Adobe Workfront Fusion - Istruzioni di base
Tipo di ricerca

Selezionare il tipo di ricerca che si desidera venga eseguita dal modulo:

  • semplice

  • Tramite SOSL (Salesforce Object Search Language)

  • Tramite SOQL (Salesforce Object Query Language)

Type
Se è stato selezionato il tipo di ricerca Semplice, scegliere il tipo di Salesforce record che si desidera cercare nel modulo.
Query / SOSL Query / SOQL Query

Immettere la query in base alla quale si desidera eseguire la ricerca.

Per ulteriori informazioni su SOSL, vedere Linguaggio di ricerca oggetti Salesforce (SOSL) nel Salesforce documentazione.

Per ulteriori informazioni su SOQL, vedere Salesforce Object Query Language (SOQL) nel Salesforce documentazione.

Nota: il valore del parametro RETURNING influenza l’output del modulo. Se usa LIMIT, Fusion ignorerà le impostazioni nel campo Conteggio massimo dei record. Se non si imposta alcun limite, verrà inserito il valore LIMIT = Maximal count of records.

Conteggio massimo dei record
Immettere o mappare il numero massimo di record che il modulo deve restituire durante ogni ciclo di esecuzione dello scenario.

Ricerca

Questo modulo di azione recupera tutti i record che soddisfano un determinato criterio.

Connection
Per istruzioni sulla connessione Salesforce account a Workfront Fusion, vedi Creare una connessione a​ Adobe Workfront Fusion - Istruzioni di base
Type
Selezionare il tipo di oggetto che si desidera cercare.
Criteri di ricerca di
Selezionare il campo in base al quale si desidera eseguire la ricerca, l'operatore che si desidera utilizzare nella query e il valore ricercato nel campo. È possibile connettere le query utilizzando AND o OR.
Output
Selezionare i campi da includere nell'output del modulo.
Set di risultati
Selezionare se si desidera che il modulo restituisca tutti i record corrispondenti o solo il primo record corrispondente.
max
Immettere o mappare il numero massimo di record che il modulo deve recuperare durante ogni ciclo di esecuzione dello scenario.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43