Interface NowTableService - Android

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 5 min. de leitura

    • . NowTableService a interface fornece funções que permitem criar, ler, excluir e atualizar registros em uma tabela em um ServiceNow instância.

    Tabela 1. Propriedades
    Nome Tipo Descrição
    configuração NowServiceConfiguration Configuração a ser associada ao serviço.

    NowTableService - createRecord(tablename: Cadeia de caracteres, campos: Map<String, String>, writeOptions: FieldWriteOptions?, configuração: FieldReadConfiguration?)

    Insere o registro especificado na tabela especificada.

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    tableName Cadeia de caracteres Nome da tabela na qual o registro será salvo.
    campos Map<String, String> Pares de chave-valor para todos os campos a serem criados no registro.
    Nota:
    Todos os campos em um registro podem não estar disponíveis para atualização. Por exemplo, campos que têm um prefixo de sys_ normalmente são parâmetros do sistema que são gerados automaticamente e não podem ser atualizados. Os campos que não são especificados e não gerados automaticamente pelo sistema são definidos com o valor nulo do tipo de dados associado.
    WriteOptions CampoWriteOptions Opcional. Opções de gravação a serem definidas nos campos, como se o valor deve ser armazenado como valores de exibição ou se deve suprimir a geração automática de campos do sistema.

    Padrão: Nulo - Nenhuma opção selecionada
    configuração FieldReadConfiguration Opcional. Configuração que especifica quais campos retornar para o registro criado e o que incluir nos campos.
    Tabela 3. Retornos
    Tipo Descrição
    Chamada . ByteArray > ByteArray que contém o registro criado. Você pode converter essas informações em qualquer modelo de dados necessário.

    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: Cadeia de caracteres, tablename: Cadeia de caracteres)

    Exclui o registro especificado na tabela especificada.

    Tabela 4. Parâmetros
    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 5. Retornos
    Tipo Descrição
    Chamada . ByteArray > Êxito: Nada é retornado.

    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: Cadeia de caracteres, configuração: FetchConfiguration)

    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á próxima página ou anterior.

    Tabela 6. Parâmetros
    Nome Tipo Descrição
    tableName Cadeia de caracteres Nome da tabela para a qual o paginador será criado.
    configuração FetchConfiguration Configuração que especificou 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 7. Retornos
    Tipo Descrição
    Paginador ​ByteArray > Paginador com saída ByteArray dos registros solicitados. Você pode usar as funções no objeto Paginator para navegar pelos registros retornados.

    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 - registro(SYSID: Cadeia de caracteres, tablename: Cadeia de caracteres, configuração: FieldReadConfiguration?)

    Recupera o registro especificado da tabela especificada.

    Tabela 8. Parâmetros
    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 Opcional. Configuração que especifica quais campos recuperar e o que incluir nos campos.
    Tabela 9. Retornos
    Tipo Descrição
    Chamada ​. ByteArray > ByteArray que contém o registro recuperado. Você pode converter essas informações em qualquer modelo de dados necessário.

    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 - registros(tablename: Cadeia de caracteres, configuração: FieldReadConfiguration?)

    Recupera o registro de registros sll da tabela especificada.

    Tabela 10. Parâmetros
    Nome Tipo Descrição
    tableName Cadeia de caracteres Nome da tabela da qual recuperar os registros, como incidente ou ativo .
    configuração FieldReadConfiguration Opcional. Configuração que especifica quais campos recuperar e o que incluir nos campos.
    Tabela 11. Retornos
    Tipo Descrição
    Chamada ​. ByteArray > ByteArray que contém os registros recuperados. Você pode converter essas informações em qualquer modelo de dados necessário.

    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: Cadeia de caracteres, tablename: Cadeia de caracteres, campos: Map<String, String>, writeOptions: FieldWriteOptions?, configuração: FieldReadConfiguration?)

    Atualiza o registro especificado na tabela especificada com os campos especificados.

    Tabela 12. Parâmetros
    Nome Tipo Descrição
    tableName Cadeia de caracteres Nome da tabela na qual atualizar o registro.
    campos Map<String, String> Pares de chave-valor para todos os campos a serem atualizados no registro.
    Nota:
    Todos os campos em um registro podem não estar disponíveis para atualização. Por exemplo, campos que têm um prefixo de sys_ normalmente são parâmetros do sistema que são gerados automaticamente e não podem ser atualizados. Os campos que não são especificados e não gerados automaticamente pelo sistema são definidos com o valor nulo do tipo de dados associado.
    WriteOptions CampoWriteOptions Opcional. Opções de gravação a serem definidas nos campos, como se o valor deve ser armazenado como valores de exibição ou se deve suprimir a geração automática de campos do sistema.

    Padrão: Nulo - Nenhuma opção selecionada
    configuração FieldReadConfiguration Opcional. Configuração que especifica quais campos atualizar e o que incluir nos campos.

    Padrão: Nulo
    Tabela 13. Retornos
    Tipo Descrição
    Chamada ​. ByteArray > ByteArray que contém o registro atualizado. Você pode converter essas informações em qualquer modelo de dados necessário.

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