---
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


---

# Now AttachmentService-Schnittstelle -- Android

# Now AttachmentService-Schnittstelle -- Android {#ariaid-title1}

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

Die Jetzt AttachmentService Die 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 | [Jetzt Servicekonfiguration](https://servicenow-prod.fluidtopics.net/WAB84mPvDb0Qp4qoJQv2OQ "Die Jetzt Servicekonfiguration Mit der Klasse können Sie konfigurieren ServiceNowInstanz-URL und Paketname für einen Funktionsservice.") | Konfiguration, die dem Service zugeordnet werden soll. |
[Tabelle : 1. Eigenschaften]

{#NowAttachServiceAndroidInterface__table_vx2_klw_5pb}

## Now AttachmentService -- attachment(sysId: Zeichenfolge, validateAttachment: Boolescher Wert = wahr) {#ariaid-title2}

Ruft den Anhang mit der angegebenen sys_ID ab und validiert optional den Anhang, 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 |
|-|-|-|
| Sys-ID | Zeichenfolge | SYS_ID des abzurufenden Anhangs. Dies ist die sys_ID für den Anhang auf Ihrem ServiceNowInstanz. |
| ValidierteAnhang | Boolean | Kennzeichnung, die angibt, ob der Anhang validiert werden soll. Gültige Werte: * Wahr: Validieren Sie den Anhang. * Falsch: Validieren Sie den Anhang nicht. {#NAttServ-attachment_S_B__ul_ftq_1q5_4pb} Standard: Wahr |
[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 An](https://servicenow-prod.fluidtopics.net/nprsQaf3Syo9jJ0_truSgA#CallAndroidInterface "Die Rufen Sie An Schnittstelle stellt eine Anforderung dar, die zur Verarbeitung vorbereitet wird.")\< [Jetzt Anhang](https://servicenow-prod.fluidtopics.net/_vyjeuC8Bu375BBo1Op3KQ#NowAttachmentAndroidAPI "Die Jetzt Anhang Klasse stellt ein Objekt bereit, das einen Anhang und die zugehörigen Metadaten enthält.")\> | Now Attachment-Objekt, das den angeforderten Anhang enthält. |
[Tabelle : 3. Rückgaben]

{#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) } 
      ) 
    }

## Now AttachmentService -- 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 |
|-|-|-|
| Sys-ID | 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 An](https://servicenow-prod.fluidtopics.net/nprsQaf3Syo9jJ0_truSgA#CallAndroidInterface "Die Rufen Sie An Schnittstelle stellt eine Anforderung dar, die zur Verarbeitung vorbereitet wird.")​\< [Now AttachmentMetadaten](https://servicenow-prod.fluidtopics.net/2JpVqEnRkDHzWc7QopSj~w#NowAttachmentMetadataAndroidAPI "Die Now AttachmentMetadaten Die Klasse bietet Funktionen, mit denen Sie Anhangsmetadaten codieren und verwalten können.")\> | Objekt, das die Metadaten für den angegebenen Anhang enthält. |
[Tabelle : 5. Rückgaben]

{#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) } 
      )
    }

## Now AttachmentService -- attachmentMetadata(Filter: Filter? = Null, Grenzwert: 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/adXauKg5I6AmQcHPDfXFdA#FilterAndroidAPI "Die Filtern Die Klasse bietet die Möglichkeit, Filter zu konfigurieren, die die Daten definieren, die in den Rückgabeergebnissen einer REST-Endpunktabfrage zurückgegeben werden sollen.") | Optional. Abfragezeichenfolge, die zum Filtern der Anhänge verwendet werden soll, deren Metadaten zurückgegeben werden sollen. Standard: Null -- gibt Metadaten für alle verfügbaren Anhänge zurück. Berücksichtigt limitParameter. |
| limit | Ganzzahl | Optional. Maximale Anzahl der zurückzugebenden Metadaten der Anhangsdatei. Standard: Null -- gibt alle Metadaten zurück, die den entsprechen filterParameterspezifikationen. |
[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 An](https://servicenow-prod.fluidtopics.net/nprsQaf3Syo9jJ0_truSgA#CallAndroidInterface "Die Rufen Sie An Schnittstelle stellt eine Anforderung dar, die zur Verarbeitung vorbereitet wird.")\< [Liste](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-list/)​\< [Now AttachmentMetadaten](https://servicenow-prod.fluidtopics.net/2JpVqEnRkDHzWc7QopSj~w#NowAttachmentMetadataAndroidAPI "Die Now AttachmentMetadaten Die Klasse bietet Funktionen, mit denen Sie Anhangsmetadaten codieren und verwalten können.")\>\> | Liste von Objekten, die die Metadaten für die übereinstimmenden Anhänge enthalten. |
[Tabelle : 7. Rückgaben]

{#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) } 
      )
    }

## Now AttachmentService -- attachmentMetadataPaginator(Filter: Filter? = Null, Grenzwert: INT? = Null) {#ariaid-title5}

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.
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 überprüfen, ob eine 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/adXauKg5I6AmQcHPDfXFdA#FilterAndroidAPI "Die Filtern Die Klasse bietet die Möglichkeit, Filter zu konfigurieren, die die Daten definieren, die in den Rückgabeergebnissen einer REST-Endpunktabfrage zurückgegeben werden sollen.") | Optional. Abfragezeichenfolge, die zum Filtern der Anhänge verwendet werden soll, deren Metadaten zurückgegeben werden sollen. Standard: Null -- gibt Metadaten für alle verfügbaren Anhänge zurück. Berücksichtigt limitParameter. |
| limit | Ganzzahl | Optional. Maximale Anzahl der zurückzugebenden Metadaten der Anhangsdatei. Standard: Null -- gibt alle Metadaten zurück, die den entsprechen filterParameterspezifikationen. |
[Tabelle : 8. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Paginierer​\< [Now AttachmentMetadaten](https://servicenow-prod.fluidtopics.net/2JpVqEnRkDHzWc7QopSj~w#NowAttachmentMetadataAndroidAPI "Die Now AttachmentMetadaten Die Klasse bietet Funktionen, mit denen Sie Anhangsmetadaten codieren und verwalten können.")\> | Erfolg: Paginierobjekt zusammen mit den angegebenen Seiten von Metadaten. Fehler: Now DataError-Objekt. |
[Tabelle : 9. Rückgaben]

{#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")
    }

## Now AttachmentService -- 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 |
|-|-|-|
| Sys-ID | 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 An](https://servicenow-prod.fluidtopics.net/nprsQaf3Syo9jJ0_truSgA#CallAndroidInterface "Die Rufen Sie An Schnittstelle stellt eine Anforderung dar, die zur Verarbeitung vorbereitet wird.")\< [ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> | Erfolg: Es wird nichts zurückgegeben. Fehler: Now DataError zurückgegeben. |
[Tabelle : 11. Rückgaben]

{#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 für die Iteration 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 | Now AttachmentUploadConfiguration | Konfigurationsparameter hochladen. |
[Tabelle : 12. Parameter]

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

| Typ | Beschreibung |
|-|-|
| [Now AttachmentMetadaten](https://servicenow-prod.fluidtopics.net/2JpVqEnRkDHzWc7QopSj~w#NowAttachmentMetadataAndroidAPI "Die Now AttachmentMetadaten Die Klasse bietet Funktionen, mit denen Sie Anhangsmetadaten codieren und verwalten können.") | Metadaten wurden hochgeladen. |
[Tabelle : 13. Rückgaben]

{#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) } 
      )
    }


