Converter uma aplicação com o ServiceNow IDE

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 2 min. de leitura
  • Converta uma aplicação com escopo existente para oferecer suporte ao desenvolvimento no código de origem com o ServiceNow IDE.

    Antes de Iniciar

    Crie um espaço para suas aplicações. Para obter mais informações, consulte Criar um espaço no ServiceNow IDE.

    Função necessária: sn_glider.ide_fluent_admin e admin

    Por Que e Quando Desempenhar Esta Tarefa

    As aplicações com escopo existentes que não foram criadas com ServiceNow IDE ou ServiceNow SDK devem ser convertidas para oferecer suporte ao desenvolvimento no código de origem. A conversão de uma aplicação adiciona os arquivos e diretórios necessários para usar o ServiceNow IDE. Você pode escolher se deseja converter metadados de aplicações existentes em código ServiceNow Fluent.

    Procedimento

    1. Navegar até Tudo > Desenvolvimento de apps > IDE da ServiceNow.
    2. Abra um espaço.
    3. Use um dos seguintes atalhos de teclado para abrir a paleta de comandos:
      • Windows: Ctrl-Shift-P
      • Mac: Cmd-Shift-P
    4. Inserir Fluente: converta um app com escopo para Fluente e pressione Enter.
    5. Selecione uma aplicação com escopo na lista.

      As aplicações que não foram convertidas são listadas como Código pronto: Falso.

      A aplicação com escopo é adicionada ao seu espaço com a estrutura de aplicação padrão, mas os metadados da aplicação não são convertidos em código ServiceNow Fluent. Para obter informações sobre a estrutura da aplicação, consulte a seção Estrutura da aplicação do tópico Criando aplicações no código de origem.
    6. Opcional: Para converter metadados existentes em código ServiceNow Fluent, conclua as etapas a seguir.
      1. Na Barra de atividades, selecione a exibição do Explorador de arquivos ( Explorador de arquivos).
      2. Clique com o botão direito do mouse no diretório de metadados da aplicação e selecione Converter diretório em Fluente.
        Opção de menu para converter o diretório de metadados para o código ServiceNow Fluent.
      Os metadados da aplicação são definidos em código ServiceNow Fluent no diretório fluent/generated e removidos do diretório de metadados e de seus subdiretórios.

      Uma aplicação com metadados convertidos em código ServiceNow Fluent.

      Nota:
      Um número limitado de tipos de metadados, como snapshots de metadados [sys_metadata_link] e ativos de UX [sys_ux_lib_asset], não pode ser representado como código ServiceNow Fluent e não é convertido.
    7. Opcional: Crie e implante sua aplicação para compilar o código de origem nos metadados da aplicação e disponibilizar suas mudanças em toda a instância. Para obter mais informações, consulte Criar uma aplicação no ServiceNow IDE.

    Resultado

    A aplicação convertida é adicionada ao seu espaço com os arquivos e diretórios necessários para oferecer suporte ao desenvolvimento no código de origem. Depois de criar e implantar uma aplicação convertida, o campo Package JSON do registro da aplicação personalizada [sys_app] contém o caminho para o arquivo package.json da aplicação.

    Nota:
    Se você tiver problemas após converter uma aplicação, poderá executar o comando Synchrotron: Redefinir aplicação para remover arquivos de origem na aplicação (não metadados da aplicação) e converter novamente a aplicação.

    O que Fazer Depois

    No seu provedor Git, crie um repositório Git dedicado para a aplicação. Inicialize um repositório Git local para sua aplicação e envie-o por push para o repositório remoto. Para obter mais informações, consulte Inicializar um repositório Git com o ServiceNow IDE.

    No ServiceNow IDE, comece a desenvolver sua aplicação em código de origem com ServiceNow Fluent, escrevendo módulos JavaScript personalizados ou adicionando bibliotecas de terceiros.