Nella pagina Lightning di Salesforce, passa alla scheda Amministratore Adobe Acrobat Sign.
Ultimo aggiornamento il
29 ott 2024
- Integrazioni di Adobe Acrobat Sign
- Novità
- Versioni del prodotto e ciclo di vita
- Acrobat Sign per Salesforce
- Installare il pacchetto
- Configurare il pacchetto
- Guida utente
- Abilitare l’autenticazione dell’identità digitale
- Guida per sviluppatori
- Guida alla personalizzazione avanzata
- Guida alla mappatura dei campi e ai modelli
- Guida utente dell’app per dispositivi mobili
- Guida all’automazione dei flussi
- Guida di Document Builder
- Configurare documenti di grandi dimensioni
- Guida all’aggiornamento
- Note sulla versione
- Domande frequenti
- Guida alla risoluzione dei problemi
- Articoli aggiuntivi
- Acrobat Sign per Microsoft
- Acrobat Sign per Microsoft 365
- Acrobat Sign per Outlook
- Acrobat Sign per Word/PowerPoint
- Acrobat Sign per Teams
- Acrobat Sign per Microsoft PowerApps e Power Automate
- Connettore Acrobat Sign per ricerca Microsoft
- Acrobat Sign per Microsoft Dynamics
- Acrobat Sign per Microsoft SharePoint
- Panoramica
- SharePoint On-Prem: guida all’installazione
- SharePoint On-Prem: guida alla mappatura dei modelli
- SharePoint On-Prem: guida utente
- SharePoint On-Prem: note sulla versione
- SharePoint Online: guida all’installazione
- SharePoint Online: guida alla mappatura dei modelli
- SharePoint Online: guida utente
- SharePoint Online: guida alla mappatura dei moduli web
- SharePoint Online: note sulla versione
- Acrobat Sign per Microsoft 365
- Acrobat Sign per ServiceNow
- Acrobat Sign per HR ServiceNow
- Acrobat Sign per SAP SuccessFactors
- Acrobat Sign per Workday
- Acrobat Sign per NetSuite
- Acrobat Sign per SugarCRM
- Acrobat Sign per VeevaVault
- Acrobat Sign per Coupa BSM Suite
- Acrobat Sign per Zapier
- Documentazione per sviluppatori Acrobat Sign
Non riesci a inviare accordi da Salesforce? Le mappature dei dati non aggiornano i campi Salesforce?
Adobe Acrobat Sign for Salesforce: guida alla risoluzione dei problemi è pensata per aiutarti a risolvere i problemi relativi all’invio di accordi da Salesforce, mappature dati o aggiornamenti automatici dello stato. Scopri come:
- Risolvere i problemi relativi alle mappature dati
- Risoluzione dei problemi relativi all’invio degli accordi
- Risoluzione dei problemi relativi agli aggiornamenti di stato automatici
- Risoluzione dei problemi che possono verificarsi dopo l’abilitazione dei domini avanzati
- Risoluzione dei problemi di ricerca dei lead nell’ambiente Government Cloud
- Contatta l’assistenza tecnica
Le mappature dati di Acrobat Sign consentono di aggiornare gli oggetti Salesforce quando viene firmato un accordo Acrobat Sign o in una fase specifica del flusso di lavoro dell’accordo. Ciascuna mappatura dati viene configurata in anticipo e include le regole di mappatura dati. Ciascuna regola di mappatura dati definisce l’origine dati e il campo Salesforce di destinazione che deve aggiornare. Per ulteriori informazioni, consulta Mappatura dati Salesforce.
Se la mappatura dati non aggiorna un campo Salesforce, esegui i seguenti passaggi per identificare e risolvere il problema:
Per eseguire questa operazione:
-
Assicurati che l’utente dell’aggiornamento automatico dello stato (in genere l’amministratore dell’account Sign utilizzato per configurare l’integrazione) e che il mittente abbia accesso agli oggetti che stai tentando di aggiornare con Mappatura dati.
Per verificare il valore del campo, puoi aggiungere il campo alla vista Elenco accordi, utilizzare la Developer Console o il Workbench.
Assicurati che il campo “Risultato mappatura dati” sull’oggetto “Accordo” abbia il valore “Completato” o “Non riuscito”. Se non è presente alcun valore, significa che la mappatura dati non è stata attivata affatto. Se il valore è vuoto e il campo “Mappatura dati” ha l’ID utente compilato, prova a riattivare la mappatura dati nel modo seguente:
Il campo Errore di mappatura dati memorizza gli errori dalla mappatura dati. Puoi controllare il valore del campo aggiungendolo alla vista Elenco accordi, utilizzando la developer console o tramite Workbench. Di seguito è riportato un elenco di errori comuni e passaggi di risoluzione corrispondenti:
| Errore | Failed to map data field: System.DmlException Update failed. Prima eccezione alla riga 0 con id 00ZxxqwertasdmjVUAR; primo errore: STRING_TOO_LONG, Titolo proprietario: valore dati troppo grande: Adobe Acrobat Sign Adobe inc (lunghezza massima=20): [Owner_Title__c] (echosign_dev1) 165 |
Soluzione: Questo errore indica che i dati nel campo modulo del documento aggiornato superano il limite di dimensione del campo Salesforce che stai tentando di aggiornare. Per risolvere:
|
|
| Errore |
Tentativo di eseguire la mappatura a un riferimento oggetto correlato che non è stato impostato sull’accordo: <api name of field on the Salesforce object you are trying to update>” |
Soluzione: Questo errore indica che non è stata stabilita una connessione tra l’oggetto Accordo e l’oggetto Salesforce che si sta tentando di aggiornare. Consulta il passaggio 4 precedente. |
|
| Errore |
Failed to map data field: System.NullPointerException Attempt to de-reference a null object (echosign_dev1) 656 |
Soluzione Questo errore indica che la mappatura dei dati non è riuscita perché non è stato possibile accedere a un oggetto richiesto. Prova i seguenti passaggi per risolvere l’errore:
|
Utente di esempio:
John Smith
Esempio di caso d’uso:
John vuole:
- inviare gli accordi da un oggetto personalizzato denominato “Demo 1”; utilizzando un modello di accordo,
- estrarre le informazioni da un altro oggetto personalizzato denominato “Demo 2” associato all’oggetto “Demo 1” e inviare l’accordo e
- Trasmettere le informazioni al record dell’oggetto “Demo 2” una volta firmato l’accordo.
Passaggi per raggiungere gli obiettivi del caso d’uso:
- Nell’oggetto “Accordo” di Acrobat Sign, crea un campo di ricerca per l’oggetto “Demo 1”.
- Sull’oggetto “Demo 1”, crea un campo di ricerca per l’oggetto “Demo 2”.
Non è possibile richiamare o trasmettere le informazioni da/a un elenco correlato. - Creare un modello di mappatura dati nel modo seguente:
- Assegna un nome univoco al modello.
- In Mappature campi, seleziona Oggetto selezionato, quindi seleziona Demo 1 dal menu a discesa.
- Dal secondo menu a discesa che viene caricato, seleziona ID Demo 2.
- Nel terzo menu a discesa che viene caricato, lascialo come “Nessuno” e seleziona Seleziona.
- In “Quale campo Salesforce aggiornare?”, scegli il nome del campo da aggiornare.
- Per completare la configurazione della mappatura dati, segui i passaggi nella sezione Usa mappature dati per trasmettere dati e file dei firmatari ai record Salesforce nella guida Mappature e modelli.
- Crea un modello di mappatura unione nel modo seguente:
- Assegna un nome univoco al modello.
- Seleziona Aggiungi mappatura campi.
- In Valore di origine, seleziona Oggetto selezionato, quindi seleziona Demo 1 dal menu a discesa.
- Dal secondo menu a discesa che viene caricato, seleziona ID Demo 2.
- Dal menu a discesa successivo che viene caricato, seleziona il nome del campo con il valore da richiamare e seleziona Fine.
- Per completare la configurazione della mappatura unione, segui i passaggi nella sezione Utilizzare le mappature unione per generare documenti con dati Salesforce nella guida Mappature e modelli.
- Crea un modello di accordo seguendo i passaggi descritti in Creare modelli e flussi di lavoro.
- Nel modello di accordo appena creato, assicurati che i modelli di mappatura unione e mappatura dati siano inclusi nella sezione “Mappatura dati”.
- Nella sezione Dettagli del modello del modello di accordo, seleziona l’oggetto Salesforce come Demo 1.
- Seleziona Mappatura dei dati nei campi dell’accordo e nella finestra di dialogo visualizzata:
- Seleziona l’opzione Seleziona da oggetto.
- In Tipo di origine, seleziona ID Demo 1.
- In Campo Accordo di destinazione, seleziona l’oggetto Demo 1 nel campo di ricerca.
- Seleziona Salva.
- Nel modello di accordo, seleziona Salva.
Crea un modello di accordo collegato all’oggetto “Demo 1” con mappatura unione e mappatura dati attivata. - Apri un record dell’oggetto “Demo 1” e seleziona
> Modifica pagina. Quindi, dalla sezione Gestione personalizzata nel pannello a sinistra, trascina AgreementPanel e seleziona Salva. - Seleziona Attivazione e assegna la pagina del record in base alle tue esigenze. A scopo di test, scegli “Assegna come impostazione predefinita a livello di organizzazione”, che rende visibile “AgreementPanel“ a tutti gli utenti.
- Seleziona Avanti e Salva.
- Accedi al record dell’oggetto “Demo 1” e aggiorna la pagina. Sarà visualizzato il pannello “AgreementPanel” che hai aggiunto.
- Seleziona Invia accordo per la firma. Viene visualizzato il modello di accordo che hai creato.
- Seleziona il modello di accordo e segui i passaggi riportati nella schermata per inviare l’accordo. Verifica che l’accordo includa i dati uniti di “Demo 2“.
- Firma l’accordo. Mostra il record “Demo 2” aggiornato con il valore dell’accordo.
Se non riesci a inviare accordi da Salesforce, esegui i passaggi di risoluzione di problemi riportati di seguito:
-
Assicurati di disporre di una versione di Adobe Acrobat Sign supportata. Consulta Versioni supportate.
-
Assicurati di disporre delle autorizzazioni necessarie in qualità di mittente.
Consulta Come concedere l’accesso richiesto agli utenti. Oltre agli oggetti e ai campi menzionati nella guida, il mittente deve avere accesso ad altri oggetti Salesforce utilizzati nel flusso di lavoro. -
Verifica se l’oggetto “Accordo” o altri oggetti di Acrobat Sign in Salesforce dispongono di personalizzazioni quali trigger, flussi di lavoro o regole. In caso affermativo, disattiva tutte le personalizzazioni e invia un accordo di prova per verificarne il completamento.
Se l’accordo viene inviato correttamente dopo aver disattivato le personalizzazioni, consulta Guida per sviluppatori per le linee guida.
Nota:Il supporto per la risoluzione dei problemi di personalizzazione non viene fornito.
-
Per identificare il tipo di errore ricevuto durante l’invio dell’accordo, utilizza uno dei modi seguenti:
- Apri il record dell’accordo interessato in Salesforce e verifica la presenza di un banner rosso con un messaggio di errore.Questo errore deve indicare la causa principale.
- Controlla il campo “Messaggio di errore” nell’oggetto “Notifica di accordo“.
- Per verificare tramite la Developer Console ed eseguire la seguente query SOQL:
Select echosign_dev1__Error_Message__c from
echosign_dev1__Agreement_Notification__c where
echosign_dev1__Agreement__c = ‘<enter agreement id>
-
Per risolverlo, consulta la tabella seguente di errori e passaggi:
Errore
Soluzione
ID utente o e-mail non validi forniti nell’intestazione x-api-user
ONon disponi di un account utente Adobe Acrobat Sign valido
Questi errori indicano che il mittente non dispone di una licenza Acrobat Sign valida. Per risolvere questi problemi:
- Controlla il campo Mittente registrato nel record dell’accordo per identificare il mittente dell’accordo.
Se è impossibile trovare un utente nel campo Mittente registrato in Salesforce, il pacchetto di Acrobat Sign utilizzerà il campo Creato da come “mittente“ dell’accordo. - Passa alla pagina Dettagli utente del mittente in Salesforce e assicurati che il campo E-mail disponga di un indirizzo e-mail valido e di una licenza Sign Enterprise attiva. Per verificare se l’indirizzo e-mail dispone di una licenza Sign Enterprise attiva.
- Effettua l’accesso ad Acrobat Sign utilizzando le credenziali di amministratore.
- Passa a Account > Utenti e cerca l’indirizzo e-mail.
- Lo stato dell’utente deve essere attivo. Gli utenti che non dispongono di uno stato “attivo” non possono inviare accordi. Se l’utente non è attivo, scopri come Aggiungere e gestire gli utenti e consulta i passaggi nella sezione “L’e-mail è in uso, ma lo stato dell’utente non è Attivo”.
- Se è utilizzata la funzione Invia per conto di (SOB), convalida l’indirizzo e-mail dell’utente verificando il campo Invia per conto di nell’oggetto Accordo. Assicurati che l’indirizzo e-mail di questo utente disponga di una licenza Sign valida accedendo ad Acrobat Sign. Assicurati che il campo Consenti l’invio come altri utenti sia abilitato nella pagina SOB dell’utente Dettagli utente. Per impostazione predefinita, questo campo potrebbe non essere visibile nel layout di pagina dell’oggetto Utente.
- Verifica le autorizzazioni dell’utente come nel passaggio n. 2 precedente.Consulta Come concedere l’accesso richiesto agli utenti.
Il formato del file non è supportato
Questo errore si verifica quando il documento che stai tentando di inviare per la firma non è in un formato supportato.
Consulta la sezione Formati documento supportati in Requisiti di sistema per Acrobat Sign per verificare quali formati di file sono supportati per il caricamento in Acrobat Sign.
ID oggetto errato utilizzato nel pulsante firma
Questo errore si verifica quando l’ID del modello o l’ID principale dell’oggetto del pulsante Invia per conto di non è valido.
Ti consigliamo di immettere l’ID oggetto corretto e quindi di riprovare il processo.
- Controlla il campo Mittente registrato nel record dell’accordo per identificare il mittente dell’accordo.
Se un accordo non viene aggiornato con lo stato corretto, continua con i passaggi di risoluzione dei problemi riportati di seguito:
-
Verifica di aver implementato i prerequisiti e le configurazioni dopo l’installazione (obbligatorie) indicate nella Guida all’installazione di Adobe Acrobat Sign for Salesforce.
-
Nella pagina Lightning di Salesforce, vai ad Amministratore Adobe Acrobat Sign > Abilita aggiornamenti di stato automatici e assicurati di visualizzare il messaggio “Gli aggiornamenti di stato automatici sono abilitati per questa organizzazione.”
Se il messaggio non è visualizzato, procedi come segue:
- Esci e accedi nuovamente come amministratore di sistema.
- Vai ad Amministratore Adobe Acrobat Sign > Abilita aggiornamenti di stato automatici e seleziona Abilita.
- Nella finestra di dialogo “Consenti accesso ad Acrobat Sign” che viene visualizzata:
- Nota l’indirizzo e-mail nella parte inferiore della finestra di dialogo.
- Assicurati che questo indirizzo e-mail abbia una licenza Sign valida e che sia un amministratore di sistema in Salesforce.
- Assicurati che all’utente sia assegnato il set di autorizzazioni “Utente integrazione Adobe Sign”.
- Seleziona Consenti.
Deve essere mostrato il messaggio “Gli aggiornamenti di stato automatici sono attivati per questa organizzazione”.
-
Nell'oggetto “Notifica accordo”, controlla il campo Messaggio di errore. Per verificare il valore nel campo, esegui la seguente query SOQL in Developer Console:
SELECT Id, echosign_dev1__Agreement_Event_Type__c, echosign_dev1__Agreement_Status__c, echosign_dev1__Document_Key__c, echosign_dev1__Error_Message__c, echosign_dev1__Notification_Type__c, echosign_dev1__Status__c FROM echosign_dev1__Agreement_Notification__c where echosign_dev1__Agreement__c='<agreementId>'
-
Se si tratta di un accordo push creato al di fuori dell’ambiente Salesforce, assicurati di seguire la Guida al servizio per documenti di grandi dimensioni e accordi push di Adobe Acrobat Sign per Salesforce.
-
Vai a Configurazione > Impostazioni personalizzate > Impostazioni per l’aggiornamento dell’accordo di Adobe Sign > Gestisci > Nuovo (o Modifica). Nella pagina visualizzata, assicurati che sia abilitata la casella di controllo Aggiorna stato accordo (situata sotto “Valore predefinito a livello di organizzazione”).
-
Controlla che lo stato di tali accordi sia aggiornato. Se adesso vengono aggiornati, verifica se il problema si ripresenta con un nuovo accordo di prova. Se il problema si ripresenta, continua con i passaggi di risoluzione dei problemi riportati di seguito.
Se invece il problema non si ripresenta, potrebbe trattarsi di un’istanza singola e ti consigliamo di consultare questa guida per la risoluzione dei problemi nel caso si dovesse verificare di nuovo.
-
Verifica se l’oggetto “Accordo” o altri oggetti di Acrobat Sign in Salesforce dispongono di personalizzazioni quali trigger, flussi di lavoro o regole.
In caso affermativo, disattiva tutte le personalizzazioni e invia un accordo di prova seguendo i passaggi usuali e verifica se viene completato. Lo stato dovrebbe cambiare da “Bozza” a “Inviato per la firma”.
Se lo stato dell’accordo viene cambiato in “Inviato per la firma” dopo aver disattivato le personalizzazioni, consulta la Guida per sviluppatori per le linee guida.
Se lo stato non viene aggiornato, invia un accordo di prova direttamente dalla scheda “Accordi” con le personalizzazioni disattivate e verifica se viene completato. Se lo stato non cambia, controlla i passaggi 1 e 2 descritti in precedenza.
Nota:Il supporto per la risoluzione dei problemi di personalizzazione non viene fornito.
Oggetti di Acrobat Sign Aggiungi file allegati Mappature dei file Esegui il mapping dei dati nei campi dell'accordo Aggiungi modelli per campi modulo Importazioni campi modulo Mappature unione Aggiungi destinatari Mappatura secondaria per campi modulo Mutex Accordi Voce di mappatura secondaria per campi modulo Mappature oggetti Eventi accordo Mappature per campi modulo Destinatari Modelli di accordo Voci di mappatura per campi modulo Accordo firmato Mappature dei dati Mappature gruppi Trigger Mappature per campi Modelli libreria Risultati sincronizzazione utenti Tipo di accordo
Tutte le organizzazioni adesso dispongono dei domini avanzati di Saleforce abilitati per impostazione predefinita e non influiscono sul pacchetto di Acrobat Sign for Salesforce.Tuttavia, i clienti che hanno configurato i propri siti per scaricare file di grandi dimensioni e gli accordi push riscontrano problemi quando i relativi domini avanzati sono abilitati, con conseguente modifica degli URL del sito e degli accordi interrotti.
Per garantire il corretto funzionamento degli accordi, i clienti devono aggiornare le impostazioni personalizzate per i download di file di grandi dimensioni in modo che rispecchino l’URL aggiornato del sito.
Per aggiornare l’URL di richiamata degli accordi push, i clienti devono Contattare l’assistenza tecnica e fornire le informazioni richieste. Per ulteriori informazioni, consulta come Ottenere la configurazione dei servizi individuali per il tuo account di Acrobat Sign.
Acrobat Sign for Salesforce consente di cercare e aggiungere lead come destinatari dell’accordo quando Lead è selezionato come tipo di destinatario. Tuttavia, se gli utenti di Government Cloud creano lead, referenti o utenti ma non sono in grado di trovarli utilizzando il campo di ricerca, gli amministratori dell’organizzazione Saleforce possono seguire questi passaggi per la risoluzione:
- Pass a Configurazione > Gestione oggetti e quindi cerca Lead.
- Nel pannello a sinistra, seleziona Campi e relazioni.
- Per tutti i campi obbligatori (ad esempio nome, e-mail, numero di cellulare e altro), verifica l’accessibilità per gli utenti. Per eseguire questa operazione:
- Seleziona il campo da verificare. Ad esempio, seleziona Dispositivi mobili.
- Per tutti gli utenti per i quali desideri abilitare l’accesso al campo, seleziona la casella di controllo Visibile.
- Seleziona Salva.
Se il problema non viene risolto, anche dopo aver seguito i passaggi di risoluzione dei problemi sopra riportati, Contatta l’assistenza tecnica e fornisci i seguenti dettagli:
- Descrizione del problema
- indirizzo e-mail dell’amministratore dell’account di Acrobat Sign utilizzato per configurare l’integrazione
- indirizzo e-mail dell’amministratore dell’account di Acrobat Sign utilizzato per abilitare gli aggiornamenti di stato automatici:
- versione del pacchetto di Acrobat Sign installato in Salesforce
- ID organizzazione Salesforce
- Salesforce registra gli ID degli accordi interessati
- Indirizzo e-mail dell’utente interessato
- Il problema è sempre riproducibile, intermittente o singolo?
- Data dell’ultima occorrenza: <Provide the date/time/timezone of the last known occurrence>
- Passaggi per replicare il problema
- Comportamento previsto: <Describe the behavior that you expect when the steps are performed>
- Note sulla risoluzione dei problemi: <Provide details of troubleshooting done so far with this documentation>
