Se você estiver desenvolvendo um aplicativo visual usando uma instância do VB Studio que esteja no mesmo domínio de identidades da sua instância do Visual Builder, poderá começar rapidamente baseando seu projeto no modelo de projeto do Visual Application.

1. Acesse o VB Studio. Consulte Acessar o VB Studio na Home Page do Oracle Cloud.
2. Na página Organização, clique em + Criar.
3. Na página Detalhes do Projeto do assistente Novo Projeto, informe um nome e uma descrição exclusivos para o projeto.
4. Em Segurança, selecione a privacidade do projeto:
   1. Selecione Privado para restringir o acesso somente aos membros do projeto.

      Marque a caixa de seleção Descobrível para permitir que os membros da organização que não são administradores da organização ou membros do projeto vejam informações básicas, como nome e informações de contato do proprietário, sobre seu projeto privado. Projetos privados que não são detectáveis não serão expostos a não-membros.

   2. Selecione Compartilhado para disponibilizar o código do projeto, os documentos wiki, as tarefas e os builds para qualquer pessoa da organização.
5. Em Idioma Preferencial, especifique o idioma das notificações por e-mail que os usuários do projeto receberão.
   Você pode alterar o idioma no qual a interface do usuário aparece nas preferências do usuário.
6. Clique em Próximo.
7. Na página Modelo de Projeto, selecione o modelo de projeto Aplicativo Visual e clique em Próximo.
8. Na página Propriedades de Projeto:
   1. Em Nome do Repositório Git, altere o nome padrão do repositório Git, se necessário.
   2. Em Região e Compartimento, selecione a região e o compartimento do OCI em que sua instância do Visual Builder está.
   3. Em Instância do VB de Desenvolvimento, se ainda não estiver selecionado, selecione a instância de desenvolvimento do Visual Builder.
      Se você não vir a instância do Visual Builder necessária, volte e revise suas seleções para a região e o compartimento do OCI.
   4. Em Modelo de Aplicativo Visual, selecione um modelo de aplicativo visual disponível na instância de desenvolvimento selecionada.
      Por padrão, o VB Studio usa o modelo Aplicativo VB Padrão. Para selecionar outro modelo, clique em Alterar Modelo, selecione o modelo e clique em Usar Selecionado.
   5. (Opcional) Em Nome do Espaço de Trabalho, se necessário, altere o nome do espaço de trabalho privado. Por padrão, ele é Workspace1.

      Um espaço de trabalho contém todos os artefatos necessários para desenvolver aplicativos visuais, incluindo um clone do repositório Git deste projeto - e a ramificação - que contém os arquivos de origem. Para saber mais sobre espaços de trabalho, consulte O que É um Espaço de Trabalho e Por Que Preciso de Um?

   6. (Opcional) Em Nome da Ramificação de Trabalho, se necessário, altere o nome da ramificação de trabalho do espaço de trabalho. Por padrão, ele é branch1.
      Quando o projeto é provisionado, a ramificação main do repositório Git contém os arquivos do aplicativo. Ao criar o espaço de trabalho, o VB Studio cria uma cópia da ramificação main, renomeia-a com seu nome especificado e a usa como ramificação de trabalho do espaço de trabalho.
   7. Clique em Próximo.
9. Na página Equipe:
   1. Clique em Adicionar Membros e selecione na lista exibida os usuários ou grupos a serem adicionados ao projeto.
   2. Selecione a associação (Proprietário do Projeto, Acesso Total do Desenvolvedor, Acesso Limitado do Desenvolvedor ou Colaborador) que os membros que você está adicionando terão no projeto.
      Consulte O Que São Associações de Projeto? para obter mais informações sobre cada associação.
   3. Clique em Adicionar.
   4. Repita as subetapas a, b e c para diferentes usuários e grupos com vários tipos de associação, se necessário.
10. Clique em Finalizar.

O job de implantação implanta o artefato de build do aplicativo visual na instância de desenvolvimento do Visual Builder. No job, especifique a versão e o perfil do aplicativo e as credenciais necessárias para conectar e implantar o artefato de build à sua instância de desenvolvimento do Visual Builder.

1. No navegador esquerdo, clique em Builds .
2. Na guia Jobs, clique no job de implantação.
3. Clique em Configurar.
4. Clique em Configurar .
5. Clique na tab Etapas.
6. Na seção Autorização, especifique o tipo de autorização para executar esta etapa de criação. Com a opção Usar OAuth selecionada por padrão, você verá a mensagem Authorization is required, indicando que essa etapa de build precisa de uma autorização única para tratar solicitações OAuth para a instância do Visual Builder do seu ambiente. Clique em Autorizar e informe credenciais para acessar sua instância do Visual Builder; você também pode executar o job manualmente e informar as credenciais quando solicitado.

   De qualquer forma, é recomendável autorizar sua conexão OAuth durante a configuração inicial. Se você ignorar esta etapa, não poderá publicar suas alterações no Designer e precisará concluir a autorização necessária antes de tentar implantar as alterações.

   Uma vez autorizada, a mensagem Authorization has been provided é exibida.

   Observação
   
   OAuth é o tipo de autorização recomendado. Use a autenticação Básica somente se tiver problemas ao configurar uma conexão OAuth. Para usar a autenticação Básica, selecione Usar Básico e informe as credenciais de um usuário que pode acessar a instância do Visual Builder em Nome do Usuário e Senha.

   Os tokens OAuth (acesso e atualização) são reiniciados durante o uso regular. Um token de atualização é usado para obter um token de acesso sempre que um usuário acessa a instância de destino. Esse token de atualização geralmente é válido por sete dias. (O tempo de expiração do token é definido no aplicativo de recursos do IDCS e pode ser diferente com base em seus requisitos de segurança.) Se o usuário se autenticar com a instância de destino dentro do período de sete dias, o token de atualização ativo gerará um novo token de acesso e um novo token de atualização. Esse ciclo continua indefinidamente, desde que o token de atualização permaneça válido. Se o token de atualização expirar durante longos períodos de inatividade (por exemplo, quando você estiver de férias), clique em Renovar Autorização (ou execute o job manualmente, para que você seja solicitado a autorizar quaisquer tokens OAuth expirados).

7. (Opcional) Para substituir a versão padrão do aplicativo, especifique a nova versão em Versão do Aplicativo. Deixe-o vazio para usar a versão definida no arquivo visual-application.json do aplicativo.
   Não desmarque a caixa de seleção Incluir a versão do aplicativo no URL.
8. (Opcional) Em Perfil do Aplicativo, especifique o perfil do aplicativo de desenvolvimento. Deixe-o vazio para usar o perfil padrão do aplicativo.

   Seu aplicativo visual acessa dados de diferentes servidores para serviços REST e pode precisar de configurações de segurança diferentes para diferentes ambientes, como desenvolvimento e produção. Usando perfis de aplicativo, você pode definir diferentes combinações de servidores e configurações de segurança para cada um dos seus ambientes e usá-los ao implantar o aplicativo em um ambiente. Isso simplifica o gerenciamento do aplicativo visual à medida que você avança do desenvolvimento para a produção. Para saber mais, consulte Sobre Perfis de Aplicativo.

9. (Opcional) Para usar o banco de dados do aplicativo existente, em Gerenciamento de Dados, selecione Manter dados do ambiente existente.

   Para usar um banco de dados limpo para a aplicação, em Gerenciamento de Dados, selecione Usar banco de dados limpo.

10. Clique em Salvar.

O pipeline de build de desenvolvimento é executado automaticamente quando um commit é enviado para a ramificação do repositório Git especificada no job de empacotamento.

1. No navegador esquerdo, clique em Builds .
2. Clique na guia Pipelines.
3. Na linha do pipeline de desenvolvimento, clique no menu Ações e selecione Executar Pipeline.

Após a execução bem-sucedida do job de implantação, você poderá exibir os aplicativos implantados na guia Implantações da página Ambientes.

1. No navegador esquerdo, clique em Ambientes .
2. Selecione o ambiente do Visual Builder.
3. Clique na guia Disponibilizações.
4. Se não estiver ativado, clique no botão de alternância Aplicativos Visuais.
5. Se a instância do Visual Builder for de outro domínio de identidades, forneça suas credenciais de acesso.
6. Expanda o nome do aplicativo para ver o link do aplicativo implantado.
   A guia Implantações exibe os aplicativos que você implantou do projeto atual. Ele não mostra aplicativos implantados por outros usuários do projeto ou aplicativos implantados de outros projetos. Veja um exemplo:

   
   

   
   Descrição da ilustração visualapp_deployment.png