---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Now TableService-Schnittstelle -- Android

# Now TableService-Schnittstelle -- Android {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 Minuten Lesedauer

Die Now TableService Die Schnittstelle bietet Funktionen, mit denen Sie Datensätze in einer Tabelle auf erstellen, lesen, löschen und aktualisieren können ServiceNowInstanz.
{#NowTableServiceAndroidInterface__table_vx2_klw_5pb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| konfigurieren | [Jetzt Servicekonfiguration](https://servicenow-prod.fluidtopics.net/WAB84mPvDb0Qp4qoJQv2OQ "Die Jetzt Servicekonfiguration Mit der Klasse können Sie konfigurieren ServiceNowInstanz-URL und Paketname für einen Funktionsservice.") | Konfiguration, die dem Service zugeordnet werden soll. |
[Tabelle : 1. Eigenschaften]

{#NowTableServiceAndroidInterface__table_vx2_klw_5pb}

## Now TableService -- createRecord(tableName: Zeichenfolge, Felder: Map\<String, String\>, writeOptions: FieldWriteOptions?, Konfiguration: FieldReadConfiguration?) {#ariaid-title2}

Fügt den angegebenen Datensatz in die angegebene Tabelle ein.
{#NTabServ-createRecord_S_S_S__table_arm_j41_ppb__entry__3}

| 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 zum Aktualisieren verfügbar. 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 | [Feldschreiboptionen](https://servicenow-prod.fluidtopics.net/bLNu2_Bso2avt0FhL7UpTA#FieldWriteOptionsAndroidAPI "Die Feldschreiboptionen Die Klasse bietet Funktionen, die die Optionen zum Aktualisieren oder Erstellen von Feldern in einem Datensatz auf festlegen ServiceNowInstanz.") | Optional. Schreiben Sie Optionen, 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](https://servicenow-prod.fluidtopics.net/H_eLq22KLePEyTnzw4RrDg#FieldReadConfigAndroidAPI "Die FeldleseKonfiguration Die Klasse bietet die Möglichkeit, zu definieren, welche Felder in einem Antwortdatensatz zurückgegeben werden sollen oder nicht.") | Optional. Konfiguration, die angibt, welche Felder für den erstellten Datensatz zurückgegeben werden sollen und was in die Felder aufgenommen werden soll. |
[Tabelle : 2. Parameter]

{#NTabServ-createRecord_S_S_S__table_arm_j41_ppb} {#NTabServ-createRecord_S_S_S__table_brm_j41_ppb__entry__2}

| Typ | Beschreibung |
|-|-|
| [Rufen Sie An](https://servicenow-prod.fluidtopics.net/nprsQaf3Syo9jJ0_truSgA#CallAndroidInterface "Die Rufen Sie An Schnittstelle stellt eine Anforderung dar, die zur Verarbeitung vorbereitet wird.")\< [ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> | Erfolg: ByteArray, das den erstellten Datensatz enthält. Sie können diese Informationen in jedes benötigte Datenmodell konvertieren. Fehler: Now DataError |
[Tabelle : 3. Rückgaben]

{#NTabServ-createRecord_S_S_S__table_brm_j41_ppb}  

    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") }) 
    } 

## Now TableService -- deleteRecord(sysId: Zeichenfolge, tableName: Zeichenfolge) {#ariaid-title3}

Löscht den angegebenen Datensatz in der angegebenen Tabelle.
{#NTabServ-deleteRecord_S_S__table_esw_b1h_ppb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Sys-ID | 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 : 4. Parameter]

{#NTabServ-deleteRecord_S_S__table_esw_b1h_ppb} {#NTabServ-deleteRecord_S_S__table_fsw_b1h_ppb__entry__2}

| Typ | Beschreibung |
|-|-|
| [Rufen Sie An](https://servicenow-prod.fluidtopics.net/nprsQaf3Syo9jJ0_truSgA#CallAndroidInterface "Die Rufen Sie An Schnittstelle stellt eine Anforderung dar, die zur Verarbeitung vorbereitet wird.")\< [ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> | Erfolg: Es wird nichts zurückgegeben. Fehler: Now DataError |
[Tabelle : 5. Rückgaben]

{#NTabServ-deleteRecord_S_S__table_fsw_b1h_ppb}  
<br />

    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) {#ariaid-title4}

Erstellt einen Paginator, der die Iteration von Seiten von Datensätzen in einer Tabelle ermöglicht.
Sie können diesen Paginator verwenden, um durch die zurückgegebenen Datensätze zu navigieren, Navigationsvorgänge auszuführen, z. B. das Abrufen der ersten, letzten, vorherigen oder nächsten Seite, oder überprüfen, ob eine nächste oder vorherige Seite vorhanden ist.
{#NTabServ-paginator_S_O__table_o32_dbh_ppb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| tableName | Zeichenfolge | Name der Tabelle, für die der Paginator erstellt werden soll. |
| konfigurieren | [Konfiguration abrufen](https://servicenow-prod.fluidtopics.net/W9UlAz_n_IiZ~kzi29RdMg#FetchConfigAndroidAPI "Die Konfiguration abrufen Die Klasse bietet die Möglichkeit, die Konfiguration zum Abrufen von Datensätzen aus dem zugeordneten zu definieren ServiceNowTabelle.") | 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 : 6. Parameter]

{#NTabServ-paginator_S_O__table_o32_dbh_ppb} {#NTabServ-paginator_S_O__table_p32_dbh_ppb__entry__2}

| Typ | Beschreibung |
|-|-|
| Paginierer​\< [ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> | Erfolg: Paginator mit ByteArray-Ausgabe der angeforderten Datensätze. Sie können die Funktionen im Paginator-Objekt verwenden, um in den zurückgegebenen Datensätzen zu navigieren. Fehler: Now DataError |
[Tabelle : 7. Rückgaben]

{#NTabServ-paginator_S_O__table_p32_dbh_ppb}  
<br />

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

## Now TableService -- Record(sysId: Zeichenfolge, tableName: Zeichenfolge, Konfiguration: FieldReadConfiguration?) {#ariaid-title5}

Ruft den angegebenen Datensatz aus der angegebenen Tabelle ab.
{#NTabServ-record_S_S_O__table_sdk_wch_ppb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Sys-ID | 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](https://servicenow-prod.fluidtopics.net/H_eLq22KLePEyTnzw4RrDg#FieldReadConfigAndroidAPI "Die FeldleseKonfiguration Die Klasse bietet die Möglichkeit, zu definieren, welche Felder in einem Antwortdatensatz zurückgegeben werden sollen oder nicht.") | Optional. Konfiguration, die angibt, welche Felder abgerufen und welche in die Felder aufgenommen werden sollen. |
[Tabelle : 8. Parameter]

{#NTabServ-record_S_S_O__table_sdk_wch_ppb} {#NTabServ-record_S_S_O__table_tdk_wch_ppb__entry__2}

| Typ | Beschreibung |
|-|-|
| [Rufen Sie An](https://servicenow-prod.fluidtopics.net/nprsQaf3Syo9jJ0_truSgA#CallAndroidInterface "Die Rufen Sie An Schnittstelle stellt eine Anforderung dar, die zur Verarbeitung vorbereitet wird.")​\< [ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> | Erfolg: ByteArray, das den abgerufenen Datensatz enthält. Sie können diese Informationen in jedes benötigte Datenmodell konvertieren. Fehler: Now DataError |
[Tabelle : 9. Rückgaben]

{#NTabServ-record_S_S_O__table_tdk_wch_ppb}  
<br />

    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") }) 
    }

## Now TableService -- Datensätze(tableName: Zeichenfolge, Konfiguration: FieldReadConfiguration?) {#ariaid-title6}

Ruft den SLL-Datensatzdatensatz aus der angegebenen Tabelle ab.
{#NTabServ-records_S_S_O__table_if5_v2h_ppb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| tableName | Zeichenfolge | Name der Tabelle, aus der die Datensätze abgerufen werden sollen, z. B. Incident Oder Asset . |
| konfigurieren | [FeldleseKonfiguration](https://servicenow-prod.fluidtopics.net/H_eLq22KLePEyTnzw4RrDg#FieldReadConfigAndroidAPI "Die FeldleseKonfiguration Die Klasse bietet die Möglichkeit, zu definieren, welche Felder in einem Antwortdatensatz zurückgegeben werden sollen oder nicht.") | Optional. Konfiguration, die angibt, welche Felder abgerufen und welche in die Felder aufgenommen werden sollen. |
[Tabelle : 10. Parameter]

{#NTabServ-records_S_S_O__table_if5_v2h_ppb} {#NTabServ-records_S_S_O__table_jf5_v2h_ppb__entry__2}

| Typ | Beschreibung |
|-|-|
| [Rufen Sie An](https://servicenow-prod.fluidtopics.net/nprsQaf3Syo9jJ0_truSgA#CallAndroidInterface "Die Rufen Sie An Schnittstelle stellt eine Anforderung dar, die zur Verarbeitung vorbereitet wird.")​\< [ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> | Erfolg: ByteArray, das die abgerufenen Datensätze enthält. Sie können diese Informationen in jedes benötigte Datenmodell konvertieren. Fehler: Now DataError |
[Tabelle : 11. Rückgaben]

{#NTabServ-records_S_S_O__table_jf5_v2h_ppb}  
<br />

    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") }) 
    } 

## Now TableService -- updateRecord(sysId: Zeichenfolge, tableName: Zeichenfolge, Felder: Map\<String, String\>, writeOptions: FieldWriteOptions?, Konfiguration: FeldReadConfiguration?) {#ariaid-title7}

Aktualisiert den angegebenen Datensatz in der angegebenen Tabelle mit den angegebenen Feldern.
{#NTabServ-updateRecord_S_S_S_O__table_jtj_nfh_ppb__entry__3}

| 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 zum Aktualisieren verfügbar. 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 | [Feldschreiboptionen](https://servicenow-prod.fluidtopics.net/bLNu2_Bso2avt0FhL7UpTA#FieldWriteOptionsAndroidAPI "Die Feldschreiboptionen Die Klasse bietet Funktionen, die die Optionen zum Aktualisieren oder Erstellen von Feldern in einem Datensatz auf festlegen ServiceNowInstanz.") | Optional. Schreiben Sie Optionen, 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](https://servicenow-prod.fluidtopics.net/H_eLq22KLePEyTnzw4RrDg#FieldReadConfigAndroidAPI "Die FeldleseKonfiguration Die Klasse bietet die Möglichkeit, zu definieren, welche Felder in einem Antwortdatensatz zurückgegeben werden sollen oder nicht.") | Optional. Konfiguration, die angibt, welche Felder aktualisiert und welche in die Felder aufgenommen werden sollen. Standard: Null |
[Tabelle : 12. Parameter]

{#NTabServ-updateRecord_S_S_S_O__table_jtj_nfh_ppb} {#NTabServ-updateRecord_S_S_S_O__table_ktj_nfh_ppb__entry__2}

| Typ | Beschreibung |
|-|-|
| [Rufen Sie An](https://servicenow-prod.fluidtopics.net/nprsQaf3Syo9jJ0_truSgA#CallAndroidInterface "Die Rufen Sie An Schnittstelle stellt eine Anforderung dar, die zur Verarbeitung vorbereitet wird.")​\< [ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> | Erfolg: ByteArray, das den aktualisierten Datensatz enthält. Sie können diese Informationen in jedes benötigte Datenmodell konvertieren. Fehler: Now DataError |
[Tabelle : 13. Rückgaben]

{#NTabServ-updateRecord_S_S_S_O__table_ktj_nfh_ppb}  
<br />

    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") }) 
    }


