FieldReadConfiguration-Struktur – iOS

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 2 Minuten Lesedauer
  • Mit der FieldReadConfiguration -Struktur können Sie konfigurieren, welche Felder in welchem Format aus einer Instanztabelle ServiceNow abgerufen werden sollen.

    Tabelle : 1. Eigenschaften
    Name Typ Beschreibung
    IncludeFields Array Liste der Felder, die in den Rückgabeergebnissen zurückgegeben werden sollen.
    Optionen Array Liste der Typen von Feldern, die zurückgegeben werden sollen.
    Mögliche Werte:
    • currentValues: 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 anhand des Datums decodiert werden müssen.
    • Beschreibung: Gibt die Beschreibung des Parameters zurück.
    • displayValues:Gibt die Anzeigewertefür die ausgewählten Felder zurück, falls verfügbar. Beispielsweise enthalten Benutzernamen normalerweise einen Referenzlink (sys_id) zum Benutzerdatensatz. Wenn Sie den Anzeigewert anfordern, wird der Name der Person anstelle der sys_id zurückgegeben, die im zugehörigen Feld gespeichert ist.
      Hinweis:
      Von einer Instanz ServiceNow zurückgegebene Anzeigewerte werden basierend auf der Anwenderprofilkonfiguration des authentifizierten Anwenders formatiert und internationalisiert. Dies kann sich von der Gerätesprache und den Gebietsschemaeinstellungen auf dem Gerät unterscheiden.
    • excludeReferenceLink: Gibt keine Daten zurück, die als Referenzlinks in der Tabelle definiert sind.
    • Rohwert: Gibt den Rohwert des Parameters zurück.

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

    Konfiguriert die Felder in einem Datensatz in einer Tabelle ServiceNow für die Rückgabe der Ergebnisse eines REST-Endpunktaufrufs.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    IncludeFields Array Liste der Felder, die in den Rückgabeergebnissen zurückgegeben werden sollen.
    Optionen Array Liste der Typen von Feldern, die zurückgegeben werden sollen.
    Mögliche Werte:
    • currentValues: 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 anhand des Datums decodiert werden müssen.
    • Beschreibung: Gibt die Beschreibung des Parameters zurück.
    • displayValues:Gibt die Anzeigewertefür die ausgewählten Felder zurück, falls verfügbar. Beispielsweise enthalten Benutzernamen normalerweise einen Referenzlink (sys_id) zum Benutzerdatensatz. Wenn Sie den Anzeigewert anfordern, wird der Name der Person anstelle der sys_id zurückgegeben, die im zugehörigen Feld gespeichert ist.
      Hinweis:
      Von einer Instanz ServiceNow zurückgegebene Anzeigewerte werden basierend auf der Anwenderprofilkonfiguration des authentifizierten Anwenders formatiert und internationalisiert. Dies kann sich von der Gerätesprache und den Gebietsschemaeinstellungen auf dem Gerät unterscheiden.
    • excludeReferenceLink: Gibt keine Daten zurück, die als Referenzlinks in der Tabelle definiert sind.
    • Rohwert: 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)
    }()