Interface NowTableService : Android

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 5 minutes de lecture

    • 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é.
    writeOptions (options d’écriture) Options d’écriture du champ Facultatif. Écrivez les options à définir sur les champs, telles que 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.

    Valeur 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
    Call<ByteArray> Réussite : ByteArray qui contient l’enregistrement créé. Vous pouvez convertir ces informations en 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 ouactif.
    Tableau 5. Renvoie
    Type Description
    Call<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 dans 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 page, la dernière, la page précédente ou 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 qui spécifiait 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 ouactif.
    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
    Call&lt;ByteArray> Réussite : ByteArray qui contient l’enregistrement récupéré. Vous pouvez convertir ces informations en 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 SLL à 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, tels que l’incident ou l’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
    Call&lt;ByteArray> Réussite : ByteArray qui contient les enregistrements récupérés. Vous pouvez convertir ces informations en 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&lt;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&lt;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é.
    writeOptions (options d’écriture) Options d’écriture du champ Facultatif. Écrivez les options à définir sur les champs, telles que 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.

    Valeur 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.

    Valeur par défaut : null
    Tableau 13. Renvoie
    Type Description
    Call&lt;ByteArray> Réussite : ByteArray qui contient l’enregistrement mis à jour. Vous pouvez convertir ces informations en 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") }) 
}