Interface NowTableService : Android

L’interface NowTableService fournit des fonctions qui vous permettent de créer, lire, supprimer et mettre à jour des enregistrements au sein d’une table sur une ServiceNow instance.

Tableau 1. Propriétés

Nom	Type	Description
configuration	Configuration Now ServiceConfiguration	Configuration à associer au service.

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

Insère l’enregistrement spécifié dans la table spécifiée.

Tableau 2. Paramètres

Nom	Type	Description
tableName	Chaîne	Nom de la table dans laquelle sauvegarder l’enregistrement.
champs	Map<chaîne, chaîne>	Paires clé-valeur pour tous les champs à créer dans l’enregistrement. Remarque : Tous les champs d’un enregistrement peuvent ne pas être disponibles pour la mise à jour. Par exemple, les champs dont le préfixe est sys_ sont généralement des paramètres système générés automatiquement et qui ne peuvent pas être mis à jour. Les champs qui ne sont pas spécifiés et qui ne sont pas générés automatiquement par le système sont définis sur la valeur null du type de données associé.
options d’écriture	FieldWriteOptions (en anglais seulement)	Facultatif. Options d’écriture à définir sur les champs, comme par exemple si la valeur doit être stockée en tant que valeurs d’affichage ou s’il faut supprimer la génération automatique de champs système. Par défaut : null - Aucune option sélectionnée
configuration	Configuration de lecture de champ	Facultatif. Configuration qui spécifie les champs à renvoyer pour l’enregistrement créé et ce qu’il faut inclure dans les champs.

Tableau 3. Renvoie

Type	Description
Appeler<ByteArray>	Réussite : ByteArray qui contient l’enregistrement créé. Vous pouvez convertir ces informations dans n’importe quel modèle de données dont vous avez besoin. Échec : 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 : chaîne, tableName : chaîne)

Supprime l’enregistrement spécifié dans la table spécifiée.

Tableau 4. Paramètres

Nom	Type	Description
sysId	Chaîne	Sys_id de l’enregistrement à supprimer.
tableName	Chaîne	Nom de la table dans laquelle se trouve l’enregistrement spécifié, comme incident ou actif.

Tableau 5. Renvoie

Type	Description
Appeler<ByteArray>	Réussite : rien n’est retourné. Échec : 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)

Crée un paginateur qui autorise l’itération de pages d’enregistrements au sein d’une table.

Vous pouvez utiliser ce paginateur pour parcourir les enregistrements renvoyés, en effectuant des opérations de navigation telles que l’extraction de la première, de la dernière, de la page précédente ou de la page suivante, ou en vérifiant s’il existe une page suivante ou précédente.

Tableau 6. Paramètres

Nom	Type	Description
tableName	Chaîne	Nom de la table pour laquelle créer le paginateur.
configuration	FetchConfiguration (Récupérer la configuration)	Configuration spécifiant les filtres à utiliser, la limite de taille de page de pagination, les champs à récupérer et les éléments à inclure dans les champs.

Tableau 7. Renvoie

Type	Description
Paginator<ByteArray>	Réussite : paginateur avec sortie ByteArray des enregistrements demandés. Vous pouvez utiliser les fonctions de l’objet Paginator pour parcourir les enregistrements renvoyés. Échec : 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 ?)

Récupère l’enregistrement spécifié à partir de la table spécifiée.

Tableau 8. Paramètres

Nom	Type	Description
sysId	Chaîne	Sys_id de l’enregistrement à récupérer.
tableName	Chaîne	Nom de la table dans laquelle se trouve l’enregistrement spécifié, comme incident ou actif.
configuration	Configuration de lecture de champ	Facultatif. Configuration qui spécifie les champs à récupérer et ce qu’il faut inclure dans les champs.

Tableau 9. Renvoie

Type	Description
Appeler<ByteArray>	Réussite : ByteArray qui contient l’enregistrement récupéré. Vous pouvez convertir ces informations dans n’importe quel modèle de données dont vous avez besoin. Échec : 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 ?)

Récupère l’enregistrement des enregistrements SSL à partir de la table spécifiée.

Tableau 10. Paramètres

Nom	Type	Description
tableName	Chaîne	Nom de la table à partir de laquelle récupérer les enregistrements, comme incident ou actif.
configuration	Configuration de lecture de champ	Facultatif. Configuration qui spécifie les champs à récupérer et ce qu’il faut inclure dans les champs.

Tableau 11. Renvoie

Type	Description
Appeler<ByteArray>	Réussite : ByteArray qui contient les enregistrements récupérés. Vous pouvez convertir ces informations dans n’importe quel modèle de données dont vous avez besoin. Échec : 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 ?, configuration : FieldReadConfiguration ?)

Met à jour l’enregistrement spécifié dans la table spécifiée avec les champs spécifiés.

Tableau 12. Paramètres

Nom	Type	Description
tableName	Chaîne	Nom de la table dans laquelle mettre à jour l’enregistrement.
champs	Map<chaîne, chaîne>	Paires clé-valeur pour tous les champs à mettre à jour dans l’enregistrement. Remarque : Tous les champs d’un enregistrement peuvent ne pas être disponibles pour la mise à jour. Par exemple, les champs dont le préfixe est sys_ sont généralement des paramètres système générés automatiquement et qui ne peuvent pas être mis à jour. Les champs qui ne sont pas spécifiés et qui ne sont pas générés automatiquement par le système sont définis sur la valeur null du type de données associé.
options d’écriture	FieldWriteOptions (en anglais seulement)	Facultatif. Options d’écriture à définir sur les champs, comme par exemple si la valeur doit être stockée en tant que valeurs d’affichage ou s’il faut supprimer la génération automatique de champs système. Par défaut : null - Aucune option sélectionnée
configuration	Configuration de lecture de champ	Facultatif. Configuration qui spécifie les champs à mettre à jour et ce qu’il faut inclure dans les champs. Par défaut : null

Tableau 13. Renvoie

Type	Description
Appeler<ByteArray>	Réussite : ByteArray qui contient l’enregistrement mis à jour. Vous pouvez convertir ces informations dans n’importe quel modèle de données dont vous avez besoin. Échec : 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") }) 
}