--- sourceDocument: Référence de l’API Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference Release : - xanadu ft:locale : - fr-FR ft:publication_title : - Référence de l’API Xanadu ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # Récupérer les pièces jointes et les métadonnées de pièce jointe # Récupérer les pièces jointes et les métadonnées de pièce jointe {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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 les pièces jointes sur 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 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. {#mobsdk-ios-retrieve_attach_metadata__ul_l5y_qjw_3qb} Pour plus d'informations sur l'utilisation des pièces jointes, consultez [API de pièce jointe](https://servicenow-prod.fluidtopics.net/l0hrYA0GJ_q5yhPiWJa~bw#c_AttachmentAPI "L’API de pièces jointes fournit des points de terminaison qui vous permettent de charger et d’interroger des pièces jointes."). Toutes les méthodes [NowAttachmentService](https://servicenow-prod.fluidtopics.net/0_CzlBzyDRvr8Q5Y1BEBiA#NowAttachmentServiceiOSAPI "La classe NowAttachmentService fournit des fonctions qui vous permettent de charger et d’interroger des pièces jointes associées à des enregistrements au sein d’une table sur une ServiceNow instance.") fournissent trois implémentations pour renvoyer les données de résultats. L'une qui appelle un gestionnaire de complétion avec les résultats de retour, l'autre qui préforme un async/await et une autre qui renvoie un éditeur [Combine](https://developer.apple.com/documentation/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(données : données, configuration : NowAttachmentUploadConfiguration, progressUpdate : @escaping ProgressUpdate, achèvement : @escaping (Result))](https://servicenow-prod.fluidtopics.net/0_CzlBzyDRvr8Q5Y1BEBiA#NAttServiOS-upload_O_O_O_O "Charge les données de la pièce jointe et les joint à un enregistrement dans une table comme spécifié dans la configuration du chargement.") 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](https://servicenow-prod.fluidtopics.net/0_CzlBzyDRvr8Q5Y1BEBiA#NAttServiOS-upload-async_O_O_O_O "Charge les données de la pièce jointe et les joint à un enregistrement dans une table comme spécifié dans la configuration du chargement.") méthode effectue un async/await et la [NowAttachmentService : upload(données : données, configuration : NowAttachmentUploadConfiguration, progressUpdate : @escaping ProgressUpdate)](https://servicenow-prod.fluidtopics.net/0_CzlBzyDRvr8Q5Y1BEBiA#NAttServiOS-upload_O_O_O "Charge les données de la pièce jointe et les joint à un enregistrement dans une table comme spécifié dans la configuration du chargement.") 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) → Void)) ## Pagination des métadonnées des pièces jointes {#mobsdk-ios-retrieve_attach_metadata__section_stt_34w_3qb} 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)](https://servicenow-prod.fluidtopics.net/0_CzlBzyDRvr8Q5Y1BEBiA#NAttServiOS-attachMetadataPag_S_I "Récupère les métadonnées de toutes les pièces jointes qui répondent aux critères spécifiés et renvoie un objet Paginator pour itération à travers les pages des métadonnées renvoyées.") méthode, qui renvoie un objet [Paginator](https://servicenow-prod.fluidtopics.net/4lx_VkdPLM4vdP7m2woCeQ#PaginatorIOSAPI "La classe Paginator fournit des méthodes d’itération à travers un ensemble d’enregistrements renvoyé par un appel à l’API ServiceNow de table via NowTableService. C’est l’objet qui est renvoyé par les méthodes paginator() NowTableService. N’appelez pas cette méthode en dehors de cet environnement.") 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'un UITableView, d'un 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() * previous() * reset() {#mobsdk-ios-retrieve_attach_metadata__ul_pyb_2w3_3qb} 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 informations sur les 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](https://servicenow-prod.fluidtopics.net/4lx_VkdPLM4vdP7m2woCeQ#PaginatorIOSAPI "La classe Paginator fournit des méthodes d’itération à travers un ensemble d’enregistrements renvoyé par un appel à l’API ServiceNow de table via NowTableService. C’est l’objet qui est renvoyé par les méthodes paginator() NowTableService. N’appelez pas cette méthode en dehors de cet environnement.").