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

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

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

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

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

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