Interface do NowTableService - Android

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 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.

    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: mapa<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 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 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 Opcional. Configuração que especifica quais campos serão retornados para o registro criado e o que será incluído nos campos.
    Tabela 3. Retornos
    Tipo Descrição
    Chamar<ByteArray> Sucesso: ByteArray que contém o registro criado. Você pode converter essas informações em qualquer modelo de dados necessário.

    Falha: 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
    Chamar<ByteArray> Sucesso: nada é retornado.

    Falha: 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á a próxima página ou a 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 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 7. Retornos
    Tipo Descrição
    Paginador​<ByteArray> 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

    		 

    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?)

    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 serão recuperados e o que será incluído nos campos.
    Tabela 9. Retornos
    Tipo Descrição
    Chamar​<ByteArray> Sucesso: ByteArray que contém o registro recuperado. Você pode converter essas informações em qualquer modelo de dados necessário.

    Falha: 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 sll da tabela especificada.

    Tabela 10. Parâmetros
    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 Opcional. Configuração que especifica quais campos serão recuperados e o que será incluído nos campos.
    Tabela 11. Retornos
    Tipo Descrição
    Chamar​<ByteArray> Sucesso: ByteArray que contém os registros recuperados. Você pode converter essas informações em qualquer modelo de dados necessário.

    Falha: 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: mapa<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 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 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 Opcional. Configuração que especifica quais campos atualizar e o que incluir nos campos.

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

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