Como assinar OneSpan: injetando campos
Com o OneSpan Sign, você pode personalizar seu documento. Uma das muitas maneiras de fazer isso é com injeção de campo. Esse recurso carimba valores diretamente no documento durante o upload do documento. Por exemplo, um assinante pode ter um número de agente e esse número de agente precisa aparecer no documento final ao lado de sua assinatura. Ao injetar o número de agente de um assinante no documento, esse novo texto se tornará parte do documento subjacente e não poderá ser violado.
Para ativar a injeção de campo, você precisará de um PDF com os campos do formulário. Além disso, os nomes dos campos do seu formulário no PDF devem ser os mesmos que os do campo injetado no seu código. Observe que atualmente a injeção de dados em um documento, usando o OneSpan Sign, só pode ser feita durante o upload do documento e somente através das API / SDKs. Neste blog, mostrarei como usar campos injetados com o Java SDK, .NET SDK e REST API.
O código
Com o nosso conjunto de objetivos, você pode ir em frente e pular para a seção que se aplica ao seu método. Cobrirei exatamente o mesmo conteúdo em cada segmento. O código completo deste blog pode ser encontrado no Compartilhamento de código da comunidade de desenvolvedores: Java , .INTERNET e DESCANSAR .
Java SDK
Vou começar com o Java SDK. No meu exemplo, optei por injetar campos de texto, pois provavelmente é isso que você acabará fazendo. No entanto, você pode injetar qualquer tipo de campo não vinculado que desejar. Você pode encontrar uma lista completa dos campos não acoplados do OneSpan Sign aqui . O código de exemplo abaixo mostra como editar o bloco de documentos para injetar campos de texto. o withName () O método é onde você insere o nome do seu campo de formulário PDF no qual deseja injetar texto, como é chamado no seu formulário PDF. o withValue () O método é o texto que você deseja carimbar no seu documento. Se você precisar de uma comparação com a criação básica de objeto de documento ou se for a primeira vez que cria um pacote com o Java SDK, consulte este blogue .
.withDocument (DocumentBuilder.newDocumentWithName ("Contrato de exemplo")
.enableExtraction ()
.fromStream (fs, DocumentType.PDF)
.withInjectedField (FieldBuilder.textField ()
.withName ("Texto1")
.withValue ("200 E MAIN ST, PHOENIX AZ, 85123 EUA"))
.withInjectedField (FieldBuilder.textField ()
.withName ("Texto2")
.withValue ("Cortador de grama"))
.withInjectedField (FieldBuilder.textField ()
.withName ("Texto3")
.withValue ("Fertilizante"))
.withInjectedField (FieldBuilder.textField ()
.withName ("Texto4")
.withValue ("100"))
.withInjectedField (FieldBuilder.textField ()
.withName ("Texto5")
.withValue ("12 12 12")))
Comunidade de desenvolvedores OneSpan Sign
Participe da comunidade de desenvolvedores do OneSpan Sign! Fóruns, blogs, documentação, downloads de SDK e muito mais.
Junte-se hoje .NET SDK A seguir, abordarei o .NET SDK. No meu exemplo, optei por injetar campos de texto, pois provavelmente é isso que você acabará fazendo. No entanto, você pode injetar qualquer tipo de campo não vinculado que desejar. Você pode encontrar uma lista completa dos campos não acoplados do OneSpan Sign aqui . O código de exemplo abaixo mostra como editar o bloco de documentos para injetar campos de texto. o withName () O método é onde você insere o nome do seu campo de formulário PDF no qual deseja injetar texto, como é chamado no seu formulário PDF. o withValue () O método é o texto que você deseja carimbar no seu documento. Se você precisar de uma comparação com a criação básica de objeto de documento ou se for a primeira vez que cria um pacote com o .NET SDK, consulte blogue .
.WithDocument (DocumentBuilder.NewDocumentNamed ("contrato de exemplo")
.EnableExtraction ()
.FromStream (fs, DocumentType.PDF)
.WithInjectedField (FieldBuilder.TextField ()
.WithId ("Texto1")
.WithName ("Texto1")
.WithValue ("200 E MAIN ST, PHOENIX AZ, 85123 EUA"))
.WithInjectedField (FieldBuilder.TextField ()
.WithId ("Texto2")
.WithName ("Texto2")
.WithValue ("Cortador de grama"))
.WithInjectedField (FieldBuilder.TextField ()
.WithId ("Texto3")
.WithName ("Texto3")
.WithValue ("Fertilizante"))
.WithInjectedField (FieldBuilder.TextField ()
.WithId ("Texto4")
.WithName ("Texto4")
.WithValue ("100"))
.WithInjectedField (FieldBuilder.TextField ()
.WithId ("Texto5")
.WithName ("Text5")
.WithValue ("12 12 12"))API REST
Por fim, examinarei a API REST. Incluí o JSON que criará seu pacote de documentos com campos de texto injetado por conveniência. No meu exemplo, optei por injetar campos de texto, pois provavelmente é isso que você acabará fazendo. No entanto, você pode injetar qualquer tipo de campo não vinculado que desejar. Você pode encontrar uma lista completa dos campos não acoplados do OneSpan Sign aqui . Além disso, observe que caixas de seleção e botões de opção são simplesmente caixas de seleção com um valor "X" quando selecionadas. A amostra JSON abaixo mostra como editar o objeto de documento para injetar campos de texto. No objeto de campos, o nome O atributo é onde você insere o nome do seu campo de formulário PDF no qual deseja injetar texto. o valor O atributo é onde você insere o texto que deseja injetar no seu documento. Se você precisar de uma comparação com a criação básica do objeto de documento ou se for a primeira vez que cria um pacote com a API REST, consulte este blogue .
{
"documentos": [
{
"Campos": [
{
"value": "200 E MAIN ST, PHOENIX AZ, 85123 EUA",
"name": "Text1"
}
{
"value": "Cortador de grama",
"name": "Text2"
}
{
"value": "fertilizante",
"name": "Text3"
}
{
"value": "100",
"name": "Text4"
}
{
"value": "12 12 12",
"name": "Text5"
}
],
"extrato": verdadeiro,
"name": "Exemplo de contrato"
}
],
"type": "PACOTE",
"status": "DRAFT",
"papéis": [
{
"id": "cliente",
"index": 0,
"type": "SIGNER",
"signatários": [
{
"email": "john.smith @example .com ",
"firstName": "John",
"lastName": "Smith",
"id": "cliente"
}
],
"nome": "cliente"
}
{
"id": "contratante",
"índice": 1,
"type": "SENDER",
"signatários": [
{
"email": "myemail @example .com ",
"firstName": "Haris",
"lastName": "Haidary",
"id": "contratante"
}
],
"nome": "contratante"
}
],
"name": "Exemplo de injeção de campo"
}Executando seu código
Depois de executar seu código, se você efetuar login no OneSpan Sign, deverá encontrar os campos de texto apropriados carimbados no documento no pacote de documentos do OneSpan Sign, conforme mostrado abaixo.
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: https://community.onespan.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 Júnior