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

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# NowAttachmentService-Schnittstelle -- Android

# NowAttachmentService-Schnittstelle -- Android {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

Die NowAttachmentService- Schnittstelle bietet Funktionen, die die Bearbeitung von Dateianhängen und den zugehörigen Metadaten ermöglichen.
{#NowAttachServiceAndroidInterface__table_vx2_klw_5pb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| konfigurieren | [NowServiceKonfiguration](https://servicenow-prod.fluidtopics.net/WaSp8v90tmV2TQkVQvCJQw "Mit der Klasse NowServiceConfiguration können Sie die Instanz-URL ServiceNow und den Paketnamen für einen Funktionsservice konfigurieren.") | Konfiguration, die dem Service zugeordnet werden soll. |
[Tabelle : 1. Eigenschaften]

{#NowAttachServiceAndroidInterface__table_vx2_klw_5pb}

## NowAttachmentService -- Anhang (sysId: Zeichenfolge, validAttachment: Boolesch = wahr) {#ariaid-title2}

Ruft den Anhang mit der angegebenen sys_id ab und validiert den Anhang optional, indem der berechnete Hash des Anhangs mit dem erwarteten Hash verglichen wird.
{#NAttServ-attachment_S_B__table_old_sp5_4pb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| sysId | Zeichenfolge | Sys_id des abzurufenden Anhangs. Dies ist die sys_id für den Anhang in Ihrer Instanz ServiceNow. |
| validAttachment | Boolean | Kennzeichnung, die angibt, ob der Anhang validiert werden soll. Gültige Werte: * „wahr": Validiert den Anhang. * „falsch": Validiert den Anhang nicht. {#NAttServ-attachment_S_B__ul_ftq_1q5_4pb} Standardwert: true |
[Tabelle : 2. Parameter]

{#NAttServ-attachment_S_B__table_old_sp5_4pb} {#NAttServ-attachment_S_B__table_pld_sp5_4pb__entry__2}

| Typ | Beschreibung |
|-|-|
| [Rufen Sie](https://servicenow-prod.fluidtopics.net/mWDE0KhzOw1jWGfFagyo2g#CallAndroidInterface "Die Schnittstelle Anruf stellt eine Anforderung dar, die zur Verarbeitung vorbereitet wird.")\<[NowAttachment](https://servicenow-prod.fluidtopics.net/_kHLpaBmwrfq18pKeZ2HCw#NowAttachmentAndroidAPI "Die NowAttachment -Klasse stellt ein Objekt bereit, das einen Anhang und die zugehörigen Metadaten enthält.")\> auf | NowAttachment-Objekt, das den angeforderten Anhang enthält. |
[Tabelle : 3. Ergebnisse]

{#NAttServ-attachment_S_B__table_pld_sp5_4pb}  
<br />

    fun getAttachment(sysId: String, isValidateAttachment: Boolean) { 
      val call = attachmentService.attachment(sysId, isValidateAttachment) 
      call.enqueue( 
        { response -> 
          val attachment: NowAttachment? = response.body 
        }, 
          { nowDataError -> handleError(nowDataError) } 
      ) 
    }

## NowAttachmentService -- AttachmentMetadata(sysId: Zeichenfolge) {#ariaid-title3}

Ruft die Metadaten für den Anhang ab, der der angegebenen sys_id zugeordnet ist.
{#NAttServ-attachmentMetadata_S__table_bqq_1r5_4pb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| sysId | Zeichenfolge | Sys_id des Anhangs, dessen Metadaten Sie abrufen möchten. |
[Tabelle : 4. Parameter]

{#NAttServ-attachmentMetadata_S__table_bqq_1r5_4pb} {#NAttServ-attachmentMetadata_S__table_cqq_1r5_4pb__entry__2}

| Typ | Beschreibung |
|-|-|
| [Rufen Sie](https://servicenow-prod.fluidtopics.net/mWDE0KhzOw1jWGfFagyo2g#CallAndroidInterface "Die Schnittstelle Anruf stellt eine Anforderung dar, die zur Verarbeitung vorbereitet wird.")​\<[NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/umuWXEDuDxtFRzXYQNF3ZA#NowAttachmentMetadataAndroidAPI "Die Klasse NowAttachmentMetadata bietet Funktionen, mit denen Sie Anhangmetadaten codieren und verwalten können.")\> auf | Objekt, das die Metadaten für den angegebenen Anhang enthält. |
[Tabelle : 5. Ergebnisse]

{#NAttServ-attachmentMetadata_S__table_cqq_1r5_4pb}  

    fun fetchMetadata(sysId: String) { 
      val call = attachmentService.attachmentMetadata(sysId) 
      call.enqueue(
        { response -> 
          val metadata: NowAttachmentMetadata? = response.body 
        },
        { nowDataError -> handleError(nowDataError) } 
      )
    }

## NowAttachmentService -- „attachmentMetadata(filter: Filter? = null, limit: Int? = null)" {#ariaid-title4}

Ruft die Metadaten für alle Anhänge ab, die die angegebenen Kriterien erfüllen.
{#NAttServ-attachmentMetadata_S_I___table_ujt_zc1_ppb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| filter | [Filter](https://servicenow-prod.fluidtopics.net/uJnw_uNtjwzdWFd0_BAAxw#FilterAndroidAPI "Die Filterklasse bietet die Möglichkeit zum Konfigurieren von Filtern, die die Daten definieren, die in den zurückgegebenen Ergebnissen einer REST-Endpunktabfrage zurückgegeben werden sollen.") | Optional. Abfragezeichenfolge zum Filtern der Anhänge, deren Metadaten zurückgegeben werden sollen. Standard: null -- Gibt Metadaten für alle verfügbaren Anhänge zurück. Berücksichtigt den Parameter limit. |
| limit | Ganzzahl | Optional. Maximale Anzahl der zurückzugebenden Metadaten der Anhangdatei. Standard: null -- Gibt alle Metadaten zurück, die die Parameterspezifikationen für filter erfüllen. |
[Tabelle : 6. Parameter]

{#NAttServ-attachmentMetadata_S_I___table_ujt_zc1_ppb} {#NAttServ-attachmentMetadata_S_I___table_vjt_zc1_ppb__entry__2}

| Typ | Beschreibung |
|-|-|
| [Rufen Sie](https://servicenow-prod.fluidtopics.net/mWDE0KhzOw1jWGfFagyo2g#CallAndroidInterface "Die Schnittstelle Anruf stellt eine Anforderung dar, die zur Verarbeitung vorbereitet wird.")\<[Liste](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-list/)​\<[NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/umuWXEDuDxtFRzXYQNF3ZA#NowAttachmentMetadataAndroidAPI "Die Klasse NowAttachmentMetadata bietet Funktionen, mit denen Sie Anhangmetadaten codieren und verwalten können.")\>\> auf | Liste der Objekte, die die Metadaten für die übereinstimmenden Anhänge enthalten. |
[Tabelle : 7. Ergebnisse]

{#NAttServ-attachmentMetadata_S_I___table_vjt_zc1_ppb}  

    fun fetchMultipleMetadata(filterQuery: String, limit: Int) { 
      val call = attachmentService.attachmentMetadata(Filter(filterQuery), limit) 
      call.enqueue( 
        { response -> 
          val metadataList: List<NowAttachmentMetadata>? = response.body 
        },
        { nowDataError -> handleError(nowDataError) } 
      )
    }

## NowAttachmentService - AttachmentMetadataPaginator(filter: Filter? = null, limit: Int? = null) {#ariaid-title5}

Ruft die Metadaten für alle Anhänge ab, die die angegebenen Kriterien erfüllen, und erstellt einen Paginator zum Iterieren durch die Seiten der zurückgegebenen Metadaten.
Sie können diesen Paginator verwenden, um durch die zurückgegebenen Metadaten zu navigieren und Navigationsvorgänge auszuführen, z. B. das Abrufen der ersten, letzten, vorherigen oder nächsten Seite oder das Überprüfen, ob die nächste oder vorherige Seite vorhanden ist.
{#NAttServ-attachMetadataPaginat_S_I__table_npz_zf1_ppb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| filter | [Filter](https://servicenow-prod.fluidtopics.net/uJnw_uNtjwzdWFd0_BAAxw#FilterAndroidAPI "Die Filterklasse bietet die Möglichkeit zum Konfigurieren von Filtern, die die Daten definieren, die in den zurückgegebenen Ergebnissen einer REST-Endpunktabfrage zurückgegeben werden sollen.") | Optional. Abfragezeichenfolge zum Filtern der Anhänge, deren Metadaten zurückgegeben werden sollen. Standard: null -- Gibt Metadaten für alle verfügbaren Anhänge zurück. Berücksichtigt den Parameter limit. |
| limit | Ganzzahl | Optional. Maximale Anzahl der zurückzugebenden Metadaten der Anhangdatei. Standard: null -- Gibt alle Metadaten zurück, die die Parameterspezifikationen für filter erfüllen. |
[Tabelle : 8. Parameter]

{#NAttServ-attachMetadataPaginat_S_I__table_npz_zf1_ppb} {#NAttServ-attachMetadataPaginat_S_I__table_opz_zf1_ppb__entry__2}

| Typ | Beschreibung |
|-|-|
| Paginator​\<[NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/umuWXEDuDxtFRzXYQNF3ZA#NowAttachmentMetadataAndroidAPI "Die Klasse NowAttachmentMetadata bietet Funktionen, mit denen Sie Anhangmetadaten codieren und verwalten können.")\> | Erfolg: Paginator-Objekt zusammen mit den angegebenen Seiten mit Metadaten. Fehler: NowDataError-Objekt. |
[Tabelle : 9. Ergebnisse]

{#NAttServ-attachMetadataPaginat_S_I__table_opz_zf1_ppb}  
Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

    suspend fun createAttachmentMetadataPaginator() {
      val filterQuery: String = "content_type=text/plain"
      val filter = filterQuery.let(::Filter)
      val limit = 10
      val paginator = nowServiceManager.getNowAttachmentService()?.attachmentMetadataPaginator(filter, limit)
        ?.observe(object : PaginatorCallBack<NowAttachmentMetadata> {
          override fun onFailure(e: NowDataError) {
            handleError(e)
          }

          override fun onSuccess(response: Response<List<NowAttachmentMetadata>>) {
            handleResponse(response)
          }

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

## NowAttachmentService -- delete(sysId: Zeichenfolge) {#ariaid-title6}

Löscht den Anhang mit der angegebenen sys_id.
{#NAttServ-delete_S__table_dq4_dj1_ppb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| sysId | Zeichenfolge | Sys_id des zu löschenden Anhangs. |
[Tabelle : 10. Parameter]

{#NAttServ-delete_S__table_dq4_dj1_ppb} {#NAttServ-delete_S__table_eq4_dj1_ppb__entry__2}

| Typ | Beschreibung |
|-|-|
| [Rufen Sie](https://servicenow-prod.fluidtopics.net/mWDE0KhzOw1jWGfFagyo2g#CallAndroidInterface "Die Schnittstelle Anruf stellt eine Anforderung dar, die zur Verarbeitung vorbereitet wird.")\<[ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> auf | Erfolg: Es wird nichts zurückgegeben. Fehler: NowDataError zurückgegeben. |
[Tabelle : 11. Ergebnisse]

{#NAttServ-delete_S__table_eq4_dj1_ppb}  
<br />

    fun deleteAttachment(sysId: String) { 
      val call = attachmentService.delete(sysId) 
      call.enqueue( 
        { response -> handleResponse(response) }, 
        { nowDataError -> handleError(nowDataError) } 
      )
    } 

## NowAttachmentService -- Upload(Daten: ByteArray, Konfiguration: NowAttachmentUploadConfiguration) {#ariaid-title7}

Ruft die Metadaten für alle Anhänge ab, die die angegebenen Kriterien erfüllen, und erstellt einen Paginator zum Iterieren durch Seiten der zurückgegebenen Metadaten.
{#NAttServ-upload_A_O__table_fkj_3k1_ppb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Daten | [ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/) | Metadaten, die hochgeladen und dem im Konfigurationsobjekt angegebenen Anhang zugeordnet werden sollen. |
| konfigurieren | NowAttachmentUploadConfiguration | Laden Sie die Konfigurationsparameter hoch. |
[Tabelle : 12. Parameter]

{#NAttServ-upload_A_O__table_fkj_3k1_ppb} {#NAttServ-upload_A_O__table_gkj_3k1_ppb__entry__2}

| Typ | Beschreibung |
|-|-|
| [NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/umuWXEDuDxtFRzXYQNF3ZA#NowAttachmentMetadataAndroidAPI "Die Klasse NowAttachmentMetadata bietet Funktionen, mit denen Sie Anhangmetadaten codieren und verwalten können.") | Metadaten hochgeladen. |
[Tabelle : 13. Ergebnisse]

{#NAttServ-upload_A_O__table_gkj_3k1_ppb}  

    fun uploadAttachment(tableName: String, recordSysId: String, fileName: String) { 
      val bitmap = BitmapFactory.decodeResource(resources, R.drawable.test_image) 
      val data = bitmap.compress(ImageType.JPEG) 
      val contentType = "image/jpg" 
      val config = NowAttachmentUploadConfiguration(tableName, recordSysId, fileName, contentType) 
      val call = attachmentService.upload(data, config) 
     
      call.enqueue( 
        { response -> 
          val uploadedAttachmentMetadata: NowAttachmentMetadata? = response.body 
        },
        { nowDataError -> handleError(nowDataError) } 
      )
    }