Anunciando o Aplicativo Gerador de Documentos de Amostra Oracle APEX!

Recentemente, a Oracle lançou a função pré-construída do Gerador de Documentos, uma nova função para gerar documentos PDF a partir de uma combinação de dados JSON e modelos do MS Word.

Hoje, estamos lançando o aplicativo Sample Document Generator, que mostra a integração do Document Generator no APEX. O aplicativo já está disponível na Galeria APEX 23.2.

Este aplicativo inclui exemplos para gerar documentos PDF usando um plug-in personalizado, que invoca a função Gerador de Documentos. Sinta-se à vontade para explorar o código do plug-in, ver os modelos do MS Word armazenados em arquivos estáticos de aplicativos e o JSON.

Custo-benefício

Para criar a função Gerador de Documentos Pré-Construídos, você precisa ter uma conta paga, mas o preço é extremamente econômico. Com o Oracle Cloud Functions, você paga apenas pelos recursos consumidos durante a execução, eliminando a necessidade de investimento inicial em infraestrutura. Você pode aprender mais sobre funções e preços aqui.

A instalação no Oracle Cloud é necessária

O aplicativo de amostra usa um plug-in que aproveita o Oracle Cloud Infrastructure SDK para PL/SQL, o que facilita muito o gerenciamento/invocação de recursos do OCI. Este SDK está disponível apenas no Autonomous Database, o que significa que o aplicativo de amostra requer um Autonomous Database. Isso não significa que você não possa usar o Gerador de Documentos em outra instância do APEX. Timo Herwix publicou uma ótima postagem no blog onde está usando REST para invocar a função.

Existem vários pré-requisitos que devemos atender antes de podermos usar o aplicativo de exemplo para gerar documentos PDF. Essas etapas são descritas abaixo.

Configurar a função Gerador de Documentos

Abaixo seguimos os passos da documentação.

No OCI, abra o menu de navegação e selecione Funções pré-construídas em Developer Services.

Selecione Documento Generator.

Clique no botão Create Function. Se ainda não existir um aplicativo adequado no compartimento atual, clique em Create new application.

Dica: ao usar o Gerador de Documentos em produção, você pode ativar a simultaneidade provisionada para reduzir o tempo de provisionamento inicial e garantir inicializações a quente.

Clique no botão Create para finalizar o assistente e você poderá ver que a função agora está implementada no aplicativo.

Criar um bucket de armazenamento de objetos

Abra o menu de navegação e selecione Buckets do Storage (armazenamento).

Criar um novo bucket, se necessário, e fornecer um nome.

O aplicativo de exemplo usará esse intervalo posteriormente para armazenar os modelos do MS Word e documentos PDF.

Configurar o banco de dados

Nas próximas etapas, garantimos que o banco de dados tenha os direitos para invocar a função Document Generator e gerenciar objetos em Object Storage Buckets.

Começamos criando um Grupo Dinâmico para o banco de dados.

Abra o menu de navegação e selecione Domains em Identity & Security. Selecione o domínio de identidade no qual deseja trabalhar e clique em Dynamic Groups. Crie um novo grupo dinâmico, se necessário, especificando um nome, uma descrição e uma regra usando o OCID do seu Autonomous Database como ID de recurso. Lembre-se do nome porque precisaremos dele mais tarde.

A seguir, criamos uma nova Política para este Grupo Dinâmico. Abra o menu de navegação e selecione Policies em Identity & Security.

Criar a seguinte política.

Íntegra do código acima:

Allow dynamic-group <group_name> to manage objects in compartment <compartment_name>

Allow dynamic-group <group_name> to manage buckets in compartment <compartment_name>

Allow dynamic-group <group_name> to use functions-family in compartment <compartment_name>

Como etapa final no OCI, temos que executar as seguintes instruções como usuário ADMIN no Autonomous Database.

Vá para o Automous Database e clique em SQL nas Ações do banco de dados.

Execute o código a seguir como usuário ADMIN.

Íntegra do código acima:

begin

    DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL();

    DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL(username => '<WORKSPACE_SCHEMA>');

end;

/

grant DWROLE to <WORKSPACE_SCHEMA>;

A entidade de recurso é usada para autenticar e acessar recursos do Oracle Cloud Infrastructure. O DWROLE permite usar o OCI PL/SQL SDK.

Instalando rapidamente o aplicativo de exemplo Gerador de Documentos

Execute as seguintes etapas para instalar o aplicativo:

1. Vá para a App Galery (Galeria de aplicativos).

2. Procure o aplicativo Sample Document Generator.

3. Clique em instalar.

4. Vá para o aplicativo e navegue até Componentes Compartilhados > Configurações do Componente

5. Especifique valores para os atributos vazios:

• Regiona name (Nome da região): a região OCI da função Object Storage Bucket e Document Generator.
• Documento Generation Function OCID (OCID da Função Geradora de Documentos): O OCID da função no aplicativo OCI.
• Bucket Namespace (Namespace do bucket): o namespace OCI do bucket do Object Storage.
• Bucket name (Nome do bucket): o nome do bucket do Object Storage.

Agora cumprimos os pré-requisitos e estamos prontos para usar o aplicativo!

Esperamos que você goste deste aplicativo e aprenda como você pode integrar com a função pré-construída do Gerador de Documentos!

-----------

Fonte: Menno Hoogendijk (Oracle Blogs)