NowTableService-Schnittstelle – Android

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 4 Minuten Lesedauer

    • Die NowTableService- Schnittstelle bietet Funktionen, mit denen Sie Datensätze in einer Tabelle in einer ServiceNow -Instanz erstellen, lesen, löschen und aktualisieren können.

    Tabelle : 1. Eigenschaften
    Name Typ Beschreibung
    konfigurieren NowServiceConfiguration Konfiguration, die dem Service zugeordnet werden soll.

    NowTableService – createRecord(tableName: String, fields: Map<String, String> , writeOptions: FieldWriteOptions?, Konfiguration: FieldReadConfiguration?)

    Fügt den angegebenen Datensatz in die angegebene Tabelle ein.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    tableName Zeichenfolge Name der Tabelle, in der der Datensatz gespeichert werden soll.
    Felder Karte<String, String> Schlüssel-Wert-Paare für alle im Datensatz zu erstellenden Felder.
    Hinweis:
    Möglicherweise sind nicht alle Felder in einem Datensatz für die Aktualisierung verfügbar. Beispielsweise sind Felder mit dem Präfix sys_ in der Regel Systemparameter, die automatisch generiert werden und nicht aktualisiert werden können. Felder, die nicht angegeben und nicht automatisch vom System generiert werden, werden auf den Nullwert des zugehörigen Datentyps gesetzt.
    writeOptions FieldWriteOptions Optional. Schreiben Sie Optionen, die in den Feldern festgelegt werden sollen, z. B. ob der Wert als Anzeigewerte gespeichert werden soll oder ob die automatische Generierung von Systemfeldern unterdrückt werden soll.

    Standard: null – Keine Optionen ausgewählt
    konfigurieren FieldReadConfiguration Optional. Konfiguration, die angibt, welche Felder für den erstellten Datensatz zurückgegeben werden sollen und was in die Felder aufgenommen werden soll.
    Tabelle : 3. Ergebnisse
    Typ Beschreibung
    Rufen Sie<ByteArray> auf Erfolg: ByteArray, das den erstellten Datensatz enthält. Sie können diese Informationen in jedes benötigte Datenmodell konvertieren.

    Fehler: NowDataError

    		 
    fun createTableRecord( tableName: String, fields: KeyValues, includeFields: String, 
  readOptions: ReadOptions?, writeOptions: WriteOptions?){ 
 
  val readOptionsArray = readOptions?.asArray() ?: arrayOf() 
  val readConfig = FieldReadConfiguration(includeFields.split(","), *readOptionsArray) 
 
  var body:ByteArray? 
 
  val call = tableService.createRecord(tableName, fields.toMap(), 
    writeOptions?.asFieldWriteOptions(), 
    readConfig) 
  call.enqueue({ body = it.body },{ Log.d("Records", "failed to create record") }) 
}

    NowTableService – deleteRecord(sysId: String, tableName: String)

    Löscht den angegebenen Datensatz in der angegebenen Tabelle.

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    sysId Zeichenfolge Sys_id des zu löschenden Datensatzes.
    tableName Zeichenfolge Name der Tabelle, in der sich der angegebene Datensatz befindet, z. B. Incident oder Asset.
    Tabelle : 5. Ergebnisse
    Typ Beschreibung
    Rufen Sie<ByteArray> auf Erfolg: Es wird nichts zurückgegeben.

    Fehler: NowDataError

    		 

    fun deleteTableRecord( recordSysId: String, tableName: String, callType: CallTestType){ 
  val tableService = serviceProvider.tableService()
  var body:ByteArray? 
  val call = tableService.deleteRecord(recordSysId, tableName) 
  call.enqueue({ body = it.body },{ Log.d("Records", "failed to create record") }) 
}

    NowTableService – paginator(tableName: String, configuration: FetchConfiguration)

    Erstellt einen Paginator, der die Iteration von Seiten mit Datensätzen in einer Tabelle ermöglicht.

    Sie können diesen Paginator verwenden, um durch die zurückgegebenen Datensätze zu navigieren und Navigationsvorgänge auszuführen, z. B. das Abrufen der ersten, letzten, vorherigen oder nächsten Seite oder das Überprüfen, ob die nächste oder vorherige Seite vorhanden ist.

    Tabelle : 6. Parameter
    Name Typ Beschreibung
    tableName Zeichenfolge Name der Tabelle, für die der Paginator erstellt werden soll.
    konfigurieren Konfiguration abrufen Konfiguration, die die zu verwendenden Filter, die Größenbeschränkung der Paginierungsseite, die abzurufenden Felder und die in die Felder einzubeziehenden Elemente angegeben hat.
    Tabelle : 7. Ergebnisse
    Typ Beschreibung
    Paginator​<ByteArray> Erfolg: Paginator mit ByteArray-Ausgabe der angeforderten Datensätze. Sie können die Funktionen innerhalb des Paginator-Objekts verwenden, um durch die zurückgegebenen Datensätze zu navigieren.

    Fehler: NowDataError

    		 

    private fun initTablePaginator() { 
  paginator = service?.paginator(tableName, FetchConfiguration(null, 3)) 
    ?.observe(object: PaginatorCallBack<ByteArray> { 
      override fun onSuccess(response: Response<List<ByteArray>>) { 
      } 
      override fun onFailure(e: NowDataError) { 
        Log.e("NowDataError", "", e) 
      } 
    }) 
}

    NowTableService – record(sysId: String, tableName: String, configuration: FieldReadConfiguration?)

    Ruft den angegebenen Datensatz aus der angegebenen Tabelle ab.

    Tabelle : 8. Parameter
    Name Typ Beschreibung
    sysId Zeichenfolge Sys_id des abzurufenden Datensatzes.
    tableName Zeichenfolge Name der Tabelle, in der sich der angegebene Datensatz befindet, z. B. Incident oder Asset.
    konfigurieren FieldReadConfiguration Optional. Konfiguration, die angibt, welche Felder abgerufen und was in die Felder aufgenommen werden soll.
    Tabelle : 9. Ergebnisse
    Typ Beschreibung
    Rufen Sie​<ByteArray> auf Erfolg: ByteArray, das den abgerufenen Datensatz enthält. Sie können diese Informationen in jedes benötigte Datenmodell konvertieren.

    Fehler: NowDataError

    		 

    fun fetchTableRecord( sysId: String, tableName: String, includeFields: String, 
  readOptions: ReadOptions?){ 
 
  val readOptionsArray = readOptions?.asArray() ?: arrayOf() 
  val readConfig = FieldReadConfiguration(includeFields.split(","), *readOptionsArray) 
 
  var body:ByteArray? 
 
  val call = tableService.record(sysId, tableName, readConfig) 
  call.enqueue({ body = it.body },{ Log.d("Record", "failed fetching record") }) 
}

    NowTableService – records(tableName: String, configuration: FieldReadConfiguration?)

    Ruft SLL-Datensätze aus der angegebenen Tabelle ab.

    Tabelle : 10. Parameter
    Name Typ Beschreibung
    tableName Zeichenfolge Name der Tabelle, aus der die Datensätze abgerufen werden sollen, z. B. Incident oder Asset.
    konfigurieren FieldReadConfiguration Optional. Konfiguration, die angibt, welche Felder abgerufen und was in die Felder aufgenommen werden soll.
    Tabelle : 11. Ergebnisse
    Typ Beschreibung
    Rufen Sie​<ByteArray> auf Erfolg: ByteArray, das die abgerufenen Datensätze enthält. Sie können diese Informationen in jedes benötigte Datenmodell konvertieren.

    Fehler: NowDataError

    		 

    fun fetchTableRecords( tableName: String, filterQuery: String, includeFields: String, 
  readOptions: ReadOptions?, limit: Int?){ 
 
  val readOptionsArray = readOptions?.asArray() ?: arrayOf() 
  val readConfig = FieldReadConfiguration(includeFields.split(","), *readOptionsArray) 
  val config = FetchConfiguration(Filter(filterQuery), limit, readConfig) 
 
  var body:ByteArray? 
 
  val call = tableService.records(tableName, config) 
  call.enqueue({ body = it.body },{ Log.d("Records", "failed fetching records") }) 
}

    NowTableService – updateRecord(sysId: String, tableName: String, fields: Map<String, String> , writeOptions: FieldWriteOptions?, Konfiguration: FieldReadConfiguration?)

    Aktualisiert den angegebenen Datensatz in der angegebenen Tabelle mit den angegebenen Feldern.

    Tabelle : 12. Parameter
    Name Typ Beschreibung
    tableName Zeichenfolge Name der Tabelle, in der der Datensatz aktualisiert werden soll.
    Felder Karte<String, String> Schlüssel-Wert-Paare für alle Felder, die im Datensatz aktualisiert werden sollen.
    Hinweis:
    Möglicherweise sind nicht alle Felder in einem Datensatz für die Aktualisierung verfügbar. Beispielsweise sind Felder mit dem Präfix sys_ in der Regel Systemparameter, die automatisch generiert werden und nicht aktualisiert werden können. Felder, die nicht angegeben und nicht automatisch vom System generiert werden, werden auf den Nullwert des zugehörigen Datentyps gesetzt.
    writeOptions FieldWriteOptions Optional. Schreiben Sie Optionen, die in den Feldern festgelegt werden sollen, z. B. ob der Wert als Anzeigewerte gespeichert werden soll oder ob die automatische Generierung von Systemfeldern unterdrückt werden soll.

    Standard: null – Keine Optionen ausgewählt
    konfigurieren FieldReadConfiguration Optional. Konfiguration, die angibt, welche Felder aktualisiert werden sollen und was in die Felder aufgenommen werden soll.

    Standard: null
    Tabelle : 13. Ergebnisse
    Typ Beschreibung
    Rufen Sie​<ByteArray> auf Erfolg: ByteArray, das den aktualisierten Datensatz enthält. Sie können diese Informationen in jedes benötigte Datenmodell konvertieren.

    Fehler: NowDataError

    		 

    fun updateTableRecord( sysId: String, tableName: String, fields: KeyValues, includeFields: String, 
   readOptions: ReadOptions?, writeOptions: WriteOptions?){ 
 
   val readOptionsArray = readOptions?.asArray() ?: arrayOf() 
   val readConfig = FieldReadConfiguration(includeFields.split(","), *readOptionsArray) 
 
   var body:ByteArray? 
 
   val call = tableService.updateRecord(recordSysId, tableName, fields.toMap(), 
     writeOptions?.asFieldWriteOptions(), 
     readConfig) 
   call.enqueue({ body = it.body },{ Log.d("Records", "failed to update record") }) 
}