FieldReadConfiguration-Struktur – iOS

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 2 Minuten Lesedauer
  • Die FeldleseKonfiguration Mit der Struktur können Sie konfigurieren, welche Felder aus einem abgerufen werden sollen ServiceNow Instanztabelle und in welchem Format.

    Tabelle : 1. Eigenschaften
    Name Typ Beschreibung
    Include-Felder Array Liste der Felder, die in den Rückgabeergebnissen zurückgegeben werden sollen.
    Optionen Array Liste der zurückzugebenden Feldtypen.
    Mögliche Werte:
    • ActualValues: Gibt die tatsächlich in jedem der Felder gespeicherten Werte zurück, einschließlich der sys_IDs für referenzierte Datensätze. Verwenden Sie diese Einstellung, wenn Datumsangaben in codierbaren Modellen mit Datum decodiert werden müssen.
    • Beschreibung: Gibt die Beschreibung des Parameters zurück.
    • DisplayValues: Gibt zurück Anzeigewerte , Falls verfügbar, für die ausgewählten Felder. Beispielsweise enthalten Anwendernamen normalerweise einen Referenzlink (sys_ID) zum Anwenderdatensatz. Wenn Sie den Anzeigewert anfordern, wird der Name der Person anstelle der sys_ID zurückgegeben, die im zugehörigen Feld gespeichert ist.
      Hinweis:
      Anzeigewerte, die von zurückgegeben werden ServiceNow Instanzen werden basierend auf der Anwenderprofilkonfiguration des authentifizierten Anwenders formatiert und internationalisiert. Dies kann sich von den Einstellungen für Gerätesprache und Gebietsschema auf dem Gerät unterscheiden.
    • ExcludeReferenceLink: Gibt keine Daten zurück, die als Referenzlinks in der Tabelle definiert sind.
    • RawValue: Gibt den Rohwert des Parameters zurück.

    FieldReadConfiguration init(includeFields: [Fieldname] = [], Optionen: Optionen = [])

    Konfiguriert die Felder in einem Datensatz in einem ServiceNow Tabelle, die in den Rückgabeergebnissen eines REST-Endpunktaufrufs zurückgegeben werden soll.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    Include-Felder Array Liste der Felder, die in den Rückgabeergebnissen zurückgegeben werden sollen.
    Optionen Array Liste der zurückzugebenden Feldtypen.
    Mögliche Werte:
    • ActualValues: Gibt die tatsächlich in jedem der Felder gespeicherten Werte zurück, einschließlich der sys_IDs für referenzierte Datensätze. Verwenden Sie diese Einstellung, wenn Datumsangaben in codierbaren Modellen mit Datum decodiert werden müssen.
    • Beschreibung: Gibt die Beschreibung des Parameters zurück.
    • DisplayValues: Gibt zurück Anzeigewerte , Falls verfügbar, für die ausgewählten Felder. Beispielsweise enthalten Anwendernamen normalerweise einen Referenzlink (sys_ID) zum Anwenderdatensatz. Wenn Sie den Anzeigewert anfordern, wird der Name der Person anstelle der sys_ID zurückgegeben, die im zugehörigen Feld gespeichert ist.
      Hinweis:
      Anzeigewerte, die von zurückgegeben werden ServiceNow Instanzen werden basierend auf der Anwenderprofilkonfiguration des authentifizierten Anwenders formatiert und internationalisiert. Dies kann sich von den Einstellungen für Gerätesprache und Gebietsschema auf dem Gerät unterscheiden.
    • ExcludeReferenceLink: Gibt keine Daten zurück, die als Referenzlinks in der Tabelle definiert sind.
    • RawValue: Gibt den Rohwert des Parameters zurück.
    Tabelle : 3. Ausgabe
    Typ Beschreibung
    Keine

    Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

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