Ruft Anhänge und Anhangmetadaten ab

Die NowAttachmentService Mit der API können Sie CRUD-Vorgänge für Anhänge ausführen und Anhangsmetadaten von Ihrem abrufen ServiceNow Instanz.

Mit dieser API können Sie:

• Laden Sie Anhänge auf hoch ServiceNow Instanz und einem bestimmten Datensatz zugeordnet.
• 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 Metadaten des Anhangs herunter. Diese Metadaten werden von generiert ServiceNow Instanz, 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, der einen Abschlusshandler mit den Rückgabeergebnissen aufruft, einer, der eine asynchrone/warten vordefiniert, und ein anderer, der einen zurückgibt Kombinieren Herausgeber (veraltet). Beispiel: Jeweils Hochladen () Methode lädt einen angegebenen Anhang hoch und ordnet ihn einem angegebenen Datensatz zu. Jedoch ist NowAttachmentService – Upload(Data: Data, Configuration: NowAttachmentUploadConfiguration, progressUpdate: @Escaping ProgressUpdate, Abschluss: @Escaping (Result<NowAttachmentMetadata, NowDataError>))Methode ruft einen Abschlusshandler mit den Rückgabeergebnissen auf, den NowAttachmentService – Upload(Data: Data, Configuration: NowAttachmentUploadConfiguration, progressUpdate: @Escaping ProgressUpdate) asynchrone Auslöse Methode führt asynchrone/warten und aus NowAttachmentService – Upload(Data: Data, Configuration: NowAttachmentUploadConfiguration, progressUpdate: @Escaping ProgressUpdate)Methode gibt einen kombinierten Herausgeber zurück.

Bevor Sie verwenden können NowAttachmentService API, Sie müssen importieren Now-Daten Und initialisieren Sie dann ein NowAttachmentService-Objekt.

// Import the NowData framework
import NowData

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

Paginierung der Anhangsmetadaten

Sie können verwenden NowAttachmentService Methoden zum Herunterladen von Anhangsmetadaten für einen oder mehrere Anhänge. Wenn Sie Metadaten aus mehreren Anhängen herunterladen, können Sie verwenden NowAttachmentService – attachmentMetadataPaginator(Filter: Filter, Grenzwert: INT)Methode, die einen zurückgibt Paginator Objekt, mit dem Sie die potenziell große Datenmenge, die zurückgegeben wird, einfach iterieren können. Normalerweise verwenden Sie paginierte Rückgabeergebnisse, um unendliche Scrollfunktionen für Daten bereitzustellen, die in einer UITableView, einer UICollectionView (UIKit) oder einer Liste (SwiftUI) angezeigt werden, oder um die Seiteniterierung von Ergebnissen im Allgemeinen zu vereinfachen.

Nachdem Sie ein Paginator-Objekt erhalten haben, abonnieren Sie den 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 bietet die folgenden Methoden, mit denen Sie die zurückgegebenen Datensätze durchblättern können:

• First()
• Letzte()
• Next()
• Zurück ()
• reset()

Hinweis:

Einige Paginator Methoden können eine Ausnahme auslösen, z. B. wenn keine weiteren Seiten zum Abrufen vorhanden sind.

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