---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# NowTableService 인터페이스 - Android

# NowTableService 인터페이스 - Android {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 9분

NowTableService 인터페이스는 인스턴스의 ServiceNow 테이블 내에서 기록을 생성, 읽기, 삭제 및 업데이트할 수 있는 기능을 제공합니다.  
{#NowTableServiceAndroidInterface__table_vx2_klw_5pb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 구성 | [NowService구성](https://servicenow-prod.fluidtopics.net/NtuWyYK4RVRmN~CPbUxQYw "NowServiceConfiguration 클래스를 사용하면 기능 서비스의 인스턴스 URL 및 패키지 이름을 구성할 ServiceNow 수 있습니다.") | 서비스와 연결할 구성입니다. |
[표 1. 속성]

{#NowTableServiceAndroidInterface__table_vx2_klw_5pb}

## NowTableService - createRecord(tableName: String, fields: Map\<String, String\>, writeOptions: FieldWriteOptions?, configuration: FieldReadConfiguration?) {#ariaid-title2}

지정된 테이블에 지정된 기록을 삽입합니다.
{#NTabServ-createRecord_S_S_S__table_arm_j41_ppb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| tableName | 문자열 | 기록을 저장할 테이블의 이름입니다. |
| 필드 | 맵\<문자열, 문자열\> | 기록에서 생성할 모든 필드에 대한 키-값 쌍입니다. 주: 기록 내의 모든 필드를 업데이트하지 못할 수 있습니다. 예를 들어 프리픽스가 `sys_` 인 필드는 일반적으로 자동으로 생성되며 업데이트할 수 없는 시스템 매개변수입니다. 지정되지 않았으며 시스템에서 자동 생성되지 않은 필드는 연결된 데이터 유형의 null 값으로 설정됩니다. |
| 쓰기 옵션 | [필드 쓰기 옵션](https://servicenow-prod.fluidtopics.net/EKQJvI1f_~1rafsdmhZTFw#FieldWriteOptionsAndroidAPI "FieldWriteOptions 클래스는 인스턴스의 ServiceNow 기록에 있는 필드를 업데이트하거나 작성하기 위한 옵션을 설정하는 기능을 제공합니다.") | 옵션입니다. 값을 표시 값으로 저장할지 또는 시스템 필드의 자동 생성을 억제할지 여부 등 필드에 설정할 옵션을 작성합니다. 기본값: null - 선택한 옵션이 없음 |
| 구성 | [필드읽기 구성](https://servicenow-prod.fluidtopics.net/bbYVLKwX5HMtKALDaXrvEQ#FieldReadConfigAndroidAPI "FieldReadConfiguration 클래스는 응답 기록에서 반환하거나 반환하지 않을 필드를 정의하는 기능을 제공합니다.") | 옵션입니다. 생성된 기록에 대해 반환할 필드와 필드에 포함할 항목을 지정하는 구성입니다. |
[표 2. 매개변수]

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

| 유형 | 설명 |
|-|-|
| [호출](https://servicenow-prod.fluidtopics.net/BN_RUz24goZYtkdnEIbMCQ#CallAndroidInterface "호출 인터페이스는 처리를 위해 준비된 요청을 나타냅니다.")\<[ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> | 성공: 생성된 기록을 포함하는 ByteArray입니다. 이 정보를 필요한 데이터 모델로 변환할 수 있습니다. 실패: NowDataError |
[표 3. 반환]

{#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: String, tableName: String) {#ariaid-title3}

지정된 테이블에서 지정된 기록을 삭제합니다.
{#NTabServ-deleteRecord_S_S__table_esw_b1h_ppb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| sysId | 문자열 | 삭제할 기록의 Sys_id입니다. |
| tableName | 문자열 | 지정된 기록이 있는 테이블의 이름입니다( 예: 인시던트 또는 자산). |
[표 4. 매개변수]

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

| 유형 | 설명 |
|-|-|
| [호출](https://servicenow-prod.fluidtopics.net/BN_RUz24goZYtkdnEIbMCQ#CallAndroidInterface "호출 인터페이스는 처리를 위해 준비된 요청을 나타냅니다.")\<[ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> | 성공: 아무 것도 반환되지 않습니다. 실패: NowDataError |
[표 5. 반환]

{#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: String, configuration: FetchConfiguration) {#ariaid-title4}

테이블 내에서 기록 페이지의 반복을 허용하는 페이지 매김기를 생성합니다.
이 페이지 매김기를 사용하여 반환된 기록을 탐색하고 처음, 마지막, 이전 또는 다음 페이지를 가져오거나 다음 또는 이전 페이지가 있는지 확인하는 등의 탐색 작업을 수행할 수 있습니다.
{#NTabServ-paginator_S_O__table_o32_dbh_ppb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| tableName | 문자열 | 페이지 매김자를 생성할 테이블의 이름입니다. |
| 구성 | [구성 가져오기](https://servicenow-prod.fluidtopics.net/820mwX6ji0BCMsf~cfw5eg#FetchConfigAndroidAPI "FetchConfiguration 클래스는 연결된ServiceNow 테이블에서 기록을 가져오기 위한 구성을 정의하는 기능을 제공합니다.") | 사용할 필터, 페이지 매김 페이지 크기 제한, 검색할 필드 및 필드에 포함할 항목을 지정한 구성입니다. |
[표 6. 매개변수]

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

| 유형 | 설명 |
|-|-|
| Paginator\<[ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)입니다\> | 성공: 요청된 기록의 ByteArray 출력이 있는 페이지 매김기. Paginator 객체 내의 함수를 사용하여 반환된 기록을 탐색할 수 있습니다. 실패: NowDataError |
[표 7. 반환]

{#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, configuration: FieldReadConfiguration?) {#ariaid-title5}

지정된 테이블에서 지정된 기록을 조회합니다.
{#NTabServ-record_S_S_O__table_sdk_wch_ppb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| sysId | 문자열 | 검색할 기록의 Sys_id입니다. |
| tableName | 문자열 | 지정된 기록이 있는 테이블의 이름입니다( 예: 인시던트 또는 자산). |
| 구성 | [필드읽기 구성](https://servicenow-prod.fluidtopics.net/bbYVLKwX5HMtKALDaXrvEQ#FieldReadConfigAndroidAPI "FieldReadConfiguration 클래스는 응답 기록에서 반환하거나 반환하지 않을 필드를 정의하는 기능을 제공합니다.") | 옵션입니다. 검색할 필드와 필드에 포함할 항목을 지정하는 구성입니다. |
[표 8. 매개변수]

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

| 유형 | 설명 |
|-|-|
| [호출](https://servicenow-prod.fluidtopics.net/BN_RUz24goZYtkdnEIbMCQ#CallAndroidInterface "호출 인터페이스는 처리를 위해 준비된 요청을 나타냅니다.")\<[ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> | 성공: 검색된 기록을 포함하는 ByteArray입니다. 이 정보를 필요한 데이터 모델로 변환할 수 있습니다. 실패: NowDataError |
[표 9. 반환]

{#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 - records(tableName: String, configuration: FieldReadConfiguration?) {#ariaid-title6}

지정된 테이블에서 SLL 기록 기록을 검색합니다.
{#NTabServ-records_S_S_O__table_if5_v2h_ppb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| tableName | 문자열 | 인시 던 트나 자산과 같은 기록을 검색할 테이블의 이름입니다. |
| 구성 | [필드읽기 구성](https://servicenow-prod.fluidtopics.net/bbYVLKwX5HMtKALDaXrvEQ#FieldReadConfigAndroidAPI "FieldReadConfiguration 클래스는 응답 기록에서 반환하거나 반환하지 않을 필드를 정의하는 기능을 제공합니다.") | 옵션입니다. 검색할 필드와 필드에 포함할 항목을 지정하는 구성입니다. |
[표 10. 매개변수]

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

| 유형 | 설명 |
|-|-|
| [호출](https://servicenow-prod.fluidtopics.net/BN_RUz24goZYtkdnEIbMCQ#CallAndroidInterface "호출 인터페이스는 처리를 위해 준비된 요청을 나타냅니다.")\<[ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> | 성공: 검색된 기록을 포함하는 ByteArray입니다. 이 정보를 필요한 데이터 모델로 변환할 수 있습니다. 실패: NowDataError |
[표 11. 반환]

{#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: String, tableName: String, fields: Map\<String, String\>, writeOptions: FieldWriteOptions?, configuration: FieldReadConfiguration?) {#ariaid-title7}

지정된 필드를 사용하여 지정된 테이블의 지정된 기록을 업데이트합니다.
{#NTabServ-updateRecord_S_S_S_O__table_jtj_nfh_ppb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| tableName | 문자열 | 기록을 업데이트할 테이블의 이름입니다. |
| 필드 | 맵\<문자열, 문자열\> | 기록에서 업데이트할 모든 필드에 대한 키-값 쌍입니다. 주: 기록 내의 모든 필드를 업데이트하지 못할 수 있습니다. 예를 들어 프리픽스가 `sys_` 인 필드는 일반적으로 자동으로 생성되며 업데이트할 수 없는 시스템 매개변수입니다. 지정되지 않았으며 시스템에서 자동 생성되지 않은 필드는 연결된 데이터 유형의 null 값으로 설정됩니다. |
| 쓰기 옵션 | [필드 쓰기 옵션](https://servicenow-prod.fluidtopics.net/EKQJvI1f_~1rafsdmhZTFw#FieldWriteOptionsAndroidAPI "FieldWriteOptions 클래스는 인스턴스의 ServiceNow 기록에 있는 필드를 업데이트하거나 작성하기 위한 옵션을 설정하는 기능을 제공합니다.") | 옵션입니다. 값을 표시 값으로 저장할지 또는 시스템 필드의 자동 생성을 억제할지 여부 등 필드에 설정할 옵션을 작성합니다. 기본값: null - 선택한 옵션이 없음 |
| 구성 | [필드읽기 구성](https://servicenow-prod.fluidtopics.net/bbYVLKwX5HMtKALDaXrvEQ#FieldReadConfigAndroidAPI "FieldReadConfiguration 클래스는 응답 기록에서 반환하거나 반환하지 않을 필드를 정의하는 기능을 제공합니다.") | 옵션입니다. 업데이트할 필드와 필드에 포함할 항목을 지정하는 구성입니다. 기본값: null |
[표 12. 매개변수]

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

| 유형 | 설명 |
|-|-|
| [호출](https://servicenow-prod.fluidtopics.net/BN_RUz24goZYtkdnEIbMCQ#CallAndroidInterface "호출 인터페이스는 처리를 위해 준비된 요청을 나타냅니다.")\<[ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> | 성공: 업데이트된 기록을 포함하는 ByteArray입니다. 이 정보를 필요한 데이터 모델로 변환할 수 있습니다. 실패: NowDataError |
[표 13. 반환]

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