---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Interface do NowTableService - Android

# Interface do NowTableService - Android {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 min. de leitura

A interface NowTableService fornece funções que permitem criar, ler, excluir e atualizar registros em uma tabela em uma instância ServiceNow.
{#NowTableServiceAndroidInterface__table_vx2_klw_5pb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| configuração | [NowServiceConfiguration](https://servicenow-prod.fluidtopics.net/jf~9lIjtHwW3MVfVkwHV9w "A classe NowServiceConfiguration permite configurar o URL da instância ServiceNow e o nome do pacote para um serviço do recurso.") | Configuração a ser associada ao serviço. |
[Tabela 1. Propriedades]

{#NowTableServiceAndroidInterface__table_vx2_klw_5pb}

## NowTableService - createRecord(tableName: cadeia de caracteres, campos: mapa\<String, String\> , writeOptions: FieldWriteOptions?, configuração: FieldReadConfiguration?) {#ariaid-title2}

Insere o registro especificado na tabela especificada.
{#NTabServ-createRecord_S_S_S__table_arm_j41_ppb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| tableName | Cadeia de caracteres | Nome da tabela na qual o registro será salvo. |
| campos | Mapa\<String, String\> | Pares de chave-valor para todos os campos a serem criados no registro. Nota: Nem todos os campos em um registro podem estar disponíveis para atualização. Por exemplo, os campos que têm um prefixo `sys_` são normalmente parâmetros do sistema gerados automaticamente e não podem ser atualizados. Os campos que não são especificados e não são gerados automaticamente pelo sistema são definidos com o valor nulo do tipo de dados associado. |
| opções de gravação | [OpçõesDeGravaçãoDeCampo](https://servicenow-prod.fluidtopics.net/OKW739xUFGL118T~Q_rz_Q#FieldWriteOptionsAndroidAPI "A classe FieldWriteOptions fornece funções que definem as opções para atualizar ou criar campos em um registro em uma instância ServiceNow.") | Opcional. Opções de gravação a serem definidas nos campos, por exemplo, se o valor deve ser armazenado como valores de exibição ou se a geração automática de campos do sistema deve ser suprimida. Padrão: nulo - Nenhuma opção selecionada |
| configuração | [FieldReadConfiguration](https://servicenow-prod.fluidtopics.net/kykqQlzkPssdFdH0IKkHaQ#FieldReadConfigAndroidAPI "A classe FieldReadConfiguration fornece a capacidade de definir quais campos serão retornados ou não em um registro de resposta.") | Opcional. Configuração que especifica quais campos serão retornados para o registro criado e o que será incluído nos campos. |
[Tabela 2. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| [Chamar](https://servicenow-prod.fluidtopics.net/3pSuthm1bUG8QcZWbXf62g#CallAndroidInterface "A interface Chamada representa uma solicitação que está preparada para processamento.")\<[ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> | Sucesso: ByteArray que contém o registro criado. Você pode converter essas informações em qualquer modelo de dados necessário. Falha: NowDataError |
[Tabela 3. Retorna]

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

## NowTableService - deleteRecord(sysId: cadeia de caracteres, tableName: cadeia de caracteres) {#ariaid-title3}

Exclui o registro especificado na tabela especificada.
{#NTabServ-deleteRecord_S_S__table_esw_b1h_ppb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| sysId | Cadeia de caracteres | Sys_id do registro a ser excluído. |
| tableName | Cadeia de caracteres | Nome da tabela na qual o registro especificado está localizado, como incidente ou ativo. |
[Tabela 4. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| [Chamar](https://servicenow-prod.fluidtopics.net/3pSuthm1bUG8QcZWbXf62g#CallAndroidInterface "A interface Chamada representa uma solicitação que está preparada para processamento.")\<[ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> | Sucesso: nada é retornado. Falha: NowDataError |
[Tabela 5. Retorna]

{#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: cadeia de caracteres, configuração: FetchConfiguration) {#ariaid-title4}

Cria um paginador que permite a iteração de páginas de registros em uma tabela.
Você pode usar este paginador para navegar pelos registros retornados, executando operações de navegação, como buscar a primeira, última, anterior ou próxima página, ou verificar se há a próxima página ou a anterior.
{#NTabServ-paginator_S_O__table_o32_dbh_ppb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| tableName | Cadeia de caracteres | Nome da tabela para a qual o paginador será criado. |
| configuração | [FetchConfiguration](https://servicenow-prod.fluidtopics.net/YRICOfi_S1RXvdZzRHX7Aw#FetchConfigAndroidAPI "A classe FetchConfiguration fornece a capacidade de definir a configuração para buscar registros da tabelaServiceNow associada.") | Configuração que especifica os filtros a serem usados, o limite de tamanho da página de paginação, quais campos recuperar e o que incluir nos campos. |
[Tabela 6. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Paginador​\<[ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> | Sucesso: paginador com saída ByteArray dos registros solicitados. Você pode usar as funções no objeto Paginator para navegar pelos registros retornados. Falha: NowDataError |
[Tabela 7. Retorna]

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

## NowTableService - record(sysId: String, tableName: String, configuração: FieldReadConfiguration?) {#ariaid-title5}

Recupera o registro especificado da tabela especificada.
{#NTabServ-record_S_S_O__table_sdk_wch_ppb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| sysId | Cadeia de caracteres | Sys_id do registro a ser recuperado. |
| tableName | Cadeia de caracteres | Nome da tabela na qual o registro especificado está localizado, como incidente ou ativo. |
| configuração | [FieldReadConfiguration](https://servicenow-prod.fluidtopics.net/kykqQlzkPssdFdH0IKkHaQ#FieldReadConfigAndroidAPI "A classe FieldReadConfiguration fornece a capacidade de definir quais campos serão retornados ou não em um registro de resposta.") | Opcional. Configuração que especifica quais campos serão recuperados e o que será incluído nos campos. |
[Tabela 8. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| [Chamar](https://servicenow-prod.fluidtopics.net/3pSuthm1bUG8QcZWbXf62g#CallAndroidInterface "A interface Chamada representa uma solicitação que está preparada para processamento.")​\<[ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> | Sucesso: ByteArray que contém o registro recuperado. Você pode converter essas informações em qualquer modelo de dados necessário. Falha: NowDataError |
[Tabela 9. Retorna]

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

## NowTableService - registros (tableName: cadeia de caracteres, configuração: FieldReadConfiguration?) {#ariaid-title6}

Recupera o registro de sll da tabela especificada.
{#NTabServ-records_S_S_O__table_if5_v2h_ppb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| tableName | Cadeia de caracteres | Nome da tabela da qual os registros serão recuperados, como incidente ou ativo. |
| configuração | [FieldReadConfiguration](https://servicenow-prod.fluidtopics.net/kykqQlzkPssdFdH0IKkHaQ#FieldReadConfigAndroidAPI "A classe FieldReadConfiguration fornece a capacidade de definir quais campos serão retornados ou não em um registro de resposta.") | Opcional. Configuração que especifica quais campos serão recuperados e o que será incluído nos campos. |
[Tabela 10. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| [Chamar](https://servicenow-prod.fluidtopics.net/3pSuthm1bUG8QcZWbXf62g#CallAndroidInterface "A interface Chamada representa uma solicitação que está preparada para processamento.")​\<[ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> | Sucesso: ByteArray que contém os registros recuperados. Você pode converter essas informações em qualquer modelo de dados necessário. Falha: NowDataError |
[Tabela 11. Retorna]

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

## NowTableService - updateRecord(sysId: cadeia de caracteres, tableName: cadeia de caracteres, campos: mapa\<String, String\> , writeOptions: FieldWriteOptions?, configuração: FieldReadConfiguration?) {#ariaid-title7}

Atualiza o registro especificado na tabela especificada com os campos especificados.
{#NTabServ-updateRecord_S_S_S_O__table_jtj_nfh_ppb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| tableName | Cadeia de caracteres | Nome da tabela na qual o registro será atualizado. |
| campos | Mapa\<String, String\> | Pares de chave-valor para todos os campos a serem atualizados no registro. Nota: Nem todos os campos em um registro podem estar disponíveis para atualização. Por exemplo, os campos que têm um prefixo `sys_` são normalmente parâmetros do sistema gerados automaticamente e não podem ser atualizados. Os campos que não são especificados e não são gerados automaticamente pelo sistema são definidos com o valor nulo do tipo de dados associado. |
| opções de gravação | [OpçõesDeGravaçãoDeCampo](https://servicenow-prod.fluidtopics.net/OKW739xUFGL118T~Q_rz_Q#FieldWriteOptionsAndroidAPI "A classe FieldWriteOptions fornece funções que definem as opções para atualizar ou criar campos em um registro em uma instância ServiceNow.") | Opcional. Opções de gravação a serem definidas nos campos, por exemplo, se o valor deve ser armazenado como valores de exibição ou se a geração automática de campos do sistema deve ser suprimida. Padrão: nulo - Nenhuma opção selecionada |
| configuração | [FieldReadConfiguration](https://servicenow-prod.fluidtopics.net/kykqQlzkPssdFdH0IKkHaQ#FieldReadConfigAndroidAPI "A classe FieldReadConfiguration fornece a capacidade de definir quais campos serão retornados ou não em um registro de resposta.") | Opcional. Configuração que especifica quais campos atualizar e o que incluir nos campos. Padrão: nulo |
[Tabela 12. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| [Chamar](https://servicenow-prod.fluidtopics.net/3pSuthm1bUG8QcZWbXf62g#CallAndroidInterface "A interface Chamada representa uma solicitação que está preparada para processamento.")​\<[ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> | Sucesso: ByteArray que contém o registro atualizado. Você pode converter essas informações em qualquer modelo de dados necessário. Falha: NowDataError |
[Tabela 13. Retorna]

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