Testando novos aplicativos ou rotas no Order Hub

Se você criou um novo aplicativo ou nova rota, use o menu Configurações > Customização para incluir o aplicativo no locatário de customização para teste.

Nota: este tópico é aplicável apenas à versão SaaS do Order Hub .
O procedimento a seguir explica como registrar seu aplicativo ou roteamento.. Se você customizou um módulo existente e desejar ver as mudanças no locatário de customização, consulte Testando customizações do módulo existente no Order Hub.

Antes de iniciar

Certifique-se de que você esteja designado à função Administrador de locatário Para obter mais informações, consulte Incluindo usuários.

Ative a customização para um de seus locatários Para obter mais informações, consulte Ativando o menu de customização para um locatário

Procedimento

  1. No menu de navegação Order Hub , selecione Configurações > Customizações.
    A página Customizações fornece uma representação visual hierárquica dos recursos disponíveis para que seja possível visualizar as novas opções ao incluí-las no menu de navegação..

    Você pode selecionar um recurso na lista Menu para visualizar os detalhes, como o nome do recurso, o caminho e a URL onde ele está implantado.

  2. Clique em Criar para incluir um recurso customizado no menu.
  3. No campo ID do Recurso , insira um identificador exclusivo do recurso.
    • O identificador deve ser exclusivo.
    • O identificador não deve ter nenhum espaço.
    • O campo identificador faz distinção entre maiúsculas e minúsculas. Por exemplo, custom-feature-1 e custom-Feature-1 são considerados como dois IDs diferentes
    • Esse ID é usado no arquivo features.json que você precisa atualizar em seu código de origem ao implementar as customizações.
  4. Na opção Nome do ícone , selecione o ícone a ser exibido no menu ao lado do nome do recurso.
  5. No campo Nome do recurso customizado , insira o texto para exibir no menu.
    Por exemplo, custom-repo..
  6. Em Ativar recurso para, determine quais funções de usuário terão acesso a esse recurso
    • Gerente de Cumprimento -Os usuários que são designados à função de gerente de Cumprimento podem acessar esse recurso customizado
    • Administrador de locatário -Os usuários que são designados à função de administrador de locatário podem acessar esse recurso customizado
  7. Para a opção Ocultar este item de menu :
    • Desmarque essa caixa se você estiver incluindo um novo aplicativo Um novo item de menu aparecerá e quando você clicar no item de menu, seu novo aplicativo será exibido
    • Selecione esta caixa se você tiver criado uma nova rota que seja acessada a partir de uma página existente em um aplicativo existente Para vincular rotas entre aplicativos, a rota deve ser registrada na interface com o usuário. Marcando essa caixa de seleção, você está registrando a rota com a interface com o usuário sem criar um novo item de menu
  8. Em Local de origem., determine de onde você deseja que esse locatário extraia a origem do..
    Tabela 1. Opções de local de origem..
    Opção Descrição
    Modo de desenvolvimento local Selecione esta opção para testar seu aplicativo customizado de seu servidor local. Quando selecionado, o Order Hub se conecta ao seu servidor local, mesmo se Hosted by IBM também estiver selecionado. Essa opção assegura que o aplicativo seja testado localmente antes de ser implementado para que outros usuários possam acessá-lo. Após o aplicativo ser testado e pronto para ser implementado, é possível limpar essa opção.
    Nota: Se você estiver inscrito no IBM Sterling Order Management, no modo de desenvolvimento local, será possível mudar o terminal do sistema Order Management que está configurado para o locatário para qualquer outro terminal. Pode ser necessário mudar o terminal configurado se você tiver outra instalação do OMS na qual as configurações e os dados são configurados especificamente para o desenvolvimento de recurso. Você pode usar o método BucSvcAngularStaticAppInfoFacadeUtil.setLocalDevModeCustomizationTeamOMSUrl() no arquivo app.module.ts para apontar para qualquer URL do sistema de gerenciamento HTTPS.

    Essa substituição é usada apenas para locatários de customização e quando Ambiente de desenvolvimento local é selecionado...

    Caminho Essa opção é aplicável quando Local development mode é selecionado..

    Insira o caminho relativo que será exibido na barra de endereço do navegador quando a página for selecionada Por exemplo, custom-page1..

    URL do modo de desenvolvimento local Essa opção é aplicável quando Local development mode é selecionado..

    Insira o URL do seu servidor angular local. O URL deve usar HTTPS, deve ser válido e deve usar somente um nome de host bucgenerichost.

    O URL do modo de desenvolvimento local nunca é usado nos locatários QA, STAGE ou PROD.

    Por exemplo,
    https://bucgenerichost:9300/custom-repo/custom-page1
    Hospedado pela IBM Por padrão, Hospedado pela IBM é selecionado para todos os novos recursos e é recomendável manter isso inalterado para a maioria das configurações. Esse é o URL usado em seus locatários QA, STAGE ou PROD.
    • Se Hosted by IBM e Modo de desenvolvimento local forem selecionados, o Order Hub se conectará ao seu servidor local.
    • Se você tiver implementado suas customizações e desejar que o Order Hub se conecte ao IBM em vez de seu servidor local, desmarque Modo de desenvolvimento local.
    URL Relativa Essa opção é aplicável quando Hospedado pela IBM é selecionado

    Forneça o caminho relativo para seu aplicativo a partir do valor base-href a partir do package.json. Inicie com uma barra: "/" e uma barra à direita não é necessária

    • No caso de recursos filhos, você deve usar o seguinte padrão para evitar um URL inválido.
      <base-href value>/<relative angular route for the feature in routing module
                file>
    • Esse caminho relativo é convertido no iFrame src correto para o locatário pelo Order Hub.
    • Por exemplo, /custom-repo, /custom-repo/custom-page1
    URL Essa opção é aplicável quando Hospedado por IBM é limpo. Especifique esta opção se estiver hospedando o aplicativo em um servidor externo.
    Forneça o URL completo do recurso. Por exemplo,
    https://www.example.com/custom-feature1
    Nota: para permitir que o Order Hub se conecte ao servidor externo, é necessário fazer upload de um arquivo features.json . Para obter mais informações, consulte Implementando customizações para aplicativos existentes.
  9. Reorganize os aplicativos na lista de navegação, conforme necessário
    Arrastar e Soltar
    É possível arrastar elementos no menu usando o ícone de pegador (::) à esquerda do nome. Você também pode aninhar itens de menu.
    Menu overflow (3 pontos)
    É possível abrir o menu overflow clicando nos 3 pontos verticais (Ícone de Ação) à direita do nome.
    • Mover para cima: mover para cima no menu.
    • Mover para baixo: Mover para baixo no menu.
    • Mover para: Mover para um recurso pai (aninhar como filho).
    • Remover: Mover para fora e configurar como pai.
    • Desapegar tudo: Mover todas as crianças para fora e definir como pais.
    • Excluir: Excluir item de menu.
  10. Clique em Salvar
    É possível criar diversos itens de menu e salvar todos os aplicativos customizados de uma só vez
  11. O valor Feature JSON é gerado com base nas configurações nessa página. Será necessário usar esse valor quando você implementar as customizações. Para obter mais informações, consulte Implementando customizações para aplicativos existentes.
    Nota: se o recurso tiver conteúdo não salvo, o valor não será exibido, pois será gerado somente após as alterações serem salvas.

Resultados

Se você criou um aplicativo, o novo recurso será listado em Lista de menus. O recurso também está agora disponível no menu principal da interface com o usuário do Order Hub . Os usuários que possuem as permissões e funções necessárias agora podem acessar esse menu..
Nota: pode ser necessário atualizar seu navegador para visualizar o item de menu recém-incluído..
  • Para excluir um item de menu, selecione o recurso na Lista de Menus e clique em Excluir Selecionado
  • Para descartar as suas mudanças, clique em Reverter não salvo
Se você criar uma rota, sua rota agora estará disponível nas páginas existentes. Depois de concluir todos os testes, é possível implementar as customizações em seus locatários Para obter mais informações, consulte Implementando novos aplicativos