---
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 AttachmentServiceklasse: IOS

# Now AttachmentServiceklasse: IOS {#ariaid-title1}

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

Die Jetzt AttachmentService Die Klasse bietet Funktionen, mit denen Sie Anhänge hochladen und abfragen können, die Datensätzen in einer Tabelle auf zugeordnet sind ServiceNowInstanz.
Sie können mit jeder Anforderung eine einzelne Datei hochladen oder abrufen. Jetzt AttachmentService Beachtet alle Systembeschränkungen für hochgeladene Dateien, z. B. maximale Dateigröße und zulässige Anhangstypen. Sie können diese Einstellungen mithilfe der Instanzeigenschaften com.Glide.attachment.max_size, standardmäßig 1024 MB und Glide.attachment.Extensions steuern.  
Hinweis:  
Jetzt AttachmentService Akzeptiert alle Inhaltstypwerte (/). Geben Sie beim Hochladen eines Anhangs den Dateiinhaltstyp an. Der Inhaltstyp wird mit den Dateimetadaten gespeichert, sodass andere Tools die Datei korrekt identifizieren und analysieren können.
{#NowAttachmentServiceiOSAPI__table_vx2_klw_5pb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| konfigurieren | [Jetzt Servicekonfiguration](https://servicenow-prod.fluidtopics.net/m~vU6ffKznzmlhUz94FBmw#NowServiceConfigurationiOSStruct "Die Jetzt Servicekonfiguration Struktur definiert Konfigurationsinformationen für einen Funktionsservice.") | Konfigurationseinstellungen, die bei der Initialisierung des Service bereitgestellt wurden. |
[Tabelle : 1. Eigenschaften]

{#NowAttachmentServiceiOSAPI__table_vx2_klw_5pb}

## Now AttachmentService: Asynchrone Auslöse des Anhangs (für sysId: Zeichenfolge, validateAttachment: Boolescher Wert) {#ariaid-title2}

Ruft den Anhang mit der angegebenen sys_ID ab und validiert den Anhang, indem der berechnete Hash des Anhangs mit der erwarteten SHA256-Prüfsumme verglichen wird.
Hinweis:  
Die Validierung eines Anhangs kann Auswirkungen auf die Leistung haben. Sie können den Validierungsschritt überspringen, indem Sie festlegen validateAttachmentParameter bis `Falsch `. Sie können den Anhang bei Bedarf später validieren, indem Sie aufrufen Anhang.validieren() Funktion.
{#NAttServiOS-attachment-async_S_B_O__table_dqr_hmx_spb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Für sysId | Zeichenfolge | SYS_ID des abzurufenden Anhangs. |
| 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. Standard: Wahr |
[Tabelle : 2. Parameter]

{#NAttServiOS-attachment-async_S_B_O__table_dqr_hmx_spb} {#NAttServiOS-attachment-async_S_B_O__table_eqr_hmx_spb__entry__2}

| Typ | Beschreibung |
|-|-|
| Jetzt Anhang | Wird zurückgegeben, wenn die Methode erfolgreich ist. Angegebener Anhang. |
| Jetzt Datenfehler | Wird ausgelöst, wenn die Methode fehlschlägt. * `AccessToken (AccessTokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstoken-Providers. * AccessTokenRetrievalFehlgeschlagen * UserSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler auftritt. * `Anhangvalidierung` Wird ausgelöst, wenn die Validierung eines Anhangs fehlschlägt. * `BadResponse (statusCode: HTTPStatusCode)` * HTTPStatusCode: Statuscode, der von der Instanz empfangen wurde. Wird ausgelöst, wenn eine Anforderung eine unerwartete Antwort zurückgibt * `CannotDecodeModel (DecodingError)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `CannotDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ, der aus einer Zeichenfolge decodiert werden soll. * from: Zeichenfolge, die für den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Zeichenfolgenumschlossener Wert nicht aus JSON decodiert werden kann. * `CannotEncodeModel(EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `CannotParseResponse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `Ungültige URL` Wird ausgelöst, wenn eine URL nicht erstellt werden kann. Beispiel: Wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind oder eine leere Zeichenfolge ist. * `FehlingAnhangMetadata` Wird ausgelöst, wenn der Header der Metadaten des Anhangs fehlt. * `MissingServiceConfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `FehlingSysID` Wird ausgelöst, wenn ein erwarteter sys_ID-Parameter fehlt. * `Netzwerk (NetzwerkServicefehler)` * GenericError (Zeichenfolge) * Betrieb abgebrochen * Servicedeaktiviert * Serverfehler (Fehler) * Systemfehler (Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-attachment-async_S_B_O__NowDataErroriOS-ul-enum} |
[Tabelle : 3. Rückgaben]

{#NAttServiOS-attachment-async_S_B_O__table_eqr_hmx_spb}  
Die folgenden Codebeispiele zeigen, wie diese Methode aufgerufen wird.

    func downloadAttachment(sysId: String) async throws -> NowAttachment {
        do {
            let nowAttachment = try await attachmentService.attachment(for: sysId, validateAttachment: false)
            return nowAttachment
        } catch {
            // Handle NowDataError
            throw error
        }
    }

## Now AttachmentService -- Anhang(für sysId: Zeichenfolge, validateAttachment: Boolescher Wert, Abschluss: @Escaping (Result\<NowAttachment, NowDataError\>)) {#ariaid-title3}

Ruft den Anhang mit der angegebenen sys_ID ab und validiert den Anhang, indem der berechnete Hash des Anhangs mit der erwarteten SHA256-Prüfsumme verglichen wird. Nach Abschluss wird der übergebene Abschlusshandler ausgeführt.
Hinweis:  
Die Validierung eines Anhangs kann Auswirkungen auf die Leistung haben. Sie können den Validierungsschritt überspringen, indem Sie festlegen validateAttachmentParameter bis `Falsch `. Sie können den Anhang bei Bedarf später validieren, indem Sie aufrufen Anhang.validieren() Funktion.
{#NAttServiOS-attachment_S_B_O__table_dqr_hmx_spb__entry__3}{#NAttServiOS-attachment_S_B_O__mobilesdkiOS-completion_data_dataerror-row}

| Name | Typ | Beschreibung |
|-|-|-|
| Für sysId | Zeichenfolge | SYS_ID des abzurufenden Anhangs. |
| 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. {#NAttServiOS-attachment_S_B_O__ul_ftq_1q5_4pb} Standard: Wahr |
| Abschluss | @Escaping (Ergebnis​\< [Jetzt Anhang](https://servicenow-prod.fluidtopics.net/TZu2pOK70GdFnZW0aLiIWQ#NowAttachmentiOSStructure "Die Jetzt Anhang Die Struktur bietet Funktionen, mit denen Sie Anhänge validieren können, indem Sie den berechneten Hash vergleichen."), Now DataError\>) | Fertigstellungs-Handler, der ausgeführt werden soll, nachdem der Anhang abgerufen wurde. Rückgabewerte für den Abschlusshandler: * Erfolg: [Jetzt Anhang](https://servicenow-prod.fluidtopics.net/TZu2pOK70GdFnZW0aLiIWQ#NowAttachmentiOSStructure "Die Jetzt Anhang Die Struktur bietet Funktionen, mit denen Sie Anhänge validieren können, indem Sie den berechneten Hash vergleichen.")-- Angeforderter Anhang * Fehler: Now DataError * `AccessToken (AccessTokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstoken-Providers. * AccessTokenRetrievalFehlgeschlagen * UserSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler auftritt. * `Anhangvalidierung` Wird ausgelöst, wenn die Validierung eines Anhangs fehlschlägt. * `BadResponse (statusCode: HTTPStatusCode)` * HTTPStatusCode: Statuscode, der von der Instanz empfangen wurde. Wird ausgelöst, wenn eine Anforderung eine unerwartete Antwort zurückgibt * `CannotDecodeModel (DecodingError)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `CannotDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ, der aus einer Zeichenfolge decodiert werden soll. * from: Zeichenfolge, die für den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Zeichenfolgenumschlossener Wert nicht aus JSON decodiert werden kann. * `CannotEncodeModel(EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `CannotParseResponse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `Ungültige URL` Wird ausgelöst, wenn eine URL nicht erstellt werden kann. Beispiel: Wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind oder eine leere Zeichenfolge ist. * `FehlingAnhangMetadata` Wird ausgelöst, wenn der Header der Metadaten des Anhangs fehlt. * `MissingServiceConfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `FehlingSysID` Wird ausgelöst, wenn ein erwarteter sys_ID-Parameter fehlt. * `Netzwerk (NetzwerkServicefehler)` * GenericError (Zeichenfolge) * Betrieb abgebrochen * Servicedeaktiviert * Serverfehler (Fehler) * Systemfehler (Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-attachment_S_B_O__NowDataErroriOS-ul-enum} {#NAttServiOS-attachment_S_B_O__ul_uzx_thj_ppb} |
[Tabelle : 4. Parameter]

{#NAttServiOS-attachment_S_B_O__table_dqr_hmx_spb} {#NAttServiOS-attachment_S_B_O__table_eqr_hmx_spb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Rückgaben]

{#NAttServiOS-attachment_S_B_O__table_eqr_hmx_spb}  
Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

    let sysId = UUID().uuidString  // UUID for the attachment
    private func downloadAttachment(sysId: String) {
      attachmentService.attachment(for: sysId, validateAttachment: false) { (result) in
        switch result {
          case .success(let attachment):
            // Attachment retrieved successful, return attachment
          case .failure(let error):
            // Attachment retrieved failed, return NowDataError
        }
      }
    }

## Now AttachmentService -- Anhang (für sysId: Zeichenfolge, validateAttachment: Boolescher Wert) {#ariaid-title4}

Ruft den Anhang mit der angegebenen sys_ID ab und validiert den Anhang, indem der berechnete Hash des Anhangs mit dem erwarteten Hash verglichen wird.
Hinweis:  
Die Validierung eines Anhangs kann Auswirkungen auf die Leistung haben. Sie können den Validierungsschritt überspringen, indem Sie festlegen validateAttachmentParameter bis `Falsch `. Bei Bedarf können Sie den Anhang zu einem späteren Zeitpunkt validieren, indem Sie aufrufen Anhang.validieren() Funktion.  
Hinweis:  
Diese Methode ist veraltet. Sie sollten stattdessen die asynchrone/wartet-Implementierung der Methode verwenden.
{#NAttServiOS-attachment_S_B__table_w4s_d3s_spb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Für sysId | Zeichenfolge | SYS_ID des abzurufenden Anhangs. |
| 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. {#NAttServiOS-attachment_S_B__ul_ftq_1q5_4pb} Standard: Wahr |
[Tabelle : 6. Parameter]

{#NAttServiOS-attachment_S_B__table_w4s_d3s_spb} {#NAttServiOS-attachment_S_B__table_x4s_d3s_spb__entry__2}

| Typ | Beschreibung |
|-|-|
| AnyHerausgeber​\< [Jetzt Anhang](https://servicenow-prod.fluidtopics.net/TZu2pOK70GdFnZW0aLiIWQ#NowAttachmentiOSStructure "Die Jetzt Anhang Die Struktur bietet Funktionen, mit denen Sie Anhänge validieren können, indem Sie den berechneten Hash vergleichen."), Now DataError\> | Erfolg: [Jetzt Anhang](https://servicenow-prod.fluidtopics.net/TZu2pOK70GdFnZW0aLiIWQ#NowAttachmentiOSStructure "Die Jetzt Anhang Die Struktur bietet Funktionen, mit denen Sie Anhänge validieren können, indem Sie den berechneten Hash vergleichen.")-- Enthält den angegebenen Anhang. Fehler: Now DataError * `AccessToken (AccessTokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstoken-Providers. * AccessTokenRetrievalFehlgeschlagen * UserSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler auftritt. * `Anhangvalidierung` Wird ausgelöst, wenn die Validierung eines Anhangs fehlschlägt. * `BadResponse (statusCode: HTTPStatusCode)` * HTTPStatusCode: Statuscode, der von der Instanz empfangen wurde. Wird ausgelöst, wenn eine Anforderung eine unerwartete Antwort zurückgibt * `CannotDecodeModel (DecodingError)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `CannotDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ, der aus einer Zeichenfolge decodiert werden soll. * from: Zeichenfolge, die für den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Zeichenfolgenumschlossener Wert nicht aus JSON decodiert werden kann. * `CannotEncodeModel(EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `CannotParseResponse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `Ungültige URL` Wird ausgelöst, wenn eine URL nicht erstellt werden kann. Beispiel: Wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind oder eine leere Zeichenfolge ist. * `FehlingAnhangMetadata` Wird ausgelöst, wenn der Header der Metadaten des Anhangs fehlt. * `MissingServiceConfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `FehlingSysID` Wird ausgelöst, wenn ein erwarteter sys_ID-Parameter fehlt. * `Netzwerk (NetzwerkServicefehler)` * GenericError (Zeichenfolge) * Betrieb abgebrochen * Servicedeaktiviert * Serverfehler (Fehler) * Systemfehler (Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-attachment_S_B__NowDataErroriOS-ul-enum} |
[Tabelle : 7. Rückgaben]

{#NAttServiOS-attachment_S_B__table_x4s_d3s_spb}  
Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

    let sysId = UUID().uuidString  // UUID for the attachment
    private func downloadAttachment(sysId: String) {
      let publisher = self.attachmentService.attachment(for: sysId, validateAttachment: false)
      publisher
        .receive(on: DispatchQueue.main)
        .sink { [weak self] completion in
          if case let .failure(error) = completion {
            // Attachment retrieved failed, return NowDataError
          }
        } receiveValue: { [weak self] (attachment) in
          // Attachment retrieved successful, return attachment
        }
        .store(in: &subscriptions)
    }

## Now AttachmentService: AnhangMetadata(Filter: Filter, Limit: INT) asynchrone Auslöse {#ariaid-title5}

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

| Name | Typ | Beschreibung |
|-|-|-|
| Filter | [Filter](https://servicenow-prod.fluidtopics.net/GVcBqE4w1nzqT8OD3TL09g#FilteriOSStructure "Die Filtern Die Struktur 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: Nil -- 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: Nil -- gibt alle Metadaten zurück, die den entsprechen filterParameterspezifikationen. |
[Tabelle : 8. Parameter]

{#NAttServiOS-attachMeta-async_S_I_O__table_tcn_cfs_spb} {#NAttServiOS-attachMeta-async_S_I_O__table_ucn_cfs_spb__entry__2}

| Typ | Beschreibung |
|-|-|
| \[Now AttachmentMetadata\] | Wird zurückgegeben, wenn die Methode erfolgreich ist. Array, das die Metadaten für die übereinstimmenden Anhänge enthält. |
| Jetzt Datenfehler | Wird ausgelöst, wenn die Methode fehlschlägt. * `AccessToken (AccessTokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstoken-Providers. * AccessTokenRetrievalFehlgeschlagen * UserSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler auftritt. * `Anhangvalidierung` Wird ausgelöst, wenn die Validierung eines Anhangs fehlschlägt. * `BadResponse (statusCode: HTTPStatusCode)` * HTTPStatusCode: Statuscode, der von der Instanz empfangen wurde. Wird ausgelöst, wenn eine Anforderung eine unerwartete Antwort zurückgibt * `CannotDecodeModel (DecodingError)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `CannotDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ, der aus einer Zeichenfolge decodiert werden soll. * from: Zeichenfolge, die für den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Zeichenfolgenumschlossener Wert nicht aus JSON decodiert werden kann. * `CannotEncodeModel(EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `CannotParseResponse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `Ungültige URL` Wird ausgelöst, wenn eine URL nicht erstellt werden kann. Beispiel: Wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind oder eine leere Zeichenfolge ist. * `FehlingAnhangMetadata` Wird ausgelöst, wenn der Header der Metadaten des Anhangs fehlt. * `MissingServiceConfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `FehlingSysID` Wird ausgelöst, wenn ein erwarteter sys_ID-Parameter fehlt. * `Netzwerk (NetzwerkServicefehler)` * GenericError (Zeichenfolge) * Betrieb abgebrochen * Servicedeaktiviert * Serverfehler (Fehler) * Systemfehler (Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-attachMeta-async_S_I_O__NowDataErroriOS-ul-enum} |
[Tabelle : 9. Rückgaben]

{#NAttServiOS-attachMeta-async_S_I_O__table_ucn_cfs_spb}  
Die folgenden Codebeispiele zeigen, wie diese Methode aufgerufen wird.

    let filter = Filter(criteria: [], sortBy: [.desc("created")],
                 queryCategory: nil)
    do {
        let metadata = try await attachmentService.attachmentMetadata(filter: filter, limit: 10)
        // Metadata retrieval successful
    } catch {
        // Metadata retrieval failed, NowDataError thrown
    }

## NowAttachmentService -- attachmentMetadata(Filter: Filter, Grenzwert: INT, Abschluss: @Escaping (Ergebnis\<\[NowAttachmentMetadata\], NowDataError\>)) {#ariaid-title6}

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

| Name | Typ | Beschreibung |
|-|-|-|
| Filter | [Filter](https://servicenow-prod.fluidtopics.net/GVcBqE4w1nzqT8OD3TL09g#FilteriOSStructure "Die Filtern Die Struktur 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: Nil -- 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: Nil -- gibt alle Metadaten zurück, die den entsprechen filterParameterspezifikationen. |
| Abschluss | @Escaping (Ergebnis​\<\[ [Now AttachmentMetadaten](https://servicenow-prod.fluidtopics.net/63RxpF3eAmfYJ9lGlAXsPA#NowAttachmentMetadataiOSStructure "Die Now AttachmentMetadaten Die Struktur bietet Funktionen, mit denen Sie Anhangsmetadaten codieren und verwalten können.")\], Now DataError\>) | Fertigstellungs-Handler, der nach dem Abrufen der Metadaten ausgeführt werden soll. Rückgabewerte für den Abschlusshandler: * Erfolg: Now AttachmentMetadata: Objekte mit den angeforderten Metadaten. * Fehler: Now DataError * `AccessToken (AccessTokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstoken-Providers. * AccessTokenRetrievalFehlgeschlagen * UserSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler auftritt. * `Anhangvalidierung` Wird ausgelöst, wenn die Validierung eines Anhangs fehlschlägt. * `BadResponse (statusCode: HTTPStatusCode)` * HTTPStatusCode: Statuscode, der von der Instanz empfangen wurde. Wird ausgelöst, wenn eine Anforderung eine unerwartete Antwort zurückgibt * `CannotDecodeModel (DecodingError)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `CannotDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ, der aus einer Zeichenfolge decodiert werden soll. * from: Zeichenfolge, die für den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Zeichenfolgenumschlossener Wert nicht aus JSON decodiert werden kann. * `CannotEncodeModel(EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `CannotParseResponse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `Ungültige URL` Wird ausgelöst, wenn eine URL nicht erstellt werden kann. Beispiel: Wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind oder eine leere Zeichenfolge ist. * `FehlingAnhangMetadata` Wird ausgelöst, wenn der Header der Metadaten des Anhangs fehlt. * `MissingServiceConfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `FehlingSysID` Wird ausgelöst, wenn ein erwarteter sys_ID-Parameter fehlt. * `Netzwerk (NetzwerkServicefehler)` * GenericError (Zeichenfolge) * Betrieb abgebrochen * Servicedeaktiviert * Serverfehler (Fehler) * Systemfehler (Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-attachMetadata_S_I_O__NowDataErroriOS-ul-enum} {#NAttServiOS-attachMetadata_S_I_O__ul_uzx_thj_ppb} |
[Tabelle : 10. Parameter]

{#NAttServiOS-attachMetadata_S_I_O__table_tcn_cfs_spb} {#NAttServiOS-attachMetadata_S_I_O__table_ucn_cfs_spb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 11. Rückgaben]

{#NAttServiOS-attachMetadata_S_I_O__table_ucn_cfs_spb}  
Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

    let query = "active=true^short_descriptionLIKEbroken"
    let filter = Filter(query: query)
    attachmentService.attachmentMetadata(filter: filter, limit: limit) { (result) in
      DispatchQueue.main.async { [weak self] in
        switch result {
        case .success(let response):
          do {
            let data = try JSONEncoder().encode(response)
            // Retrieve metadata successfully, return data
          } catch {
            // Retrieve metadata failed, return error 
          }
        case .failure(let error):
          // Retrieve metadata failed, return NowDataError
        }	
      }
    }

## Now AttachmentService -- attachmentMetadata(Filter: Filter, Grenzwert: INT) {#ariaid-title7}

Ruft die Metadaten für alle Anhänge ab, die die angegebenen Kriterien erfüllen.
Hinweis:  
Diese Methode ist veraltet. Sie sollten stattdessen die asynchrone/wartet-Implementierung der Methode verwenden.
{#NAttServiOS-attachMetadata_S_I__table_ahv_32s_spb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Filter | [Filter](https://servicenow-prod.fluidtopics.net/GVcBqE4w1nzqT8OD3TL09g#FilteriOSStructure "Die Filtern Die Struktur 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: Nil -- 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: Nil -- gibt alle Metadaten zurück, die den entsprechen filterParameterspezifikationen. |
[Tabelle : 12. Parameter]

{#NAttServiOS-attachMetadata_S_I__table_ahv_32s_spb} {#NAttServiOS-attachMetadata_S_I__table_bhv_32s_spb__entry__2}

| Typ | Beschreibung |
|-|-|
| AnyHerausgeber​\<\[ [Now AttachmentMetadaten](https://servicenow-prod.fluidtopics.net/63RxpF3eAmfYJ9lGlAXsPA#NowAttachmentMetadataiOSStructure "Die Now AttachmentMetadaten Die Struktur bietet Funktionen, mit denen Sie Anhangsmetadaten codieren und verwalten können.")\], Now DataError\> | Erfolg: Now AttachmentMetadata: Objekte, die die Metadaten für die übereinstimmenden Anhänge enthalten. Fehler: Now DataError * `AccessToken (AccessTokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstoken-Providers. * AccessTokenRetrievalFehlgeschlagen * UserSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler auftritt. * `Anhangvalidierung` Wird ausgelöst, wenn die Validierung eines Anhangs fehlschlägt. * `BadResponse (statusCode: HTTPStatusCode)` * HTTPStatusCode: Statuscode, der von der Instanz empfangen wurde. Wird ausgelöst, wenn eine Anforderung eine unerwartete Antwort zurückgibt * `CannotDecodeModel (DecodingError)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `CannotDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ, der aus einer Zeichenfolge decodiert werden soll. * from: Zeichenfolge, die für den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Zeichenfolgenumschlossener Wert nicht aus JSON decodiert werden kann. * `CannotEncodeModel(EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `CannotParseResponse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `Ungültige URL` Wird ausgelöst, wenn eine URL nicht erstellt werden kann. Beispiel: Wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind oder eine leere Zeichenfolge ist. * `FehlingAnhangMetadata` Wird ausgelöst, wenn der Header der Metadaten des Anhangs fehlt. * `MissingServiceConfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `FehlingSysID` Wird ausgelöst, wenn ein erwarteter sys_ID-Parameter fehlt. * `Netzwerk (NetzwerkServicefehler)` * GenericError (Zeichenfolge) * Betrieb abgebrochen * Servicedeaktiviert * Serverfehler (Fehler) * Systemfehler (Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-attachMetadata_S_I__NowDataErroriOS-ul-enum} |
[Tabelle : 13. Rückgaben]

{#NAttServiOS-attachMetadata_S_I__table_bhv_32s_spb}  
Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

    let query = "active=true^short_descriptionLIKEbroken"
    let filter = Filter(query: query)
    let publisher = self.attachmentService.attachmentMetadata(filter: filter)
    publisher
      .receive(on: DispatchQueue.main)
      .encode(encoder: JSONEncoder())
      .sink { [weak self] completion in
        if case let .failure(error) = completion {
          // Retrieve metadata failed, return NowDataError
      } receiveValue: { [weak self] (data) in
         // Retrieve metadata successfully, return data
      }
    .store(in: &subscriptions

## Now AttachmentService: AnhangMetadata (für sysId: Zeichenfolge) asynchrone Auslöse {#ariaid-title8}

Ruft die Metadaten für den Anhang ab, der der angegebenen sys_ID zugeordnet ist
{#NAttServiOS-attachMeta-async_S_O__table_ldt_3hs_spb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Für sysId | Zeichenfolge | SYS_ID des Anhangs, dessen Metadaten abgerufen werden sollen. |
[Tabelle : 14. Parameter]

{#NAttServiOS-attachMeta-async_S_O__table_ldt_3hs_spb} {#NAttServiOS-attachMeta-async_S_O__table_mdt_3hs_spb__entry__2}

| Typ | Beschreibung |
|-|-|
| Now AttachmentMetadaten | Wird zurückgegeben, wenn die Methode erfolgreich ist. Metadaten für den angeforderten Anhang. |
| Jetzt Datenfehler | Wird ausgelöst, wenn die Methode fehlschlägt. * `AccessToken (AccessTokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstoken-Providers. * AccessTokenRetrievalFehlgeschlagen * UserSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler auftritt. * `Anhangvalidierung` Wird ausgelöst, wenn die Validierung eines Anhangs fehlschlägt. * `BadResponse (statusCode: HTTPStatusCode)` * HTTPStatusCode: Statuscode, der von der Instanz empfangen wurde. Wird ausgelöst, wenn eine Anforderung eine unerwartete Antwort zurückgibt * `CannotDecodeModel (DecodingError)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `CannotDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ, der aus einer Zeichenfolge decodiert werden soll. * from: Zeichenfolge, die für den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Zeichenfolgenumschlossener Wert nicht aus JSON decodiert werden kann. * `CannotEncodeModel(EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `CannotParseResponse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `Ungültige URL` Wird ausgelöst, wenn eine URL nicht erstellt werden kann. Beispiel: Wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind oder eine leere Zeichenfolge ist. * `FehlingAnhangMetadata` Wird ausgelöst, wenn der Header der Metadaten des Anhangs fehlt. * `MissingServiceConfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `FehlingSysID` Wird ausgelöst, wenn ein erwarteter sys_ID-Parameter fehlt. * `Netzwerk (NetzwerkServicefehler)` * GenericError (Zeichenfolge) * Betrieb abgebrochen * Servicedeaktiviert * Serverfehler (Fehler) * Systemfehler (Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-attachMeta-async_S_O__NowDataErroriOS-ul-enum} |
[Tabelle : 15. Rückgaben]

{#NAttServiOS-attachMeta-async_S_O__table_mdt_3hs_spb}  
Die folgenden Codebeispiele zeigen, wie diese Methode aufgerufen wird.

    do {
        let metadata = try await attachmentService.attachmentMetadata(for: sysId)
        // Metadata retrieval successful
    } catch {
        // Metadata retrieval failed, NowDataError thrown
    }

## Now AttachmentService -- attachmentMetadata (für sysId: Zeichenfolge, Abschluss: @Escaping (Result\<NowAttachmentMetadata, NowDataError\>)) {#ariaid-title9}

Ruft die Metadaten für den Anhang ab, der der angegebenen sys_ID zugeordnet ist, und führt dann den Abschlusshandler aus, nachdem die Metadaten abgerufen wurden.
{#NAttServiOS-attachMetadata_S_O__table_ldt_3hs_spb__entry__3}{#NAttServiOS-attachMetadata_S_O__mobilesdkiOS-completion_data_dataerror-row}

| Name | Typ | Beschreibung |
|-|-|-|
| Für sysId | Zeichenfolge | SYS_ID des Anhangs, dessen Metadaten abgerufen werden sollen. |
| Abschluss | @Escaping (Ergebnis​\< [Now AttachmentMetadaten](https://servicenow-prod.fluidtopics.net/63RxpF3eAmfYJ9lGlAXsPA#NowAttachmentMetadataiOSStructure "Die Now AttachmentMetadaten Die Struktur bietet Funktionen, mit denen Sie Anhangsmetadaten codieren und verwalten können."), Now DataError\>) | Fertigstellungs-Handler, der nach dem Abrufen der Metadaten ausgeführt werden soll. Rückgabewerte für den Abschlusshandler: * Erfolg: [Now AttachmentMetadaten](https://servicenow-prod.fluidtopics.net/63RxpF3eAmfYJ9lGlAXsPA#NowAttachmentMetadataiOSStructure "Die Now AttachmentMetadaten Die Struktur bietet Funktionen, mit denen Sie Anhangsmetadaten codieren und verwalten können.")-- Angeforderte Metadaten * Fehler: Now DataError * `AccessToken (AccessTokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstoken-Providers. * AccessTokenRetrievalFehlgeschlagen * UserSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler auftritt. * `Anhangvalidierung` Wird ausgelöst, wenn die Validierung eines Anhangs fehlschlägt. * `BadResponse (statusCode: HTTPStatusCode)` * HTTPStatusCode: Statuscode, der von der Instanz empfangen wurde. Wird ausgelöst, wenn eine Anforderung eine unerwartete Antwort zurückgibt * `CannotDecodeModel (DecodingError)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `CannotDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ, der aus einer Zeichenfolge decodiert werden soll. * from: Zeichenfolge, die für den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Zeichenfolgenumschlossener Wert nicht aus JSON decodiert werden kann. * `CannotEncodeModel(EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `CannotParseResponse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `Ungültige URL` Wird ausgelöst, wenn eine URL nicht erstellt werden kann. Beispiel: Wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind oder eine leere Zeichenfolge ist. * `FehlingAnhangMetadata` Wird ausgelöst, wenn der Header der Metadaten des Anhangs fehlt. * `MissingServiceConfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `FehlingSysID` Wird ausgelöst, wenn ein erwarteter sys_ID-Parameter fehlt. * `Netzwerk (NetzwerkServicefehler)` * GenericError (Zeichenfolge) * Betrieb abgebrochen * Servicedeaktiviert * Serverfehler (Fehler) * Systemfehler (Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-attachMetadata_S_O__NowDataErroriOS-ul-enum} {#NAttServiOS-attachMetadata_S_O__ul_uzx_thj_ppb} |
[Tabelle : 16. Parameter]

{#NAttServiOS-attachMetadata_S_O__table_ldt_3hs_spb} {#NAttServiOS-attachMetadata_S_O__table_mdt_3hs_spb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 17. Rückgaben]

{#NAttServiOS-attachMetadata_S_O__table_mdt_3hs_spb}  
Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

    let sysId = UUID().uuidString  // UUID for the attachment
    attachmentService.attachmentMetadata(for: sysId) { (result) in
      DispatchQueue.main.async { [weak self] in
        switch result {
          case .success(let response):
            do {
              let data = try JSONEncoder().encode(response)
              // Retrieve metadata successfully, return data
            } catch {
              // Retrieve metadata failed, return error      
            }
          case .failure(let error):
            // Retrieve metadata failed, return NowDataError
        }	
      }
    }

## Now AttachmentService -- attachmentMetadata (für sysId: Zeichenfolge) {#ariaid-title10}

Ruft die Metadaten für den Anhang ab, der der angegebenen sys_ID zugeordnet ist
Hinweis:  
Diese Methode ist veraltet. Sie sollten stattdessen die asynchrone/wartet-Implementierung der Methode verwenden.
{#NAttServiOS-attachMetadata_S__table_shc_ngs_spb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Für sysId | Zeichenfolge | SYS_ID des Anhangs, dessen Metadaten abgerufen werden sollen. |
[Tabelle : 18. Parameter]

{#NAttServiOS-attachMetadata_S__table_shc_ngs_spb} {#NAttServiOS-attachMetadata_S__table_thc_ngs_spb__entry__2}

| Typ | Beschreibung |
|-|-|
| AnyHerausgeber​\<\[ [Now AttachmentMetadaten](https://servicenow-prod.fluidtopics.net/63RxpF3eAmfYJ9lGlAXsPA#NowAttachmentMetadataiOSStructure "Die Now AttachmentMetadaten Die Struktur bietet Funktionen, mit denen Sie Anhangsmetadaten codieren und verwalten können.")\], Now DataError\> | Erfolg: Now AttachmentMetadata: Objekt, das die Metadaten für den angeforderten Anhang enthält. Fehler: Now DataError * `AccessToken (AccessTokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstoken-Providers. * AccessTokenRetrievalFehlgeschlagen * UserSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler auftritt. * `Anhangvalidierung` Wird ausgelöst, wenn die Validierung eines Anhangs fehlschlägt. * `BadResponse (statusCode: HTTPStatusCode)` * HTTPStatusCode: Statuscode, der von der Instanz empfangen wurde. Wird ausgelöst, wenn eine Anforderung eine unerwartete Antwort zurückgibt * `CannotDecodeModel (DecodingError)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `CannotDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ, der aus einer Zeichenfolge decodiert werden soll. * from: Zeichenfolge, die für den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Zeichenfolgenumschlossener Wert nicht aus JSON decodiert werden kann. * `CannotEncodeModel(EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `CannotParseResponse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `Ungültige URL` Wird ausgelöst, wenn eine URL nicht erstellt werden kann. Beispiel: Wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind oder eine leere Zeichenfolge ist. * `FehlingAnhangMetadata` Wird ausgelöst, wenn der Header der Metadaten des Anhangs fehlt. * `MissingServiceConfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `FehlingSysID` Wird ausgelöst, wenn ein erwarteter sys_ID-Parameter fehlt. * `Netzwerk (NetzwerkServicefehler)` * GenericError (Zeichenfolge) * Betrieb abgebrochen * Servicedeaktiviert * Serverfehler (Fehler) * Systemfehler (Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-attachMetadata_S__NowDataErroriOS-ul-enum} |
[Tabelle : 19. Rückgaben]

{#NAttServiOS-attachMetadata_S__table_thc_ngs_spb}  
Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

    let sysId = UUID().uuidString  // UUID for the attachment
    let publisher = self.attachmentService.attachmentMetadata(for: sysId)
    publisher
      .receive(on: DispatchQueue.main)
      .encode(encoder: JSONEncoder())
      .sink { [weak self] completion in
        if case let .failure(error) = completion {
          // Retrieve metadata failed, return NowDataError
        }
      } receiveValue: { [weak self] (data) in
         // Retrieve metadata successfully, return data
      }
    .store(in: &subscriptions)

## Now AttachmentService -- attachmentMetadataPaginator(Filter: Filter, Grenzwert: INT) {#ariaid-title11}

Ruft die Metadaten für alle Anhänge ab, die die angegebenen Kriterien erfüllen, und gibt ein Paginator-Objekt zurück, das durch die Seiten der zurückgegebenen Metadaten iteriert werden kann.
{#NAttServiOS-attachMetadataPag_S_I__table_tqh_dcs_spb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Filter | [Filter](https://servicenow-prod.fluidtopics.net/GVcBqE4w1nzqT8OD3TL09g#FilteriOSStructure "Die Filtern Die Struktur 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: Nil -- 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: Nil -- gibt alle Metadaten zurück, die den entsprechen filterParameterspezifikationen. |
[Tabelle : 20. Parameter]

{#NAttServiOS-attachMetadataPag_S_I__table_tqh_dcs_spb} {#NAttServiOS-attachMetadataPag_S_I__table_uqh_dcs_spb__entry__2}

| Typ | Beschreibung |
|-|-|
| [Paginierer](https://servicenow-prod.fluidtopics.net/fPJKWMZ80x~qhgKsMYCcOQ#PaginatorIOSAPI "Die Paginierer Die Klasse stellt Methoden für die Iteration durch einen Datensatzsatz bereit, der von einem Aufruf an zurückgegeben wird ServiceNow Tabelle API über den Now TableService. Dies ist das Objekt, das vom NowTableService zurückgegeben wird paginierer() Methoden. Rufen Sie diese Methode nicht außerhalb dieser Umgebung auf.")​\<\[ [Now AttachmentMetadaten](https://servicenow-prod.fluidtopics.net/63RxpF3eAmfYJ9lGlAXsPA#NowAttachmentMetadataiOSStructure "Die Now AttachmentMetadaten Die Struktur bietet Funktionen, mit denen Sie Anhangsmetadaten codieren und verwalten können.")\]\> | Erfolg: Array von Now AttachmentMetadata-Objekten. Fehler: Now DataError-Objekt. * `AccessToken (AccessTokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstoken-Providers. * AccessTokenRetrievalFehlgeschlagen * UserSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler auftritt. * `Anhangvalidierung` Wird ausgelöst, wenn die Validierung eines Anhangs fehlschlägt. * `BadResponse (statusCode: HTTPStatusCode)` * HTTPStatusCode: Statuscode, der von der Instanz empfangen wurde. Wird ausgelöst, wenn eine Anforderung eine unerwartete Antwort zurückgibt * `CannotDecodeModel (DecodingError)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `CannotDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ, der aus einer Zeichenfolge decodiert werden soll. * from: Zeichenfolge, die für den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Zeichenfolgenumschlossener Wert nicht aus JSON decodiert werden kann. * `CannotEncodeModel(EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `CannotParseResponse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `Ungültige URL` Wird ausgelöst, wenn eine URL nicht erstellt werden kann. Beispiel: Wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind oder eine leere Zeichenfolge ist. * `FehlingAnhangMetadata` Wird ausgelöst, wenn der Header der Metadaten des Anhangs fehlt. * `MissingServiceConfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `FehlingSysID` Wird ausgelöst, wenn ein erwarteter sys_ID-Parameter fehlt. * `Netzwerk (NetzwerkServicefehler)` * GenericError (Zeichenfolge) * Betrieb abgebrochen * Servicedeaktiviert * Serverfehler (Fehler) * Systemfehler (Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-attachMetadataPag_S_I__NowDataErroriOS-ul-enum} |
[Tabelle : 21. Rückgaben]

{#NAttServiOS-attachMetadataPag_S_I__table_uqh_dcs_spb}  
Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

    let paginator: Paginator<T> = makePaginator(query: query, fetchLimit: 1)

    func makePaginator(query: String, fetchLimit: Int?) -> Paginator<[NowAttachmentMetadata]> {
      attachmentsService.attachmentMetadataPaginator(filter: Filter(query: query), limit: fetchLimit)
    }

## Now AttachmentService -- asynchrone Auslöse (sysId: Zeichenfolge) {#ariaid-title12}

Löscht den Anhang mit der angegebenen sys_ID
{#NAttServiOS-delete-async_S_O__table_e5b_zqx_spb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Sys-ID | Zeichenfolge | SYS_ID des zu löschenden Anhangs. |
[Tabelle : 22. Parameter]

{#NAttServiOS-delete-async_S_O__table_e5b_zqx_spb} {#NAttServiOS-delete-async_S_O__table_f5b_zqx_spb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine | Es wird nichts zurückgegeben, wenn die Methode erfolgreich war. |
| Jetzt Datenfehler | Wird ausgelöst, wenn die Methode fehlschlägt. * `AccessToken (AccessTokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstoken-Providers. * AccessTokenRetrievalFehlgeschlagen * UserSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler auftritt. * `Anhangvalidierung` Wird ausgelöst, wenn die Validierung eines Anhangs fehlschlägt. * `BadResponse (statusCode: HTTPStatusCode)` * HTTPStatusCode: Statuscode, der von der Instanz empfangen wurde. Wird ausgelöst, wenn eine Anforderung eine unerwartete Antwort zurückgibt * `CannotDecodeModel (DecodingError)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `CannotDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ, der aus einer Zeichenfolge decodiert werden soll. * from: Zeichenfolge, die für den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Zeichenfolgenumschlossener Wert nicht aus JSON decodiert werden kann. * `CannotEncodeModel(EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `CannotParseResponse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `Ungültige URL` Wird ausgelöst, wenn eine URL nicht erstellt werden kann. Beispiel: Wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind oder eine leere Zeichenfolge ist. * `FehlingAnhangMetadata` Wird ausgelöst, wenn der Header der Metadaten des Anhangs fehlt. * `MissingServiceConfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `FehlingSysID` Wird ausgelöst, wenn ein erwarteter sys_ID-Parameter fehlt. * `Netzwerk (NetzwerkServicefehler)` * GenericError (Zeichenfolge) * Betrieb abgebrochen * Servicedeaktiviert * Serverfehler (Fehler) * Systemfehler (Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-delete-async_S_O__NowDataErroriOS-ul-enum} |
[Tabelle : 23. Rückgaben]

{#NAttServiOS-delete-async_S_O__table_f5b_zqx_spb}  
Die folgenden Codebeispiele zeigen, wie diese Methode aufgerufen wird.

    do {
        try await attachmentService.delete(sysId: sysId)
        // Deletion successful
    } catch {
        // Deletion failed, NowDataError thrown
    }

## Now AttachmentService -- DELETE(sysId: Zeichenfolge, Abschluss: @Escaping (Result\<Void, NowDataError\>)) {#ariaid-title13}

Löscht den Anhang mit der angegebenen sys_ID und führt dann den übergebenen Abschlusshandler aus, nachdem der Anhang gelöscht wurde.
{#NAttServiOS-delete_S_O__table_e5b_zqx_spb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Sys-ID | Zeichenfolge | SYS_ID des zu löschenden Anhangs. |
| Abschluss | @Escaping (Result\<Void, NowDataError\>) | Fertigstellungs-Handler, der ausgeführt werden soll, nachdem der Anhang gelöscht wurde. Rückgabewerte für den Abschlusshandler: * Erfolg: Ungültig * Fehler: Now DataError * `AccessToken (AccessTokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstoken-Providers. * AccessTokenRetrievalFehlgeschlagen * UserSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler auftritt. * `Anhangvalidierung` Wird ausgelöst, wenn die Validierung eines Anhangs fehlschlägt. * `BadResponse (statusCode: HTTPStatusCode)` * HTTPStatusCode: Statuscode, der von der Instanz empfangen wurde. Wird ausgelöst, wenn eine Anforderung eine unerwartete Antwort zurückgibt * `CannotDecodeModel (DecodingError)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `CannotDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ, der aus einer Zeichenfolge decodiert werden soll. * from: Zeichenfolge, die für den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Zeichenfolgenumschlossener Wert nicht aus JSON decodiert werden kann. * `CannotEncodeModel(EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `CannotParseResponse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `Ungültige URL` Wird ausgelöst, wenn eine URL nicht erstellt werden kann. Beispiel: Wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind oder eine leere Zeichenfolge ist. * `FehlingAnhangMetadata` Wird ausgelöst, wenn der Header der Metadaten des Anhangs fehlt. * `MissingServiceConfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `FehlingSysID` Wird ausgelöst, wenn ein erwarteter sys_ID-Parameter fehlt. * `Netzwerk (NetzwerkServicefehler)` * GenericError (Zeichenfolge) * Betrieb abgebrochen * Servicedeaktiviert * Serverfehler (Fehler) * Systemfehler (Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-delete_S_O__NowDataErroriOS-ul-enum} |
[Tabelle : 24. Parameter]

{#NAttServiOS-delete_S_O__table_e5b_zqx_spb} {#NAttServiOS-delete_S_O__table_f5b_zqx_spb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 25. Rückgaben]

{#NAttServiOS-delete_S_O__table_f5b_zqx_spb}  
Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

    let sysId = UUID().uuidString  // UUID for the attachment
    attachmentService.delete(sysId: sysId) { (result) in
      DispatchQueue.main.async { [weak self] in
        switch result {
          case .success:
            // Attachment with sysId is deleted
          case .failure(let error):
            // Failed to delete, with NowDataError
        }
      }
    }

## Now AttachmentService -- delete(sysId: Zeichenfolge) {#ariaid-title14}

Löscht den Anhang mit der angegebenen sys_ID
Hinweis:  
Diese Methode ist veraltet. Sie sollten stattdessen die asynchrone/wartet-Implementierung der Methode verwenden.
{#NAttServiOS-delete_S__table_svp_2qx_spb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Sys-ID | Zeichenfolge | SYS_ID des zu löschenden Anhangs. |
[Tabelle : 26. Parameter]

{#NAttServiOS-delete_S__table_svp_2qx_spb} {#NAttServiOS-delete_S__table_tvp_2qx_spb__entry__2}

| Typ | Beschreibung |
|-|-|
| AnyPublisher\<Void, NowDataError\> | Erfolg: Nichts zurückgegeben Fehler: Now DataError * `AccessToken (AccessTokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstoken-Providers. * AccessTokenRetrievalFehlgeschlagen * UserSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler auftritt. * `Anhangvalidierung` Wird ausgelöst, wenn die Validierung eines Anhangs fehlschlägt. * `BadResponse (statusCode: HTTPStatusCode)` * HTTPStatusCode: Statuscode, der von der Instanz empfangen wurde. Wird ausgelöst, wenn eine Anforderung eine unerwartete Antwort zurückgibt * `CannotDecodeModel (DecodingError)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `CannotDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ, der aus einer Zeichenfolge decodiert werden soll. * from: Zeichenfolge, die für den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Zeichenfolgenumschlossener Wert nicht aus JSON decodiert werden kann. * `CannotEncodeModel(EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `CannotParseResponse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `Ungültige URL` Wird ausgelöst, wenn eine URL nicht erstellt werden kann. Beispiel: Wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind oder eine leere Zeichenfolge ist. * `FehlingAnhangMetadata` Wird ausgelöst, wenn der Header der Metadaten des Anhangs fehlt. * `MissingServiceConfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `FehlingSysID` Wird ausgelöst, wenn ein erwarteter sys_ID-Parameter fehlt. * `Netzwerk (NetzwerkServicefehler)` * GenericError (Zeichenfolge) * Betrieb abgebrochen * Servicedeaktiviert * Serverfehler (Fehler) * Systemfehler (Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-delete_S__NowDataErroriOS-ul-enum} |
[Tabelle : 27. Rückgaben]

{#NAttServiOS-delete_S__table_tvp_2qx_spb}  
Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

    let publisher = attachmentService.delete(sysId: sysId)
    publisher
      .receive(on: DispatchQueue.main)
      .sink { [weak self] completion in
        switch completion {
          case .finished:
            // Attachment with sysId is deleted
          case .failure(let error):
           // Failed to delete, with NowDataError
       }
     } receiveValue: {
     }
     .store(in: &subscriptions)

## NowAttachmentService -- init(Konfiguration: NowServiceConfiguration, coreServiceProvider: NowCoreServiceProviding) {#ariaid-title15}

Initialisiert eine neue Now AttachmentService-Instanz.
{#NAttServiOS-init_O_O__table_hfm_ry2_tpb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| konfigurieren | [Jetzt Servicekonfiguration](https://servicenow-prod.fluidtopics.net/m~vU6ffKznzmlhUz94FBmw#NowServiceConfigurationiOSStruct "Die Jetzt Servicekonfiguration Struktur definiert Konfigurationsinformationen für einen Funktionsservice.") | Konfigurationsinformationen, die zum ordnungsgemäßen Initialisieren des Service erforderlich sind. |
| CoreServiceanbieter | Jetzt CoreServicebereitstellung | Optional. Objekt, das das NowCoreServiceProviding-Protokoll implementiert. Standard: Null |
[Tabelle : 28. Parameter]

{#NAttServiOS-init_O_O__table_hfm_ry2_tpb}  
Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

    guard let coreService = NowSDK.core() else {
      // Error with NowServiceError.sdkNotConfigured
      return
    }
    guard 
      let instanceUrl = URL(string: "http://sample.service-now.com"), 
      let serviceConfig = NowSDK.makeServiceConfiguration(for: instanceUrl) else {
        // Could not create service -- 
        // NowServiceError.serviceConfigurationInvalid
        return
    }
    let attachmentService = NowAttachmentService(configuration: serviceConfig, coreServiceProvider: coreService)

## Now AttachmentService -- asynchrone Auslöser hochladen(Daten: Daten, Konfiguration: NowAttachmentUploadConfiguration, progressUpdate: @Escaping ProgressUpdate) {#ariaid-title16}

Lädt die Anhangsdaten hoch und hängt sie an einen Datensatz in einer Tabelle an, wie in der Upload-Konfiguration angegeben.
Die Fortschrittsaktualisierung Rückruf bietet Informationen zum Upload-Fortschritt, die Sie dann verwenden können, um UI-Feedback bereitzustellen.
{#NAttServiOS-upload-async_O_O_O_O__table_n5z_mpx_spb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Daten | Daten | Hochzuladender Anhang. |
| konfigurieren | [Now AttachmentUpload-Konfiguration](https://servicenow-prod.fluidtopics.net/velwpDxQOoC9EfLwcqetjg#NowAttachUploadConfigiOSStruct "Die Now AttachmentUploadConfiguration Mit der Struktur können Sie die Konfigurationsinformationen für einen Anhang definieren, den Sie in hochladen ServiceNowInstanz.") | Konfigurationsinformationen, die die Upload-Parameter für den Anhang definieren, z. B.: * Tabelle und Datensatz, an die die Datei angehängt werden soll * Name der Anhangsdatei * Typ des Anhangs * Gibt an, ob die Datei verschlüsselt ist |
| FortschrittsUpdate | @Escape-Statusaktualisierung | Fertigstellungs-Handler, der ausgeführt werden soll, nachdem der Anhang abgerufen wurde. Dies wird mehrmals aufgerufen, bis der Upload-Prozess abgeschlossen ist. Rückgabewerte für den Abschlusshandler: Fortschrittsaktualisierung: Gibt den aktuellen Fortschritt des Uploads zurück. `FortschrittsUpdate = (_bytesWritten: Int64, _totalBytesWritten: Int64, _totalBytesExpectedToWrite: Int64) -> ungültig` |
[Tabelle : 29. Parameter]

{#NAttServiOS-upload-async_O_O_O_O__table_n5z_mpx_spb} {#NAttServiOS-upload-async_O_O_O_O__table_o5z_mpx_spb__entry__2}

| Typ | Beschreibung |
|-|-|
| Now AttachmentMetadaten | Wird zurückgegeben, wenn die Methode erfolgreich ist. Objekt, das die hochgeladenen Metadaten enthält. |
| Jetzt Datenfehler | Wird ausgelöst, wenn die Methode fehlschlägt. * `AccessToken (AccessTokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstoken-Providers. * AccessTokenRetrievalFehlgeschlagen * UserSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler auftritt. * `Anhangvalidierung` Wird ausgelöst, wenn die Validierung eines Anhangs fehlschlägt. * `BadResponse (statusCode: HTTPStatusCode)` * HTTPStatusCode: Statuscode, der von der Instanz empfangen wurde. Wird ausgelöst, wenn eine Anforderung eine unerwartete Antwort zurückgibt * `CannotDecodeModel (DecodingError)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `CannotDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ, der aus einer Zeichenfolge decodiert werden soll. * from: Zeichenfolge, die für den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Zeichenfolgenumschlossener Wert nicht aus JSON decodiert werden kann. * `CannotEncodeModel(EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `CannotParseResponse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `Ungültige URL` Wird ausgelöst, wenn eine URL nicht erstellt werden kann. Beispiel: Wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind oder eine leere Zeichenfolge ist. * `FehlingAnhangMetadata` Wird ausgelöst, wenn der Header der Metadaten des Anhangs fehlt. * `MissingServiceConfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `FehlingSysID` Wird ausgelöst, wenn ein erwarteter sys_ID-Parameter fehlt. * `Netzwerk (NetzwerkServicefehler)` * GenericError (Zeichenfolge) * Betrieb abgebrochen * Servicedeaktiviert * Serverfehler (Fehler) * Systemfehler (Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-upload-async_O_O_O_O__NowDataErroriOS-ul-enum} |
[Tabelle : 30. Rückgaben]

{#NAttServiOS-upload-async_O_O_O_O__table_o5z_mpx_spb}  
Die folgenden Codebeispiele zeigen, wie diese Methode aufgerufen wird.

    func uploadFile(for tableName: String, sysId: String, mimeType: String, encryptionContext: String?, data: Data, filename: String) async throws -> NowAttachmentMetadata { 

        let mimeType = MediaUtilities.mimeType(forFileName: filename)
        let uploadConfig = NowAttachmentUploadConfiguration(tableName: tableName, 
                                                            recordSysId: sysId,
                                                            fileName: filename,
                                                            contentType: mimeType,
                                                            encryptionContext: encryptionContext) 

        do {
            let attachmentMetadata = try await attachmentService.upload(data: data, configuration: uploadConfig) { (_, _, _) in }
            return attachmentMetadata
        } catch {
            // Handle NowDataError
            throw error
        }
    }

## Now AttachmentService -- Upload(Daten: Daten, Konfiguration: NowAttachmentUploadConfiguration, progressUpdate: @Escape-FortschrittUpdate, Abschluss: @Escape-Zeichen (Result\<NowAttachmentMetadata, NowDataError\>)) {#ariaid-title17}

Lädt die Anhangsdaten hoch und hängt sie an einen Datensatz in einer Tabelle an, wie in der Upload-Konfiguration angegeben.
Die Fortschrittsaktualisierung Rückruf bietet Informationen zum Upload-Fortschritt, die Sie dann verwenden können, um UI-Feedback bereitzustellen.
{#NAttServiOS-upload_O_O_O_O__table_n5z_mpx_spb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Daten | Daten | Hochzuladender Anhang. |
| konfigurieren | [Now AttachmentUpload-Konfiguration](https://servicenow-prod.fluidtopics.net/velwpDxQOoC9EfLwcqetjg#NowAttachUploadConfigiOSStruct "Die Now AttachmentUploadConfiguration Mit der Struktur können Sie die Konfigurationsinformationen für einen Anhang definieren, den Sie in hochladen ServiceNowInstanz.") | Konfigurationsinformationen, die die Upload-Parameter für den Anhang definieren, z. B.: * Tabelle und Datensatz, an die die Datei angehängt werden soll * Name der Anhangsdatei * Typ des Anhangs * Gibt an, ob die Datei verschlüsselt ist |
| FortschrittsUpdate | @Escape-Statusaktualisierung | Fertigstellungs-Handler, der ausgeführt werden soll, nachdem der Anhang abgerufen wurde. Dies wird mehrmals aufgerufen, bis der Upload-Prozess abgeschlossen ist. Rückgabewerte für den Abschlusshandler: Fortschrittsaktualisierung: Gibt den aktuellen Fortschritt des Uploads zurück. `FortschrittsUpdate = (_bytesWritten: Int64, _totalBytesWritten: Int64, _totalBytesExpectedToWrite: Int64) -> ungültig` |
| Abschluss | @Escaping (Ergebnis\< [Now AttachmentMetadaten](https://servicenow-prod.fluidtopics.net/63RxpF3eAmfYJ9lGlAXsPA#NowAttachmentMetadataiOSStructure "Die Now AttachmentMetadaten Die Struktur bietet Funktionen, mit denen Sie Anhangsmetadaten codieren und verwalten können."), Now DataError\>) | Fertigstellungs-Handler, der nach dem Hochladen der Metadaten ausgeführt werden soll. Rückgabewerte für den Abschlusshandler: * Erfolg: [Now AttachmentMetadaten](https://servicenow-prod.fluidtopics.net/63RxpF3eAmfYJ9lGlAXsPA#NowAttachmentMetadataiOSStructure "Die Now AttachmentMetadaten Die Struktur bietet Funktionen, mit denen Sie Anhangsmetadaten codieren und verwalten können.")-- Objekt, das die Metadaten für den hochgeladenen Anhang enthält. * Fehler: Now DataError * `AccessToken (AccessTokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstoken-Providers. * AccessTokenRetrievalFehlgeschlagen * UserSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler auftritt. * `Anhangvalidierung` Wird ausgelöst, wenn die Validierung eines Anhangs fehlschlägt. * `BadResponse (statusCode: HTTPStatusCode)` * HTTPStatusCode: Statuscode, der von der Instanz empfangen wurde. Wird ausgelöst, wenn eine Anforderung eine unerwartete Antwort zurückgibt * `CannotDecodeModel (DecodingError)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `CannotDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ, der aus einer Zeichenfolge decodiert werden soll. * from: Zeichenfolge, die für den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Zeichenfolgenumschlossener Wert nicht aus JSON decodiert werden kann. * `CannotEncodeModel(EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `CannotParseResponse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `Ungültige URL` Wird ausgelöst, wenn eine URL nicht erstellt werden kann. Beispiel: Wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind oder eine leere Zeichenfolge ist. * `FehlingAnhangMetadata` Wird ausgelöst, wenn der Header der Metadaten des Anhangs fehlt. * `MissingServiceConfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `FehlingSysID` Wird ausgelöst, wenn ein erwarteter sys_ID-Parameter fehlt. * `Netzwerk (NetzwerkServicefehler)` * GenericError (Zeichenfolge) * Betrieb abgebrochen * Servicedeaktiviert * Serverfehler (Fehler) * Systemfehler (Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-upload_O_O_O_O__NowDataErroriOS-ul-enum} |
[Tabelle : 31. Parameter]

{#NAttServiOS-upload_O_O_O_O__table_n5z_mpx_spb} {#NAttServiOS-upload_O_O_O_O__table_o5z_mpx_spb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 32. Rückgaben]

{#NAttServiOS-upload_O_O_O_O__table_o5z_mpx_spb}  
Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

    typealias ProgressUpdate = (_ bytesWritten: Int64, _ totalBytesWritten: Int64, _ totalBytesExpectedToWrite: Int64) -> Void

    let image = UIImage(named: "photo.png") 
    let data = image.pngData() 
    let recordSysId = "" // Sys_id of the record on the SN instance

    let config = NowAttachmentUploadConfiguration(
      tableName: "tableName", 
      recordSysId: recordSysId, 
      fileName: "photo.png",
      contentType: "image/png",
      encryptionContext: nil)

    private func uploadFile(
      data: Data,
      config: NowAttachmentUploadConfiguration,
      progress: @escaping ProgressUpdate) {
        attachmentService.upload(data: data, configuration: config, progressUpdate: progress) { (result) in
          DispatchQueue.main.async { [weak self] in
            switch result {
              case .success(let response)
                do {
                  let data = try JSONEncoder().encode(response)
                    // Upload file successfully, return data
                } catch
                    // Upload file decode failed, return error
                }
              case .failure(let error):
                    // Upload file failed, return NowDataError
          }
        }
      }

## Now AttachmentService -- Upload(Daten: Daten, Konfiguration: NowAttachmentUploadConfiguration, progressUpdate: @Escape-FortschrittUpdate) {#ariaid-title18}

Lädt die Anhangsdaten hoch und hängt sie an einen Datensatz in einer Tabelle an, wie in der Upload-Konfiguration angegeben.
Die Fortschrittsaktualisierung Rückruf bietet Informationen zum Upload-Fortschritt, die Sie dann verwenden können, um UI-Feedback bereitzustellen.  
Hinweis:  
Diese Methode ist veraltet. Sie sollten stattdessen die asynchrone/wartet-Implementierung der Methode verwenden.
{#NAttServiOS-upload_O_O_O__table_ptn_lnx_spb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Daten | Daten | Hochzuladender Anhang. Die Datengröße und der Typ des Anhangs, den Sie hochladen können, werden von gesteuert ServiceNowInstanz. |
| konfigurieren | [Now AttachmentUploadConfiguration](https://servicenow-prod.fluidtopics.net/velwpDxQOoC9EfLwcqetjg#NowAttachUploadConfigiOSStruct "Die Now AttachmentUploadConfiguration Mit der Struktur können Sie die Konfigurationsinformationen für einen Anhang definieren, den Sie in hochladen ServiceNowInstanz.") | Konfigurationsinformationen, die die Upload-Parameter für den Anhang definieren, z. B.: * Tabelle und Datensatz, an die die Datei angehängt werden soll * Name der Anhangsdatei * Typ des Anhangs * Gibt an, ob die Datei verschlüsselt ist |
| FortschrittsUpdate | @Escape-Statusaktualisierung | Fertigstellungs-Handler, der ausgeführt werden soll, nachdem der Anhang abgerufen wurde. Rückgabewerte für den Abschlusshandler: Fortschrittsaktualisierung: Gibt den aktuellen Fortschritt des Uploads zurück. Dies wird mehrmals aufgerufen, bis der Upload-Prozess abgeschlossen ist. `FortschrittsUpdate = (_bytesWritten: Int64, _totalBytesWritten: Int64, _totalBytesExpectedToWrite: Int64) -> ungültig` |
[Tabelle : 33. Parameter]

{#NAttServiOS-upload_O_O_O__table_ptn_lnx_spb} {#NAttServiOS-upload_O_O_O__table_qtn_lnx_spb__entry__2}

| Typ | Beschreibung |
|-|-|
| AnyHerausgeber​\< [Now AttachmentMetadaten](https://servicenow-prod.fluidtopics.net/63RxpF3eAmfYJ9lGlAXsPA#NowAttachmentMetadataiOSStructure "Die Now AttachmentMetadaten Die Struktur bietet Funktionen, mit denen Sie Anhangsmetadaten codieren und verwalten können."), Now DataError\> | Erfolg: [Now AttachmentMetadaten](https://servicenow-prod.fluidtopics.net/63RxpF3eAmfYJ9lGlAXsPA#NowAttachmentMetadataiOSStructure "Die Now AttachmentMetadaten Die Struktur bietet Funktionen, mit denen Sie Anhangsmetadaten codieren und verwalten können.")-- Objekt, das die Metadaten für den angeforderten Anhang enthält. Fehler: Now DataError * `AccessToken (AccessTokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstoken-Providers. * AccessTokenRetrievalFehlgeschlagen * UserSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler auftritt. * `Anhangvalidierung` Wird ausgelöst, wenn die Validierung eines Anhangs fehlschlägt. * `BadResponse (statusCode: HTTPStatusCode)` * HTTPStatusCode: Statuscode, der von der Instanz empfangen wurde. Wird ausgelöst, wenn eine Anforderung eine unerwartete Antwort zurückgibt * `CannotDecodeModel (DecodingError)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `CannotDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ, der aus einer Zeichenfolge decodiert werden soll. * from: Zeichenfolge, die für den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Zeichenfolgenumschlossener Wert nicht aus JSON decodiert werden kann. * `CannotEncodeModel(EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `CannotParseResponse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `Ungültige URL` Wird ausgelöst, wenn eine URL nicht erstellt werden kann. Beispiel: Wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind oder eine leere Zeichenfolge ist. * `FehlingAnhangMetadata` Wird ausgelöst, wenn der Header der Metadaten des Anhangs fehlt. * `MissingServiceConfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `FehlingSysID` Wird ausgelöst, wenn ein erwarteter sys_ID-Parameter fehlt. * `Netzwerk (NetzwerkServicefehler)` * GenericError (Zeichenfolge) * Betrieb abgebrochen * Servicedeaktiviert * Serverfehler (Fehler) * Systemfehler (Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-upload_O_O_O__NowDataErroriOS-ul-enum} |
[Tabelle : 34. Rückgaben]

{#NAttServiOS-upload_O_O_O__table_qtn_lnx_spb}  
Das folgende Codebeispiel zeigt, wie diese Funktion aufgerufen wird.

    typealias ProgressUpdate = (_ bytesWritten: Int64, _ totalBytesWritten: Int64, _ totalBytesExpectedToWrite: Int64) -> Void

    let image = UIImage(named: "photo.png") 
    let data = image.pngData() 
    let recordSysId = "" // Sys_id of the record on the SN instance
    let config = NowAttachmentUploadConfiguration(
      tableName: "tableName", 
      recordSysId: recordSysId, 
      fileName: "photo.png",
      contentType: "image/png", 
      encryptionContext: nil)

    private func uploadFile(data: Data,
      config: NowAttachmentUploadConfiguration,
      progress: @escaping ProgressUpdate) {
        let publisher = attachmentService.upload(data: data, configuration: config, progressUpdate: progress)

        publisher
          .receive(on: DispatchQueue.main)
          .encode(encoder: JSONEncoder())
          .sink { [weak self] completion in
            if case let .failure(error) = completion {
              // Upload file failed, return NowDataError
            }
          } receiveValue: { [weak self] (data) in
            // Upload file successfully, return data
          }
          .store(in: &subscriptions)
      }


