Criar um campo de função para executar uma função de banco de dados

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 2 min. de leitura
  • Crie um campo de função que exiba os resultados de uma função de banco de dados, como uma operação matemática, cálculo de tamanho de campo ou cálculo de dia da semana.

    Antes de Iniciar

    Função necessária: administrador

    Você pode selecionar um campo de função de uma tabela física ou criar um campo de função diretamente na exibição do banco de dados.

    Se você criar um campo de função diretamente na exibição do banco de dados, deverá usar os prefixos variáveis da exibição do banco de dados na definição da função para identificar as colunas. Antes de criar o campo de função, anote os prefixos de variáveis na exibição do banco de dados.

    Por exemplo, se o prefixo da variável da tabela Incidentes for inc2 e você quiser retornar o tamanho do campo de descrição, a definição da função será glidefunction:length(inc2_description). Se o prefixo da variável da tabela Instância de métrica for mi e você quiser concatenar os campos Definição e Valor, a definição da função será glidefunction:concat(mi_definition.name,' ',mi_value).

    Procedimento

    1. Navegar até Todos > Definição do Sistema > Dicionário.
    2. Selecione Novo.
    3. Selecione o campo Função.
    4. No formulário, preencha os campos.
      Tabela 1. Formulário Campos de função
      Campo Descrição
      Tabela A exibição da tabela ou do banco de dados à qual o campo de função é adicionado.

      Se você selecionar uma exibição de banco de dados, deverá incluir os prefixos de variável da exibição do banco de dados no campo Definição de função.

      Tipo O tipo de campo: cadeia de caracteres, número, data e assim por diante.
      Rótulo da coluna O rótulo da coluna.
      Nome da coluna O nome da coluna. Este campo é definido automaticamente como o valor do campo Rótulo da coluna.
      Comprimento máximo O comprimento máximo do valor de retorno.
      Campo da função Se selecionado, cria um campo que exibe os resultados de uma função de banco de dados, como uma operação matemática, cálculo de tamanho de campo ou cálculo de dia da semana.

      Depois que o novo registro de função for salvo, você não poderá desmarcar a caixa de seleção para tornar o campo um campo regular.

      Definição de função A função que o campo executa.

      O formato das funções começa com glidefunction:, seguido pela operação a ser realizada (por exemplo, concat), seguido pelos parâmetros da função. As constantes devem ser colocadas entre aspas simples.

      Importante:
      Se você criar o campo de função em uma exibição de banco de dados e não em uma tabela física, deverá incluir os prefixos de variável da exibição de banco de dados no campo Definição de função.
    5. Selecione Enviar.

    Criar um campo Função na exibição do banco de dados de métrica de incidente

    Neste exemplo, um novo campo de Função, CallerDesc, é adicionado à exibição do banco de dados de Métrica de Incidente. O campo concatena o nome do chamador, um hífen e a descrição resumida.

    Campo Função na exibição do banco de dados de métrica de incidente

    O prefixo variável inc está incluído porque o campo da função é definido na exibição do banco de dados de métrica de incidente e não em uma tabela física. O prefixo é necessário para distinguir quais colunas short_description e caller_id usar das tabelas que fazem parte da exibição do banco de dados.

    O que Fazer Depois

    Exibir resultados da função em uma exibição de banco de dados