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

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# NowTableService 인터페이스 - Android

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

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

NowTableService 인터페이스는 인스턴스의 테이블 ServiceNow 내에서 레코드를 만들고, 읽고, 삭제하고, 업데이트할 수 있는 함수를 제공합니다.
{#NowTableServiceAndroidInterface__table_vx2_klw_5pb__entry__3}

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

{#NowTableServiceAndroidInterface__table_vx2_klw_5pb}

## NowTableService - createRecord(tableName: 문자열, 필드: Map\<String, String\>, writeOptions: FieldWriteOptions?, 구성: FieldReadConfiguration?) {#ariaid-title2}

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

| 이름 | 유형 | 설명 |
|-|-|-|
| tableName | 문자열 | 기록을 저장할 테이블의 이름입니다. |
| 필드 | Map\<String, String\> | 기록에 생성할 모든 필드에 대한 키-값 쌍입니다. 주: 기록 내의 모든 필드를 업데이트할 수 없습니다. 예를 들어, 프리픽스가 `sys_` 인 필드는 일반적으로 자동으로 생성되어 업데이트할 수 없는 시스템 매개변수입니다. 지정되지 않고 시스템에서 자동 생성되지 않은 필드는 연결된 데이터 형식의 null 값으로 설정됩니다. |
| writeOptions | [FieldWriteOptions (필드 쓰기 옵션)](https://servicenow-prod.fluidtopics.net/rVYcGeBjbHRIknFdZOz4mA#FieldWriteOptionsAndroidAPI "FieldWriteOptions 클래스는 인스턴스의 레코드 ServiceNow 에서 필드를 업데이트하거나 만들기 위한 옵션을 설정하는 함수를 제공합니다.") | 옵션입니다. 값을 표시 값으로 저장할지 또는 시스템 필드의 자동 생성을 억제할지 여부 등 필드에 설정할 쓰기 옵션입니다. 기본값: null - 선택한 옵션 없음 |
| 구성 | [FieldReadConfiguration](https://servicenow-prod.fluidtopics.net/VqWGI2ZgbpIOVZ1sRHnSFQ#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/EfE7tICr3353oOPmB9qPZw#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: 문자열, tableName: 문자열) {#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/EfE7tICr3353oOPmB9qPZw#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 | 문자열 | 페이지 매김기를 생성할 테이블의 이름입니다. |
| 구성 | [구성 페치(FetchConfiguration)](https://servicenow-prod.fluidtopics.net/3kqVUkfJ9YKuvduU49OO9A#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 | 문자열 | 인시던트 또는 자산과 같이 지정된 기록이 있는 테이블의 이름입니다. |
| 구성 | [FieldReadConfiguration](https://servicenow-prod.fluidtopics.net/VqWGI2ZgbpIOVZ1sRHnSFQ#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/EfE7tICr3353oOPmB9qPZw#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}

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

| 이름 | 유형 | 설명 |
|-|-|-|
| tableName | 문자열 | 인시던트 또는 자산과 같이 기록을 검색할 테이블의 이름입니다. |
| 구성 | [FieldReadConfiguration](https://servicenow-prod.fluidtopics.net/VqWGI2ZgbpIOVZ1sRHnSFQ#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/EfE7tICr3353oOPmB9qPZw#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: 문자열, tableName: 문자열, 필드: Map\<String, String\>, writeOptions: FieldWriteOptions?, 구성: FieldReadConfiguration?) {#ariaid-title7}

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

| 이름 | 유형 | 설명 |
|-|-|-|
| tableName | 문자열 | 기록을 업데이트할 테이블의 이름입니다. |
| 필드 | Map\<String, String\> | 기록에서 업데이트할 모든 필드에 대한 키-값 쌍입니다. 주: 기록 내의 모든 필드를 업데이트할 수 없습니다. 예를 들어, 프리픽스가 `sys_` 인 필드는 일반적으로 자동으로 생성되어 업데이트할 수 없는 시스템 매개변수입니다. 지정되지 않고 시스템에서 자동 생성되지 않은 필드는 연결된 데이터 형식의 null 값으로 설정됩니다. |
| writeOptions | [FieldWriteOptions (필드 쓰기 옵션)](https://servicenow-prod.fluidtopics.net/rVYcGeBjbHRIknFdZOz4mA#FieldWriteOptionsAndroidAPI "FieldWriteOptions 클래스는 인스턴스의 레코드 ServiceNow 에서 필드를 업데이트하거나 만들기 위한 옵션을 설정하는 함수를 제공합니다.") | 옵션입니다. 값을 표시 값으로 저장할지 또는 시스템 필드의 자동 생성을 억제할지 여부 등 필드에 설정할 쓰기 옵션입니다. 기본값: null - 선택한 옵션 없음 |
| 구성 | [FieldReadConfiguration](https://servicenow-prod.fluidtopics.net/VqWGI2ZgbpIOVZ1sRHnSFQ#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/EfE7tICr3353oOPmB9qPZw#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") }) 
    }