OneSpan Sign Como: Usando Tags de Texto

Haris Haidary, 2 de Agosto de 2017

No próximo liberação do OneSpan Sign (11.5), adicionamos um novo recurso de extração de tags de texto que extrai automaticamente assinaturas e campos colocando tags de texto diretamente em um documento. Em outras palavras, o OneSpan Sign analisará o documento carregado e substituirá todo texto que corresponda ao padrão Tag de texto pela assinatura ou campo apropriados. A versão 11.5 está programada para ser lançada em 7 de agosto para o ambiente sandbox e 17 de agosto para o ambiente de produção. Neste blog, mostrarei um exemplo de como usar tags de texto.

O código

Vamos direto ao assunto. O recurso de extração de Tag de texto é muito simples de usar. Em resumo, tudo o que você precisa fazer é adicionar as "tags de texto" no seu documento onde deseja que suas assinaturas e campos usem a nomenclatura do OneSpan Sign. Depois de fazer o upload do documento no OneSpan Sign, as tags de texto desaparecerão e serão substituídas pelas assinaturas e campos correspondentes. Por exemplo, a seguir é a sintaxe válida mais curta para uma tag de texto:

{{esl: role: fieldType}}

Onde Função o é o roleId do seu destinatário e fieldType é a assinatura ou o tipo de campo que você deseja colocar. Abaixo está uma captura de tela do documento que usei no meu exemplo. Ele ilustra alguns exemplos de tags de texto válidos que você pode usar.

O recurso de extração de tags de texto está disponível por meio da API REST e SDKs. Para uma descrição completa do novo recurso Tag de texto, consulte nosso documentação . Depois que seu documento estiver finalizado, você precisará habilitar esse recurso durante a criação da transação. Abaixo estão exemplos usando nossa API Java SDK, .NET SDK e REST, respectivamente.

Java SDK

EslClient eslClient = novo EslClient (API_KEY, API_URL);

DocumentPackage pkg = PackageBuilder.newPackageNamed ("Exemplo de tags de texto")
		.withSigner (SignerBuilder.newSignerWithEmail ("mail32 @mailinator .com ")
				.withFirstName ("John")
				.withLastName ("Smith")
				.withCustomId ("signer1"))
		.withDocument (DocumentBuilder.newDocumentWithName ("Contrato de exemplo")
				.fromFile ("C: /Users/hhaidary/Desktop/sample_contract_text_tags.docx")
				.enableExtraction ()
				.withExtractionType (ExtractionType.TEXT_TAGS))
		.Construir();

PackageId packageId = eslClient.createAndSendPackage (pkg);

System.out.println (packageId);

.NET SDK

EslClient eslClient = novo EslClient (API_KEY, API_URL);

DocumentPackage pkg = PackageBuilder.NewPackageNamed ("Exemplo de tags de texto")
        .WithSigner (SignerBuilder.NewSignerWithEmail ("mail32 @mailinator .com ")
                .WithFirstName ("John")
                .WithLastName ("Smith")
                .WithCustomId ("signer1"))
        .WithDocument (DocumentBuilder.NewDocumentNamed ("Contrato de exemplo")
                .FromFile ("C: /Users/hhaidary/Desktop/sample_contract_text_tags.docx")
                .EnableExtraction ()
                .WithExtractionType (ExtractionType.TEXT_TAGS))
        .WithStatus (DocumentPackageStatus.SENT)
        .Construir();

PackageId packageId = eslClient.CreatePackageOneStep (pkg);

Debug.WriteLine (packageId);

API REST

POST https://sandbox.esignlive.com/api/packages HTTP / 1.1
Tipo de Conteúdo: multipart / form-data; esl-api-version = 11.9; boundary = lKkOm3QpMGT9LnKz
Autorização: básica YOUR_API_KEY
Anfitrião: sandbox.esignlive.com
Comprimento do conteúdo: 13736
Esperar: 100 continuações
Conexão: Keep-Alive

--lKkOm3QpMGT9LnKz

Disposição de conteúdo: dados do formulário; nome = "carga útil"; filename = "carga útil"

{
  "preenchimento automático": true,
  "documentos": [
    {
      "extrato": verdadeiro,
      "extractTypes": [
        "TEXT_TAGS"
      ],
      "index": 0,
      "name": "Exemplo de contrato"
    }
  ],
  "name": "Exemplo de tags de texto",
  "papéis": [
    {
      "id": "signer1",
      "index": 0,
      "name": "signer1",
      "signatários": [
        {
          "email": "mail32 @mailinator .com ",
          "firstName": "John",
          "id": "signer1",
          "lastName": "Smith"
        }
      ]
    }
  ],
  "status": "SENT",
  "type": "PACOTE",
  "visibilidade": "CONTA"
}

--lKkOm3QpMGT9LnKz

Disposição de conteúdo: dados do formulário; nome = "arquivo"; filename = "C: /Users/hhaidary/Desktop/sample_contract_text_tags.docx"

[binários de documentos]

--lKkOm3QpMGT9LnKz--

Executando seu código

Depois de executar o código, você verá que as tags de texto desapareceram e foram substituídas pela assinatura e pelos campos correspondentes.

capturar

Você pode fazer o download da amostra JSON e do documento acima na Comunidade do desenvolvedor Partilha de código .

Se você tiver dúvidas sobre este blog ou qualquer outra coisa relacionada à integração do OneSpan Sign ao seu aplicativo, visite os fóruns da comunidade de desenvolvedores: developer.esignlive.com . É isso de mim. Obrigado pela leitura! Se você achou esta publicação útil, compartilhe-a no Facebook, Twitter ou LinkedIn.

Haris Haidary

Evangelista Técnico

LinkedIn | Twitter