Criar uma tabela

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 9 min. de leitura
  • Administradores e desenvolvedores de aplicações podem criar tabelas personalizadas para armazenar dados da aplicação. Depois de criar uma tabela, você também pode modificar os tipos de campo e os rótulos de campo.

    Antes de Iniciar

    Função necessária: administrador

    Certifique-se de verificar seu licenciamento e direitos antes de criar tabelas. Para obter mais informações, consulte Licenciamento.

    Por Que e Quando Desempenhar Esta Tarefa

    Now Platform As assinaturas da aplicação incluem direitos de tabela personalizados. Você pode criar tabelas personalizadas para qualquer finalidade, até o limite de direito na assinatura. Para saber mais sobre como o administrador de uso mapeia as tabelas personalizadas que você cria para assinaturas, consulte Map custom tables to a product subscription in Subscription Management.

    Nota:
    É melhor criar tabelas ao criar aplicações com ferramentas. Para saber mais, consulte Como criar aplicações. Para minimizar a existência de tabelas desnecessárias e estranhas em uma instância, não exagere na criação de tabelas. Crie somente as tabelas necessárias para minimizar as tarefas de administração e reduzir o tempo de atualização. Não estenda a tabela [sys_choice]. Não há suporte para estender a tabela [sys_choice].

    Procedimento

    1. Navegar até Todos > Definição do Sistema > Tabelas.
    2. Selecione Novo e preencha o formulário.
      Controle Descrição
      Rótulo Insira um rótulo exclusivo para a tabela (como Laptops ou Thin Clients). O rótulo aparece nas exibições de lista e de formulário da tabela. Atualizar o campo Rótulo também atualiza o registro de rótulo no arquivo de idioma para o idioma atual. Consulte Rótulos de campo em Tabelas Dicionário de dados.
      Nome
      Edite o nome da tabela, que é preenchido automaticamente com base no rótulo da tabela e em um prefixo da seguinte forma:
      • Para uma tabela em uma aplicação com escopo, o nome é prefixado com um identificador de namespace para indicar que faz parte de uma aplicação.
      • Para uma tabela na aplicação global, o nome é prefixado com a cadeia de caracteres u_.
      • Para uma tabela remota em uma aplicação com escopo, o nome é prefixado com um identificador de namespace e a cadeia de caracteres st_ para indicar que é remoto e faz parte de uma aplicação.
      • Para uma tabela remota na aplicação global, o nome é prefixado com a cadeia de caracteres u_st_.

      Você não pode modificar o prefixo; no entanto, você pode modificar o restante do nome da tabela. O nome pode conter apenas caracteres ASCII alfanuméricos minúsculos e sublinhados (_).

      Tabela de Extensões

      Selecione a tabela a ser estendida. Estender uma tabela base incorpora todos os campos da tabela original e cria campos do sistema para a nova tabela. Se eles estiverem no mesmo escopo ou se puderem ser configurados de outros escopos, você poderá estender tabelas marcadas como extensíveis.

      Esta opção não estará disponível se você marcar a caixa de seleção Tabela programável para designar que esta tabela é programável.

      Aplicação [Somente leitura] Exibe a aplicação associada a esta tabela. Se você estiver trabalhando em uma aplicação ou criando uma tabela a partir de um registro de aplicação, o campo será padronizado para esse aplicativo. Caso contrário, o padrão do campo é Global. Todos os registros criados a partir do registro da tabela, como módulos e regras de segurança, são atribuídos a este aplicativo por padrão.
      Tabela Remota Opção para designar esta tabela como remota. Uma tabela remota é uma tabela à qual você pode associar uma definição de script para recuperação de dados de uma fonte de dados externa. Ao contrário de uma tabela interna padrão, os dados não vêm de registros na instância atual.

      Se você marcar esta caixa de seleção, não poderá acessar a opção Estende tabela porque as tabelas programáveis não podem ser estendidas de outras tabelas.

      Criar módulo

      Marque a caixa de seleção e preencha o campo Adicionar módulo ao menu para criar um módulo de lista no menu da aplicação.

      Esta opção está disponível somente ao criar uma tabela.

      Adicionar módulo ao menu Selecione um menu existente ou selecione Criar novo e insira um novo nome de menu. Esta opção está disponível somente quando a caixa de seleção Criar módulo está marcada.
    3. Na seção Colunas, use a lista integrada Colunas da tabela para adicionar colunas à tabela.
      Coluna Descrição
      Rótulo da coluna

      Defina um rótulo exclusivo para a coluna. O rótulo aparece nos cabeçalhos da lista e nos campos de formulário da coluna. Quando você atualiza o campo Rótulo da coluna, o sistema também atualiza o rótulo no arquivo de idioma para o idioma atual.

      Tipo [Obrigatório] Defina o tipo de campo da coluna. Consulte Administração de campo e Tipos de campo. Para preservar os dados existentes, altere somente os campos entre o mesmo tipo básico (por exemplo, Opção e Cadeia de caracteres). Um aviso será exibido se uma mudança em um campo personalizado resultar em perda de dados. Você não pode mudar um campo do sistema de base, o que resulta em perda de dados.
      Referência

      Transforme o campo em um tipo de campo de referência inserindo o nome da tabela referenciada.

      Nota:
      A criação de referência dinâmica está habilitada para este campo. Portanto, se você inserir um nome de tabela que não corresponda a uma tabela existente, uma tabela será criada ao salvar as mudanças no registro da tabela atual. Se a tabela atual tiver um módulo no navegador de aplicações, um módulo para a tabela recém-criada será criado automaticamente no mesmo menu de aplicação.
      Comprimento máximo

      [Somente campos de cadeia de caracteres] Limite o tamanho do campo. Um comprimento inferior a 254 aparece como um campo de texto de linha única. Qualquer coisa com 255 caracteres ou mais aparece como uma caixa de texto de várias linhas.

      Nota:
      • Você só poderá alterar este valor se o Tipo do campo for Cadeia de caracteres. Mudanças para qualquer outro tipo de campo são ignoradas.
      • Em uma instância Oracle, você não pode aumentar o tamanho máximo de um campo de cadeia de caracteres para mais de 4000 porque isso requer o tipo de dados CLOB no Oracle. Para aumentar além deste tamanho, registre um incidente com o suporte técnico ServiceNow para solicitar a mudança.
      • Para ajudar a evitar a perda de dados, diminua o tamanho de um campo de cadeia de caracteres somente ao desenvolver uma aplicação e não quando um campo contiver dados. Um aviso será exibido se uma mudança em um campo personalizado resultar em perda de dados. Para um campo do sistema de base, você não pode fazer uma mudança que resulte em perda de dados.
      Valor padrão Especifique o valor padrão do campo para qualquer novo registro. Certifique-se de que este valor use o tipo de campo correto. Por exemplo, um campo de número inteiro pode usar um valor padrão de 2, mas não pode usar um valor padrão de dois. Esses valores podem ser substituídos por substituições de dicionário.
      Exibição

      Indique se este campo é o Valores de exibição (aparece em registros que fazem referência a esta tabela).

      Nota:
      Esta opção não controla se este campo é exibido em listas ou formulários.
    4. Na seção Controles, defina opções de tabela adicionais.
      Controle Descrição
      Extensível Marque a caixa de seleção para permitir que outras tabelas estendam esta tabela. Desmarque a caixa de seleção para evitar a criação de tabelas secundárias adicionais; tabelas secundárias existentes permanecem inalteradas.
      Feed de atividades Marque a caixa de seleção para habilitar feeds de registro para a tabela. Esta opção adiciona o ícone Mostrar Live Feed (ícone Mostrar Live Feed) ao cabeçalho do formulário.
      Número automático Marque a caixa de seleção e defina o formato de número para adicionar um campo numerado automaticamente à tabela. A caixa de seleção está disponível somente quando não existe um formato de número para a tabela. Caso contrário, você poderá editar o formato de número existente.
      Criar controles de acesso Marque a caixa de seleção e preencha o campo Função do usuário para criar as regras básicas de segurança para a tabela.
      Função do usuário Insira um novo nome ou selecione uma função de usuário existente que seja necessária para acessar esta tabela. Esta opção está disponível somente quando a caixa de seleção Criar controles de acesso está marcada.
    5. Na seção Acesso à aplicação, defina a proteção de escopo para a tabela.
      Para obter mais informações, consulte Configurações de acesso à aplicação.
      Controle Descrição
      Acessível de
      Especifique quais escopos da aplicação podem acessar a tabela:
      Todos os escopos de aplicação
      Pode ser acessado de qualquer escopo da aplicação.
      Somente este escopo da aplicação
      Pode ser acessado somente a partir do escopo da aplicação atual.
      Permitir leitura Marque a caixa de seleção para habilitar objetos de script de outros escopos da aplicação para ler registros armazenados nesta tabela. Esta opção oferece proteção em tempo de execução. Por exemplo, um script em outra aplicação pode consultar dados nesta tabela. Primeiro, selecione o acesso de leitura para conceder qualquer outra operação de registro de API.
      Permitir criação

      Marque a caixa de seleção para habilitar objetos de script de outros escopos da aplicação para criar registros nesta tabela. Esta opção oferece proteção em tempo de execução. Por exemplo, um script em outra aplicação pode inserir um novo registro nesta tabela. Esta opção está disponível somente quando a caixa de seleção Pode ler está marcada.

      Desmarque a caixa de seleção para ajudar a impedir que objetos de script de outros escopos da aplicação criem registros nesta tabela.

      Permitir atualização

      Marque a caixa de seleção para habilitar objetos de script de outros escopos da aplicação para modificar registros armazenados nesta tabela. Esta opção oferece proteção em tempo de execução. Por exemplo, um script em outra aplicação pode modificar um valor de campo nesta tabela. Esta opção está disponível somente quando a caixa de seleção Pode ler está marcada.

      Desmarque a caixa de seleção para ajudar a impedir que objetos de script de outros escopos da aplicação modifiquem os dados armazenados nesta tabela.

      Permitir exclusão

      Marque a caixa de seleção para habilitar objetos de script de outros escopos da aplicação para excluir registros desta tabela. Esta opção oferece proteção em tempo de execução. Por exemplo, um script em outra aplicação pode remover um registro desta tabela. Esta opção está disponível somente quando a caixa de seleção Pode ler está marcada.

      Desmarque a caixa de seleção para ajudar a impedir que objetos de script de outros escopos da aplicação excluam registros desta tabela.

      Permitir acesso a estas tabelas por meio de serviços web

      Marque a caixa de seleção para permitir que os usuários façam consultas de serviço da Web de entrada nesta tabela. Esta opção oferece proteção em tempo de design e em tempo de execução. O usuário que executa a consulta deve ter as permissões corretas para acessar esta tabela, mesmo quando esta caixa de seleção está marcada.

      Desmarque a caixa de seleção para ajudar a impedir que os usuários façam consultas de serviço Web a esta tabela.

      Permitir configuração

      Marque a caixa de seleção para permitir que aplicações de outros escopos de aplicação criem registros de configuração para esta tabela que mudam sua funcionalidade. Por exemplo, um designer de aplicações pode selecionar esta tabela na lista Tabelas em regras de negócios, scripts de cliente ou ações de IU. Esta opção oferece proteção em tempo de design.

      Desmarque a caixa de seleção para ajudar a impedir que os designers de aplicações selecionem esta tabela ao criar registros de configuração.

    6. Selecione Enviar.

    O que Fazer Depois

    Para mudar os rótulos de campo em sua tabela ou o rótulo da própria tabela, execute a seguinte tarefa:
    1. Navegue até a tabela Rótulo do campo [sys_documentation] e filtre a tabela para mostrar a tabela que tem os campos que você deseja alterar. Para encontrar o rótulo que representa a própria tabela, filtre os registros em que o elemento está vazio.
    2. Abra o registro de campo que você deseja mudar e faça as atualizações. Para obter uma descrição de cada campo, consulte a tabela Rótulo do campo.