Récupérer les pièces jointes et les métadonnées des pièces jointes

L’API NowAttachmentService vous permet d’effectuer des opérations CRUD sur les pièces jointes et de récupérer les métadonnées de pièce jointe à partir de votre ServiceNow instance.

À l’aide de cette API, vous pouvez :

• Téléchargez des pièces jointes sur votre ServiceNow instance et associez-les à un enregistrement spécifique.
• Téléchargez une ou plusieurs pièces jointes.
• Supprimer les pièces jointes.
• Validez une pièce jointe en comparant le hachage calculé de la pièce jointe au hachage attendu.
• Téléchargez les métadonnées de la pièce jointe. Ces métadonnées sont générées par votre ServiceNow instance lorsqu’une pièce jointe est chargée.

Pour plus d’informations sur l’utilisation des pièces jointes, consultez API des pièces jointes.

Toutes les méthodes NowAttachmentService fournissent trois implémentations pour renvoyer des données de résultats. L’un qui appelle un gestionnaire de complétion avec les résultats renvoyés, l’autre qui préforme un async/await, et un autre qui renvoie un éditeur Combine (obsolète). Par exemple, chaque méthode upload() télécharge et associe une pièce jointe spécifiée à un enregistrement spécifié. Toutefois, la NowAttachmentService : upload(data : Data, configuration : NowAttachmentUploadConfiguration, progressUpdate : @escaping ProgressUpdate, completion : @escaping (Result<NowAttachmentMetadata, NowDataError>)) méthode appelle un gestionnaire de complétion avec les résultats renvoyés, la NowAttachmentService : upload(data : Data, configuration : NowAttachmentUploadConfiguration, progressUpdate : @escaping ProgressUpdate) Levées asynchrones méthode effectue un async/await et la NowAttachmentService : upload(data : Data, configuration : NowAttachmentUploadConfiguration, progressUpdate : @escaping ProgressUpdate) méthode renvoie un éditeur Combine.

Avant de pouvoir utiliser l’API NowAttachmentService , vous devez importer NowData , puis initialiser un objet NowAttachmentService.

// Import the NowData framework
import NowData

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

Pagination des métadonnées de pièce jointe

Vous pouvez utiliser les méthodes NowAttachmentService pour télécharger les métadonnées de pièce jointe pour une ou plusieurs pièces jointes. Lors du téléchargement de métadonnées à partir de plusieurs pièces jointes, vous pouvez utiliser la NowAttachmentService : attachmentMetadataPaginator(filter : Filter, limit : Int) méthode, qui renvoie un objet Paginator qui vous permet d’itérer facilement sur la quantité potentiellement importante de données renvoyées. Vous utilisez généralement des résultats de retour paginés pour fournir des capacités de défilement infini pour les données présentées à l’intérieur d’un UITableView, d’un UICollectionView (UIKit) ou d’une liste (SwiftUI), ou pour simplifier l’itération des résultats de page en général.

Après avoir obtenu un objet Paginator, abonnez-vous à son éditeur pour commencer à recevoir des données.

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

L’objet paginateur renvoyé fournit les méthodes suivantes qui vous permettent de parcourir les enregistrements renvoyés :

• premier()
• last()
• suivant()
• précédent()
• réinitialiser()

Remarque :

Certaines méthodes Paginator peuvent lever une exception, par exemple lorsqu’il n’y a plus de pages à extraire.

En outre, l’objet Paginator fournit des propriétés qui vous permettent d’obtenir des aperçus des données paginées. Pour plus d’informations sur ces propriétés et les méthodes disponibles, reportez-vous à la section API du paginateur : iOS.