NowTableService-Schnittstelle – Android

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 4 Minuten Lesedauer

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

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

    NowTableService – createRecord(tableName: Zeichenfolge, Felder: 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 <String, String> zuordnen Schlüssel-Wert-Paare für alle Felder, die im Datensatz erstellt werden sollen.
    Hinweis:
    Möglicherweise sind nicht alle Felder in einem Datensatz für die Aktualisierung verfügbar. Zum Beispiel Felder mit dem Präfix sys_ Sind normalerweise Systemparameter, die automatisch generiert werden und nicht aktualisiert werden können. Felder, die nicht angegeben und vom System nicht automatisch generiert werden, werden auf den Nullwert des zugehörigen Datentyps festgelegt.
    WriteOptions FieldWriteOptions Optional. Schreiboptionen, die für die Felder 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 FeldleseKonfiguration 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. Rückgaben
    Typ Beschreibung
    Rufen Sie An < ByteArray > 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: Zeichenfolge, tableName: Zeichenfolge)

    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. Rückgaben
    Typ Beschreibung
    Rufen Sie An < ByteArray > 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: Zeichenfolge, Konfiguration: FetchConfiguration)

    Erstellt einen Paginator, der die Iteration von Datensatzseiten 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 eine 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 das, was in die Felder aufgenommen werden soll, angegeben hat.
    Tabelle : 7. Rückgaben
    Typ Beschreibung
    Paginator​< ByteArray > Erfolg: Paginator mit ByteArray-Ausgabe der angeforderten Datensätze. Sie können die Funktionen im Paginator-Objekt 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: Zeichenfolge, tableName: Zeichenfolge, Konfiguration: 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 FeldleseKonfiguration Optional. Konfiguration, die angibt, welche Felder abgerufen werden sollen und was in die Felder aufgenommen werden soll.
    Tabelle : 9. Rückgaben
    Typ Beschreibung
    Rufen Sie An ​< ByteArray > 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: Zeichenfolge, Konfiguration: FieldReadConfiguration?)

    Ruft den SLL-Datensatzdatensatz 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 FeldleseKonfiguration Optional. Konfiguration, die angibt, welche Felder abgerufen werden sollen und was in die Felder aufgenommen werden soll.
    Tabelle : 11. Rückgaben
    Typ Beschreibung
    Rufen Sie An ​< ByteArray > 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: Zeichenfolge, tableName: Zeichenfolge, Felder: 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 <String, String> zuordnen 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. Zum Beispiel Felder mit dem Präfix sys_ Sind normalerweise Systemparameter, die automatisch generiert werden und nicht aktualisiert werden können. Felder, die nicht angegeben und vom System nicht automatisch generiert werden, werden auf den Nullwert des zugehörigen Datentyps festgelegt.
    WriteOptions FieldWriteOptions Optional. Schreiboptionen, die für die Felder 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 FeldleseKonfiguration Optional. Konfiguration, die angibt, welche Felder aktualisiert und welche in die Felder aufgenommen werden sollen.

    Standard: Null
    Tabelle : 13. Rückgaben
    Typ Beschreibung
    Rufen Sie An ​< ByteArray > 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") }) 
}