NowTableService-Schnittstelle – Android

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 4 Minuten Lesedauer

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

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

    NowTableService - createRecord(tableName: Zeichenfolge, Felder: Zuordnung<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 Zuordnung<String, String> 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. Beispielsweise sind Felder mit dem Präfix sys_ 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 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 FieldReadConfiguration Optional. Konfiguration, die angibt, welche Felder für den erstellten Datensatz zurückgegeben und was in die Felder aufgenommen werden soll.
    Tabelle : 3. Rückgaben
    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: 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<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, Konfiguration: FetchConfiguration)

    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 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 RufenKonfiguration ab Konfiguration, die die zu verwendenden Filter, die Größenbeschränkung für Paginierungsseiten, die abzurufenden Felder und die Angaben in den Feldern 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 in den zurückgegebenen Datensätzen 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 FieldReadConfiguration Optional. Konfiguration, die angibt, welche Felder abgerufen und was in die Felder aufgenommen werden soll.
    Tabelle : 9. Rückgaben
    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 – Datensätze (tableName: Zeichenfolge, Konfiguration: 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. Rückgaben
    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: Zeichenfolge, tableName: Zeichenfolge, Felder: Zuordnung<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 Zuordnung<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_ 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 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 FieldReadConfiguration Optional. Konfiguration, die angibt, welche Felder aktualisiert werden sollen und was in die Felder aufgenommen werden soll.

    Standard: null
    Tabelle : 13. Rückgaben
    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") }) 
}