GlideDBFunctionCaseBuilder - Global

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 7 min. de leitura

    • O GlideDBCaseStatementBuilder permite criar instruções SQL CASE e retornar valores com base em uma série de condições.

    Esta API pode ser usada como parte da definição da API GlideElement - Global ou ao consultar uma tabela. Para criar uma declaração CASE, comece instanciando o objeto GlideDBFunctionCaseBuilder usando seu construtor, GlideDBFunctionCaseBuilder(). Em seguida, defina um ou mais casos usando uma série de chamadas quando () e então () seguidas por uma única chamada de outra forma (). Por fim, chame o método build() para finalizar o construtor e produzir a declaração de caso de função de banco de dados concluída. Esta declaração pode ser usada diretamente ou como parte de outras definições de função do Glide.

    Funções necessárias: Administrador, função_campo_admin.

    GlideDBFunctionCaseBuilder — GlideDBFunctionCaseBuilder()

    Instancia um objeto GlideDBFunctionCaseBuilder.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    Nenhum

    Este exemplo instancia um objeto GlideDBFunctionCaseBuilder.

    var caseBuilder = new GlideDBFunctionCaseBuilder();

    GlideDBFunctionCaseBuilder - compilação ()

    Conclui a lista de condições e cria a declaração CASE final.

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 3. Retorna
    Tipo Descrição
    Cadeia de caracteres A declaração do caso concluída.

    O exemplo a seguir mostra como definir e criar uma declaração de caso simples. Dependendo do valor numérico do campo de impacto, ele produzirá uma das quatro cadeias de caracteres diferentes.

    const caseStatement = new GlideDBFunctionCaseBuilder()
    .whenCompare("impact", "'='", "'1'").then("'CRITICAL'")
    .whenCompare("impact", "'='", "'2'").then("'URGENT'")
    .whenCompare("impact", "'='", "'3'").then("'IMPORTANT'")
    .otherwise("'NOT IMPORTANT'")
    .build();

const gr = new GlideRecord("incident");
gr.addFunction(caseStatement);
gr.setLimit(10);
gr.query();
while(gr.next())  {
    gs.info("impact: {0}  case: {1}",
            [gr.impact, gr.getValue(caseStatement)]);
}

    Saída:

    *** Script: impact: 2  case: URGENT
*** Script: impact: 2  case: URGENT
*** Script: impact: 1  case: CRITICAL
*** Script: impact: 2  case: URGENT
*** Script: impact: 2  case: URGENT
*** Script: impact: 3  case: IMPORTANT
*** Script: impact: 1  case: CRITICAL
*** Script: impact: 1  case: CRITICAL
*** Script: impact: 3  case: IMPORTANT
*** Script: impact: 3  case: IMPORTANT

    GlideDBFunctionCaseBuilder - então (cadeia de caracteres exp)

    Após qualquer método quando (), então () permite que você especifique um valor de saída se a expressão quando () for atendida.

    Tabela 4. Parâmetros
    Nome Tipo Descrição
    exp Cadeia de caracteres Valor de saída. Pode ser uma constante, referência a um campo ou outra função do Glide.
    Tabela 5. Retorna
    Tipo Descrição
    GlideDBFunctionCaseBuilder O objeto do construtor fluente para continuar criando a declaração.

    O exemplo a seguir mostra como definir e criar uma declaração de caso simples. Nesse caso, as expressões de então () mostram como você pode gerar não apenas cadeias de caracteres, mas também os resultados de outras funções do glide, como o comprimento (short_description).

    const caseStatement = new GlideDBCaseFunctionBuilder()
    .whenEqual("impact", "'1'").then("'CRITICAL'") 
    .whenEqual("impact", "'2'").then("category")
    .whenEqual("impact", "'3'").then("length(short_description)")
    .otherwise("'NOT IMPORTANT'")
    .build();

const gr = new GlideRecord("incident");
gr.addFunction(caseStatement);
gr.setLimit(10);
gr.query();
while(gr.next())  {
      gs.info("impact: {0}  case: {1}",
              [gr.impact, gr.getValue(caseStatement)]);
}

    Saída:

    *** Script: impact: 2  case: inquiry
*** Script: impact: 2  case: Hardware
*** Script: impact: 1  case:  CRITICAL
*** Script: impact: 2  case: database
*** Script: impact: 2  case: inquiry
*** Script: impact: 3  case: 28
*** Script: impact: 1  case: CRITICAL
*** Script: impact: 1  case: CRITICAL
*** Script: impact: 3  case: 17
*** Script: impact: 3  case: 29

    GlideDBFunctionCaseBuilder - caso contrário (cadeia de caracteres exp)

    Opcional. Após pelo menos um par de chamadas para quando e então, a chamada de outra forma () permite que você especifique um valor de saída se nenhuma das expressões quando for atendida.

    Tabela 6. Parâmetros
    Nome Tipo Descrição
    exp Cadeia de caracteres Valor de saída. Pode ser uma constante, uma referência a um campo ou outra função do Glide.
    Tabela 7. Retorna
    Tipo Descrição
    GlideDBFunctionCaseBuilder O objeto do construtor fluente para continuar criando a declaração.

    O exemplo a seguir mostra como definir e criar uma declaração de caso simples.

    const caseStatement = new GlideDBCaseFunctionBuilder()
    .whenEqual("impact", "'1'").then("'CRITICAL'") 
    .whenEqual("impact", "'2'").then("category")
    .whenEqual("impact", "'3'").then("length(short_description)")
    .otherwise("'NOT IMPORTANT'")
    .build();

const gr = new GlideRecord("incident");
gr.addFunction(caseStatement);
gr.setLimit(10);
gr.query();
while(gr.next())  {
      gs.info("impact: {0}  case: {1}",
              [gr.impact, gr.getValue(caseStatement)]);
}

    Saída:

    *** Script: impact: 2  case: inquiry
*** Script: impact: 2  case: Hardware
*** Script: impact: 1  case:  CRITICAL
*** Script: impact: 2  case: database
*** Script: impact: 2  case: inquiry
*** Script: impact: 3  case: 28
*** Script: impact: 1  case: CRITICAL
*** Script: impact: 1  case: CRITICAL
*** Script: impact: 3  case: 17
*** Script: impact: 3  case: 29

    GlideDBFunctionCaseBuilder -when(cadeia de caracteres func)

    A mais versátil das expressões "when" compatíveis, o método quando () permite que você forneça qualquer função Glide de valor booliano como a condição a ser atendida.

    Tabela 8. Parâmetros
    Nome Tipo Descrição
    função Cadeia de caracteres Uma função do Glide que resulta em um resultado de valor booliano quando avaliada. Valores possíveis:
    • glidefunction: comparar
    • glidefunction: e
    • glidefunction: ou
    Tabela 9. Retorna
    Tipo Descrição
    glideDBFunctionCaseBuilder O objeto para continuar criando a declaração.

    O exemplo a seguir mostra como definir e criar uma declaração de caso simples. Nesse caso, o método quando () é usado para especificar expressões de comparação mais complexas. Se a expressão for avaliada como verdadeira, a cadeia de caracteres correspondente será retornada.

    const caseStatement = new GlideDBFunctionCaseBuilder() 
    // if impact == 1 AND category == 'Software' then output "CRITICAL SOFTWARE" 
    .when("and(compare(impact, '=', '1'), compare(category, '=',  
'Software')") 
        .then("'CRITICAL SOFTWARE'") 
    // if impact == 1 then output "CRITICAL OTHER" 
    .when("compare(impact, '=', '1')") 
        .then("'CRITICAL OTHER'") 
    // if impact == 2 OR category == 'Software' then output "URGENT" 
    .when("or(compare(impact, '=', '2'), compare(category, '=', 'Software')") 
        .then("'URGENT'") 
    // If none of the above expressions are true, output "NOT IMPORTANT" 
    .otherwise("'NOT IMPORTANT'") 
    .build(); 
 
const gr = new GlideRecord("incident"); 
gr.addFunction(caseStatement); 
gr.setLimit(20); 
gr.query(); 
while(gr.next())  { 
      gs.info("impact: {0}  category: {1}  case: {2}", 
            [gr.impact, gr.category, gr.getValue(caseStatement)]); 
}

    Saída:

    impact: 2  category: inquiry  case: URGENT
impact: 2  category: Hardware  case: URGENT
impact: 1  category: inquiry  case:  CRITICAL OTHER
impact: 2  category: database  case: URGENT
impact: 2  category: inquiry  case: URGENT
impact: 3  category: software  case: URGENT
impact: 1  category: inquiry  case: CRITICAL OTHER
impact: 1  category: inquiry  case: CRITICAL OTHER
impact: 3  category: inquiry  case: NOT IMPORTANT
impact: 3  category: inquiry  case: NOT IMPORTANT
impact: 3  category: hardware  case: NOT IMPORTANT
impact: 3  category: inquiry  case: NOT IMPORTANT
impact: 3  category: hardware  case: NOT IMPORTANT
impact: 3  category: inquiry  case: NOT IMPORTANT
impact: 1  category: inquiry  case: CRITICAL OTHER
impact: 1  category: software  case: CRITICAL SOFTWARE
impact: 3  category: inquiry  case: NOT IMPORTANT
impact: 3  category: inquiry  case: NOT IMPORTANT
impact: 2  category: software  case: URGENT
impact: 1  category: software  case: CRITICAL SOFTWARE

    GlideDBFunctionCaseBuilder -whenCompare(cadeia de caracteres exp1, cadeia de caracteres op, cadeia de caracteres exp2)

    Inicia uma condição de caso de comparação.

    Tabela 10. Parâmetros
    Nome Tipo Descrição
    exp1 Cadeia de caracteres Expressão de comparação à esquerda. Pode ser uma constante, referência a um campo ou outra função do Glide.
    op Cadeia de caracteres Um operador de comparação, entre aspas. Deve ser um de:
    • "'='"
    • "'<'"
    • "'>'"
    • "'<='"
    • "'>='"
    exp2 Cadeia de caracteres Expressão de comparação à direita. Pode ser uma constante, referência a um campo ou outra função do Glide.
    Tabela 11. Retorna
    Tipo Descrição
    GlideDBFunctionCaseBuilder O objeto do construtor de função para continuar criando a declaração.

    O exemplo a seguir mostra como definir e criar uma declaração de caso simples. Nesse caso, o métodowhenCompare() é usado para comparar o valor do campo de impacto com um número e gerar uma cadeia de caracteres especificada se eles corresponderem.

    const caseStatement = new GlideDBFunctionCaseBuilder()
    .whenCompare("impact", "'='", "'1'").then("'CRITICAL'")
    .whenCompare("impact", "'='", "'2'").then("URGENT")
    .whenCompare("impact", "'='", "'3'").then("IMPORTANT")
    .otherwise("'NOT IMPORTANT'")
    .build();

const gr = new GlideRecord("incident");
gr.addFunction(caseStatement);
gr.setLimit(10);
gr.query();
while(gr.next()) {
    gs.info("impact: {0} case: {1}",
            [gr.impact, gr.getValue(caseStatement)]);
}

    Saída:

    *** Script: impact: 2  case: URGENT
*** Script: impact: 2  case: URGENT
*** Script: impact: 1  case: CRITICAL
*** Script: impact: 2  case: URGENT
*** Script: impact: 2  case: URGENT
*** Script: impact: 3  case: IMPORTANT
*** Script: impact: 1  case: CRITICAL
*** Script: impact: 1  case: CRITICAL
*** Script: impact: 3  case: IMPORTANT
*** Script: impact: 3  case: IMPORTANT

    GlideDBFunctionCaseBuilder -whenEqual(cadeia de caracteres exp1, cadeia de caracteres exp2)

    Semelhante a quandoCompare(), quandoEqual() é um método conveniente para verificar a igualdade. É equivalente awhenCompare(leftExpression, '=', RightExpression).

    Tabela 12. Parâmetros
    Nome Tipo Descrição
    exp1 Cadeia de caracteres Expressão de comparação à esquerda. Pode ser uma constante, uma referência a um campo ou outra função do Glide.
    exp2 Cadeia de caracteres Expressão de comparação à direita. Pode ser uma constante, uma referência a um campo ou outra função do Glide.
    Tabela 13. Retorna
    Tipo Descrição
    GlideDBFunctionCaseBuilder O objeto do construtor de função para continuar criando a declaração.

    O exemplo a seguir mostra como definir e criar uma declaração de caso simples. Nesse caso, o método quandoEqual() é usado para comparar o valor do campo de impacto com um número e gerar uma cadeia de caracteres especificada se eles corresponderem.

    const caseStatement = new GlideDBFunctionCaseBuilder()
    .whenEqual("impact", "'1'").then("'CRITICAL'")
    .whenEqual("impact", "'2'").then("'URGENT'")
    .whenEqual("impact", "'3'").then("'IMPORTANT'")
    .otherwise("'NOT IMPORTANT'")
    .build();

const gr = new GlideRecord("incident");
gr.addFunction(caseStatement);
gr.setLimit(10);
gr.query();
while(gr.next())  {
    gs.info("impact: {0}  case: {1}",
            [gr.impact, gr.getValue(caseStatement)]);
}

    Saída:

    *** Script: impact: 2  case: URGENT
*** Script: impact: 2  case: URGENT
*** Script: impact: 1  case: CRITICAL
*** Script: impact: 2  case: URGENT
*** Script: impact: 2  case: URGENT
*** Script: impact: 3  case: IMPORTANT
*** Script: impact: 1  case: CRITICAL
*** Script: impact: 1  case: CRITICAL
*** Script: impact: 3  case: IMPORTANT
*** Script: impact: 3  case: IMPORTANT