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


---

# NowAttachmentService 인터페이스 - Android

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

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

NowAttachmentService 인터페이스는 파일 첨부 파일 및 관련 메타데이터를 조작할 수 있는 함수를 제공합니다.
{#NowAttachServiceAndroidInterface__table_vx2_klw_5pb__entry__3}

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

{#NowAttachServiceAndroidInterface__table_vx2_klw_5pb}

## NowAttachmentService - attachment(sysId: String, validateAttachment: Boolean = true) {#ariaid-title2}

지정된 sys_id 가진 첨부 파일을 검색하고, 필요한 경우 첨부 파일의 계산된 해시를 예상 해시와 비교하여 첨부 파일의 유효성을 검사합니다.
{#NAttServ-attachment_S_B__table_old_sp5_4pb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| sysId | 문자열 | 검색할 첨부 파일의 Sys_id입니다. 인스턴스의 ServiceNow 첨부 파일에 대한 sys_id입니다. |
| validateAttachment | 부울 | 첨부 파일의 유효성을 검사할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 첨부 파일의 유효성을 검사합니다. * false: 첨부 파일의 유효성을 검사하지 않습니다. {#NAttServ-attachment_S_B__ul_ftq_1q5_4pb} 기본값: true |
[표 2. 매개변수]

{#NAttServ-attachment_S_B__table_old_sp5_4pb} {#NAttServ-attachment_S_B__table_pld_sp5_4pb__entry__2}

| 유형 | 설명 |
|-|-|
| [Call](https://servicenow-prod.fluidtopics.net/EfE7tICr3353oOPmB9qPZw#CallAndroidInterface "호출 인터페이스는 처리를 위해 준비된 요청을 나타냅니다.")\<[NowAttachment](https://servicenow-prod.fluidtopics.net/AUfpNO5Sgs_lUlvOAV9EXA#NowAttachmentAndroidAPI "NowAttachment 클래스는 첨부 파일 및 관련 메타데이터가 포함된 개체를 제공합니다.")입니다\> | NowAttachment 객체에는 요청된 첨부 파일이 포함되어 있습니다. |
[표 3. 반환]

{#NAttServ-attachment_S_B__table_pld_sp5_4pb}  
<br />

    fun getAttachment(sysId: String, isValidateAttachment: Boolean) { 
      val call = attachmentService.attachment(sysId, isValidateAttachment) 
      call.enqueue( 
        { response -> 
          val attachment: NowAttachment? = response.body 
        }, 
          { nowDataError -> handleError(nowDataError) } 
      ) 
    }

## NowAttachmentService - attachmentMetadata(sysId: String) {#ariaid-title3}

지정된 sys_id와 연결된 첨부 파일에 대한 메타데이터를 조회합니다.
{#NAttServ-attachmentMetadata_S__table_bqq_1r5_4pb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| sysId | 문자열 | 메타데이터를 검색할 첨부 파일의 Sys_id입니다. |
[표 4. 매개변수]

{#NAttServ-attachmentMetadata_S__table_bqq_1r5_4pb} {#NAttServ-attachmentMetadata_S__table_cqq_1r5_4pb__entry__2}

| 유형 | 설명 |
|-|-|
| [Call](https://servicenow-prod.fluidtopics.net/EfE7tICr3353oOPmB9qPZw#CallAndroidInterface "호출 인터페이스는 처리를 위해 준비된 요청을 나타냅니다.")\<[NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/VxBLmAil7aPHDjDo_hAkqA#NowAttachmentMetadataAndroidAPI "NowAttachmentMetadata 클래스는 첨부 파일 메타데이터를 인코딩하고 관리할 수 있는 함수를 제공합니다.")\> | 지정된 첨부 파일에 대한 메타데이터를 포함하는 객체입니다. |
[표 5. 반환]

{#NAttServ-attachmentMetadata_S__table_cqq_1r5_4pb}  

    fun fetchMetadata(sysId: String) { 
      val call = attachmentService.attachmentMetadata(sysId) 
      call.enqueue(
        { response -> 
          val metadata: NowAttachmentMetadata? = response.body 
        },
        { nowDataError -> handleError(nowDataError) } 
      )
    }

## NowAttachmentService - attachmentMetadata(filter: filter? = null, limit: Int? = null) {#ariaid-title4}

지정된 기준을 충족하는 모든 첨부 파일에 대한 메타데이터를 검색합니다.
{#NAttServ-attachmentMetadata_S_I___table_ujt_zc1_ppb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 필터 | [필터](https://servicenow-prod.fluidtopics.net/etVJnwLE~KttCiMwuWyAKA#FilterAndroidAPI "Filter 클래스는 REST 끝점 쿼리의 반환 결과에 반환할 데이터를 정의하는 필터를 구성하는 기능을 제공합니다.") | 옵션입니다. 반환할 메타데이터가 있는 첨부 파일을 필터링하는 데 사용할 쿼리 문자열입니다. 기본값: null - 사용 가능한 모든 첨부 파일에 대한 메타데이터를 반환합니다. 매개변수를 limit 고려합니다. |
| 제한 | 정수 | 옵션입니다. 반환할 첨부 파일 메타데이터의 최대 수입니다. 기본값: null - 매개 변수 사양을 충족하는 모든 메타데이터를 filter 반환합니다. |
[표 6. 매개변수]

{#NAttServ-attachmentMetadata_S_I___table_ujt_zc1_ppb} {#NAttServ-attachmentMetadata_S_I___table_vjt_zc1_ppb__entry__2}

| 유형 | 설명 |
|-|-|
| [Call](https://servicenow-prod.fluidtopics.net/EfE7tICr3353oOPmB9qPZw#CallAndroidInterface "호출 인터페이스는 처리를 위해 준비된 요청을 나타냅니다.")\<[List](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-list/)\<[NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/VxBLmAil7aPHDjDo_hAkqA#NowAttachmentMetadataAndroidAPI "NowAttachmentMetadata 클래스는 첨부 파일 메타데이터를 인코딩하고 관리할 수 있는 함수를 제공합니다.")입니다\>\> | 일치하는 첨부 파일에 대한 메타데이터를 포함하는 객체의 목록입니다. |
[표 7. 반환]

{#NAttServ-attachmentMetadata_S_I___table_vjt_zc1_ppb}  

    fun fetchMultipleMetadata(filterQuery: String, limit: Int) { 
      val call = attachmentService.attachmentMetadata(Filter(filterQuery), limit) 
      call.enqueue( 
        { response -> 
          val metadataList: List<NowAttachmentMetadata>? = response.body 
        },
        { nowDataError -> handleError(nowDataError) } 
      )
    }

## NowAttachmentService - attachmentMetadataPaginator(filter: filter? = null, limit: Int? = null) {#ariaid-title5}

지정된 기준을 충족하는 모든 첨부 파일에 대한 메타데이터를 검색하고 반환된 메타데이터의 페이지를 반복하기 위한 페이지 매김기를 만듭니다.
이 페이지네이터를 사용하여 반환된 메타데이터를 탐색하고 첫 번째, 마지막, 이전 또는 다음 페이지를 가져오거나 다음 또는 이전 페이지가 있는지 확인하는 등의 탐색 작업을 수행할 수 있습니다.
{#NAttServ-attachMetadataPaginat_S_I__table_npz_zf1_ppb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 필터 | [필터](https://servicenow-prod.fluidtopics.net/etVJnwLE~KttCiMwuWyAKA#FilterAndroidAPI "Filter 클래스는 REST 끝점 쿼리의 반환 결과에 반환할 데이터를 정의하는 필터를 구성하는 기능을 제공합니다.") | 옵션입니다. 반환할 메타데이터가 있는 첨부 파일을 필터링하는 데 사용할 쿼리 문자열입니다. 기본값: null - 사용 가능한 모든 첨부 파일에 대한 메타데이터를 반환합니다. 매개변수를 limit 고려합니다. |
| 제한 | 정수 | 옵션입니다. 반환할 첨부 파일 메타데이터의 최대 수입니다. 기본값: null - 매개 변수 사양을 충족하는 모든 메타데이터를 filter 반환합니다. |
[표 8. 매개변수]

{#NAttServ-attachMetadataPaginat_S_I__table_npz_zf1_ppb} {#NAttServ-attachMetadataPaginat_S_I__table_opz_zf1_ppb__entry__2}

| 유형 | 설명 |
|-|-|
| paginator\<[nowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/VxBLmAil7aPHDjDo_hAkqA#NowAttachmentMetadataAndroidAPI "NowAttachmentMetadata 클래스는 첨부 파일 메타데이터를 인코딩하고 관리할 수 있는 함수를 제공합니다.")입니다\> | 성공: 지정된 메타데이터 페이지와 함께 Paginator 객체입니다. 실패: NowDataError 개체입니다. |
[표 9. 반환]

{#NAttServ-attachMetadataPaginat_S_I__table_opz_zf1_ppb}  
다음 코드 예제에서는 이 함수를 호출하는 방법을 보여 줍니다.

    suspend fun createAttachmentMetadataPaginator() {
      val filterQuery: String = "content_type=text/plain"
      val filter = filterQuery.let(::Filter)
      val limit = 10
      val paginator = nowServiceManager.getNowAttachmentService()?.attachmentMetadataPaginator(filter, limit)
        ?.observe(object : PaginatorCallBack<NowAttachmentMetadata> {
          override fun onFailure(e: NowDataError) {
            handleError(e)
          }

          override fun onSuccess(response: Response<List<NowAttachmentMetadata>>) {
            handleResponse(response)
          }

        })
        ?: throw Exception("Response is null")
    }

## NowAttachmentService - 삭제(sysId: 문자열) {#ariaid-title6}

지정된 sys_id 가진 첨부 파일을 삭제합니다.
{#NAttServ-delete_S__table_dq4_dj1_ppb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| sysId | 문자열 | 삭제할 첨부 파일의 Sys_id입니다. |
[표 10. 매개변수]

{#NAttServ-delete_S__table_dq4_dj1_ppb} {#NAttServ-delete_S__table_eq4_dj1_ppb__entry__2}

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

{#NAttServ-delete_S__table_eq4_dj1_ppb}  
<br />

    fun deleteAttachment(sysId: String) { 
      val call = attachmentService.delete(sysId) 
      call.enqueue( 
        { response -> handleResponse(response) }, 
        { nowDataError -> handleError(nowDataError) } 
      )
    } 

## NowAttachmentService - 업로드(데이터: ByteArray, 구성: NowAttachmentUploadConfiguration) {#ariaid-title7}

지정된 기준을 충족하는 모든 첨부 파일에 대한 메타데이터를 검색하고 반환된 메타데이터의 페이지를 반복하기 위한 페이지 매김기를 만듭니다.
{#NAttServ-upload_A_O__table_fkj_3k1_ppb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 데이터 | [바이트 어레이](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/) | 구성 객체에 지정된 첨부 파일과 업로드하고 연결할 메타데이터입니다. |
| 구성 | NowAttachment업로드구성 | 구성 매개변수를 업로드합니다. |
[표 12. 매개변수]

{#NAttServ-upload_A_O__table_fkj_3k1_ppb} {#NAttServ-upload_A_O__table_gkj_3k1_ppb__entry__2}

| 유형 | 설명 |
|-|-|
| [NowAttachmentMetadata (영문)](https://servicenow-prod.fluidtopics.net/VxBLmAil7aPHDjDo_hAkqA#NowAttachmentMetadataAndroidAPI "NowAttachmentMetadata 클래스는 첨부 파일 메타데이터를 인코딩하고 관리할 수 있는 함수를 제공합니다.") | 업로드된 메타데이터입니다. |
[표 13. 반환]

{#NAttServ-upload_A_O__table_gkj_3k1_ppb}  

    fun uploadAttachment(tableName: String, recordSysId: String, fileName: String) { 
      val bitmap = BitmapFactory.decodeResource(resources, R.drawable.test_image) 
      val data = bitmap.compress(ImageType.JPEG) 
      val contentType = "image/jpg" 
      val config = NowAttachmentUploadConfiguration(tableName, recordSysId, fileName, contentType) 
      val call = attachmentService.upload(data, config) 
     
      call.enqueue( 
        { response -> 
          val uploadedAttachmentMetadata: NowAttachmentMetadata? = response.body 
        },
        { nowDataError -> handleError(nowDataError) } 
      )
    }