---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Ruft Anhänge und Anhangsmetadaten ab

# Ruft Anhänge und Anhangsmetadaten ab {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Die Jetzt AttachmentService Mit der API können Sie CRUD-Vorgänge für Anhänge ausführen und Anhangsmetadaten von abrufen ServiceNowInstanz.
Hinweis:  
Die Jetzt Anhang API funktioniert für Gastanwender in der Basis ServiceNowSystem.  
Mit dieser API können Sie:

* Laden Sie Anhänge auf hoch ServiceNowInstanz und hat sie 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 ServiceNowInstanz, wenn ein Anhang hochgeladen wird.
{#mobsdk-and-retrieve_attach_metadata__ul_l5y_qjw_3qb}

Weitere Informationen zum Arbeiten mit Anhängen finden Sie unter [Anhang-API](https://servicenow-prod.fluidtopics.net/yvHCr6JSNqXgjBt_D_9IoQ#c_AttachmentAPI "Die Anhang Die API stellt Endpunkte bereit, mit denen Sie Dateianhänge hochladen und abfragen können.").  
Im Folgenden wird gezeigt, wie Now AttachmentService instanziiert wird:

    /**
     * Helper class used to handle different Now service instances. 
     * It has an application scope or is a Singleton.
     */
    @Singleton
    class SdkManager @Inject constructor() {


        private var nowAttachmentService: NowAttachmentService? = null

        /**
         * Create the NowAttachmentService once in the lifetime of the application 
         * inside the Application class or another manager class
         * that will be injected into other classes via dagger/hilt.
         * NowAttachmentService should be created after initializing the NowSDK
         */
        suspend fun getNowAttachmentService(): NowAttachmentService? {
            if (nowAttachmentService != null) return nowAttachmentService

            return NowDataSDK.makeAttachmentService(URL("https://instance-name.service-now.com"))
                .getOrThrow()
                .also { this.nowAttachmentService = it }
        }
    }

Im Folgenden wird gezeigt, wie Sie einen erhalten [Rufen Sie An](https://servicenow-prod.fluidtopics.net/nprsQaf3Syo9jJ0_truSgA#CallAndroidInterface "Die Rufen Sie An Schnittstelle stellt eine Anforderung dar, die zur Verarbeitung vorbereitet wird.")Objekt, das Metadaten für bestimmte Anhänge abruft. Erstellt ein ausführbares Objekt, das die angegebene Anforderung ausführen und zurückgeben kann `Response<NowAttachmentMetadata> `.  

    suspend fun fetchMetadata(sysId: String) {
        val response = runCatching {
            sdkManager.getNowAttachmentService()?.attachmentMetadata(sysId)?.execute()
        }

        if (response.isSuccess) {
            val nowAttachmentMetadata = response.getOrNull()?.body
        } else {
            Log.e("NowSDK", "result not successful")
        }
    }

Im Folgenden wird gezeigt, wie Sie einen erhalten [Rufen Sie An](https://servicenow-prod.fluidtopics.net/nprsQaf3Syo9jJ0_truSgA#CallAndroidInterface "Die Rufen Sie An Schnittstelle stellt eine Anforderung dar, die zur Verarbeitung vorbereitet wird.")Objekt, das Metadaten für mehrere Anhänge abruft. Erstellt ein ausführbares Objekt, das die angegebene Anforderung ausführen und zurückgeben kann `Antwort< List<NowAttachmentMetadata>> `.  

    suspend fun fetchMultipleMetadata() {
        val filterQuery = "content_type=text/plain"
        val limit = 5

        val response = runCatching {
            sdkManager.getNowAttachmentService()?.attachmentMetadata(Filter(filterQuery), limit)?.execute()
        }

        if (response.isSuccess) {
            val attachmentMetadataList = response.getOrNull()?.body
        } else {
            Log.e("NowSDK", "result not successful")
        }
    }

## Paginierung der Anhangsmetadaten {#mobsdk-and-retrieve_attach_metadata__section_stt_34w_3qb}

Sie können verwenden Jetzt AttachmentService Methoden zum Herunterladen von Anhangsmetadaten für einen oder mehrere Anhänge. Wenn Sie Metadaten aus mehreren Anhängen herunterladen, können Sie verwenden [Now AttachmentService -- attachmentMetadataPaginator(Filter: Filter? = Null, Grenzwert: INT? = Null)](https://servicenow-prod.fluidtopics.net/2lnHZPGfrGVJ4~9hk8Y44A#NAttServ-attachMetadataPaginat_S_I "Ruft die Metadaten für alle Anhänge ab, die die angegebenen Kriterien erfüllen, und erstellt einen Paginator für die Iteration durch die Seiten der zurückgegebenen Metadaten.")Methode, die ein Paginierungsobjekt zurückgibt, mit dem Sie die potenziell große Datenmenge, die zurückgegeben wird, einfach iterieren können.  
Sie können dann die zurückgegebenen Metadaten mithilfe von Paginator-Methoden durchlaufen und die Antwort in erhalten Beobachten () Rückruf.

     suspend fun createAttachmentMetadataPaginator() {
      val filterQuery: String = "content_type=text/plain"
      val filter = filterQuery.let(::Filter)
      val limit = 10

      val paginator = sdkmanager.getNowAttachmentService()?.attachmentMetadataPaginator(filter, limit)
        ?.observe(object : PaginatorCallBack<NowAttachmentMetadata> {
          override fun onSuccess(response: Response<List<NowAttachmentMetadata>>) {
            // Handle response
          }

          override fun onFailure(e: NowDataError) {
            // Handle error
          }

        })
        ?: throw Exception("Response is null")

      // Use paginator operators to navigate. Example
      while (paginator.hasNext() && !paginator.isBusy()) {
        paginator.next()
      }
    }

Das zurückgegebene Paginierobjekt bietet die folgenden Methoden, mit denen Sie die zurückgegebenen Datensätze durchblättern können. Sie müssen zuerst anrufen Beobachten () Funktion zum Festlegen des Rückrufs des Paginierers.

* First()
* HasNext()
* HasPrevious
* Ist Busy
* Letzte()
* Next()
* Beobachten ()
* Zurück()
* Zurücksetzen ()

{#mobsdk-and-retrieve_attach_metadata__ul_pyb_2w3_3qb}  
Hinweis:  
Einige Paginierer Methoden können eine Ausnahme auslösen, z. B. wenn keine Seiten mehr zum Abrufen vorhanden sind.

