Rufen Sie Anhänge und Anhangsmetadaten ab

Mit der NowAttachmentService- API können Sie CRUD-Vorgänge für Anhänge ausführen und Anhangmetadaten aus Ihrer -Instanz ServiceNow abrufen.

Mit dieser API können Sie:

• Laden Sie Anhänge in Ihre Instanz ServiceNow hoch und ordnen Sie sie einem bestimmten Datensatz zu.
• Laden Sie einen oder mehrere Anhänge herunter.
• Löschen Sie Anhänge.
• Validiert einen Anhang, indem der berechnete Hash des Anhangs mit dem erwarteten Hash verglichen wird.
• Laden Sie die Anhangmetadaten herunter. Diese Metadaten werden von Ihrer Instanz ServiceNow generiert, wenn ein Anhang hochgeladen wird.

Weitere Informationen zum Arbeiten mit Anhängen finden Sie unter Anhang-API.

Alle NowAttachmentService- Methoden bieten drei Implementierungen für die Rückgabe von Ergebnisdaten. Einer ruft einen Abschluss-Handler mit den zurückgegebenen Ergebnissen auf, einer, der ein asynchrones/wartendes Element vorformt, und ein anderer, der einen (veraltet) Kombinieren -Herausgeber zurückgibt. Zum Beispiel lädt jede Upload()- Methode einen bestimmten Anhang zu einem bestimmten Datensatz hoch und ordnet ihn diesem zu. Die Methode NowAttachmentService - Upload(Daten: Daten, Konfiguration: NowAttachmentUploadConfiguration, ProgressUpdate: @escaping ProgressUpdate, Abschluss: @escaping (Ergebnis<NowAttachmentMetadata, NowDataError> )) ruft jedoch einen Abschluss-Handler mit den zurückgegebenen Ergebnissen auf, die Methode NowAttachmentService: asynchrone Auslösungen für „upload(data: Data, Configuration: NowAttachmentUploadConfiguration, ProgressUpdate: @escaping ProgressUpdate)“ führt ein asynchrones Warten aus und die Methode NowAttachmentService – Upload(Daten: Daten, Konfiguration: NowAttachmentUploadConfiguration, ProgressUpdate: @escaping ProgressUpdate) gibt einen Kombinationsherausgeber zurück.

Bevor Sie die NowAttachmentService- API verwenden können, müssen Sie NowData importieren und dann ein NowAttachmentService-Objekt initialisieren.

// Import the NowData framework
import NowData

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

Paginierung der Anhangmetadaten

Sie können die NowAttachmentService- Methoden verwenden, um Anhangmetadaten für einen oder mehrere Anhänge herunterzuladen. Wenn Sie Metadaten aus mehreren Anhängen herunterladen, möchten Sie möglicherweise die Methode NowAttachmentService – AttachmentMetadataPaginator(filter: Filter, limit: Int) verwenden, die ein Paginator- Objekt zurückgibt, mit dem Sie auf einfache Weise über die potenziell große Menge der zurückgegebenen Daten iterieren können. Normalerweise verwenden Sie paginierte Rückgabeergebnisse, um unbegrenzte Scrollfunktionen für Daten bereitzustellen, die in einer UITableView, einer UICollectionView (UIKit) oder einer Liste (SwiftUI) präsentiert werden, oder um die Seiteniteration der Ergebnisse im Allgemeinen zu vereinfachen.

Nachdem Sie ein Paginator-Objekt erhalten haben, abonnieren Sie dessen Herausgeber, um mit dem Empfang von Daten zu beginnen.

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

Das zurückgegebene Paginator-Objekt stellt die folgenden Methoden bereit, mit denen Sie durch die zurückgegebenen Datensätze blättern können:

• zuerst ()
• letzte ()
• nächste ()
• vorherige ()
• reset()

Hinweis:

Einige Paginatormethoden lösen möglicherweise eine Ausnahme aus, z. B. wenn keine Seiten mehr abzurufen sind.

Darüber hinaus bietet das Paginator-Objekt Eigenschaften, mit denen Sie Einblicke in die paginierten Daten erhalten. Weitere Informationen zu diesen Eigenschaften und den verfügbaren Methoden finden Sie unter Paginator-API – iOS.