Estrutura de filtro - iOS

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • . Filtro A estrutura fornece a capacidade de configurar filtros que definem os dados a serem retornados nos resultados de retorno de uma consulta de endpoint REST.

    Init(criteria criteria aList: [Criteria], sortBy: [Sort]? QueryCategory: Cadeia de caracteres? nulo)

    Cria um filtro com base em um ou mais critérios de filtro que estão juntos.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    critérios Matriz Condições de critérios de nível superior para agrupar OU conectores.
    sortBy Cadeia de caracteres Opcional. Ordem de classificação dos resultados retornados.
    Valores possíveis:
    • asc: Crescente
    • desc: Término

    Padrão: asc

    QueryCategory Cadeia de caracteres Opcional. Nome da categoria de consulta.

    Padrão: Nenhum

    Tabela 2. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra a criação de três critérios separados e, quando aprovado, se algum desses critérios for atendido, o registro será retornado nos resultados de retorno.

    // All of criteria1 conditions must be met
    let criteria1 = Criteria(conditions: …)
    
    // OR all of criteria2 conditions must be met
    let criteria2 = Criteria(conditions: …)
    
    // OR all of criteria3 conditions must be met
    let criteria3 = Criteria(conditions: …)
    
    let filter = Filter(criterias: [criteria1, criteria2, criteria3])

    Init(Condições: [QueryProviding], classifica: [Classificar]? nulo)

    Cria um filtro com base em todas as condições especificadas (E juntas)

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    condições QueryProviding Condições para agrupar com um E. conector.
    Valores possíveis:
    • booliano
    • Data/hora
    • e-mail
    • IntegerChoice
    • numérico
    • referência
    • cadeia de caracteres
    • StringChoice
    classificações Cadeia de caracteres Opcional. Ordem de classificação dos resultados retornados.
    Valores possíveis:
    • asc: Crescente
    • desc: Término

    Padrão: asc

    Tabela 4. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo de código a seguir mostra como chamar esta função.

    // Where the record is active
    let condition1 = Condition.boolean(field: "active", .is(true))
    
    // AND the date value of the SLA due field is on "today" or any date after today.
    let condition2 = Condition.dateTime(field: "sla_due", .atOrAfter(0, .daysAgoStart))
    
    let filter = Filter(conditions: [condition1, condition2])

    Init(query: Cadeia de caracteres, queryCategory: Cadeia de caracteres? nulo)

    Cria um filtro usando uma consulta codificada especificada.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    consulta Cadeia de caracteres Consulta codificada Consulta codificada para usar para filtrar os registros a serem retornados da tabela.
    QueryCategory Cadeia de caracteres Opcional. Nome da categoria de consulta a ser usada para a consulta.
    Tabela 6. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo de código a seguir mostra como chamar esta função.

    let query = "active=true^short_descriptionLIKEbroken"
    let filter = Filter(query: query)

    Init(palavras-chave: Cadeia de caracteres? Nil, condições: [Condição], classificBy: [Classificar]? nulo)

    Cria um filtro com base em palavras-chave e condições específicas que são E devem juntas.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    palavras-chave Cadeia de caracteres Opcional. Qualquer palavra ou frase específica a ser pesquisada.

    Padrão: Nil - Nenhuma pesquisa de palavra específica.

    condições Cadeia de caracteres Condições para agrupar com um E. conector.
    Valores possíveis:
    • booliano
    • Data/hora
    • e-mail
    • IntegerChoice
    • numérico
    • referência
    • cadeia de caracteres
    • StringChoice
    sortBy Cadeia de caracteres Opcional. Ordem de classificação dos resultados retornados.
    Valores possíveis:
    • asc: Crescente
    • desc: Término

    Padrão: asc

    Tabela 8. Retornos
    Tipo Descrição
    Nenhum

    // Keyword that must be found in the record
    let searchTerm = "…"
    
    // AND the specified condition must be met
    let condition1 = Condition.email(field: "state", .changesFrom("4"))
    
    let filter = Filter(keywords: searchTerm, condition: condition1)