Récupérer les pièces jointes et les métadonnées de pièce jointe

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 :

• Chargez les pièces jointes dans votre ServiceNow instance et associez-les à un enregistrement spécifique.
• Téléchargez une ou plusieurs pièces jointes.
• Supprimez les pièces jointes.
• Validez une pièce jointe en comparant le hachage calculé de la pièce jointe au hachage attendu.
• Télécharger les métadonnées de 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 retourne un éditeur Combine (déconseillé). 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) lève une fonction asynchrone méthode effectue un async/await et la NowAttachmentService : upload(données : données, 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 des pièces jointes

Vous pouvez utiliser les méthodes NowAttachmentService pour télécharger les métadonnées de pièce jointe d’une ou de 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 options de défilement infini pour les données présentées à l’intérieur d’une UITableView, d’une UICollectionView (UIKit) ou d’une liste (SwiftUI), ou pour simplifier l’itération de page des résultats 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 Paginator renvoyé fournit les méthodes suivantes qui vous permettent de parcourir les enregistrements renvoyés :

• premier()
• last()
• next()
• précédent()
• reset()

Remarque :

Certaines méthodes Paginator peuvent générer 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 en savoir plus sur ces propriétés et les méthodes disponibles, reportez-vous à la section API du paginateur : iOS.