NomaSign (preview)
Herbruikbare NomaSign-sjablonen verzenden voor handtekening vanuit geautomatiseerde werkstromen. Exchange een integratievernieuwingstoken voor een Bearer-token en verzendt u vervolgens een of meer ontvangersrijen uit een opgeslagen sjabloon met optionele veldwaarden, herinneringen, verloopdatum en e-mailinstellingen.
Deze connector is beschikbaar in de volgende producten en regio's:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logische apps | Standard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate regio's behalve: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | Ondersteuning voor NomaSign |
| URL | https://www.nomasign.com/service-delivery/ |
| E-mailadres | support@nomasign.com |
| Connectormetagegevens | |
|---|---|
| Publisher | U bron-SA |
| Website | https://www.nomasign.com |
| Privacybeleid | https://www.nomasign.com/privacy/ |
| Categories | Productiviteit |
NomaSign
NomaSign helpt teams herbruikbare ondertekeningssjablonen te verzenden voor handtekeningen vanuit geautomatiseerde werkstromen. De connector bevat twee hoofdacties: een NomaSign-integratievernieuwingstoken uitwisselen voor een bearer-token en een opgeslagen sjabloon verzenden naar een of meer ontvangersrijen.
Prerequisites
- Een NomaSign-account met een actief plan dat integraties ondersteunt.
- Een opgeslagen NomaSign-sjabloon met gelabelde tijdelijke aanduidingen.
- Een nomaSign-integratievernieuwingstoken dat is gegenereerd in de NomaSign-web-app.
- Een beveiligd archief voor het vernieuwingstoken, zoals Azure Key Vault.
Ondersteunde acties
token voor vernieuwen Exchange
Hiermee wordt het huidige vernieuwingstoken van NomaSign-integratie uitgewisseld voor een toegangstoken en een gedraaid vernieuwingstoken. Sla het geretourneerde vernieuwingstoken op vóór de volgende uitvoering.
Sjabloon verzenden
Hiermee maakt u ondertekeningssessies op basis van een opgeslagen NomaSign-sjabloon, worden geadresseerdelabels toegewezen aan tijdelijke aanduidingen voor sjablonen, worden optionele veldwaarden vooraf ingevuld op label en worden uitnodigingen voor ondertekening verzonden.
Bekende problemen en beperkingen
- Het initiële vernieuwingstoken voor integratie wordt gegenereerd in de NomaSign-web-app en eenmaal weergegeven.
- Vernieuw tokens draaien. Een werkstroom moet na elke geslaagde uitwisseling het laatst geretourneerde vernieuwingstoken opslaan.
- Geadresseerdelabels moeten overeenkomen met tijdelijke aanduidingen voor sjabloonlabels. Ontbrekende toewijzingen van tijdelijke aanduidingen retourneren een validatiefout.
- Veldwaarden zijn best effort. Niet-overeenkomende veldlabels worden overgeslagen.
- De afzender moet zijn of haar Microsoft of Google-account verbonden houden in NomaSign, zodat sjabloondocumenten kunnen worden gekopieerd en uitnodigingen kunnen worden verzonden.
Referenties verkrijgen
Meld u als eigenaar van de Organisatie aan bij de NomaSign-web-app, open het integratie-installatiegebied, maak of selecteer een integrator en genereer een integratietoken. Kopieer het vernieuwingstoken onmiddellijk naar een beveiligd archief, omdat het slechts één keer wordt weergegeven.
Support
Ga naar https://www.nomasign.com/service-delivery/ of e-mail support@nomasign.comvoor ondersteuning.
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| Default | Parameters voor het maken van verbinding. | Alle regio's | Niet deelbaar |
Verstek
Van toepassing: Alle regio's
Parameters voor het maken van verbinding.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
Acties
| Sjabloon verzenden |
Hiermee maakt u ondertekeningssessies op basis van een opgeslagen NomaSign-sjabloon, kopieert u de sjabloondocumenten en verzendt u uitnodigingen voor ondertekening naar toegewezen geadresseerden. |
| token voor vernieuwen Exchange |
Hiermee wordt een NomaSign-integratievernieuwingstoken uitgewisseld voor een bearer-token met een korte levensduur en een gedraaid vernieuwingstoken. |
Sjabloon verzenden
Hiermee maakt u ondertekeningssessies op basis van een opgeslagen NomaSign-sjabloon, kopieert u de sjabloondocumenten en verzendt u uitnodigingen voor ondertekening naar toegewezen geadresseerden.
Parameters
| Naam | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
NomaSign-autorisatie
|
X-NomaSign-Authorization | True | password |
Bearer-autorisatiewaarde met behulp van het toegangstoken dat wordt geretourneerd door Exchange vernieuwingstoken, bijvoorbeeld Bearer ey... |
|
Sjabloon-ID
|
templateId | True | string |
De sjabloon-id NomaSign. |
|
Label
|
label | True | string |
Het tijdelijke aanduidingslabel voor de sjabloon, komt niet overeen met hoofdlettergevoelig. |
|
Name
|
name | True | string |
De weergavenaam van de geadresseerde. |
|
E-mailadres
|
True |
Het e-mailadres van de geadresseerde. |
||
|
Document
|
document | string |
Optioneel bestandsfilter voor documentbestand voor dubbele veldlabels. |
|
|
Label
|
label | True | string |
Het label van het sjabloonveld. Dubbele labels gebruiken numerieke achtervoegsels, zoals Amount 2. |
|
Recipient
|
recipient | string |
Optioneel labelfilter voor tijdelijke aanduidingen voor geadresseerden voor dubbele veldlabels. |
|
|
Value
|
value | True | string |
De waarde die moet worden ingevuld in overeenkomende sjabloonvelden. |
|
Handtekeningtype
|
signingType | string |
Hiermee bepaalt u of geadresseerden zich parallel kunnen aanmelden of moeten worden aangemeld. |
|
|
Verificatievereiste
|
authRequirement | string |
Hiermee bepaalt u of voor openbare ondertekeningskoppelingen eenmalige verificatie van de wachtwoordcode is vereist. |
|
|
Naam afzender
|
senderName | string |
De weergavenaam van de afzender die wordt gebruikt in uitnodigingen voor ondertekening. |
|
|
Subject
|
subject | string |
Het e-mailonderwerp voor ondertekeningsuitnodigingen. |
|
|
Bericht
|
message | string |
Het bericht zonder opmaak dat is opgenomen in uitnodigingen voor ondertekening. |
|
|
Berichtsjabloon
|
messageTemplate | string |
De berichtsjabloon die wordt gebruikt voor het ondertekenen van uitnodigingen. |
|
|
CC-geadresseerden
|
cc | array of string |
E-mailadressen die zijn gekopieerd in uitnodigingen voor ondertekening. |
|
|
E-mail beantwoorden
|
replyToEmail |
Het antwoord op het e-mailadres voor ondertekeningsuitnodigingen. |
||
|
Eerste melding verzenden
|
sendInitialNotification | boolean |
Stel in op True om de eerste uitnodigingen voor ondertekening onmiddellijk te verzenden. |
|
|
Herinneringen ingeschakeld
|
remindersEnabled | boolean |
Ingesteld op Waar om ondertekeningsherinneringen te plannen. |
|
|
Herinneringsdagen vóór de vervaldatum
|
reminderDaysBeforeExpiry | array of integer |
Dagen voor de vervaldatum wanneer herinnerings-e-mailberichten moeten worden verzonden. |
|
|
Verloopt in dagen
|
expiresInDays | integer |
Aantal dagen voordat de gemaakte ondertekeningssessies verlopen. |
Retouren
Antwoord voor verzenden van sjabloon.
- Body
- SendTemplateResponse
token voor vernieuwen Exchange
Hiermee wordt een NomaSign-integratievernieuwingstoken uitgewisseld voor een bearer-token met een korte levensduur en een gedraaid vernieuwingstoken.
Parameters
| Naam | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Token vernieuwen
|
refresh_token | True | password |
Het actieve nomaSign-integratietoken voor vernieuwen. |
Retouren
OAuth-tokenantwoord.
- Body
- TokenResponse
Definities
TokenResponse
OAuth-tokenantwoord.
| Naam | Pad | Type | Description |
|---|---|---|---|
|
Toegangstoken
|
access_token | string |
Het bearer-token dat moet worden gebruikt in de X-NomaSign-Authorization-header. |
|
Token vernieuwen
|
refresh_token | string |
Het gedraaide vernieuwingstoken dat moet worden opgeslagen voor de volgende uitvoering. |
|
Verloopt in
|
expires_in | integer |
De levensduur van het toegangstoken in seconden. |
|
Tokentype
|
token_type | string |
Het tokentype dat wordt geretourneerd door de autorisatieservice. |
|
Scope
|
scope | string |
De bereiken die zijn verleend aan het toegangstoken. |
SendTemplateResponse
Antwoord voor verzenden van sjabloon.
| Naam | Pad | Type | Description |
|---|---|---|---|
|
Instantiëren
|
instantiation | InstantiateTemplateResponse |
Sjabloon-instantiëringsreactie. |
|
Uitnodigingen
|
invites | array of SessionInviteResult |
Resultaten van uitnodiging per sessie. |
InstantiateTemplateResponse
Sjabloon-instantiëringsreactie.
| Naam | Pad | Type | Description |
|---|---|---|---|
|
Batch-id bulksgewijs verzenden
|
bulkSendBatchId | string |
Batch-id wanneer meer dan één sessie is gemaakt. |
|
Sessions
|
sessions | array of InstantiateRowResult |
Resultaten voor het maken van een sessie per rij. |
InstantiateRowResult
Resultaat van het maken van een sessie per rij.
| Naam | Pad | Type | Description |
|---|---|---|---|
|
Rijindex
|
rowIndex | integer |
De op nul gebaseerde rijindex van de aanvraag. |
|
sessie-ID
|
sessionId | string |
De gemaakte sessie-id voor ondertekening. |
|
Document-ID's
|
documentIds | array of string |
De gemaakte sessiedocument-id's in sjabloondocumentvolgorde. |
|
Status
|
status | string |
De status van het maken van de rij. |
|
Error
|
error | string |
Het foutbericht van de rij bij het maken is mislukt. |
SessionInviteResult
Resultaat van uitnodiging per sessie.
| Naam | Pad | Type | Description |
|---|---|---|---|
|
sessie-ID
|
sessionId | string |
De id van de ondertekeningssessie. |
|
Title
|
title | string |
De titel van de ondertekeningssessie. |
|
Uitnodigingsstatus
|
inviteStatus | string |
De uitnodigingsstatus voor deze sessie. |
|
Uitnodigingsfout
|
inviteError | string |
Het foutbericht van de uitnodiging, wanneer het verzenden is mislukt. |
|
Participants
|
participants | array of SessionParticipantEmailResult |
E-mailresultaten per deelnemer. |
SessionParticipantEmailResult
E-mailresultaat per deelnemer.
| Naam | Pad | Type | Description |
|---|---|---|---|
|
Deelnemer-id
|
participantId | string |
De id van de ondertekeningsdeelnemer. |
|
E-mailadres
|
Het e-mailadres van de deelnemer. |
||
|
Name
|
name | string |
De weergavenaam van de deelnemer. |
|
Status
|
status | string |
De e-mailstatus van de deelnemer. |
|
Ondertekenings-URL
|
signingUrl | string |
De URL voor openbare ondertekening voor deze deelnemer. |