Nitro Sign (anteprima)

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Service	Class	Regions
Copilot Studio	Premium	Tutte le aree di Power Automate , ad eccezione delle seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica	Standard	Tutte le aree di App per la logica , ad eccezione delle seguenti:      - Aree di Azure per enti pubblici      - Aree di Azure Cina      - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps	Premium	Tutte le aree di Power Apps , ad eccezione dei seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate	Premium	Tutte le aree di Power Automate , ad eccezione delle seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)

Contatto
Nome	Supporto di Nitro
URL	https://www.gonitro.com/support
Posta elettronica	prosupport@sfdc.gonitro.com

Metadati del connettore
Publisher	Nitro PDF
Sito web	https://www.gonitro.com/
Informativa sulla privacy	https://www.gonitro.com/legal/privacy-policy
Categorie	Produttività; Operazioni IT

Nitro Sign Connector

Informazioni generali

Il connettore Nitro Sign consente flussi di lavoro eSignature end-to-end sicuri direttamente da Power Automate e Power Apps. Consente alle applicazioni di creare e gestire buste di firma, caricare e riordinare documenti, aggiungere partecipanti e definire l'ordine di firma, inserire campi di firma e dati, inviare documenti per firma, tenere traccia dello stato e scaricare i file originali, sealed e audit-trail, tutto tramite un approccio completamente automatizzato basato sulle API.

Publisher: Nitro Software

---

Prerequisites

Per usare Nitro Sign through this connector, è necessario:

• Un account Nitro con Nitro Sign abilitato
  https://developers.gonitro.com/
• Piano di Microsoft PowerApps o Power Automate con le funzionalità di Custom Connector.

---

Authentication

Nitro Sign usa OAuth 2.0 da computer a computer con la concessione delle credenziali client per generare token di accesso per le richieste API.

Come funziona

• Si crea un'applicazione API nel portale self-service di Nitro e si ottengono l'ID client e il segreto client associati.
• Il connettore esegue l'autenticazione scambiando queste credenziali per un token di accesso bearer .
• Il token viene quindi usato per autorizzare le successive chiamate API Nitro Sign.

Creare credenziali e leggere la guida dettagliata:
https://developers.gonitro.com/docs/authentication/credentials

Creazione di una connessione in Power Automate/Power Apps

Quando si aggiunge il connettore a un flusso o a un'app:

1. Fare clic su Aggiungi una nuova connessione.
2. Immettere l'ID client e il segreto client (rilasciati nel portale per sviluppatori Nitro).
3. Selezionare l'areaNitro (Europa, Stati Uniti o APAC), ovvero l'area associata all'account Nitro.
4. Salvare la connessione: al primo utilizzo, il connettore scambia l'ID client e il segreto client per un token di accesso di breve durata usando la concessione delle credenziali client OAuth 2.0, la memorizza nella cache e la rinnova automaticamente. Le credenziali vengono usate solo per ottenere il token; le chiamate API successive vengono autenticate con un token di connessione per conto dell'utente.

Nota: non è necessario alcun accesso interattivo per l'utente; questo flusso è progettato per scenari da server a server/da app a app.

Operazioni supportate

Il connettore raggruppa le azioni relative alle quattro risorse di un flusso di lavoro di firma, ovvero buste, documenti, campi e partecipanti , oltre a un set di azioni di download per il recupero di file completati.

1. Buste

Una busta è il contenitore per i documenti, i partecipanti e i campi in una singola richiesta di firma.

• List Envelopes
  Restituisce tutte le buste associate all'applicazione nell'account. I risultati sono impaginati: la risposta include un token del cursore pagina successiva, che è possibile fornire al parametro Facoltativo Page After per recuperare la pagina successiva (o Pagina prima della pagina all'indietro). Entrambi i parametri del cursore sono in Avanzate e sono necessari solo quando si passa attraverso set di risultati di grandi dimensioni.

• Crea busta
  Crea una nuova busta con un nome, un messaggio di notifica (oggetto + corpo, con variabili dinamiche come $(sender_name_or_email) e $(envelope_name)) e la modalità di firma:

  • parallel — tutti i partecipanti ricevono una notifica contemporaneamente e possono firmare in modo indipendente.
  • sequential — i partecipanti ricevono una notifica uno alla volta, nell'ordine in cui sono stati aggiunti.

• Ottenere envelope per ID
  Recupera i dettagli per una busta specifica in base al relativo UUID.

• Aggiorna busta
  Aggiorna il nome della busta, le impostazioni di notifica e/o la modalità di firma. Tutti i campi sono facoltativi.

• Elimina busta per ID
  Elimina definitivamente una busta e tutti i documenti, i campi e i partecipanti associati. Non è possibile annullare l'operazione.

• Invia busta per la firma
  Invia la busta ai partecipanti per la raccolta di firme. Prima dell'invio, la busta deve in genere contenere documenti, partecipanti e campi di firma aggiunti (tramite Crea documento per ID busta, Crea partecipante per ID busta e Crea campi in base all'ID documento). Tutti i documenti nella busta devono avere uno stato caricato prima che la busta possa essere inviata.

• Invia promemoria per envelope
  Attiva le notifiche di promemoria ai partecipanti in sospeso. Se non vengono specificate impostazioni di notifica, viene usato il modello di notifica predefinito configurato per la busta.

• Annulla busta per ID
  Annulla la richiesta di firma. Solo le buste che sono già state inviate per la firma possono essere annullate.

---

2. Documenti

I documenti sono i file allegati a una busta e firmati dai partecipanti.

• Elencare i documenti in base all'ID busta
  Recupera tutti i documenti associati a una busta.

• Creare un documento in base all'ID busta
  Carica un documento in una busta esistente. Specificare il file più campi semplici tipizzato, senza JSON scritto a mano:

  • File di documento : il file da caricare.
  • Nome documento : nome in cui archiviare il documento.
  • Tipo di contenuto(avanzato, facoltativo) - tipo MIME del file; il valore predefinito è application/pdf. Se omesso, vengono accettati solo i file PDF.

• Ottenere il documento in base all'ID
  Recupera i dettagli per un documento specifico in una busta.

• Aggiornare il documento in base all'ID
  Aggiorna i metadati del documento. Attualmente è possibile modificare solo il nome del documento.

• Elimina documento in base all'ID
  Elimina definitivamente un documento da una busta.

• Riordinare i documenti in base all'ID busta
  Riordina i documenti in una busta in base a un elenco fornito di ID documento.

---

3. Campi

I campi sono gli elementi interattivi (firma, iniziali, data e così via) inseriti in un documento e assegnati a un partecipante.

• Elencare i campi in base all'ID documento
  Recupera tutti i campi associati a un documento specifico.

• Creare campi in base all'ID documento
  Crea uno o più campi in un documento e li assegna ai partecipanti. Specificare un elemento per un singolo campo o più elementi per una richiesta in blocco. Ogni campo specifica:

  • participantID — il partecipante assegnato al campo.
  • type— uno di signature, initials, namedate, title, company, checkboxcustom.
  • page — numero di pagina (indicizzazione basata su 1).
  • Posizione X, Posizione Y, Larghezza, Altezza : posizione e dimensioni del campo, ognuna immessa come numero separato in punti (X/Y viene misurata dal bordo sinistro/superiore della pagina). Questi sostituiscono la matrice singola boundingBox precedente, quindi ogni valore è un campo tipizzato nell'interfaccia utente anziché un elenco compilato a mano.
  • Facoltativo: required (impostazione predefinita true) e - in Avanzate ( format ad esempio MM/DD/YYYY per i campi data) e modifiable.

• Aggiorna campo per ID
  Aggiorna le proprietà di un campo esistente. Il campo type deve essere specificato e deve corrispondere al tipo di campo esistente, che viene usato per identificare lo schema del campo e non modifica il tipo di campo.

• Elimina campo per ID
  Elimina definitivamente un campo da un documento.

---

4. Partecipanti

I partecipanti sono le persone che ricevono la busta, sia per firmarlo che per essere tenuti informati.

• Elencare i partecipanti per ID busta
  Recupera tutti i partecipanti associati a una busta.

• Creare partecipanti per ID busta
  Aggiunge uno o più partecipanti a una busta. Specificare un elemento per un singolo partecipante o più elementi per una richiesta in blocco. Ogni partecipante specifica:

  • email — indirizzo di posta elettronica del partecipante.
  • role — signer (può avere campi assegnati per la firma) o cc (accesso in sola lettura).
  • authentication (avanzato, facoltativo):codice di accesso: un codice di accesso statico che il partecipante deve fornire prima della firma. Aprire questa sezione solo se il partecipante deve eseguire l'autenticazione prima della firma.

• Aggiornare il partecipante in base all'ID
  Aggiorna le impostazioni di autenticazione di un partecipante. Impossibile modificare il messaggio di posta elettronica del partecipante.

• Elimina partecipante per ID
  Elimina definitivamente un partecipante da una busta.

---

5. Download

Recuperare i file completati dopo che i documenti sono stati firmati e sealed.

• Scarica busta originale
  Scarica i documenti originali non firmati da una busta come archivio ZIP .

• Scarica busta sealed
  Scarica i documenti firmati sealed, insieme al audit trail, come archivio ZIP .

• Scarica documento sealed in base all'ID
  Scarica un singolo documento firmato bloccato come file PDF .

• Scarica Audit Trail of Envelope
  Scarica il audit trail completo per una busta come file PDF .

Le azioni di download espongono token di file nativi enome file nativi (più tipo di contenuto file). Eliminare il contenuto del file direttamente nell'input del file di un passaggio downstream, ad esempio OneDrive/SharePoint Crea file e nome file nell'input del nome file. Non body('Action_Name') è necessaria alcuna espressione o un nome file tipizzato manualmente. Il connettore esegue il wrapping del file ZIP o PDF scaricato in una busta JSON, in modo che Power Automate li eseprima come token di contenuto dinamico ordinari.

---

Flusso di lavoro di firma tipico

Un flusso di firma completo concatena le azioni precedenti nell'ordine indicato. Un flusso di Power Automate comune è simile al seguente:

1. Crea busta : impostare il nome, l'oggetto o il corpo della notifica e la modalità di firma (parallel o sequential). Salvare l'ID busta restituito.
2. Crea documento per ID busta : carica uno o più file nella busta (usando l'ID busta del passaggio 1). Salvare ogni ID documento restituito.
   (Facoltativo)Riordinare i documenti in base all'ID busta : impostare l'ordine del documento.
3. Creare partecipanti in base all'ID busta : aggiungere i firmatari e i destinatari cc con l'autenticazione con codice di accesso. Salvare ogni ID partecipante restituito.
4. Crea campi in base all'ID documento : inserisci i campi firma/data/e così via in ogni documento e assegnali ai partecipanti (usando l'ID documento del passaggio 2 e l'ID partecipante del passaggio 3).
5. Invia busta per la firma : invia la busta. Prima di tutto, tutti i documenti devono trovarsi nello stato caricato.
6. (In sospeso)Invia promemoria per envelope ai partecipanti nudge o Annulla busta per ID per arrestare la richiesta.
7. (Al termine)Scaricare sealed envelope / Download Sealed Document by ID / Download Audit Trail of Envelope per recuperare i file completati.

Suggerimento: l'ID busta, l'ID documento e l'ID partecipante restituiti dal flusso delle azioni di creazione naturalmente nelle azioni successive tramite la selezione contenuto dinamico di Power Automate, selezionare il token ID dall'azione upstream anziché digitarlo.

---

Errori e limitazioni

L'API Nitro Sign può restituire gli errori seguenti:

• 400 - Richiesta non valida
• 401 - Non autorizzato
• 404 - Non trovato
• 409 - Conflitto (ad esempio, che agisce su una busta in uno stato che non consente l'operazione)
• 413 - Contenuto troppo grande
• 415 - Tipo di supporto non supportato
• 422 - Entità non elaborabile
• 500 - Errore interno del server

Limitazione

• Chiamate API per connessione: 100 per 60 secondi.

---

Limiti della piattaforma

Dimensioni file

• Massimo: 25 MB per richiesta
  Si applica sia alle operazioni a file singolo che a più file.

Conteggio pagine

• Massimo: 250 pagine per singolo documento
  Il totale delle pagine combinate tra più documenti può superare i 250.

Tempo di conservazione

• I file di input e output vengono eliminati circa 15 minuti dopo il completamento dell'operazione.

---

Note

• Le azioni di gestione busta, documento, campo e partecipante restituiscono JSON.
• Le azioni di download restituiscono il file (ZIP o PDF) racchiuso in una busta JSON che espone il nome file, il tipo di contenuto file e il contenuto del file come token nativi di selezione, in modo che i risultati possano essere concatenati in un'azione di file downstream senza espressioni.
• La modalità di firma (parallel vs sequential) viene impostata quando viene creata la busta e può essere modificata con Update Envelope prima dell'invio della busta.
• L'autenticazione partecipante attualmente supporta solo il codice di accesso .

Creazione di una connessione

Il connettore supporta i tipi di autenticazione seguenti:

Predefinita	Parametri per la creazione della connessione.	Tutte le aree geografiche	Non condivisibile

Predefinito

Applicabile: tutte le aree

Parametri per la creazione della connessione.

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Nome	Tipo	Descrizione	Required
Nitro Client ID	securestring	ID client dell'applicazione Nitro	True
Nitro Client Secret	securestring	Segreto client dell'applicazione Nitro	True
Nitro Region	string	Selezionare l'area api Nitro per l'account.	True

Azioni

Aggiorna busta	Aggiorna una busta Nitro Sign esistente. È possibile modificare il nome della busta, le impostazioni di notifica, la modalità di firma o qualsiasi combinazione di questi campi.
Aggiorna campo per ID	Aggiorna le proprietà di un campo esistente in un documento Nitro Sign. Il tipo di campo deve essere specificato e deve corrispondere al tipo di campo esistente; viene usato dall'API per identificare lo schema del campo e non modifica il tipo di campo.
Aggiornare il documento in base all'ID	Aggiorna i metadati di un documento esistente all'interno di una busta Nitro Sign. Attualmente è possibile aggiornare solo il nome del documento.
Aggiornare il partecipante in base all'ID	Aggiorna le impostazioni di autenticazione per un partecipante in una busta Nitro Sign. Impossibile aggiornare il messaggio di posta elettronica del partecipante.
Annulla busta per ID	Annulla la richiesta di firma per una busta Nitro Sign. Solo le buste inviate per la firma possono essere annullate.
Crea busta	Crea una nuova busta Nitro Sign che in un secondo momento può essere popolata con documenti, partecipanti, campi e inviati per la firma.
Creare campi in base all'ID documento	Crea uno o più campi in un documento e li assegna ai partecipanti. Per creare un singolo campo, specificare un elemento nella matrice Fields. Per creare più campi, specificare più elementi.
Creare partecipanti per ID busta	Aggiunge uno o più partecipanti a una busta Nitro Sign. Per aggiungere un singolo partecipante, specificare un elemento nella matrice Partecipanti. Per aggiungere più partecipanti, specificare più elementi.
Creare un documento in base all'ID busta	Carica un documento in una busta Nitro Sign esistente. Il documento può essere usato successivamente nel flusso di lavoro di firma.
Elencare i campi in base all'ID documento	Recupera tutti i campi associati a un documento specifico all'interno di una busta Nitro Sign.
Elencare i documenti in base all'ID busta	Recupera tutti i documenti associati a una busta Nitro Sign specifica.
Elencare i partecipanti per ID busta	Recupera tutti i partecipanti associati a una busta Nitro Sign specifica.
Elimina busta per ID	Elimina definitivamente una busta Nitro Sign. Questa operazione non può essere annullata e vengono eliminati anche tutti i documenti, i campi e i partecipanti associati.
Elimina campo per ID	Elimina definitivamente un campo da un documento all'interno di una busta Nitro Sign.
Elimina documento in base all'ID	Elimina definitivamente un documento da una busta Nitro Sign.
Elimina partecipante per ID	Elimina definitivamente un partecipante da una busta Nitro Sign.
Invia busta per la firma	Invia una busta Nitro Sign ai partecipanti per la raccolta di firme. Prima di usare questa azione, la busta deve in genere contenere documenti, partecipanti e campi di firma aggiunti usando Crea documento per ID busta, Crea partecipante per ID busta e Crea campi in base all'ID documento. Tutti i documenti nella busta devono avere uno stato caricato prima che la busta possa essere inviata.
Invia promemoria per envelope	Attiva le notifiche di promemoria ai partecipanti in sospeso di una busta Nitro Sign specificata. Se non vengono specificate impostazioni di notifica, viene usato il modello di notifica predefinito configurato per la busta.
List Envelopes	L'endpoint List Envelopes restituisce tutte le buste associate a un'applicazione in un account.
Ottenere envelope per ID	Recupera i dettagli per una busta Nitro Sign specifica usando l'ID busta univoco.
Ottenere il documento in base all'ID	Recupera i dettagli per un documento specifico in una busta Nitro Sign.
Riordinare i documenti in base all'ID busta	Riordina i documenti associati a una busta Nitro Sign specifica in base all'elenco fornito di ID documento.
Scarica Audit Trail of Envelope	Scarica il file PDF contenente il audit trail completo per la busta Nitro Sign selezionata.
Scarica busta originale	Scarica i documenti originali non firmati da una busta Nitro Sign come archivio ZIP.
Scarica busta sealed	Scarica i documenti firmati sealed da una busta Nitro Sign, insieme al audit trail, come archivio ZIP.
Scarica documento sealed in base all'ID	Scarica un singolo documento firmato sealed da una busta Nitro Sign come file PDF.

Aggiorna busta

Aggiorna campo per ID

Aggiornare il documento in base all'ID

Aggiornare il partecipante in base all'ID

Annulla busta per ID

Crea busta

Creare campi in base all'ID documento

Creare partecipanti per ID busta

Creare un documento in base all'ID busta

Elencare i campi in base all'ID documento

Elencare i documenti in base all'ID busta

Elencare i partecipanti per ID busta

Elimina busta per ID

Elimina campo per ID

Elimina documento in base all'ID

Elimina partecipante per ID

Invia busta per la firma

Invia promemoria per envelope

List Envelopes

Ottenere envelope per ID

Ottenere il documento in base all'ID

Riordinare i documenti in base all'ID busta

Scarica Audit Trail of Envelope

Scarica busta originale

Scarica busta sealed

Scarica documento sealed in base all'ID

Definizioni

EnvelopeNotification

EnvelopeSummaryResponse

EnvelopeResponse

ListDocumentsByEnvelopeIDResponse

DocumentResponse

FieldsResponse

FieldResponse

PartecipantiResponse

ParticipantsListResponse

PartecipanteResponse

ParticipantAuthenticationResponse

FileDownloadResponse