Structure de FieldReadConfiguration : iOS

La structure FieldReadConfiguration vous permet de configurer les champs à extraire d’une ServiceNow table d’instance et leur format.

Tableau 1. Propriétés

Nom	Type	Description
includeFields	Tableau	Liste des champs à renvoyer dans les résultats de retour.
options	Tableau	Liste des types de champs à renvoyer. Valeurs possibles : actualValues : renvoie les valeurs réellement stockées dans chacun des champs, y compris les sys_ids pour les enregistrements référencés. Utilisez ce paramètre si les dates doivent être décodées dans des modèles codables à l’aide de Date. description : renvoie la description du paramètre. displayValues : renvoie les valeurs d’affichage, le cas échéant, des champs sélectionnés. Par exemple, les noms d’utilisateur contiennent généralement un lien de référence (sys_id) vers l’enregistrement utilisateur. Si vous demandez la valeur d’affichage, le nom de la personne est renvoyé à la place de l’sys_id stockée dans le champ associé. Remarque : Les valeurs d’affichage renvoyées par une ServiceNow instance sont formatées et internationalisées en fonction de la configuration du profil d’utilisateur de l’utilisateur authentifié. Cela peut différer des paramètres de langue et de paramètres régionaux de l’appareil. excludeReferenceLink : ne renvoie aucune donnée définie comme liens de référence dans la table. rawValue : renvoie la valeur brute du paramètre.

FieldReadConfiguration - init(includeFields : [FieldName] = [], options : Options = [])

Configure les champs dans un enregistrement d’une ServiceNow table à renvoyer dans les résultats de retour d’un appel de point de terminaison REST.

Tableau 2. Paramètres

Nom	Type	Description
includeFields	Tableau	Liste des champs à renvoyer dans les résultats de retour.
options	Tableau	Liste des types de champs à renvoyer. Valeurs possibles : actualValues : renvoie les valeurs réellement stockées dans chacun des champs, y compris les sys_ids pour les enregistrements référencés. Utilisez ce paramètre si les dates doivent être décodées dans des modèles codables à l’aide de Date. description : renvoie la description du paramètre. displayValues : renvoie les valeurs d’affichage, le cas échéant, des champs sélectionnés. Par exemple, les noms d’utilisateur contiennent généralement un lien de référence (sys_id) vers l’enregistrement utilisateur. Si vous demandez la valeur d’affichage, le nom de la personne est renvoyé à la place de l’sys_id stockée dans le champ associé. Remarque : Les valeurs d’affichage renvoyées par une ServiceNow instance sont formatées et internationalisées en fonction de la configuration du profil d’utilisateur de l’utilisateur authentifié. Cela peut différer des paramètres de langue et de paramètres régionaux de l’appareil. excludeReferenceLink : ne renvoie aucune donnée définie comme liens de référence dans la table. rawValue : renvoie la valeur brute du paramètre.

Tableau 3. Renvoie

Type	Description
Néant

L’exemple de code suivant montre comment appeler cette fonction.

/// 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)
}()