Como criar aplicações no código de origem

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 5 min. de leitura

    • Crie e desenvolva aplicações personalizadas no código de origem usando ferramentas e processos de desenvolvimento conhecidos.

    Visão geral

    Você pode criar aplicações com escopo no código usando o ServiceNow IDE no Now Platform ou localmente no Visual Studio Code Desktop com o ServiceNow SDK.

    Em qualquer ambiente de desenvolvimento, você usa ServiceNow Fluent, uma linguagem de programação específica de domínio, para definir os metadados que compõem as aplicações. ServiceNow Fluent inclui APIs para definir os diferentes tipos de metadados.

    Com ServiceNow IDE ou ServiceNow SDK, você também pode criar módulos JavaScript e usar bibliotecas de terceiros em sua aplicação para otimizar a reutilização de código em scripts em uma aplicação com escopo.

    O desenvolvimento e a manutenção de aplicações no código-fonte permitem que você trabalhe em ambientes de desenvolvimento familiares, crie e modifique aplicações complexas, gerencie o código no controle de código-fonte com mais facilidade e detecte erros no momento da compilação.

    Comparação entre ServiceNow IDE e ServiceNow SDK

    Recurso ServiceNow IDE ServiceNow SDK
    Ambiente de desenvolvimento On-line ServiceNow instância Desenvolvimento local e capacidade de trabalhar off-line
    Interface do usuário IDE baseado em Visual Studio Code para a web Visual Studio Code Desktop
    Colaboração Exiba as mudanças de qualquer usuário em tempo real em interfaces de usuário de código ou incorporadas Now Platform.

    Colabore com outros desenvolvedores em aplicações no controle de código-fonte.

    		 Busque e implante mudanças em uma instância usando a CLI ServiceNow SDK para colaborar com outros usuários.

    Colabore com outros desenvolvedores em aplicações no controle de código-fonte.
    Controle de código-fonte Oferece suporte à funcionalidade Git mais comum e à integração com um provedor Git de sua escolha.

    Uma ramificação simultânea por repositório por instância.

    		 Suporte completo
    Conversão da aplicação Oferece suporte somente a aplicações com escopo criadas com ServiceNow IDE ou ServiceNow SDK.

    As aplicações convertidas não são compatíveis com ServiceNow IDE.

    		 Suporte para conversão de aplicações com escopo existentes não criadas com ServiceNow IDE ou ServiceNow SDK.
    ServiceNow Fluent Suporte completo Suporte completo
    Módulos JavaScript e bibliotecas de terceiros Suporte completo Suporte completo

    Estrutura da aplicação

    As aplicações com escopo personalizado criadas com ServiceNow IDE ou ServiceNow SDK incluem arquivos de código de origem e arquivos XML de metadados. Os arquivos package.json e now.config.json definem a estrutura da aplicação, que é semelhante à das aplicações Node.js ou aos pacotes do Node Package Manager (npm).

    Por padrão, as aplicações incluem os seguintes diretórios e arquivos. Você pode modificar determinados aspectos da estrutura da aplicação para atender às suas necessidades no arquivo now.config.json.

    .now
    Diretório que contém informações de cache e métricas para os processos de criação e implantação.
    dist/app
    Diretório que contém os artefatos de compilação para empacotamento. Este diretório só está disponível com o ServiceNow SDK.
    metadados

    Diretório que contém os metadados da aplicação (XML), como esquemas de tabela e regras de negócio, organizados na mesma estrutura de diretórios das aplicações ServiceNow existentes.

    Nota:
    Os metadados da aplicação não devem ser editados a partir dos arquivos XML. Edite os metadados da aplicação no código de origem ou no Now Platform.
    node_modules
    Diretório que contém os módulos Node.js de terceiros dos quais sua aplicação depende.
    origem
    Diretório que contém o código-fonte da sua aplicação, incluindo arquivos de exemplo. Este diretório inclui os seguintes subdiretórios:
    • fluent: diretório que contém os arquivos de código de origem para definir metadados da aplicação (.now.ts). O subdiretório gerado contém os arquivos de aplicações gerados com ServiceNow Fluent.
    • server: diretório que contém o código do módulo JavaScript (.js ou .ts) para uso com scripts do lado do servidor.
    meta
    Diretório que contém um pacote implantável a ser carregado em uma instância. Este diretório só está disponível com o ServiceNow SDK.
    .eslintrc.json
    Arquivo que contém a configuração do ESLint. O ESLint ajuda a identificar e corrigir problemas no código da aplicação.
    .gitignorar
    Arquivo que contém uma lista de diretórios ou arquivos para o Git ignorar. Esses arquivos não são rastreados no controle de código-fonte.
    now.config.json
    Arquivo que contém a configuração da aplicação ServiceNow. O arquivo now.config.json deve estar no diretório base de uma aplicação.
    Você pode configurar a estrutura de diretórios de uma aplicação adicionando os parâmetros a seguir. Por exemplo: 
    {
  "scope": "x_snc_example_app",
  "scopeId": "2f8400eb07426110f736e28f69d3017a",
  "metadataDir": "metadata",
  "appOutputDir": "dist/app",
  "sourceDir": "src",
  "fluentDir": "src/fluent",
  "serverModulesDir": "src/server", 
  "packOutputDir": "target",
  "transpiledSourceDir": "dist/modules",
  "maxInlineScriptLines": 15,
  "ignoreTransformTableList": ["ua_table_licensing_config", "sys_embedded_help_role"]
}
    Tabela 1. Parâmetros now.config.json compatíveis
    Parâmetro Descrição
    metadataDir Diretório que contém os metadados da aplicação como arquivos XML.

    Padrão: metadados
    appOutputDir Diretório para a saída dos artefatos de compilação para empacotamento ao criar a aplicação. Este diretório só está disponível com o ServiceNow SDK.

    Padrão: dist/app
    dirorigem Diretório que contém o código de origem da aplicação.

    Padrão: src
    fluentDir Diretório que contém ServiceNow arquivos Fluent (.now.ts) que definem os metadados da aplicação no código de origem.

    Padrão: src/fluent
    serverMódulosDir Diretório que contém os arquivos JavaScript ou TypeScript a serem incorporados aos módulos JavaScript para uso em scripts do lado do servidor.

    Padrão: src/server
    packOutputDir Diretório para gerar o arquivo zip a ser carregado em uma instância ao criar a aplicação. Este diretório só está disponível com o ServiceNow SDK.

    Padrão: destino
    transpiledSourceDir Diretório que contém arquivos JavaScript transpilados.

    Padrão: o valor do parâmetro sourceDir

    maxInlineScriptLines Número máximo de linhas em um script em linha definido no código de origem usando o marcador de script antes que o script seja movido automaticamente para um arquivo separado. O arquivo de script é referenciado na propriedade de script no código de origem.

    Padrão: 10
    ignoreTransformTableList Tabelas a serem ignoradas ao transformar metadados da aplicação em código de origem.
    pacote-bloqueio.json
    Arquivo atualizado automaticamente que contém informações completas sobre dependências e suas versões. Este arquivo só está disponível com o ServiceNow SDK.
    pacote.json

    Arquivo que contém informações sobre sua aplicação e dependências de módulos personalizados ou de terceiros. O arquivo package.json deve estar no diretório base de uma aplicação.

    Aplicações e recursos relacionados

    APIs JavaScript
    Use as APIs JavaScript em scripts que você grava para mudar a funcionalidade de aplicações ou ao criar aplicações.