{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/it/products/namirialsignenterprise/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img"]},"type":"markdown"},"seo":{"title":"Layout firma (configurazione dell'imprint)","description":"Integration and usage documentation."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"layout-firma-configurazione-dellimprint","__idx":0},"children":["Layout firma (configurazione dell'imprint)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Un layout firma definisce quali informazioni compaiono nell'imprint di firma visivo applicato a un documento quando un destinatario firma. NSE consente di configurare un ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["layout predefinito"]}," valido per l'intera organizzazione, oltre a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["layout personalizzati"]}," applicabili a singoli campi firma tramite l'API."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"passaggio-1--configurare-i-layout-nellinterfaccia-utente","__idx":1},"children":["Passaggio 1 — Configurare i layout nell'interfaccia utente"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Accedere a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Impostazioni → Impostazioni dell'organizzazione → Generali → Layout firma"]},"."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/imprint.61d37da90a126af3d638c9253267fc872e8aa3d93dbe14bb7586ca9ddce8c145.4d07ae9a.png","alt":"No image","framed":false,"withLightbox":false},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"layout-predefinito","__idx":2},"children":["Layout predefinito"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Il layout predefinito si applica a ogni campo firma per il quale non è specificato un layout personalizzato. Utilizzare gli interruttori per abilitare o disabilitare ciascuna informazione:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Interruttore"},"children":["Interruttore"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Informazione mostrata nell'imprint"},"children":["Informazione mostrata nell'imprint"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Mostra nome"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Nome del firmatario"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Mostra cognome"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cognome del firmatario"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Mostra testo personalizzato"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Una stringa di testo personalizzato statica"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Mostra data e ora"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Data e ora della firma"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Mostra email"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Indirizzo email del firmatario"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["È inoltre possibile caricare un'",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["immagine di sfondo"]}," che compare sul contenuto dell'imprint di ogni firma."," ","Se è stata caricata un'immagine di sfondo, è possibile configurare dove deve essere visualizzata. Vedere le seguenti opzioni:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sfondo completo"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sopra il testo"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sotto il testo"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A sinistra del testo"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A destra del testo"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"layout-personalizzati","__idx":3},"children":["Layout personalizzati"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["I layout personalizzati consentono di definire configurazioni dell'imprint alternative, ad esempio un layout senza data oppure uno con un'immagine di sfondo diversa per un marchio o un tipo di documento specifico."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Per creare un layout personalizzato:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Fare clic su ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Aggiungi layout personalizzato"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Inserire un ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Nome layout"]},". Questo nome è quello a cui si fa riferimento nell'API."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configurare le informazioni da mostrare come imprint per la firma."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Fare clic su ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Salva"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["È possibile creare più layout personalizzati. Ciascuno è identificato dal proprio nome."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Importante:"]}," il nome del layout è sensibile alle maiuscole/minuscole e deve corrispondere esattamente a quello passato nell'API."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"passaggio-2---aggiungere-un-testo-personalizzato-opzionale","__idx":4},"children":["Passaggio 2 - Aggiungere un testo personalizzato (opzionale)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Se nel layout personalizzato il testo personalizzato è abilitato, è possibile definire un testo personalizzato a livello di destinatario dello stage. Vedere il seguente esempio di configurazione:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"type\": \"Automatic\",\n  \"languageCode\": \"en\",\n  \"signatureProfile\": \"Automatic Profile\",\n  \"signatureReason\": \"I agree to the terms.\",\n  \"metadata\": [\n    {\n      \"name\": \"customText\",\n      \"value\": \"First Signature\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"passaggio-3--fare-riferimento-a-un-layout-nellapi","__idx":5},"children":["Passaggio 3 — Fare riferimento a un layout nell'API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["I layout personalizzati vengono applicati a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["livello di campo firma"]},", all'interno di ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedSignatureTypes"]},", quando si posizionano i task di campo su un documento."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Per una panoramica completa del workflow di creazione di una pratica, vedere ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/03-developer-documentation/01-api-reference/basic-envelope-workflow"},"children":["Workflow base della pratica"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"il-parametro-layoutname","__idx":6},"children":["Il parametro ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["layoutName"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ogni tipo di firma, a eccezione della voce BiometricSignature, in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedSignatureTypes"]}," accetta un campo opzionale ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["layoutName"]},". Impostarlo sul nome di un layout personalizzato definito nell'interfaccia utente. Quando il firmatario completa quel campo, per l'imprint viene utilizzato il layout specificato invece di quello predefinito dell'organizzazione."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"allowedSignatureTypes\": [\n  {\n    \"signatureType\": \"TypeToSignSignature\",\n    \"layoutName\": \"TEST1\"\n  }\n]\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Se ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["layoutName"]}," viene omesso, si applica il layout predefinito dell'organizzazione."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"esempio-completo--campo-firma-con-layout-personalizzato","__idx":7},"children":["Esempio completo — campo firma con layout personalizzato"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["La richiesta seguente posiziona un singolo campo firma a pagina 1 e applica all'imprint il layout personalizzato ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TEST1"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"PUT /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/files/{fileId}/tasks\nAuthorization: Bearer {jwt_token}\nContent-Type: application/json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"tasks\": [\n    {\n      \"field\": {\n        \"fieldType\": \"Signature\",\n        \"id\": \"signature\",\n        \"page\": 1,\n        \"positionX\": 100,\n        \"positionY\": 650,\n        \"width\": 200,\n        \"height\": 60,\n        \"allowedSignatureTypes\": [\n          {\n            \"signatureType\": \"TypeToSignSignature\",\n            \"layoutName\": \"TEST1\"\n          }\n        ]\n      },\n      \"recipientId\": \"{recipientId}\",\n      \"sortOrder\": 1\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"più-tipi-di-firma-con-lo-stesso-layout","__idx":8},"children":["Più tipi di firma con lo stesso layout"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Se si consente al firmatario di scegliere tra più metodi, aggiungere ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["layoutName"]}," a ciascuna voce:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"allowedSignatureTypes\": [\n  { \"signatureType\": \"ClickToSignSignature\", \"layoutName\": \"TEST1\" },\n  { \"signatureType\": \"DrawToSignSignature\",  \"layoutName\": \"TEST1\" },\n  { \"signatureType\": \"TypeToSignSignature\",  \"layoutName\": \"TEST1\" }\n]\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"layout-differenti-per-tipo-di-firma","__idx":9},"children":["Layout differenti per tipo di firma"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["È possibile assegnare un layout diverso a ciascun metodo di firma, ad esempio un layout personalizzato con il proprio marchio per type-to-sign e uno minimale per click-to-sign:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"allowedSignatureTypes\": [\n  { \"signatureType\": \"ClickToSignSignature\", \"layoutName\": \"TEST1\" },\n  { \"signatureType\": \"TypeToSignSignature\",  \"layoutName\": \"TEST2\" }\n]\n","lang":"json"},"children":[]}]},"headings":[{"value":"Layout firma (configurazione dell'imprint)","id":"layout-firma-configurazione-dellimprint","depth":1},{"value":"Passaggio 1 — Configurare i layout nell'interfaccia utente","id":"passaggio-1--configurare-i-layout-nellinterfaccia-utente","depth":2},{"value":"Layout predefinito","id":"layout-predefinito","depth":3},{"value":"Layout personalizzati","id":"layout-personalizzati","depth":3},{"value":"Passaggio 2 - Aggiungere un testo personalizzato (opzionale)","id":"passaggio-2---aggiungere-un-testo-personalizzato-opzionale","depth":2},{"value":"Passaggio 3 — Fare riferimento a un layout nell'API","id":"passaggio-3--fare-riferimento-a-un-layout-nellapi","depth":2},{"value":"Il parametro layoutName","id":"il-parametro-layoutname","depth":3},{"value":"Esempio completo — campo firma con layout personalizzato","id":"esempio-completo--campo-firma-con-layout-personalizzato","depth":2},{"value":"Più tipi di firma con lo stesso layout","id":"più-tipi-di-firma-con-lo-stesso-layout","depth":3},{"value":"Layout differenti per tipo di firma","id":"layout-differenti-per-tipo-di-firma","depth":3}],"frontmatter":{"seo":{"title":"Layout firma (configurazione dell'imprint)"}},"lastModified":"2026-09-21T14:47:50.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/it/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/03-developer-documentation/01-api-reference/imprint-configuration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}