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

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 2 minutes de lecture

    • 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 des pièces jointes dans 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écharger 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 la section API des pièces jointes.

    Toutes les méthodes NowAttachmentService fournissent trois implémentations pour renvoyer des données de résultats. Un qui appelle un gestionnaire de complétion avec les résultats de retour, un qui préforme un async/await, et un autre qui renvoie un éditeur de combinaison (obsolète). Par exemple, chaque méthode upload() télécharge et associe une pièce jointe spécifiée à un enregistrement spécifié. Cependant, 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 asynchrone méthode effectue un async/await et la NowAttachmentService : upload(data : Data, configuration : NowAttachmentUploadConfiguration, progressUpdate : @escaping ProgressUpdate) méthode renvoie un éditeur de combinaison.

    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. Lorsque vous téléchargez des métadonnées à partir de plusieurs pièces jointes, vous pouvez utiliser la NowAttachmentService : attachmentMetadataPaginator(filtre : filtre, limite : 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 les résultats de retour paginés pour fournir des fonctionnalités 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 des pages 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 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 de paginateur peuvent générer une exception, par exemple lorsqu’il n’y a plus de pages à extraire.

    En outre, l’objet Paginateur 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.