Antes de Começar

Neste tutorial, você aprende a instalar o Add-in do Oracle Visual Builder Add-in for Excel, criar uma pasta de trabalho do Microsoft Excel que recupera dados de um serviço REST e publicar a pasta de trabalho para que os usuários de negócios possam executar tarefas de entrada de dados. Este tutorial demora aproximadamente 10 minutos para ser concluído.

Histórico

O Oracle Visual Builder Add-in for Excel ajuda você a fazer download de dados de um serviço REST para uma tabela em uma pasta de trabalho do Excel, na qual os usuários podem modificar, criar ou excluir dados antes de enviar essas alterações de volta ao serviço. Depois de instalar o add-in, você informará o ponto final do serviço para fazer download dos dados do serviço para a pasta de trabalho do Excel. Você também verá uma nova guia da faixa do Oracle Visual Builder com comandos para ajudá-lo a gerenciar os dados baixados.

Do Que Você Precisa?

• Um sistema operacional Windows 10 ou 11 com uma instalação do Microsoft Excel 365 ou outra versão suportada

  (Consulte Plataformas Suportadas em Desenvolvendo Planilhas Integradas Usando o Oracle Visual Builder Add-in for Excel.)

• Acesso à sua instância do Oracle Visual Builder

  Observação: talvez você possa concluir o tutorial usando um serviço REST de sua escolha. Certifique-se de ter os metadados do serviço OpenAPI para o serviço de destino (alguns serviços Oracle fornecem essa descrição adicionando /describe ao URL). Se você seguir essa rota, algumas etapas deste tutorial poderão ser diferentes para o seu serviço.

  Por exemplo, você pode ignorar as subetapas 1 a 6 da etapa 1, mas ainda precisará concluir as subetapas 7 e 8 para instalar o add-in. Faça download do instalador na página Downloads antes de começar.

Instalar o Oracle Visual Builder Add-in for Excel

1. Clique com o botão direito do mouse neste arquivo e faça download dele para seu computador.

   O arquivo Personnel_Manager.zip contém um aplicativo visual com um objeto de negócios Funcionários e dados de amostra.

2. Em seu navegador da Web, acesse o Oracle Visual Builder.
3. Na página Aplicativos Visuais, clique em Importar, selecione Aplicativo do arquivo e procure o arquivo Personnel_Manager.zip . Clique em Importar.
4. Na página Aplicativos Visuais, clique em Gerenciador de Pessoal na coluna Nome.
5. Clique em Objetos de Negócios , depois clique em Menu e selecione Gerenciador de Dados.

   

6. Na página Gerenciador de Dados, clique em Editar Dados no Excel para fazer download do instalador.

   Dica: Verifique se há uma versão mais recente na página Downloads.

7. Saia do Excel antes de executar o instalador.
8. Clique duas vezes no arquivo do instalador baixado para iniciar a instalação, clique em Próximo e, em seguida, em Fechar após a instalação do add-in. Consulte Instalar o Oracle Visual Builder Add-in for Excel em Desenvolvendo Planilhas Integradas Usando o Oracle Visual Builder Add-in for Excel.

   Uma instalação bem-sucedida ativa o add-in no Excel e uma nova guia do Oracle Visual Builder é exibida quando você inicia o Excel.

   

Configurar uma Pasta de Trabalho do Excel para Fazer Download de Dados de um Serviço REST

Nesta etapa, você criará uma tabela em uma pasta de trabalho do Excel que fará download dos dados do funcionário do serviço REST associado ao aplicativo visual que você acabou de importar.

1. Na guia Objetos de Negócios do Oracle Visual Builder, clique em Funcionários e, em seguida, em Pontos Finais.
2. Expanda APIs de Recursos e, em seguida, clique no ícone Área de Transferência para copiar todo o URL da API de recursos de metadados:

   

3. Crie uma pasta de trabalho do Excel chamada employees-source.xlsx em um diretório no computador e abra-a.
4. Clique na célula onde deseja localizar a tabela de dados.
5. Na guia Oracle Visual Builder da pasta de trabalho do Excel, clique em Designer para iniciar o assistente de Configuração de Novo Layout.
6. Na primeira tela do assistente, informe o URL que você copiou anteriormente no campo Endereço da Web e clique em Próximo.

   

   Deixe a definição de autenticação definida como "Padrão".

   Observação: Se você estiver usando outro serviço REST, digite o URL desse serviço e anexe /describe ao URL.

7. Na caixa de diálogo Acessar, informe o nome do usuário e a senha que você usa para acessar o Oracle Visual Builder e clique em Acessar.

   O add-in se conecta à sua instância do Oracle Visual Builder e recupera os metadados do serviço. Os resultados da operação são exibidos no assistente.

8. Clique em Próximo para continuar.
9. Na próxima tela, selecione Funcionários e clique em Próximo.

   

   A próxima tela solicita que você escolha o tipo de layout que deseja criar: Tabela ou Form-over-Table.

   

10. Selecione Layout da Tabela e clique em Próximo.

    A próxima tela solicita que você escolha objetos de negócios adicionais para um ou mais layouts dependentes.

    

11. Deixe esta tela em branco e clique em Próximo para continuar.
12. Na tela final, confirme os detalhes do seu novo layout e clique em Finalizar.

    Uma nova tabela é exibida na pasta de trabalho do Excel. Os cabeçalhos de coluna são mostrados, com uma linha de dados de espaço reservado abaixo dos cabeçalhos. Você também verá o Designer de Layout à direita.

    

    Observação: Se a célula de origem do layout estiver nas primeiras 10 linhas, a linha do cabeçalho será congelada para que você sempre veja os cabeçalhos da coluna quando rolar para cima e para baixo na planilha.

13. Clique em Fazer Download de Dados para fazer download dos dados aos quais o objeto de negócios Funcionário faz referência.

    

Personalizar a Tabela na Pasta de Trabalho do Excel Antes da Publicação

Talvez você queira personalizar a tabela que o suplemento cria na pasta de trabalho do Excel antes de publicá-la e distribuí-la aos usuários para entrada de dados. Por exemplo, talvez você queira alterar a ordem das colunas para que a coluna E-mail apareça antes do nome do funcionário. Você também pode adicionar uma consulta de pesquisa para filtrar os dados baixados do serviço. Por exemplo, você pode adicionar o campo Salário do objeto de negócios Funcionários como um campo de pesquisa para permitir que os usuários informem critérios de pesquisa que lhes permitam fazer download apenas dos registros de funcionários que correspondem a esses critérios.

1. Na guia Oracle Visual Builder, clique em Designer, se necessário. Em seguida, clique na guia Colunas no Designer de Layout.
2. Reordene as colunas arrastando e soltando o ícone que aparece à esquerda da entrada E-mail, conforme mostrado aqui:

   Dica: Clique com o botão direito do mouse em uma coluna para ver mais opções de reordenação.

   

   Observação: as colunas Alteração, Status e Chave são geradas automaticamente. Não é possível personalizar ou remover essas colunas.

3. Clique na guia Fazer Download para adicionar uma consulta de pesquisa.
4. Clique no ícone Editar ao lado de Pesquisar.

   

5. Selecione Salário no Editor de Campos de Objetos de Negócios Disponíveis e clique em OK.
6. No Editor de Pesquisa, selecione maior que na lista de comparadores e deixe o valor vazio.
7. Desmarque Editor ativado no download para garantir que os controles do editor de pesquisa no prompt de Pesquisa estejam desativados no download.
8. Clique em OK para salvar as definições de pesquisa e fechar o Editor de Pesquisa.
9. Clique em Fazer Download de Dados.
10. Na caixa de diálogo Pesquisar, informe 10000 e clique em OK.

    O add-in faz download somente dos registros de funcionários cujo salário excede 10.000.

    

Publicar e Distribuir a Pasta de Trabalho do Excel para Usuários

Agora que você criou a pasta de trabalho do Excel e a configurou para fazer download de dados do seu serviço REST, talvez queira publicá-la. Esta etapa opcional é útil se você quiser criar uma cópia de sua pasta de trabalho que você possa distribuir para outros usuários para entrada de dados. Ele também permite que você remova as ferramentas de Design (Designer, Excluir Layout e Publicar) e ative a proteção da planilha. Dito isto, você pode distribuir a pasta de trabalho do Excel de origem sem publicá-la.

1. Na guia Oracle Visual Builder, clique em Publicar.

   

2. Na janela Publicar Pasta de Trabalho, aceite o local e o nome do arquivo da pasta de trabalho. Quando o nome da pasta de trabalho original termina com -source (como em nosso exemplo, employees-source.xlsx), o add-in oferece o mesmo nome sem -source.

   

3. Desmarque a caixa de seleção Remover o host de serviço de cada catálogo, mas deixe as outras opções de publicação inalteradas.
4. Clique em Publicar. Consulte Publicar uma Pasta de Trabalho do Excel Integrada em Desenvolvendo Planilhas Integradas Usando o Oracle Visual Builder Add-in for Excel.

   Uma confirmação é exibida no painel Status.

   

5. Salve e feche a pasta de trabalho do Excel de origem que você usou para publicar a pasta de trabalho do Excel.

   Agora, você pode distribuir a pasta de trabalho publicada para outros usuários para entrada de dados. Cada usuário deve ter um nome de usuário e uma senha que permitam o acesso ao serviço REST informado ao criar a pasta de trabalho do Excel.

   A próxima etapa deste tutorial mostra como os usuários concluem as tarefas de entrada de dados usando a pasta de trabalho do Excel que você acabou de publicar.

Criar, Ler, Atualizar e Excluir Dados em uma Pasta de Trabalho Publicada do Excel

Os usuários comerciais que recebem uma cópia da pasta de trabalho do Excel publicada devem instalar o add-in para fazer download dos dados do serviço REST. (Eles podem fazer download do instalador diretamente na página Downloads.) Depois que o suplemento é instalado, eles podem criar, ler, atualizar e excluir dados baixados na pasta de trabalho antes de fazer upload das alterações no serviço.

1. Abra a pasta de trabalho do Excel publicada no diretório no qual você a salvou.

   

   A seção Design não aparece na guia Oracle Visual Builder porque você desativou as ferramentas de Design, impedindo que os usuários de uma pasta de trabalho publicada acessem os comandos Designer, Excluir Layout e Publicar que você, como desenvolvedor de pasta de trabalho, pode acessar. A tabela exibe os cabeçalhos de coluna, mas sem dados, porque você optou por limpar todos os layouts ao publicar a pasta de trabalho do Excel.

2. Clique em Fazer Download de Dados para fazer download dos dados que a pasta de trabalho está configurada para recuperar.
3. Insira um nome de usuário e uma senha na caixa de diálogo Acessar e clique em OK.
4. Como você configura uma consulta de pesquisa para limitar os downloads de dados com base no salário do funcionário, será solicitado que você insira um valor para a consulta. Deixe o valor vazio e clique em OK.

   O suplemento baixa todos os dados do funcionário.

   

5. Faça as seguintes alterações:
   • Na Linha 1, altere Sophia para Sophie.
   • Clique na célula G2 e selecione Gerente na lista de valores para alterar o Título do Cargo de Dave Brown.
   • Selecione a linha para John Sieve (Linha 4) clicando, por exemplo, em seu endereço de email. Na guia Oracle Visual Builder, clique em Alterações de Linha da Tabela e, em seguida, clique em Marcar para Exclusão.
   • Selecione a linha inteira 5, clique com o botão direito do mouse e escolha Inserir no menu de contexto. Insira esses dados para a linha recém-inserida: E-mail = jmcgahern@example.com, Nome = John, Sobrenome = McGahern, Data de Admissão = 2018-01-30, Cargo = Accountant, Salário = 19,000 e Departamento = Accounting.

     Observação: Outra forma de adicionar novas linhas na tabela é selecionar a linha imediatamente abaixo da última linha baixada na tabela, clicar em Alterações de Linha da Tabela e Inserir Linhas. O suplemento cria uma nova linha na tabela, que pode ser editada.

   • Selecione a linha de Ken Ster no final da tabela (Linha 102) selecionando, por exemplo, seu endereço de e-mail. Na guia Oracle Visual Builder, clique em Alterações de Linha da Tabela e, em seguida, clique em Marcar para Exclusão.

     Depois de fazer essas alterações, sua tabela será semelhante à mostrada na imagem a seguir. Ou seja, uma mensagem Update, Delete ou Create aparece na coluna Alterado para cada linha em que você fez uma alteração.

     

6. Na guia Oracle Visual Builder, clique em Fazer Upload de Alterações.

   Quando for solicitada uma mensagem informando que a tabela tem exclusões pendentes, clique em Sim para confirmar. Após a conclusão do upload, a tabela atualiza a coluna Status para descrever a alteração de cada linha modificada que foi submetida a upload.

   A nova linha criada resulta na criação de um novo registro para John McGahern na coleção.

   As linhas marcadas para exclusão, os registros de John Sieve e Ken Ster, não aparecem mais porque o serviço REST as excluiu de sua coleção.

   

   Observação: Todos os dados são validados antes de serem carregados no serviço REST. Se você encontrar erros, sempre poderá corrigir os erros e fazer upload das alterações novamente. Se você tiver erros parciais, por exemplo, se a atualização e a exclusão de linhas foram bem-sucedidas, mas houve falha na criação de linhas, será necessário corrigir apenas os dados da linha de criação com falha.

   Para verificar se as alterações na pasta de trabalho do Excel foram carregadas com sucesso, vá para a guia Dados da página Objetos de Negócios no seu aplicativo visual.

   

Quer aprender mais?

• Introdução ao Oracle Visual Builder Add-in for Excel em Desenvolvendo Planilhas Integradas Usando o Oracle Visual Builder Add-in for Excel
• Configurar Opções de Pesquisa para Download em Desenvolvendo Planilhas Integradas Usando o Add-in do Oracle Visual Builder Add-in for Excel
• Gerenciando Dados Usando o Oracle Visual Builder Add-in for Excel. Este guia ajuda seus usuários de negócios a obter sucesso usando suas pastas de trabalho integradas.