NomaSign (wersja zapoznawcza)
Wysyłaj szablony NomaSign wielokrotnego użytku do podpisu z zautomatyzowanych przepływów pracy. Exchange token odświeżania integracji dla tokenu elementu nośnego, a następnie wyślij jeden lub wiele wierszy adresatów z zapisanego szablonu z opcjonalnymi wartościami pól, przypomnieniami, wygaśnięciem i ustawieniami poczty e-mail.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate - narzędzie do automatyzacji procesów | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Contact | |
|---|---|
| Name | Obsługa nomaSign |
| adres URL | https://www.nomasign.com/service-delivery/ |
| support@nomasign.com |
| Metadane łącznika | |
|---|---|
| Publisher | Źródłowa baza danych |
| Website | https://www.nomasign.com |
| Zasady ochrony prywatności | https://www.nomasign.com/privacy/ |
| Categories | Produktywność |
NomaSign
Aplikacja NomaSign ułatwia zespołom wysyłanie szablonów podpisywania wielokrotnego użytku na potrzeby podpisu z zautomatyzowanych przepływów pracy. Łącznik uwidacznia dwie główne akcje: wymianę tokenu odświeżania integracji NomaSign dla tokenu elementu nośnego i wysłanie zapisanego szablonu do co najmniej jednego wiersza adresata.
Prerequisites
- Konto NomaSign z aktywnym planem obsługującym integracje.
- Zapisany szablon NomaSign z oznaczonymi symbolami zastępczymi.
- Token odświeżania integracji NomaSign wygenerowany w aplikacji internetowej NomaSign.
- Bezpieczny magazyn tokenu odświeżania, taki jak Azure Key Vault.
Obsługiwane akcje
token odświeżania Exchange
Wymienia bieżący token odświeżania integracji NomaSign dla tokenu dostępu i rotowany token odświeżania. Zapisz zwrócony token odświeżania przed następnym uruchomieniem.
Wyślij szablon
Tworzy sesje podpisywania z zapisanego szablonu NomaSign, mapuje etykiety adresatów na symbole zastępcze szablonu, wstępnie wypełnia opcjonalne wartości pól według etykiety i wysyła zaproszenia podpisywania.
Znane problemy i ograniczenia
- Początkowy token odświeżania integracji jest generowany w aplikacji internetowej NomaSign i wyświetlany raz.
- Odśwież tokeny obracają się. Przepływ pracy musi przechowywać najnowszy zwrócony token odświeżania po każdym pomyślnym wymianie.
- Etykiety adresatów muszą być zgodne z etykietami zastępczymi szablonu. Brakujące mapowania symboli zastępczych zwracają błąd weryfikacji.
- Wartości pól są najlepszym rozwiązaniem. Niedopasowane etykiety pól są pomijane.
- Nadawca musi przechowywać swoje Microsoft lub konto Google połączone w nomaSign, aby można było kopiować dokumenty szablonu i można wysyłać zaproszenia.
Pobieranie poświadczeń
Zaloguj się do aplikacji internetowej NomaSign jako właściciel organizacji, otwórz obszar konfiguracji integracji, utwórz lub wybierz integratora i wygeneruj token integracji. Skopiuj token odświeżania do bezpiecznego magazynu natychmiast, ponieważ jest on wyświetlany tylko raz.
Support
Aby uzyskać pomoc techniczną, odwiedź stronę https://www.nomasign.com/service-delivery/ lub wyślij wiadomość e-mail na adres support@nomasign.com.
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
Domyślny
Dotyczy: wszystkie regiony
Parametry tworzenia połączenia.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
Akcje
| token odświeżania Exchange |
Wymienia token odświeżania integracji NomaSign dla krótkotrwałego tokenu elementu nośnego i token odświeżania rotowanego. |
| Wyślij szablon |
Tworzy sesje podpisywania z zapisanego szablonu NomaSign, kopiuje dokumenty szablonu i wysyła zaproszenia podpisywania do zamapowanych adresatów. |
token odświeżania Exchange
Wymienia token odświeżania integracji NomaSign dla krótkotrwałego tokenu elementu nośnego i token odświeżania rotowanego.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Odświeżanie tokenu
|
refresh_token | True | password |
Aktywny token odświeżania integracji NomaSign. |
Zwraca
Odpowiedź tokenu OAuth.
- Body
- TokenResponse
Wyślij szablon
Tworzy sesje podpisywania z zapisanego szablonu NomaSign, kopiuje dokumenty szablonu i wysyła zaproszenia podpisywania do zamapowanych adresatów.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Autoryzacja NomaSign
|
X-NomaSign-Authorization | True | password |
Wartość autoryzacji elementu nośnego przy użyciu tokenu dostępu zwróconego przez token odświeżania Exchange, na przykład Bearer ey... |
|
Identyfikator szablonu
|
templateId | True | string |
Identyfikator szablonu NomaSign. |
|
Label
|
label | True | string |
Etykieta symbolu zastępczego szablonu bez uwzględniania wielkości liter. |
|
Name
|
name | True | string |
Nazwa wyświetlana adresata. |
|
Email
|
True |
Adres e-mail adresata. |
||
|
Document
|
document | string |
Opcjonalny filtr nazwy pliku dokumentu dla zduplikowanych etykiet pól. |
|
|
Label
|
label | True | string |
Etykieta pola szablonu. Zduplikowane etykiety używają sufiksów liczbowych, takich jak Amount 2. |
|
Recipient
|
recipient | string |
Opcjonalny filtr etykiety zastępczej adresata dla zduplikowanych etykiet pól. |
|
|
Value
|
value | True | string |
Wartość do wstępnego wypełniania pasujących pól szablonu. |
|
Typ podpisywania
|
signingType | string |
Określa, czy adresaci mogą się logować równolegle, czy też muszą się zalogować. |
|
|
Wymaganie dotyczące uwierzytelniania
|
authRequirement | string |
Określa, czy publiczne linki podpisywania wymagają jednorazowej weryfikacji kodu dostępu. |
|
|
Nazwa nadawcy
|
senderName | string |
Nazwa wyświetlana nadawcy używana podczas podpisywania zaproszeń. |
|
|
Temat
|
subject | string |
Temat wiadomości e-mail na potrzeby podpisywania zaproszeń. |
|
|
Message
|
message | string |
Zwykły komunikat zawarty w zaproszeniach do podpisywania. |
|
|
Szablon wiadomości
|
messageTemplate | string |
Szablon wiadomości używany do podpisywania zaproszeń. |
|
|
Adresaci DW
|
cc | array of string |
Adresy e-mail skopiowane podczas podpisywania zaproszeń. |
|
|
Odpowiedz na adres e-mail
|
replyToEmail |
Odpowiedź na adres e-mail do podpisywania zaproszeń. |
||
|
Wysyłanie powiadomienia początkowego
|
sendInitialNotification | boolean |
Ustaw wartość true, aby natychmiast wysłać początkowe zaproszenia do podpisywania. |
|
|
Przypomnienia włączone
|
remindersEnabled | boolean |
Ustaw wartość true, aby zaplanować przypomnienia dotyczące podpisywania. |
|
|
Przypomnienie dni przed wygaśnięciem
|
reminderDaysBeforeExpiry | array of integer |
Dni przed wygaśnięciem, gdy powinny zostać wysłane wiadomości e-mail z przypomnieniami. |
|
|
Wygasa w dniach
|
expiresInDays | integer |
Liczba dni przed wygaśnięciem utworzonych sesji podpisywania. |
Zwraca
Odpowiedź na żądanie wysłania szablonu.
- Body
- SendTemplateResponse
Definicje
TokenResponse
Odpowiedź tokenu OAuth.
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Token dostępu
|
access_token | string |
Token elementu nośnego do użycia w nagłówku X-NomaSign-Authorization. |
|
Odświeżanie tokenu
|
refresh_token | string |
Obracany token odświeżania do przechowywania na potrzeby następnego przebiegu. |
|
Wygasa za
|
expires_in | integer |
Okres istnienia tokenu dostępu w sekundach. |
|
Typ tokenu
|
token_type | string |
Typ tokenu zwrócony przez usługę autoryzacji. |
|
Scope
|
scope | string |
Zakresy przyznane tokenowi dostępu. |
SendTemplateResponse
Odpowiedź na żądanie wysłania szablonu.
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
tworzenie wystąpienia
|
instantiation | InstantiateTemplateResponse |
Odpowiedź wystąpienia szablonu. |
|
Zaproszenia
|
invites | array of SessionInviteResult |
Wyniki zaproszeń na sesję. |
Wystąpienie elementuTemplateResponse
Odpowiedź wystąpienia szablonu.
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator partii wysyłania zbiorczego
|
bulkSendBatchId | string |
Identyfikator usługi Batch po utworzeniu więcej niż jednej sesji. |
|
Sessions
|
sessions | array of InstantiateRowResult |
Wyniki tworzenia sesji w poszczególnych wierszach. |
Tworzenie wystąpienia elementuRowResult
Wynik tworzenia sesji dla wiersza.
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Indeks wierszy
|
rowIndex | integer |
Indeks wiersza na podstawie zera z żądania. |
|
Identyfikator sesji
|
sessionId | string |
Utworzony identyfikator sesji podpisywania. |
|
Identyfikatory dokumentów
|
documentIds | array of string |
Utworzone identyfikatory dokumentów sesji w kolejności dokumentu szablonu. |
|
Status
|
status | string |
Stan tworzenia wiersza. |
|
Error
|
error | string |
Komunikat o błędzie wiersza, gdy tworzenie nie powiodło się. |
SessionInviteResult
Wynik zaproszenia dla sesji.
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator sesji
|
sessionId | string |
Identyfikator sesji podpisywania. |
|
Title
|
title | string |
Tytuł sesji podpisywania. |
|
Stan zaproszenia
|
inviteStatus | string |
Stan zaproszenia dla tej sesji. |
|
Błąd zapraszania
|
inviteError | string |
Komunikat o błędzie zaproszenia podczas wysyłania nie powiodło się. |
|
Participants
|
participants | array of SessionParticipantEmailResult |
Wyniki e-mail poszczególnych uczestników. |
SessionParticipantEmailResult
Wynik e-mail dla każdego uczestnika.
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator uczestnika
|
participantId | string |
Identyfikator uczestnika podpisywania. |
|
Email
|
Adres e-mail uczestnika. |
||
|
Name
|
name | string |
Nazwa wyświetlana uczestnika. |
|
Status
|
status | string |
Stan wiadomości e-mail uczestnika. |
|
Adres URL podpisywania
|
signingUrl | string |
Publiczny adres URL podpisywania dla tego uczestnika. |