Fai clic qui per accedere al pacchetto Adobe Acrobat Sign for Salesforce Document Builder nell’AppExchange di Salesforce.
Ultimo aggiornamento il
5 dic 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
Note sulla versione
Acrobat Sign Document Builder V 1.3
- Mappatura relazioni avanzata: Document Builder ora consente di stabilire fino a cinque livelli di relazioni principale-secondario (campi di ricerca) per gli oggetti correlati. Con questo miglioramento è possibile effettuare mappature dei campi dettagliate per gestire i modelli di dati Salesforce complessi.
Document Builder consente di collegare più oggetti correlati direttamente all’oggetto principale all’interno di una mappatura del campo oggetto singolo. Tuttavia, considerate le limitazioni di Salesforce, non è possibile specificare più di 20 relazioni principale-secondario (oggetti correlati) in una singola query SOQL.
Esempio di relazione principale-secondario: Contact.Account.Owner.FirstName (considerando Contatto come oggetto principale, questa rappresenta tre livelli). - Configurare l’ordinamento e il filtro dei dati uniti: è ora possibile configurare l’ordinamento e il filtro dei dati uniti all’interno degli oggetti correlati. Scopri come configurare Ordinamento e unione dati uniti.
Scopri come Aggiornare il pacchetto base di Document Builder alla versione più recente.
Nota:
Con la versione V 1.3, è stato aggiornato il campo adobesign__Object_Name__c per farlo corrispondere al nome della relazione secondaria. Questo campo rappresenta il nome del campo correlato all’interno dell’oggetto personalizzato adobesign__Related_Object_Mapping__c. I modelli Document Builder con campi correlati nella mappatura dei campi oggetto funzioneranno perfettamente in Document Builder 1.3 e versioni future. Tuttavia, i modelli di Document Builder creati nella versione 1.3 e successive non funzioneranno con i modelli di Word che contengono tag per campi correlati da modelli creati prima della versione 1.3 di Document Builder.
Problemi risolti
| Numero problema | Descrizione del problema corretto |
|---|---|
| 29923 |
È stato risolto il problema a causa del quale gli utenti non potevano selezionare un record di esempio nei modelli Document Builder tramite il mouse. |
- Gestione ottimizzata dei modelli: con la versione 3.x.x dell’API di PDF Services più recente, Document Builder è in grado di gestire in modo efficiente modelli Word più grandi, che possono avere dimensioni fino a 5,5 MB. Questo miglioramento consente di progettare e utilizzare modelli più completi e complessi all’interno del pacchetto Document Builder.
- Campi casella combinata ricercabili: durante la creazione dei modelli Document Builder, questo risulta notevolmente più rapido in quanto i campi della casella combinata sono ora disponibili per la ricerca. Ciò significa che puoi cercare e compilare facilmente campi come Dati di esempio, Campi Salesforce e Dati record di esempio, semplificando il processo di creazione del modello.
- Integrazione sandbox: il pacchetto Document Builder ora si integra perfettamente con l’ambiente sandbox, fornendo una flessibilità ancora maggiore e funzionalità di test nel flusso di lavoro.
Utilizzo di modelli Document Builder sui portali cloud della community: il pacchetto corrente include un set di autorizzazioni per gli utenti della community che consente loro di utilizzare i modelli Document Builder sul portale cloud della community. Gli amministratori devono assegnare autorizzazioni ai record tramite profilo o tramite le impostazioni di condivisione per tali oggetti.
- Per l’utente di accesso alla community, è necessario utilizzare il profilo utente della community per concedere l’accesso viewAll a “Modello Document Builder” e a “Mappatura campi oggetto”.
- Per l’accesso utente alla community Plus e alla community partner, è necessario utilizzare le regole di condivisione per concedere l’accesso a “Modello Document Builder” e a “Mappatura campi oggetto”. Per eseguire questa operazione, passa a Configurazione > Sicurezza > Impostazioni di condivisione, quindi seleziona l’oggetto per il quale condividere l’accesso in sola lettura in base ai ruoli e ai subordinati.
- Supporto per ambito OAuth “gruppo”: con l’aggiunta di una nuova impostazione personalizzata pubblica denominata “Impostazioni DOCBLDR di Acrobat Sign”, gli amministratori di Salesforce possono ora creare una connessione OAuth con un amministratore a livello di gruppo.
- È stato risolto il problema relativo alla mappatura unione quando la lingua passava dall’inglese al francese.
- È stato risolto il problema a causa del quale l’unione di dati con Document Builder e successivamente l’invio di un accordo con un modello Document Builder generava un errore.
: “Inserimento non riuscito. Prima eccezione sulla riga 0; primo errore: STRING_TOO_LONG, Unisci dati JSON: valore dati troppo grande...” Il pacchetto corrente ora supporta lunghezze di campo più lunghe.
- Funzione di unione delle immagini migliorata: ora puoi unire le immagini in un modello di documento utilizzando i tag API DocGen.
- È stato risolto il problema relativo alla mappatura del campo oggetto correlato: con la versione attuale, potete mappare senza problemi un oggetto correlato tramite una relazione di ricerca. Consente di generare un documento da un oggetto principale (come WorkOrder) e di includere nel documento gli elementi di riga secondari (come gli elenchi correlati a WorkOrder).
- È stato risolto il problema relativo al filtraggio degli oggetti standard: la versione corrente risolve il problema del filtro oggetto correlato in cui un oggetto personalizzato veniva filtrato quando veniva aggiunta una relazione oggetto personalizzato secondaria. Gli oggetti personalizzati aggiunti ora vengono visualizzati nell’elenco degli oggetti correlati.
Panoramica
Document Builder è una funzione di Adobe Acrobat Sign for Salesforce che consente di generare automaticamente i documenti utilizzando i dati di Salesforce. Fa parte dell’attuale funzionalità Modello di accordo di Sign. Gli amministratori di Salesforce possono consentire ai team o a singoli membri di un team di utilizzare Document Builder per creare documenti quali proposte, preventivi o accordi. Il documento generato viene inviato come allegato con il modello di accordo di Acrobat Sign e può essere facilmente monitorato e gestito in Salesforce.
Document Builder è un pacchetto di estensione del pacchetto di base Adobe Acrobat Sign for Salesforce e non richiede alcun acquisto aggiuntivo. Questa funzione offre una procedura guidata per creare le regole da applicare all’unione dei dati dai campi oggetto di Salesforce in un modello di documento Word.
Consulta Adobe Acrobat Sign for Salesforce: guida utente di Document Builder per comprendere come:
- Installare e configurare il pacchetto Document Builder
- Applicare i set di autorizzazioni Adobe Acrobat Sign
- Aggiungere il valore per elenco di selezione “Modello Document Builder”
- Creare nuovi modelli Document Builder
- Inviare accordi utilizzando i modelli Document Builder
- Aggiornare il pacchetto base di Document Builder a una versione successiva
- Risolvere i problemi più comuni
Nota:
Document Builder è supportato solo sulla piattaforma Lightning di Salesforce.
Document Builder non è supportato su Government Cloud o per accordi soggetti alla conformità con la normativa HIPAA.
Prerequisiti
Prima di installare il pacchetto di estensione Document Builder:
- Accedi all’account Salesforce utilizzando credenziali di amministratore. Se non disponi ancora di un account Salesforce, devi registrarti per un nuovo account.
- Installa (o aggiorna) e configura Acrobat Sign for Salesforce v24.0 o versione successiva.
- Autorizza l’account Adobe Acrobat Sign in Salesforce utilizzando la procedura di configurazione guidata. Per ulteriori informazioni, consulta la guida all’installazione di Adobe Acrobat Sign for Salesforce.
-
Nella pagina Installa Acrobat Sign Document Builder che viene visualizzata:
- Seleziona Installa solo per gli amministratori.
- Seleziona la casella di controllo per confermare l’installazione.
- Seleziona Installa.
- Nella finestra di dialogo Approva accesso di terze parti che viene visualizzata, seleziona la casella di controllo del consenso, quindi seleziona Continua.
Una notifica segnala che il processo di installazione richiederà un po’ di tempo.
Installazione di Adobe Acrobat Sign Document Builder Installazione di Adobe Acrobat Sign Document Builder
Una volta installato correttamente il pacchetto, gli amministratori devono fornire agli utenti i set di autorizzazioni corretti per consentire loro di utilizzare il pacchetto Document Builder per inviare accordi da Salesforce. A tale scopo, gli amministratori devono aggiungere i seguenti set di autorizzazioni di Document Builder in base alla funzionalità richiesta:
- Amministratore di Acrobat Sign Document Builder
- Utente della community di Acrobat Sign Document Builder
- Utente di Acrobat Sign Document Builder
Per supportare i modelli Document Builder, il campo Type__c dell’oggetto Attachment_Template__c ora include un nuovo valore per l’elenco di selezione: “Modello Document Builder”. Affinché i modelli Document Builder possano funzionare correttamente dopo l’aggiornamento del pacchetto di base alla versione 24.x, gli amministratori di Salesforce devono aggiungere il valore per l’elenco di selezione Modello Document Builder all’elenco di selezione esistente per il campo Type__c dell’oggetto Attachment_Template__c.
Nota:
Tutti gli utenti esistenti di Adobe Acrobat Sign for Salesforce che eseguono l’aggiornamento alla versione 24 devono aggiungere il valore per l’elenco di selezione “Modello Document Builder” seguendo le istruzioni riportate di seguito.
Se si tratta di un’installazione pulita di Adobe Acrobat Sign for Salesforce v24, non è necessario aggiungere il valore per l’elenco di selezione “Modello Document Builder”.
-
Per individuare il nuovo valore Tipo allegato tramite l’area di lavoro traduzione:
- Passa a Configurazione > Strumenti piattaforma > Interfaccia utente > Area di lavoro traduzione > Traduci.
- Se viene richiesto di abilitare l’area di lavoro traduzione, seleziona Abilita.
- Seleziona la lingua per la quale vuoi localizzare i valori.
- Per Componente configurazione, seleziona Valore elenco di scelta.
- Per Oggetto, seleziona Aggiungi file allegato.
- Per Etichetta valore elenco di selezione principale, seleziona + Tipo allegato per espandere il menu.
- Fai doppio clic sullo spazio della colonna accanto a Modello Document Builder per aprire il campo di testo in cui è possibile inserire la traduzione, quindi immetti il valore tradotto.
- Al termine, seleziona Salva.
Una volta che il pacchetto dell’estensione Document Builder è installato e connesso all’account Adobe Acrobat Sign, gli utenti autorizzati possono accedervi da Modelli di accordo, nella scheda Allegato. Gli amministratori di Salesforce possono creare un nuovo modello Document Builder o utilizzare un modello esistente come allegato al proprio modello di accordo.
Per creare un nuovo modello Document Builder:
-
Dalla scheda Modelli di accordo nella pagina Lightning di Adobe Acrobat Sign for Salesforce, apri un modello di accordo esistente.
Oppure, seleziona Modelli di accordo > Nuovo modello di accordo per avviare la creazione di un modello di accordo. Per ulteriori informazioni, consulta Creare un modello di accordo.
-
Nella scheda Dettagli modello:
- Assegna un nome al modello di accordo.
- Nel campo Oggetto Salesforce, seleziona un oggetto.
Nota: il modello Document Builder utilizza l’oggetto Salesforce selezionato come origine dati principale. Pertanto, devi selezionare l’oggetto principale Salesforce prima di utilizzare Document Builder.
- Compila gli altri dettagli, in base alle tue esigenze.
- Seleziona la scheda Allegato.
-
Nota:
Prima di iniziare a creare un modello Document Builder, è necessario impostare l’Oggetto principale Salesforce nella scheda Dettagli modello.
Nota: puoi cercare e selezionare un modello creato in precedenza dal campo di ricerca “Seleziona un modello Document Builder esistente”.
-
Per aggiungere i campi da includere nel modello di accordo, seleziona + Aggiungi e seleziona un nome di campo dall’elenco a discesa.Dopo aver aggiunto e verificato tutti i campi necessari, seleziona Avanti.
Per configurare l’ordinamento e il filtro dei dati uniti:
- Assicurati di aver aggiunto campi correlati e campi non correlati alla mappatura dei campi oggetto correlati.
- Seleziona la freccia a discesa accanto al campo aggiunto, quindi seleziona Opzioni tabella.
- Nella finestra di dialogo Opzioni tabella che viene visualizzata:
- Apri il menu a discesa Seleziona campo di ordinamento e seleziona un campo di ordinamento desiderato.
Le opzioni disponibili derivano dai campi selezionati nella mappatura dei campi oggetto correlati. - Nel campo Seleziona ordinamento seleziona l’ordine desiderato.
- Nel campo Filtro query, immetti i criteri di filtro.
Verifica che i criteri siano conformi alle linee guida per la lingua delle query Salesforce.
- Apri il menu a discesa Seleziona campo di ordinamento e seleziona un campo di ordinamento desiderato.
Nota:Se immetti un filtro di query non valido, l’applicazione mostra un messaggio contenente un collegamento alla documentazione Salesforce pertinente.
-
Dalla scheda Documento tag, copia il testo di ancoraggio per ogni campo e incollalo nel modello Word. Oppure, seleziona Scarica JSON per scaricare l’intero file JSON.
Una volta scaricato il file, viene visualizzato un messaggio che ne conferma il download.Puoi utilizzare il file JSON scaricato per importare tutti i tag nel modello Microsoft Word utilizzando il componente aggiuntivo gratuito Adobe Document Generation Tagger.
-
Per applicare i tag al modello, apri il documento Microsoft Word e genera i tag utilizzando il componente aggiuntivo Document Generation.
Scopri come installare e utilizzare il Componente aggiuntivo Adobe Document Generation per Microsoft Word.
Scopri come aggiungere tag di testo al modello MS Word utilizzando Adobe Document Generation Tagger.
-
Una volta aggiunti i tag al documento, torna alla pagina della procedura guidata di Document Builder e seleziona Carica file per caricare il modello Word con tag. Dopo aver caricato il file, seleziona Fine per chiudere la finestra di dialogo.
Al file caricato viene automaticamente assegnato un nome di modello. Per rinominare il file del modello, puoi modificare il Nome file generato.
-
Al termine, seleziona Avanti. Nella pagina che viene visualizzata, seleziona Anteprima.
Nota: se necessario, puoi selezionare dati di record diversi o modificare le informazioni fornite nei passaggi precedenti.
Viene aperta un’anteprima del modello con i dati provenienti dal record di esempio di Salesforce selezionato in precedenza.
Dopo aver creato e aggiunto un modello Document Builder, puoi configurare ulteriormente il modello di accordo per inviarlo ai destinatari per la firma. Puoi inviare per la firma un accordo con il modello Document Builder dalle seguenti aree:
- Scheda Accordi
- Pannello Accordi in un record di oggetto
Per inviare gli accordi dalla scheda Accordi:
Dopo aver creato e aggiunto un modello Document Builder a un accordo seguendo le istruzioni riportate sopra, segui i passaggi riportati di seguito per inviare l’accordo da far firmare dalla scheda Accordi:
-
Nella pagina della bozza del nuovo accordo che viene visualizzata, compila i seguenti dati in base alle tue esigenze:
- Per Destinatari, seleziona un ruolo destinatario dal menu a discesa
Firmatario. - Nel campo Cerca contatti, cerca il contatto del destinatario. In alternativa, seleziona E-mail dal menu a discesa e aggiungi l’indirizzo e-mail del destinatario.
- Seleziona Devo firmare per aggiungerti come firmatario. Seleziona Firma per ultimo o Firma per primo per impostare l’ordine con cui dovrai firmare. Se necessario, seleziona Firma in hosting per il primo firmatario.
- Per aggiungere altri destinatari, seleziona Aggiungi destinatario.
- Per impostare una password per la verifica dell’identità dei destinatari, seleziona Password dal menu a discesa in Verifica identità. Quindi immetti e conferma la password.
Nota: l’ID e-mail del destinatario è il metodo di verifica dell’identità predefinito. - Facoltativamente, aggiungi un messaggio per i destinatari dell’accordo.
- Per aggiungere il modello di accordo Document Builder, seleziona Aggiungi file. Nella finestra di dialogo Aggiungi file, seleziona la casella di controllo per il file da includere, quindi seleziona Aggiungi file.
In alternativa, per aggiungere file dal computer, seleziona Carica dal computer e segui il flusso di lavoro.
- Per Destinatari, seleziona un ruolo destinatario dal menu a discesa
-
In Opzioni:
- Per proteggere con password il documento firmato, seleziona Proteggi con password i documenti firmati. Quindi, specifica una password nei campi password visualizzati.
- Per impostare una scadenza per il completamento, seleziona l’icona del calendario e scegli una data di completamento.
- Per inviare promemoria ai firmatari, seleziona un’opzione dal menu a discesa Crea promemoria.
- Facoltativamente, seleziona una lingua alternativa per i destinatari dell’accordo.
- Per Tipo di firma, seleziona Firma elettronica o Firma manuale, in base alle esigenze.
-
Nella finestra Anteprima, effettua una o più delle seguenti operazioni, in base alle esigenze:
- Per aggiungere i campi firma per tutti i destinatari, seleziona ciascun destinatario, quindi trascina i campi dal menu Campi firma nel pannello a destra.
- Per aggiungere il titolo del firmatario, il nome della società o altri campi correlati, apri Dati firmatario e aggiungi il campo appropriato.
- Per aggiungere campi di dati, apri il menu a discesa Campi dati e aggiungi il tipo di campo dati desiderato.
- Per inserire un allegato, apri il menu a discesa Altri campi e trascina Allegato. Fai doppio clic sul campo Allegato e inserisci i dettagli richiesti nella finestra di dialogo. Se necessario, puoi aggiungere un collegamento ipertestuale.
- Per includere un timbro di partecipazione o un numero di transazione, apri il menu a discesa Campi transazione e aggiungi l’opzione desiderata.
-
Dopo aver aggiunto tutti i campi necessari e aver visualizzato in anteprima l’accordo, seleziona Invia.
Puoi selezionare Salva come modello per salvare il modello da inviare in un secondo momento.Un messaggio conferma che l’accordo è stato inviato per la firma, come illustrato di seguito. Seleziona OK per tornare alla pagina degli accordi.
Per inviare gli accordi dal pannello Accordi nel record Oggetto:
Un modello Document Builder, utilizza l’oggetto Salesforce selezionato durante la creazione di un modello di accordo. Puoi utilizzare lo stesso oggetto principale Salesforce per inviare gli accordi con il modello Document Builder ai destinatari per richiederne la firma.
Segui i passaggi riportati di seguito per inviare gli accordi dal pannello Accordi in un record di oggetto:
-
Nel pannello Accordi, apri il menu a discesa Invia accordo per firma e seleziona l’accordo da inviare per la firma.
L’accordo viene aperto in modalità bozza, come illustrato di seguito. L’accordo include i file dal modello di accordo selezionato nel passaggio precedente.
Nota:Se il pannello Accordi non è visualizzato nella pagina del record dell’oggetto, puoi aggiungerlo come descritto di seguito:
- Nella pagina del record dell’oggetto Opportunità, seleziona Configurazione > Modifica pagina.
- Nel pannello a sinistra della pagina visualizzata, scorri l’elenco Componenti fino a individuare i componenti Personalizzati-Gestiti.
- Dall’elenco dei componenti personalizzati-gestiti, seleziona AgreementPanel e trascinalo nella posizione desiderata sulla pagina.
- Seleziona Activation nell’angolo in alto a destra.
- Nella finestra di dialogo visualizzata, segui il flusso di lavoro.
- Seleziona Salva.
È possibile aggiornare il pacchetto Adobe Acrobat Sign Document Builder pacchetto dall’AppExchange di Salesforce. Questa sezione spiega come aggiornare Adobe Acrobat Sign per Document Builder da una versione precedente a quella più recente.
Ogni versione di Adobe Acrobat Sign Document Builder presenta nuove funzioni e miglioramenti importanti per i flussi di lavoro documentali. Si consiglia vivamente di eseguire l’aggiornamento alla versione più recente, poiché nel tempo Adobe interrompe il supporto delle versioni più datate.
Per individuare la versione del pacchetto Adobe Acrobat Sign Document Builder attualmente installato:
- Accedi a Salesforce con credenziali di amministratore.
- Passa a Configurazione > Strumenti piattaforma > Applicazioni > Pacchetti > Pacchetti installati.
Per aggiornare il pacchetto Adobe Acrobat Sign Document Builder:
-
Vai al pacchetto Adobe Acrobat Sign Document Builder sull’AppExchange di Salesforce e accedi utilizzando le credenziali del tuo account Salesforce.
- Errore di tipo “Token di aggiornamento non valido” quando si tenta di accedere ad Adobe Acrobat Sign for Salesforce. Come si corregge l’errore?
Per risolvere l’errore “Token di aggiornamento non valido”, l’amministratore di Salesforce deve assicurarsi che OAuth per Sign sia eseguito correttamente per il pacchetto Document Builder.
- Errore durante il caricamento del file del modello Word per creare un modello Document Builder. Perché non è possibile caricare il file Word?
Il modello Word utilizzato nel modello Document Builder non può superare ~4,4 MB. A seconda delle regole di mappatura impostate nel modello Document Builder e dei dati acquisiti dall’organizzazione Salesforce, la dimensione consentita per il modello Word potrebbe essere anche inferiore a questo valore. Pertanto, assicurati che la dimensione del file del modello Word non superi il limite consentito.
