Desenvolver um Aplicativo Web que Modifique Documentos PDF
O Oracle Visual Builder fornece ferramentas e modelos que permitem criar aplicativos web que podem usar bibliotecas JavaScript externas para criar, atualizar e fazer download de Documentos PDF.
- Adição de um novo texto.
- Desenhando um retângulo ao redor de uma parte do documento.
- Dividindo o PDF em diferentes páginas.
- Inserindo uma imagem.
Esta solução oferece a você a orientação necessária para implementar a funcionalidade de modificação de PDF nos seus aplicativos Visual Builder web e móveis. Ele descreve como desenvolver um aplicativo web de uma página com o qual um usuário pode fazer upload ou criar um novo arquivo PDF, modificar esse documento com um texto personalizado e, em seguida, exibir o documento na página principal do aplicativo. Se necessário, o aplicativo também permitirá que os usuários façam download do arquivo no repositório do cliente local.
O repositório GitHub (SampleVBCSModifyingPDFApplication) contém o código-fonte de um aplicativo Web do Oracle Visual Builder que pode ser usado como exemplo de tal implementação. Você pode acessar esse repositório na seção "Explorar Mais" deste playbook.
Antes de Começar
Os desenvolvedores podem usar o Low Code Visual Builder da Oracle para criar aplicativos web ou móveis que podem tratar arquivos PDF para executar tarefas como:
- Criando um arquivo PDF.
- Modificando um conteúdo PDF (por exemplo, adicionando ou removendo páginas, texto, imagens).
- Mesclar documento PDF diferente em um ou dividir um documento PDF com várias páginas.
- Exibido na IU do aplicativo.
- Download feito pelo usuário do aplicativo.
- Armazenado em um bucket.
- Enviado a outros serviços do OCI para processamento adicional (por exemplo, serviço OCI Document Understanding).
Esta solução usa a API PDF-LIB para criar um novo documento PDF e modificar os documentos PDF existentes.
Arquitetura
Este diagrama de arquitetura mostra uma maneira comum de desenvolver e integrar um aplicativo web implementado e implantado pelo Oracle Visual Builder.
Descrição da ilustração webapp-vb-arch.png
O Oracle Visual Builder permite que você desenvolva aplicativos que possam se comunicar com o serviço de armazenamento de back-end. Use-o para criar as páginas que renderizam a interface do seu aplicativo, criar as conexões de serviço que se conectam aos serviços REST e definir configurações de build para que os serviços de build do Oracle Visual Builder possam criar aplicativos Web Android, iOS, Progressivos e básicos.
- Visual Builder Cloud Service
O Oracle Visual Builder Cloud Service é uma Plataforma como Serviço de desenvolvimento de software baseada em nuvem (PaaS) e um ambiente hospedado para sua infraestrutura de desenvolvimento de aplicativo. Ele fornece uma solução de código-fonte aberto baseada em padrões para desenvolvimento, colaboração e implantação de aplicativos no Oracle Cloud. Ele também oferece um ambiente de desenvolvimento Visual integrado com desenvolvimento colaborativo ágil, controle de versão e automação de entrega contínua. Enriqueça aplicativos com interface de usuário personalizada envolvente e é uma plataforma extensível por meio de JavaScript, HTML, CSS e REST padrão.
- Estúdio do Visual Builder
O Oracle Visual Builder Studio (VB Studio) é uma plataforma robusta de desenvolvimento de aplicativos que ajuda sua equipe a planejar e gerenciar com eficiência o seu trabalho em todos os estágios do ciclo de vida de desenvolvimento de aplicativos: projetar, criar, testar e implantar. Com o Oracle Visual Builder Studio, você obtém:
- Repositórios incorporados para hospedagem de código no Git e para hospedagem de binários, como dependências do Maven.
- Um serviço de integração contínua para que você possa automatizar seus sistemas de criação e teste.
- Um serviço de entrega contínua que se integra perfeitamente aos Oracle Cloud Applications.
- Um designer visual avançado integrado ao controle de origem (Git), para que os desenvolvedores possam gerenciar alterações, aplicar as melhores práticas de controle de versão e colaborar com seus colegas de equipe para desenvolver aplicativos.
- A capacidade de criar e exibir diferentes tipos de interface do usuário para atender às necessidades de usuários discretos de determinados Oracle Cloud Applications (aqueles criados com o VB Studio e o Oracle JavaScript Extension Toolkit (Oracle JET)), também dentro de uma estrutura Git.
- Placas ágeis e um sistema de rastreamento de problemas para rastrear sprints, tarefas, defeitos e recursos.
- VMs (executores de build de Máquinas Virtuais)
Os executores de build de VM são instâncias de computação de VM do OCI dedicadas a executar builds de jobs definidos pelos membros da sua organização em projetos do VB Studio. Um executor de VM está sempre associado a um modelo de executor de build. Quando os membros da sua organização criam jobs, eles simplesmente associam o modelo de executor apropriado ao job. Quando o build do job é acionado, o VB Studio executa o build em um executor de VM associado ao modelo do executor. Um executor de VM é iniciado automaticamente quando um build de um job que faz referência a seus triggers de modelo de executor e altera seu estado de acordo. Lembre-se de que um executor de VM só custa quando está ativo, executa um build ou está se preparando para executar um build.
- Contêineres Docker (Criar executor e Imagens)
Uma imagem do Docker define o sistema operacional e os pacotes de software necessários aos membros da sua organização para executar builds em um executor do Docker. Você pode importar uma imagem do Docker de um registro externo do Docker, como DockerHub, ou criá-la com base em um modelo de executor de build. Diferentemente de um executor de VM, um executor do Docker não está diretamente associado a nenhuma VM específica. Quando os membros da sua organização criam jobs, eles simplesmente associam uma imagem do Docker como um modelo de build ao job. Quando o build do job é acionado, o VB Studio executa o build em qualquer VM de implantação do Docker. Alguns pontos principais a serem lembrados sobre imagens do Docker:
- Quando você cria uma imagem com base em um modelo de executor de build, o VB Studio cria uma nova imagem do Docker instalando o software configurado nesse modelo. Quando você cria uma imagem de um registro, o VB Studio extrai a imagem do registro, adiciona um agente de build e cria uma nova imagem.
- Você pode especificar o número máximo de executores que podem ser criados com base na imagem.
- Você pode criar quantas imagens do Docker forem necessárias, desde que a VM de Gerenciamento tenha espaço suficiente.
- Funções
O Oracle Cloud Infrastructure Functions é uma plataforma Functions-as-a-Service totalmente gerenciada, multilocação, altamente escalável, sob demanda. Foi desenvolvido no Oracle Cloud Infrastructure de nível empresarial e desenvolvido pelo mecanismo de código aberto Fn Project. A arquitetura sem servidor e elástica do OCI Functions significa que não há administração de infraestrutura ou administração de software para que você execute. OCI Functions, você pode escrever código em Java, Python, Node, Go, Ruby e C# (e para casos de uso avançados, trazer seu próprio Dockerfile e Graal VM). Em seguida, você pode implantar seu código, chamá-lo diretamente ou acioná-lo em resposta a eventos e ser cobrado somente pelos recursos consumidos durante a execução. Você pode acessar as Funções do OCI usando a Console, uma CLI e uma API REST. Você pode chamar as funções que implantar no OCI Functions usando a CLI ou fazendo solicitações HTTP assinadas. O OCI Functions é integrado ao Oracle Cloud Infrastructure Identity and Access Management (IAM), que fornece autenticação fácil com a funcionalidade de identidade nativa do Oracle Cloud Infrastructure.
- Eventos
Ações que você executa nas instâncias do Oracle Visual Builder Studio que emitem eventos. Você pode usar a Console do Oracle Cloud para definir regras que acionem uma ação específica quando um evento ocorrer. O Oracle Cloud Infrastructure Events permite criar automação com base nas alterações de estado de recursos em toda a sua tenancy. Use o serviço Events para permitir que suas equipes de desenvolvimento respondam automaticamente quando um recurso alterar seu estado. Por exemplo, você poderá definir uma regra que envie uma notificação aos administradores quando alguém criar, excluir ou atualizar uma instância.
- Projeto
Um projeto é uma coleção de recursos do VB Studio. Você pode usar um projeto para hospedar arquivos de código-fonte, rastrear problemas, colaborar no código, criar e implantar seus aplicativos. Um projeto pode hospedar vários repositórios Git. Cada repositório Git pode ter várias ramificações e centenas de arquivos de código. Você pode criar uma solicitação de mesclagem para cada ramificação do repositório Git e solicitar que os revisores revisem o código. Você pode criar e configurar vários jobs de build para gerar artefatos de projeto diferentes que você possa implantar no Oracle Cloud ou no seu servidor Web local.
- Repositório Git
Um SCM (Source Code Management) e uma ferramenta de controle de versão distribuída para hospedar arquivos de código-fonte.
- Verificação de código e solicitação de fusão
Um método para mesclar uma ramificação do repositório Git com outra ramificação. Antes de mesclar as ramificações, os membros da equipe podem revisar as diferenças entre os arquivos de ambas as ramificações e fornecer seu feedback.
- Pipelines de integração contínua (CI) e entrega contínua (CD)
A integração contínua é um conjunto de práticas que permitem que as equipes de desenvolvimento implementem pequenas alterações de código e enviem o código para repositórios de controle de versão, como Git, com frequência. A entrega contínua é uma prática que permite que os desenvolvedores produzam software em ciclos curtos.
- Serviços em Nuvem de rede virtual na nuvem (VCN)
VCN é uma rede personalizável definida por software que você configura em uma região do Oracle Cloud Infrastructure. Como as redes tradicionais de data center, as VCNs oferecem total controle sobre seu ambiente de rede. Uma VCN pode ter vários blocos CIDR não sobrepostos que você pode alterar após a criação da VCN. Você pode segmentar uma VCN em sub-redes, com escopo definido para uma região ou para um domínio de disponibilidade. Cada sub-rede consiste em um intervalo contíguo de endereços que não se sobrepõem a outras sub-redes da VCN. Você pode alterar o tamanho de uma sub-rede após a criação. Uma sub-rede pode ser pública ou privada.
- Repositórios de Dados (com Oracle Autonomous Transaction Processing)
O Oracle Autonomous Transaction Processing é um banco de dados independente, com segurança e reparo, que é otimizado para cargas de trabalho de processamento de transações. Você não precisa configurar nem gerenciar nenhum hardware, nem instalar nenhum software. O Oracle Cloud Infrastructure trata da criação do banco de dados, bem como do backup, da aplicação de patches, do upgrade e do ajuste do banco de dados.
- Identity Cloud Services (IdCS)
O Oracle Identity Cloud Service fornece um serviço inovador e totalmente integrado que oferece todos os principais recursos de gerenciamento de identidade e acesso por meio de uma plataforma de Nuvem multitenant.
- Auditoria
O serviço OCI Audit registra automaticamente as chamadas a todos os pontos finais de API pública do OCI como eventos de log.
- Object Storage
O armazenamento de objetos fornece acesso rápido a grandes quantidades de dados estruturados e não estruturados de qualquer tipo de conteúdo, incluindo backups de banco de dados, dados analíticos e conteúdo avançado, como imagens e vídeos. Você pode armazenar de forma segura e depois recuperar dados diretamente da internet ou de dentro da plataforma da nuvem. Você pode dimensionar o armazenamento de forma integrada sem sofrer qualquer degradação no desempenho ou na confiabilidade do serviço. Use armazenamento padrão para armazenamento "dinâmico" que você precisa acessar de forma rápida, imediata e frequente. Use o armazenamento de arquivos compactados para armazenamento "frio" que você retém por longos períodos de tempo e raramente acessa.
Etapas para Criar Aplicativos com o Oracle Visual Builder
Estas são as etapas básicas a serem seguidas ao desenvolver aplicativos com o Oracle Visual Builder:
- Crie uma instância do serviço Visual Builder (se ainda não houver uma criada) com base no serviço independente Visual Builder ou na nova instância de integração (se ainda não houver uma criada) com base no Oracle Integration Cloud (OIC).
- Crie um novo aplicativo do Visual Builder.
- Crie um novo aplicativo web no Oracle Visual Builder.
- Crie as páginas e uma interface geral do usuário que expõe controles, como botões para fazer upload de arquivos, criar novos documentos PDF e fazer download de documentos atualizados.
- Crie as variáveis e constantes para hospedar as informações extraídas ou incluídas de e para o documento PDF.
- Importe os recursos externos e as bibliotecas necessários
- Desenvolva o código JavaScript necessário para:
- Faça upload de um arquivo no sistema local.
- Modifique o arquivo PDF carregado com o texto inserido.
- Crie um novo documento PDF.
- Faça download do arquivo PDF.
- Teste o aplicativo com o usuário e o documento apropriados.
- Armazene e publique o aplicativo Web.
Sobre Serviços e Atribuições Obrigatórios
Esta solução requer o serviço Oracle Visual Builder juntamente com estes serviços adicionais e as respectivas atribuições:
| Nome do Serviço: Atribuição | Obrigatório para |
|---|---|
| Oracle Cloud Infrastructure: Administrador | Gerencie usuários móveis, atribuições e realms. |
| Oracle Visual Builder: A atribuição predefinida do Desenvolvedor do Visual Builder que é mapeada para a atribuição predefinida da camada de aplicativos ServiceDeveloper. | Para criar, gerenciar, proteger e publicar aplicativos web e móveis. |
Consulte Saiba como obter serviços do Oracle Cloud para Soluções Oracle para obter os serviços de nuvem necessários.