Tutorial parte 3: Definir uma tabela em ServiceNow Fluentcódigo

Crie uma tabela e referencie-a em definições de script de amostra usando ServiceNow FluentAPIs.

Antes de Iniciar

Concluído Parte 2 do tutorial: Inicialize um repositório para sua aplicação.

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

ServiceNow FluentÉ uma linguagem específica do domínio (DSL) baseada no typescript para definir os arquivos de metadados [sys_metadata] que compõem as aplicações e inclui APIs para os diferentes tipos de metadados, como tabelas, funções, ACLs, regras de negócios, e. Automated Test Frameworktestes. Você usa objetos no ServiceNow FluentAPIs para definir metadados em arquivos com .now.ts extensão. . IDE da ServiceNowtem processamento e validação de linguagem para ServiceNow FluentAPIs e aplicações por padrão. Para obter mais informações sobre ServiceNow Fluent, consulte ServiceNow Fluent.

Neste exemplo, você cria uma tabela simples para uma lista de tarefas pendentes usando objetos no ServiceNow FluentAPI de tabela. Em seguida, atualize o código de amostra para a regra de negócio e as definições de script do cliente para fazer referência à nova tabela. Por fim, revise suas mudanças no Explorador de metadados. Para obter mais informações sobre a API Tabela, consulte API de tabela - ServiceNow Fluent.

Procedimento

1. Na Barra de atividades, selecione a exibição do Explorador de arquivos ( ).
2. Navegue até src/fluente em sua aplicação.
3. Abra o. index.now.ts arquivo de amostra.
   Dica:

   Você pode escrever ServiceNow Fluentcódigo em um único arquivo ou em tantos .now.ts arquivos como você deseja e organiza arquivos em diretórios dentro do fluente diretório.
4. Em uma nova linha no final do arquivo, insira Tabela Para adicionar o objeto Tabela.
5. Na barra de status, selecione o ícone de diagnóstico ( ) Para abrir o painel Problemas e verificar se há problemas no código.

   

6. Clique com o botão direito do mouse no erro exibido e selecione Em ServiceNow/sdk/core" correção rápida.

   

   Na linha 2, o. Tabela o objeto foi adicionado à lista de importações de servicenow/sdk/core :

   import { BusinessRule, ClientScript, Table } from '@servicenow/sdk/core'

   Dica:

   Depois de corrigir esse problema, você pode fechar o painel Problemas enquanto prossegue com as etapas a seguir. Em uma etapa posterior, você retornará a ela se houver algum problema.
7. Em Tabela objeto, adicione as seguintes propriedades.
   • Nome: O nome da tabela deve começar com o escopo da aplicação e usar todas as letras minúsculas no seguinte formato: <scope>_<name> . Você pode encontrar o escopo em now.config.json arquivo da aplicação.
   • Rótulo: O rótulo deve ser exclusivo e aparecer para a tabela nas exibições de lista e formulário.
   • Extensões: O nome de outra tabela na qual a tabela se baseia.

   Table({
       name: 'x_snc_hello_world_to_do', //ensure that the name begins with the correct scope (<scope>_<name>)
       label: 'To-do Items',
       extends: 'task',
   })

   Dica:

   Passe o mouse sobre um objeto para ver sua documentação no produto.

   

8. Para suporte de autodigitação ao definir colunas na tabela, antes de Tabela objeto, adicione uma variável exportada com o mesmo nome que nome propriedade.

   export const x_snc_hello_world_to_do = Table({
       name: 'x_snc_hello_world_to_do',
       label: 'To-do Items',
       extends: 'task',
   })

9. Em Tabela objeto, adicione o. esquema propriedade para definir colunas na tabela.

   export const x_snc_hello_world_to_do = Table({
       name: 'x_snc_hello_world_to_do',
       label: 'To-do Items',
       extends: 'task',
       schema: {
           //define columns here
       }
   })

   A propriedade do esquema é uma matriz de Coluna objetos. Há muitos tipos de colunas com base no tipo de campo. Os objetos de coluna usam o formato <Type>Coluna onde <Type> é o tipo de campo.

   Use os detalhes a seguir para definir três colunas na tabela: Prazo, Matriz e Tarefa. Consulte Objeto de colunadocumentação para ajudar você a configurar cada coluna.

   Nome da coluna	Detalhes
   prazo	Rótulo: Prazo Tipo: Data/hora
   matriz	Rótulo: Matriz Tipo: cadeia de caracteres Opções: Rótulo: Urgente e importante Rótulo: Importante, mas não urgente Rótulo: Urgente, mas não importante Rótulo: Nem urgente nem importante
   tarefa	Rótulo: Tarefa Tipo: cadeia de caracteres Comprimento máximo: 120

   Com esses detalhes, o. esquema a propriedade deve ser semelhante a este exemplo. As chaves que você usa para as escolhas podem ser qualquer cadeia de caracteres.

   export const x_snc_hello_world_to_do = Table({
       name: 'x_snc_hello_world_to_do',
       label: 'To-do Items',
       extends: 'task',
       schema: {
           deadline: DateColumn({ label: 'Deadline' }),
           matrix: StringColumn({
               label: 'Matrix',
               choices: {
                   do: { label: 'Urgent and Important' },
                   decide: { label: 'Important but Not Urgent' },
                   delegate: { label: 'Urgent but Not Important' },
                   delete: { label: 'Neither Urgent nor Important' },
               },
           }),
           task: StringColumn({ label: 'Task', maxLength: 120 }),
       },
   })

10. Na linha 2, adicione importações para Coluna de data e. Coluna de String objetos.

    import { BusinessRule, ClientScript, Table, DateColumn, StringColumn } from '@servicenow/sdk/core'

11. Atualize a regra de negócio existente e as definições de script de cliente para fazer referência à tabela que você criou.
    1. Em ClientScript objeto, altere o valor de tabela propriedade para o nome da tabela ( x_snc_hello_world_to_do ).
    2. Repita a etapa anterior para BusinessRule objeto.
12. Se o ícone de diagnóstico ( ) Mostra todos os erros ou avisos, selecione-o para abrir o painel Problemas e revisar as mensagens de diagnóstico e as correções rápidas para resolvê-los.
13. Salve suas mudanças usando um dos atalhos de teclado a seguir.
    • Windows: Ctrl-S.
    • MAC: Cmd-S.

    Nota:

    Se você tiver mudanças não salvas em um arquivo, um ícone de ponto aparecerá na guia de arquivos.
14. Na Barra de status, selecione Criar e instalar .

    . instalação concluído com sucesso, o atualizado ServiceNow FluentO código-fonte é compilado em arquivos de aplicação [sys_metadata] na instância.

15. Revise suas mudanças como metadados.
    1. Na Barra de atividades, selecione a exibição do Explorador de metadados ( ).
    2. Selecione sua aplicação para expandi-la.
    3. Navegar até Dados > Tabela e selecione Itens pendentes .
       A tabela é aberta em Construtor de tabelas.

       

16. Opcional: Edite os metadados e sincronize suas mudanças no código-fonte.
    No Explorador de metadados, você pode simular outro usuário editando os metadados fora do código-fonte para ver as mudanças transformadas de volta no código adicionado.
    1. Em Construtor de tabelas, Pesquise o campo Tarefa e mude o rótulo da coluna de "Tarefa" para "Tarefa pendente".
    2. Selecione Save (Salvar).
    3. Na Barra de atividades, selecione a exibição do Now SDK ( ).
    4. Selecione Sincronize mudanças .

       

       Em index.now.ts arquivo, você deve ver rótulo a propriedade da coluna de tarefa foi alterada para "Tarefa pendente" .

       task: StringColumn({ label: 'To Do', maxLength: 120 }),

Resultado

Você criou seus primeiros metadados de aplicação usando ServiceNow FluentAPIs. A tabela de itens pendentes [x_snc_hello_world_to_do] pode ser modificada no código-fonte por outro IDE da ServiceNowou de outro ServiceNow AI Platforminterfaces do usuário.

Em ServiceNow AI Platform, você pode navegar até a exibição de lista da tabela inserindo x_snc_hello_world_to_do.list no filtro de navegação. Porque você atualizou a definição de script do cliente para executar na tabela de itens de tarefa pendente [x_snc_hello_world_to_do], se você selecionar Novo para adicionar um registro à tabela, a mensagem do script do cliente aparece quando o registro é carregado.

O que Fazer Depois

Continuar para Parte 4 do tutorial: Instalar e usar uma biblioteca de terceiros.