FieldReadConfiguration-Struktur – iOS

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 2 Minuten Lesedauer
  • Mit der FieldReadConfiguration- Struktur können Sie konfigurieren, welche Felder aus einer ServiceNow -Instanztabelle abgerufen werden sollen und in welchem Format.

    Tabelle : 1. Eigenschaften
    Name Typ Beschreibung
    includeFields Array Liste der Felder, die in den Rückgabeergebnissen zurückgegeben werden sollen.
    Optionen Array Liste der zurückzugebenden Feldtypen.
    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.
    • description: Gibt die Beschreibung des Parameters zurück.
    • displayValues: Gibt, falls verfügbar, die Anzeigewertefür die ausgewählten Felder zurück. 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 ServiceNow -Instanz zurückgegebene Anzeigewerte werden basierend auf der Benutzerprofilkonfiguration des authentifizierten Benutzers formatiert und internationalisiert. Dies kann sich von den Sprach- und Gebietsschemaeinstellungen des Geräts unterscheiden.
    • excludeReferenceLink: Gibt keine Daten zurück, die als Referenzlinks innerhalb 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 einer Tabelle ServiceNow, um die Rückgabeergebnisse eines REST-Endpunktaufrufs zurückzugeben.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    includeFields Array Liste der Felder, die in den Rückgabeergebnissen zurückgegeben werden sollen.
    Optionen Array Liste der zurückzugebenden Feldtypen.
    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.
    • description: Gibt die Beschreibung des Parameters zurück.
    • displayValues: Gibt, falls verfügbar, die Anzeigewertefür die ausgewählten Felder zurück. 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 ServiceNow -Instanz zurückgegebene Anzeigewerte werden basierend auf der Benutzerprofilkonfiguration des authentifizierten Benutzers formatiert und internationalisiert. Dies kann sich von den Sprach- und Gebietsschemaeinstellungen des Geräts unterscheiden.
    • excludeReferenceLink: Gibt keine Daten zurück, die als Referenzlinks innerhalb 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)
    }()