OneSpan Blog

OneSpan Sign for New Users: Como criar e enviar seu primeiro pacote (Java SDK)

Desenvolvedores
Michael Williams, 16 de Junho de 2015
Thumbnail

Meus primeiros blogs abordados criando, enviando , assinar, arquivar e visualizar o resumo de evidências de um pacote de documentos de sinal OneSpan, usando a interface do usuário. Com isso concluído, agora é hora de entrar nas APIs. Minha principal linguagem de uso nos últimos 7 anos e na escola era Java, então começarei com o Java SDK.

Se você não possui uma conta Sandbox, consulte meu primeiro blog. Caso contrário, continue abaixo.

Exigências

Primeiro, abordaremos alguns requisitos para acompanhar este blog.

Fazendo Download do Java SDK

Antes de podermos usar o Java SDK, você precisará baixá-lo. No link a seguir, você encontrará links para o download do Java SDK, do Java SDK JavaDoc e dos Exemplos de Java do GitHub. Você também verá downloads e informações do .NET SDK e Mobile SDK.

Faça o download do Java SDK

 

Fazendo Download de um IDE Java

Eu usarei o Eclipse IDE neste blog. Você pode usar outro, mas tudo neste blog será descrito usando o Eclipse. Abaixo está um link para baixar o Eclipse. Estou usando o "Eclipse para Java e desenvolvedores de relatórios" porque o uso para a ferramenta de relatório BIRT, posteriormente neste exemplo.

Baixar Eclipse

Vá em frente e instale o Eclipse descompactando o arquivo zip no seu local preferido. Eu escolhi "C: / Eclipse /".

Comunidade de desenvolvedores OneSpan Sign

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

Criar e enviar um pacote

Agora que temos todos os elementos essenciais para concluir o tutorial, podemos prosseguir e começar.

Criar e configurar um projeto Java

Abra o Eclipse executando eclipse.exe na pasta raiz "eclipse". Depois de iniciado: se ainda não estiver aberto, abra a perspectiva Java. Você pode fazer isso indo para Janela -> Perspectiva aberta -> Outro… -> Java .

javaPerspective

Depois de abrir a perspectiva Java, você verá uma Visualização chamada "Package Explorer" no lado esquerdo da tela. Clique com o botão direito dentro desta janela e vá para Novo -> Projeto Java . Isso abrirá uma janela como a abaixo:

javaProject

Nomeie seu projeto como desejar. Eu usei "CreateAndSendPackage". Então, bata em seguida.

Escolha a guia Bibliotecas, clique no botão "Adicionar JARs externos ...", navegue até o local em que você salvou seu SDK e selecione o jar "sdk - jar-with-dependencies". Depois de selecionar "Abrir", você verá que o jar do SDK foi adicionado ao seu caminho de compilação.

sdkJar

Selecione Concluir.

Seu novo projeto foi adicionado à sua visualização do Package Explorer.

createSrcPackage

Expanda o pacote clicando na seta à esquerda, clique com o botão direito na pasta "src" e vá para Novo -> Pacote . Digite o que você deseja para o nome do pacote. Eu digitei "com.esignlive.example". Selecione Concluir.

createSrcPackage

Clique com o botão direito do mouse no seu novo pacote no Package Explorer e vá para Novo -> Arquivo para criar um novo arquivo java. Digite um nome para o arquivo. Eu nomeei o arquivo "SimpleCreateAndSendPackage.java". Selecione Concluir.

Por fim, adicione um arquivo PDF de amostra que você deseja assinar no seu projeto com uma simples cópia e colagem do seu sistema de arquivos no seu projeto no explorador de pacotes. Usei o BIRT (projeto de relatório do Eclipse) para criar o exemplo de PDF de contrato usado neste blog.

Isso completa a instalação e configuração. Seu projeto agora deve ficar assim:

configureProject

Agora você está pronto para escrever o código na sua classe Java.

O código

Abra o arquivo "SimpleCreateAndSendPackage.java" no Eclipse. Copie o código abaixo no editor de arquivos. Discutiremos o código em mais detalhes, mais adiante.

pacote com.esignlive.example;

importar com.silanis.esl.sdk.DocumentPackage;
import com.silanis.esl.sdk.EslClient;
importar com.silanis.esl.sdk.PackageId;
importar com.silanis.esl.sdk.SessionToken;
 
importar estático com.silanis.esl.sdk.builder.DocumentBuilder.newDocumentWithName;
importar estático com.silanis.esl.sdk.builder.PackageBuilder.newPackageNamed;
importar estático com.silanis.esl.sdk.builder.SignatureBuilder.signatureFor;
importar estático com.silanis.esl.sdk.builder.SignerBuilder.newSignerWithEmail;
 
classe pública SimpleCreateAndSendPackage {
 
    final estático público String API_KEY = "";
    public static final String API_URL = "https://sandbox.esignlive.com/api"; 
    // USE https://apps.e-signlive.com/api PARA PRODUÇÃO
 
    public static void main (String [] args) {
        EslClient eslClient = novo EslClient (API_KEY, API_URL);
        // Construa o objeto DocumentPackage
        DocumentPackage documentPackage = newPackageNamed ("API do Pacote de Teste")
                .withSigner (newSignerWithEmail ("signers.email @example .com ")
                        .withCustomId ("Signer")
                        .withFirstName ("SignerFirstName")
                        .withLastName ("SignerLastName"))
                .withSigner (newSignerWithEmail ("your.email @example .com ")
                        .withFirstName ("YourFirstName")
                        .withLastName ("YourLastName"))
                .withDocument (newDocumentWithName ("sampleAgreement")
                        .fromFile ("sampleAgreement.pdf")
                        .withSignature (signatureFor ("signers.email @example .com ")
                                .emPágina (0)
                                .atPosition (175, 165))
                        .withSignature (signatureFor ("your.email @example .com ")
                        		.emPágina (0)
                        		.atPosition (550, 165)))
                .Construir();
 
        // Emita a solicitação ao servidor de sinal OneSpan para criar o DocumentPackage
        PackageId packageId = eslClient.createPackage (documentPackage);
 
        // Envie o pacote a ser assinado pelos participantes
        eslClient.sendPackage (packageId);
    }
}

Você verá na primeira linha da classe que precisará da sua chave de API. Para encontrar isso, faça login na sua conta OneSpan Sign e clique em "CONTA" no menu superior. Sua chave de API está listada lá. Por padrão, o valor está oculto. Selecione "Desbloquear" para mostrar o valor. Agora, substitua pelo valor da chave da API.

A próxima linha é a API_URL. Se você estiver usando o Sandbox, como eu, o URL correto já está no lugar. Se estiver em produção, você deve usar o URL comentado.

Como este é um exemplo muito básico, o restante do código também está dentro do método principal.

EslClient eslClient = novo EslClient (API_KEY, API_URL);

A linha de código acima cria nosso OneSpan Sign Client usando a chave de API da sua conta OneSpan Sign e o URL da API apropriado que você definiu acima.

O próximo bloco de código é onde você realmente cria o pacote de documentos. Dentro desse bloco, você dá um nome ao seu pacote.

DocumentPackage documentPackage = newPackageNamed ("API do Pacote de Teste")

Em seguida, dois assinantes são adicionados ao pacote. Um é você mesmo e o outro é a pessoa para quem você enviará o pacote para assinatura. Neste bloco, você substituirá os endereços e nomes de email pelas suas informações de teste.

.withSigner (newSignerWithEmail ("signers.email @example .com ")
        .withCustomId ("Signer")
        .withFirstName ("SignerFirstName")
        .withLastName ("SignerLastName"))
.withSigner (newSignerWithEmail ("your.email @example .com ")
        .withFirstName ("YourFirstName")
        .withLastName ("YourLastName"))

Adicionamos nosso documento a ser assinado e também colocamos os blocos de assinatura para nossos assinantes. Novamente, lembre-se de substituir os valores da amostra neste bloco pelas suas informações de teste.

.withDocument (newDocumentWithName ("sampleAgreement")
        .fromFile ("sampleAgreement.pdf")
        .withSignature (signatureFor ("signers.email @example .com ")
                .emPágina (0)
                .atPosition (175, 165))
        .withSignature (signatureFor ("your.email @example .com ")
                .emPágina (0)
                .atPosition (550, 165)))

Finalmente, construímos nosso pacote.

.Construir();

Agora que o objeto do pacote de documentos está pronto, podemos acessar nosso OneSpan Sign Client, criar nosso pacote e enviá-lo aos assinantes.

// Emita a solicitação ao servidor de sinal OneSpan para criar o DocumentPackage
PackageId packageId = eslClient.createPackage (documentPackage);
 
// Envie o pacote a ser assinado pelos participantes
eslClient.sendPackage (packageId);

Executando o código

Com sua classe Java concluída, você pode prosseguir e executar seu aplicativo simples. Existem algumas maneiras de fazer isso no Eclipse. Na barra de ferramentas, você pode selecionar o botão Executar, você pode selecionar Executar -> Executar na barra de menus, ou você pode clicar com o botão direito do mouse na sua classe Java no Package Explorer e escolher Executar como -> aplicativo Java .

Parabéns! Agora você criou e enviou um pacote com o Java SDK. Se você for verificar a caixa de entrada da conta OneSpan Sign Sandbox, verá que o pacote foi criado e aguardando assinatura.

caixa de entrada

Obrigado pela leitura! Se você tiver dúvidas, sinta-se à vontade para postar perguntas na seção de comentários. Da próxima vez, continuarei com o que acontece em seguida com este pacote, mostrando como verificar o status de um pacote e fazer o download do pacote completo. Se você quiser avançar um pouco mais com as APIs, consulte a documentação e os exemplos disponíveis. Você encontrará links no local em que baixamos o SDK, acima. Os links para todas as postagens desta série de blogs podem ser encontrados abaixo.

- Michael Williams
Twitter | Facebook | LinkedIn

 

Série de blogs OneSpan Sign for New Users

desenvolvedor e-Sign assinatura eletrônica Eclipse Java pacote caixa de areia tutorial
Michael Williams
Ir para o topo