첨부 파일 및 첨부 파일 메타데이터 검색

NowAttachmentService API를 사용하면 첨부 파일에 대해 CRUD 작업을 수행하고 인스턴스에서 첨부 파일 메타데이터를 검색할 수 있습니다ServiceNow.

이 API를 사용하여 다음을 수행할 수 있습니다.

• 첨부 파일을 ServiceNow 인스턴스에 업로드하고 특정 기록에 연결합니다.
• 하나 이상의 첨부 파일을 다운로드합니다.
• 첨부 파일을 삭제합니다.
• 첨부 파일의 계산된 해시를 예상 해시와 비교하여 첨부 파일의 유효성을 확인합니다.
• 첨부 파일 메타데이터를 다운로드합니다. 이 메타데이터는 첨부 파일이 업로드될 때 인스턴스에서 생성됩니다 ServiceNow .

첨부 파일 작업에 대한 자세한 내용은 첨부 파일 API를 참조하십시오.

모든 NowAttachmentService 메서드는 결과 데이터를 반환하기 위한 세 가지 구현을 제공합니다. 하나는 반환 결과와 함께 완성 처리기를 호출하고, 하나는 async/await를 수행하고, 다른 하나는 Combine 게시자(사용되지 않음)를 반환합니다. 예를 들어, 각 upload() 메서드는 지정된 첨부 파일을 업로드하고 지정된 기록에 연결합니다. NowAttachmentService - upload(data: Data, configuration: NowAttachmentUploadConfiguration, progressUpdate: @escaping ProgressUpdate, completion: @escaping (Result<NowAttachmentMetadata, NowDataError>)) 그러나 메서드는 반환 결과와 함께 완성 처리기를 호출하고, NowAttachmentService - upload(data: Data, configuration: NowAttachmentUploadConfiguration, progressUpdate: @escaping ProgressUpdate) async throws 메서드는 async/await를 수행하고NowAttachmentService - 업로드(데이터: 데이터, 구성: NowAttachmentUploadConfiguration, progressUpdate: @escaping ProgressUpdate), 메서드는 Combine 게시자를 반환합니다.

NowAttachmentService API를 사용하려면 먼저 NowData를 가져온 다음 NowAttachmentService 개체를 초기화해야 합니다.

// Import the NowData framework
import NowData

func makeAttachmentService(instanceUrl: URL, 
  completion: @escaping ((Result<NowAttachmentService, NowServiceErrors>) → Void))

첨부 파일 메타데이터 페이지 매김

NowAttachmentService 메서드를 사용하여 하나 이상의 첨부 파일에 대한 첨부 파일 메타데이터를 다운로드할 수 있습니다. 여러 첨부 파일에서 메타데이터를 다운로드할 때 반환되는 많은 양의 데이터를 쉽게 반복할 수 있는 Paginator 개체를 반환하는 메서드를 사용할 NowAttachmentService - attachmentMetadataPaginator(filter: Filter, limit: Int) 수 있습니다. 일반적으로 페이지 매김된 반환 결과를 사용하여 UITableView, UICollectionView(UIKit) 또는 List(SwiftUI) 내에 표시되는 데이터에 대한 무한 스크롤 기능을 제공하거나 일반적으로 결과의 페이지 반복을 간소화합니다.

Paginator 개체를 얻은 후 게시자를 구독하여 데이터 수신을 시작합니다.

paginator.publisher
  .subscribe(on: DispatchQueue.global())
  .receive(on: DispatchQueue.main)
  .sink { ... }
  .store(in: &subscriptions)

반환된 Paginator 개체는 반환된 레코드를 페이징할 수 있는 다음 메서드를 제공합니다.

• 첫 번째()
• 마지막()
• 다음()
• 이전()
• 재설정()

주:

일부 Paginator 메서드는 가져올 페이지가 더 이상 없는 경우와 같이 예외를 throw할 수 있습니다.

또한 Paginator 개체는 페이지 매김된 데이터에 대한 인사이트를 얻을 수 있는 속성을 제공합니다. 이러한 속성 및 사용 가능한 메서드에 대한 자세한 내용은 을 참조하십시오 페이지 매김기 API - iOS.