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 ServiceNow -Instanz 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.
• Validieren Sie einen Anhang, indem Sie den berechneten Hash des Anhangs mit dem erwarteten Hash vergleichen.
• Laden Sie die Anhangsmetadaten herunter. Diese Metadaten werden von Ihrer ServiceNow -Instanz 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. Einen, der einen Abschluss-Handler mit den zurückgegebenen Ergebnissen aufruft, einen, der async/wait ausführt, und einen anderen, der einen Kombinationsherausgeber zurückgibt (veraltet). Zum Beispiel lädt jede Upload()- Methode einen angegebenen Anhang zu einem angegebenen Datensatz hoch und ordnet ihn zu. Die Methode NowAttachmentService – Upload(data: 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 – Upload(data: Data, configuration: NowAttachmentUploadConfiguration, progressUpdate: @escaping ProgressUpdate) async wirft führt ein async/await aus, und die Methode NowAttachmentService – Upload(data: Data, configuration: 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 die potenziell große Datenmenge, die zurückgegeben wird, einfach durchlaufen können. Normalerweise verwenden Sie paginierte Rückgabeergebnisse, um unendliche Bildlauffunktionen für Daten bereitzustellen, die in einer UITableView, einer UICollectionView (UIKit) oder einer Liste (SwiftUI) angezeigt werden, oder um die Seiteniteration der Ergebnisse im Allgemeinen zu vereinfachen.

Nachdem Sie ein Paginator-Objekt erhalten haben, abonnieren Sie den Herausgeber, um mit dem Empfangen 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:

• erste ()
• letzte(r)
• next()
• previous()
• reset()

Hinweis:

Einige Paginator- Methoden lösen möglicherweise eine Ausnahme aus, z. B. wenn keine weiteren Seiten abzurufen sind.

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