Documentazione Workfront Adobe Workfront Fusion

Salesforce moduli

Last update: Wed Feb 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:

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:

Salesforce

Per istruzioni sulla creazione di uno scenario, vedere gli articoli in Creare scenari: indice articolo.

Per informazioni sui moduli, vedere gli articoli in Moduli: indice articolo.

NOTE

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

Espandi per visualizzare i requisiti di accesso per la funzionalità in questo articolo.

Per utilizzare le funzionalità di questo articolo, è necessario disporre dei seguenti diritti 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
Licenza Adobe Workfront	Nuovo: Standard Oppure Corrente: Lavoro o versione successiva
Licenza Adobe Workfront Fusion**	Corrente: nessun requisito di licenza Workfront Fusion. Oppure Legacy: Workfront Fusion per l'automazione e l'integrazione del lavoro
Prodotto	Nuovo: Seleziona o crea un pacchetto Prime Workfront: la tua organizzazione deve acquistare Adobe Workfront Fusion. Pacchetto Ultimate Workfront: è incluso Workfront Fusion. Oppure Corrente: la tua organizzazione deve acquistare Adobe Workfront Fusion.

Per ulteriori dettagli sulle informazioni contenute in questa tabella, vedere Requisiti di accesso nella documentazione.

Per informazioni sulle Adobe Workfront Fusion licenze, vedere Adobe Workfront Fusion licenze.

Prerequisiti

Per utilizzare i moduli Salesforce, è necessario disporre di un account Salesforce.

Informazioni API di Salesforce

Il connettore Salesforce utilizza quanto segue:

URL di base

Versione API

v62.0

Tag API

v1.15.14

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.

Crea una connessione a Salesforce

Per creare una connessione per i moduli Salesforce:

In qualsiasi modulo Salesforce, fare clic su Add accanto alla casella Connessione.

Compila i campi seguenti:

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	Immettere un nome per la nuova connessione.
Environment	Seleziona se ti connetti a un ambiente di produzione o non di produzione.
Type	Specificare se ci si connette a un account di servizio o a un account personale.
Client ID	Immetti l'ID client di Salesforce.
Client Secret	Immetti il segreto del client Salesforce.
Sandbox	Abilita questa opzione se si tratta di un ambiente Sandbox.
API Version	Immetti la versione dell’API Salesforce che desideri utilizzare. La versione predefinita è 62.0.

Fare clic su Continue per salvare la connessione e tornare al modulo.

Trigger

Watch a field
Watch for Records
Watch Outbound Messages

Watch a field

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

Connection

Per istruzioni sulla connessione dell'account Salesforce a Workfront Fusion, vedere Creare una connessione a Adobe Workfront Fusion - Istruzioni di base.

Record Type

Selezionare il tipo di record contenente il campo che si desidera controllare nel modulo. Scegliere un tipo di record con Field History attivato nella configurazione di Salesforce. Per ulteriori informazioni, vedere Tracciamento cronologia campi nella documentazione di Salesforce.

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.

Watch for Records

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 dell'account Salesforce a Workfront Fusion, vedere Creare una connessione a Adobe Workfront Fusion - Istruzioni di base.

Type

Selezionare il tipo di record Salesforce che si desidera controllare nel modulo.

Record Fields

Selezionare i campi che si desidera controllare nel modulo. I campi disponibili dipendono dal tipo di record.

Maximal count of records

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.

Watch Outbound Messages

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:

Passare alla pagina di installazione di Salesforce.

Per accedere alla pagina di configurazione, individuare e fare clic sul pulsante con etichetta "Setup" nell'angolo superiore destro dell'account Salesforce. Dalla pagina di installazione di Salesforce, individuare la barra "Quick Find / Search" sul lato sinistro. Cerca "Workflow Rules".
Fare clic su Workflow Rules.
Nella pagina Workflow Rules visualizzata, fare clic su New Rule e selezionare il tipo di oggetto a cui applicare la regola (ad esempio "Opportunity" se si monitorano gli aggiornamenti ai record Opportunità).
Fare clic su Next.
Impostare un nome di regola, criteri di valutazione e criteri di regola, quindi fare clic su Save e Next.
Fare clic su Done.
Dalla regola del flusso di lavoro appena creata, fare clic su Edit.
Dall'elenco a discesa Add Workflow Action, selezionare New Outbound Message.
Specificare nome, descrizione, URL endpoint e campi da includere nel nuovo messaggio in uscita, quindi fare clic su Save.

Il campo Endpoint URL contiene l'URL specificato per Salesforce Outbound Message in Workfront Fusion.
Configurare uno scenario che inizia con l'evento Outbound Message.
Fai clic sull'icona </> in basso a destra e copia l'URL specificato.
Torna alla pagina Workflow Rules, individua la regola appena creata, quindi fai clic su Activate.

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, fare clic su Add e immettere il nome e la connessione del webhook.

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

Record Type

Selezionare il tipo di record Salesforce che si desidera che il modulo controlli per 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.

Azioni

Create a Record
Custom API Call
Delete a Record
Download Attachment/Document
Read a Record
Upload Attachment/Document
Carica file

Create a 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 dell'account Salesforce a Workfront Fusion, vedere Creare una connessione a Adobe Workfront Fusion - Istruzioni di base.

Record Type

Selezionare il tipo di record Salesforce che si desidera venga creato dal modulo. I campi diventano disponibili in base al tipo di record selezionato nel campo Record Type. Questi campi sono basati sull'API Salesforce.

Select fields to map

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.

Custom API Call

Questo modulo di azione consente di effettuare una chiamata autenticata personalizzata all'API Salesforce. In questo modo è possibile creare un'automazione del flusso di dati che non può essere eseguita dagli altri moduli Salesforce.

Il modulo restituisce quanto segue:

Status Code (numero): indica l'esito positivo o negativo della richiesta HTTP. Si tratta di codici standard che puoi cercare su Internet.
Headers (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.
Body (oggetto): a seconda della richiesta HTTP scelta durante la configurazione del modulo, alcuni dati potrebbero essere restituiti. Tali dati, ad esempio i dati di una richiesta GET, sono contenuti 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, vedere Metodi di richiesta HTTP.

Connection

Per istruzioni sulla connessione dell'account Salesforce a Workfront Fusion, vedere Creare una connessione a Adobe Workfront Fusion - Istruzioni di base.

URL

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

Per l'elenco degli endpoint disponibili, fare riferimento alla Guida per gli sviluppatori di 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.

Query String

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 come if nel JSON, inserire le virgolette al di fuori dell'istruzione condizionale.

Delete a Record

Questo modulo di azione elimina un record esistente in un oggetto.

Specifica l’ID del record.

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

Connection

Per istruzioni sulla connessione dell'account Salesforce a Workfront Fusion, vedere Creare una connessione a Adobe Workfront Fusion - Istruzioni di base.

Record Type

Selezionare il tipo di record Salesforce da eliminare dal modulo.

Immettere o mappare l'ID Salesforce univoco del record che si desidera eliminare dal modulo.

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

Download Attachment/Document

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 dell'account Salesforce a Workfront Fusion, vedere Creare una connessione a Adobe Workfront Fusion - Istruzioni di base.

Type of Download

Specifica il tipo di file da scaricare da Salesforce.

Attachment
Document
ContentDocument Questo documento è stato caricato in una raccolta in Saleforce CRM Content o Salesforce Files.

ID /

Attachment ID /

ContentDocument ID

Immettere o mappare l'ID Salesforce univoco del record che si desidera scaricare dal modulo.

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

Read a Record

Questo modulo di azione legge i dati da un singolo oggetto in Salesforce.

Specifica l’ID del record.

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

Connection

Per istruzioni sulla connessione dell'account Salesforce a Workfront Fusion, vedere Creare una connessione a Adobe Workfront Fusion - Istruzioni di base.

Record Type

Selezionare il tipo di record Salesforce che si desidera impostare come [action] per il modulo.read.

Record Fields

Seleziona i campi che desideri che il modulo legga. Selezionare almeno un campo.

Immettere o mappare l'ID Salesforce univoco del record che si desidera venga letto dal modulo.

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

INFO

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> Body >records.

Nel nostro esempio, sono stati restituiti 6 utenti:

Update a 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.

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

Connection

Per istruzioni sulla connessione dell'account Salesforce a Workfront Fusion, vedere Creare una connessione a Adobe Workfront Fusion - Istruzioni di base.

Immetti o mappa l’ID del record da aggiornare.

Record Type

Selezionare il tipo di record Salesforce da aggiornare nel modulo. I campi diventano disponibili in base al tipo di record selezionato nel campo Tipo di record. Questi campi sono basati sull'API Salesforce.

Select fields to map

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.

Upload Attachment/Document

Questo modulo di azione carica un file e lo allega a un record specificato oppure carica un documento.

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

Connection

Per istruzioni sulla connessione dell'account Salesforce a Workfront Fusion, vedere Creare una connessione a Adobe Workfront Fusion - Istruzioni di base.

Type of Upload

Seleziona se vuoi che il modulo carichi un allegato o un documento.

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.

Source File

Selezionare un file di origine da un modulo precedente o mappare il nome e i dati del file di origine.

Carica file

Questo modulo di azione carica un singolo file in Salesforce.

Ricerche

Search with 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 dell'account Salesforce a Workfront Fusion, vedere Creare una connessione a Adobe Workfront Fusion - Istruzioni di base

Source file

Selezionare un file di origine da un modulo precedente o mappare il nome e i dati del file di origine.

Document linking

Seleziona se applicare un collegamento al documento di contenuto.

linkedEntityId

Se si utilizza il collegamento di documenti, immettere o mappare l'ID dell'oggetto collegato.

ShareType

Se si utilizza il collegamento di documenti, selezionare le autorizzazioni per il file.

Autorizzazione visualizzatore

L’utente può visualizzare il file.
Autorizzazione collaboratore

L’utente può visualizzare e modificare il file.
Autorizzazioni dedotte

Le autorizzazioni si basano sulle autorizzazioni dell'utente per il record correlato, ad esempio una libreria.

Visibility

Se si utilizza il collegamento del documento, immettere o mappare la visibilità del documento.

AllUsers

Disponibile per tutti gli utenti con autorizzazioni
InternalUsers

Disponibile per gli utenti interni con autorizzazioni.
SharedUsers

Disponibile per gli utenti che possono visualizzare il feed in cui è pubblicato il file.

Connection

Per istruzioni sulla connessione dell'account Salesforce a Workfront Fusion, vedere Creare una connessione a Adobe Workfront Fusion - Istruzioni di base.

Search Type

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

Simple
Using SOSL (Salesforce Object Search Language)
Using SOQL (Salesforce Object Query Language)

Type

Se è stato selezionato il tipo di ricerca Semplice, scegliere il tipo di record Salesforce 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 Salesforce Object Search Language (SOSL) nella documentazione di Salesforce.

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

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

Maximal count of records

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

Search

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

Connection

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

Type

Selezionare il tipo di oggetto che si desidera cercare.

Search criteria

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.

Outputs

Selezionare i campi da includere nell'output del modulo.

Result set

Selezionare se si desidera che il modulo restituisca tutti i record corrispondenti o solo il primo record corrispondente.

Maximal

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

recommendation-more-help

7e1891ad-4d59-4355-88ab-a2e62ed7d1a3