Estrutura FieldReadConfiguration - iOS

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • . FieldReadConfiguration a estrutura permite que você configure quais campos buscar de um ServiceNow tabela de instância e em qual formato.

    Tabela 1. Propriedades
    Nome Tipo Descrição
    IncludeFields Matriz Lista de campos a serem retornados nos resultados de retorno.
    opções Matriz Lista dos tipos de campos a serem retornados.
    Valores possíveis:
    • ActualValues: Retorna os valores realmente armazenados em cada um dos campos, incluindo os sys_ids para registros referenciados. Use esta configuração se as datas precisarem ser decodificadas em modelos codificáveis usando Data.
    • Descrição: Retorna a descrição do parâmetro.
    • DisplayValues: Retorna o. valores de exibição , se disponível, para os campos selecionados. Por exemplo, os nomes de usuário normalmente contêm um link de referência (sys_id) para o registro do usuário. Se você solicitar o valor de exibição, o nome da pessoa será retornado em vez do sys_id armazenado no campo associado.
      Nota:
      Valores de exibição retornados por um ServiceNow as instâncias são formatadas e internacionalização com base na configuração do perfil do usuário autenticado. Isso pode ser diferente das configurações de idioma e localidade do dispositivo.
    • ExcludeReferenceLink: Não retorna dados definidos como links de referência na tabela.
    • RawValue: Retorna o valor bruto do parâmetro.

    FieldReadConfiguration init(includeFieldFieldReadConfiguration init: [FieldName]

    Configura os campos em um registro em um ServiceNow Tabela para repassar os resultados de retorno de uma chamada de endpoint REST.

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    IncludeFields Matriz Lista de campos a serem retornados nos resultados de retorno.
    opções Matriz Lista dos tipos de campos a serem retornados.
    Valores possíveis:
    • ActualValues: Retorna os valores realmente armazenados em cada um dos campos, incluindo os sys_ids para registros referenciados. Use esta configuração se as datas precisarem ser decodificadas em modelos codificáveis usando Data.
    • Descrição: Retorna a descrição do parâmetro.
    • DisplayValues: Retorna o. valores de exibição , se disponível, para os campos selecionados. Por exemplo, os nomes de usuário normalmente contêm um link de referência (sys_id) para o registro do usuário. Se você solicitar o valor de exibição, o nome da pessoa será retornado em vez do sys_id armazenado no campo associado.
      Nota:
      Valores de exibição retornados por um ServiceNow as instâncias são formatadas e internacionalização com base na configuração do perfil do usuário autenticado. Isso pode ser diferente das configurações de idioma e localidade do dispositivo.
    • ExcludeReferenceLink: Não retorna dados definidos como links de referência na tabela.
    • RawValue: Retorna o valor bruto do parâmetro.
    Tabela 3. Retornos
    Tipo Descrição
    Nenhum(a)

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

    /// The configuration for what to fetch from the Table API.
    lazy var fetchConfiguration: FetchConfiguration = {
      let includeFields = [
        // Case details
        "number",
        "short_description",
        "priority",
        "state",
        "opened_at",
                
        // Account details
        "account.name",
        "account.number",
        "contact.name",
        "contact.email",
        "contact_type",
    
        // Assignment
        "assignment_group.name",
        "assigned_to.name"
      ]
      let readConfiguration = FieldReadConfiguration(includeFields: includeFields, options: .actualValues)
      let filter = Filter(criteria: [], sortBy: [.desc("opened_at")], queryCategory: nil)
      return FetchConfiguration(filter: filter, limit: 10, readConfiguration: readConfiguration)
    }()