Documentação do Oracle Cloud Infrastructure

Criar uma Extensão Simples

A maneira mais fácil de configurar o VB Studio para que outras pessoas possam configurar páginas do Oracle Cloud Applications é criar você mesmo uma extensão simples. Isso permite que você garanta que tudo esteja funcionando corretamente.

Antes de começar, decida como deseja configurar os projetos para sua equipe:
  • Em geral, é mais fácil usar um único projeto do VB Studio para todo o seu trabalho de extensão, com um repositório Git diferente para cada pilar (como HCM, SCM etc.). O uso de um único projeto mantém tudo unido em um só lugar, limita o número de permissões que cada usuário exige e geralmente faz sentido se sua equipe estiver do lado menor. É assim que o VB Studio faz as coisas por padrão, portanto, se isso funcionar para sua equipe, você pode ir direto para a etapa 1 e começar.
  • Se, por outro lado, você tiver usuários que precisam ser isolados do trabalho um do outro, digamos, diferentes organizações de consultoria que fazem o trabalho de implementação para diferentes pilares ou um maior equipe que usa uma família comum de ambientes do Oracle Cloud Application para desenvolver, testar e hospedar extensões de vários pilares. Você pode optar por separar seu trabalho criando um projeto para cada pilar. Se essa direção fizer mais sentido para você, vá para a página Organização no VB Studio e comece a criar projetos, usando Criar um Projeto para orientá-lo. Quando terminar, prossiga para a etapa 1 abaixo.
  1. Navegue até uma página no seu Aplicativo Oracle Cloud.
  2. Clique no seu nome de usuário no canto superior direito para abrir o menu Definições e Ações e selecione Editar Página no Visual Builder Studio:
    A seguir, descrição de fa-edit-page-link.png
    Descrição da ilustração fa-edit-page-link.png

  3. Na caixa de diálogo Projeto de Extensão de Novo Aplicativo, informe um nome exclusivo para o projeto, bem como alguns membros da equipe ou grupos que você acha que podem usar esse projeto para estender esse Aplicativo Oracle Cloud:
    A seguir, descrição de newappextproj.png
    Descrição da ilustração newappextproj.png

    Observação

    Depois de concluir este procedimento, certifique-se de que os membros da equipe adicionados tenham as atribuições adequadas, seguindo as etapas em Configurar Usuários do VB Studio.

    O VB Studio mostra uma caixa de diálogo de status para que você possa acompanhar a criação de cada ativo:
    A seguir, descrição de projprogress.png
    Descrição da ilustração projprogress.png

    Se estiver curioso sobre esses ativos, você poderá saber mais sobre eles em Quais Artefatos de Projeto São Criados?.

    Por padrão, o VB Studio cria um projeto privado que é descobrível, o que significa que os usuários que você não adicionou explicitamente ao projeto poderão escolher o projeto quando clicarem em Editar Página no Visual Builder Studio no Aplicativo Oracle Cloud associado. Lembre-se de que é melhor manter todo o trabalho de um determinado Aplicativo Oracle Cloud dentro do mesmo projeto, portanto, o VB Studio colocará um selo "Recomendado" ao lado do nome do projeto para incentivar os usuários a selecioná-lo.

    Observação

    O nome do espaço de trabalho padrão gerado quando você passa para o VB Studio geralmente usa o pilar da página que você está tentando estender, no formato Workspace PILLAR, por exemplo, Workspace HCM. Se esse nome já existir, um número será adicionado ao nome e incrementado conforme necessário, por exemplo, Workspace HCM 1, Workspace HCM 2 e assim por diante.
  4. O VB Studio abre a página que você acabou de visualizar no Designer. Quando você passa o mouse sobre um componente extensível na tela, ele é descrito em azul, como este:
    A seguir, descrição de extendableareasingreen.png
    Descrição da ilustração extendableareasingreen.png

  5. Faça uma pequena alteração na página, apenas para fins de teste. Você pode arrastar um componente Cabeçalho para a página, por exemplo, ou adicionar ou remover um campo em um formulário dinâmico. O VB Studio salva implicitamente suas alterações à medida que você trabalha.
  6. No cabeçalho do Designer, clique em Publicar:
    A seguir, descrição do botão publicar-header.png
    Descrição da ilustração publish-button-header.png

  7. Como isso é apenas um teste, aceite os padrões na caixa de diálogo Publicar e clique em Publicar.
    Por padrão, as origens da sua extensão são mescladas à ramificação padrão (main) do repositório Git do espaço de trabalho e, em seguida, criadas e implantadas imediatamente na instância do Oracle Cloud Applications dentro do seu ambiente DEV.
    Observação

    Se preferir, você poderá alterar o padrão e, em vez disso, implantar suas alterações por meio de um pipeline de integração e entrega contínuas (CI/CD). Os pipelines de CI/CD oferecem a opção de implantar uma extensão em vários ambientes, bem como automatizar algumas operações de ciclo de vida. Para obter mais informações, consulte Usar Pipelines CI/CD para Implantação.
  8. Agora clique no link na caixa de diálogo Publicar para ver suas alterações publicadas:
    Descrição da publish-pipelinedisabled.png a seguir
    Descrição da ilustração publish-pipelinedisabled.png

    Observação

    Certifique-se de copiar e colar o URL da implantação na área de transferência antes de clicar em Fechar. Você não terá acesso ao URL depois que a caixa de diálogo Publicar for fechada.