---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/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-Klasse -- iOS

# NowAttachmentService-Klasse -- iOS {#ariaid-title1}

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

Die Klasse NowAttachmentService bietet Funktionen zum Hochladen und Abfragen von Anhängen, die Datensätzen in einer Tabelle in einer Instanz ServiceNow zugeordnet sind.
Sie können mit jeder Anforderung eine einzelne Datei hochladen oder abrufen. NowAttachmentService berücksichtigt alle Systembeschränkungen für hochgeladene Dateien, z. B. maximale Dateigröße und zulässige Anhangstypen. Sie können diese Einstellungen mit den Instanzeigenschaften com.glide.attachment.max_size, standardmäßig 1024 MB und glide.attachment.extensions steuern.  
Hinweis:  
NowAttachmentService akzeptiert alle Inhaltstypwerte (/). Geben Sie den Content-Typ an, wenn Sie einen Anhang hochladen. 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 | [NowServiceKonfiguration](https://www.servicenow.com/docs/t29ejQijYiDvAZOB3b4eYQ#NowServiceConfigurationiOSStruct "Die NowServiceConfiguration- Struktur definiert Konfigurationsinformationen für einen Funktionsservice.") | Konfigurationseinstellungen, die bei der Initialisierung des Service angegeben wurden. |
[Tabelle : 1. Eigenschaften]

{#NowAttachmentServiceiOSAPI__table_vx2_klw_5pb}

## NowAttachmentService: asynchrone Würfe „attachment(for sysId: String, validAttachment: Boolesch)". {#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 den Parameter validateAttachment auf `false`setzen. Sie können den Anhang bei Bedarf zu einem späteren Zeitpunkt validieren, indem Sie die Funktion Attachment.validate() aufrufen.
{#NAttServiOS-attachment-async_S_B_O__table_dqr_hmx_spb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| für sysId | Zeichenfolge | Sys_id des abzurufenden Anhangs. |
| validAttachment | Boolean | Kennzeichnung, die angibt, ob der Anhang validiert werden soll. Gültige Werte: * „wahr": Validiert den Anhang. * „falsch": Validiert den Anhang nicht. Standardwert: true |
[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 |
|-|-|
| NowAttachment | Wird zurückgegeben, wenn die Methode erfolgreich ist. Angegebener Anhang. |
| NowDataError | Wird ausgelöst, wenn die Methode fehlschlägt. * `Zugriffstoken(ZugriffstokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstokenanbieters. * „accessTokenRetrieval" fehlgeschlagen * userSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler vorliegt. * `„attachmentValidation"` 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 * `kann nichtDecodeModell(Decodierungsfehler)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `kann nichtDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ zum Decodieren aus einer Zeichenfolge. * from: Zeichenfolge, die in den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Wert mit Zeichenfolgenumbruch nicht aus JSON decodiert werden kann. * `kann nicht EncodeModel (EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `kannAntwort nichtParse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `ungültigeURL` Wird ausgelöst, wenn eine URL nicht gebildet werden kann. Zum Beispiel, wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind, oder ob es sich um eine leere Zeichenfolge handelt. * `FehlendeAttachmentMetadata` Wird ausgelöst, wenn der Header der Anhangmetadaten fehlt. * `fehltServiceKonfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `fehltSysID` Wird ausgelöst, wenn ein erwarteter sys_id-Parameter fehlt. * `Netzwerk(NetzwerkServiceFehler)` * generischeError(Zeichenfolge) * VorgangAbgebrochen * service Deaktiviert * serverError(Fehler) * systemError(Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-attachment-async_S_B_O__NowDataErroriOS-ul-enum} |
[Tabelle : 3. Ergebnisse]

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

## NowAttachmentService -- Anhang (für sysId: Zeichenfolge, validAttachment: Boolesch, Abschluss: @escaping (Ergebnis\<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. Anschließend wird der übergebene Abschluss-Handler ausgeführt.
Hinweis:  
Die Validierung eines Anhangs kann Auswirkungen auf die Leistung haben. Sie können den Validierungsschritt überspringen, indem Sie den Parameter validateAttachment auf `false`setzen. Sie können den Anhang bei Bedarf zu einem späteren Zeitpunkt validieren, indem Sie die Funktion Attachment.validate() aufrufen.
{#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. |
| validAttachment | Boolean | Kennzeichnung, die angibt, ob der Anhang validiert werden soll. Gültige Werte: * „wahr": Validiert den Anhang. * „falsch": Validiert den Anhang nicht. {#NAttServiOS-attachment_S_B_O__ul_ftq_1q5_4pb} Standardwert: true |
| Abschluss | @escaping (Ergebnis​\<[NowAttachment](https://www.servicenow.com/docs/GGO4rxwt66b9hsIqFYOnPQ#NowAttachmentiOSStructure "Die NowAttachment- Struktur bietet Funktionen, mit denen Sie Anhänge durch Vergleich des berechneten Hashs validieren können."), NowDataError\>) | Abschluss-Handler, der nach dem Abrufen des Anhangs ausgeführt werden soll. Rückgabewerte für Abschluss-Handler: * Erfolg: [NowAttachment](https://www.servicenow.com/docs/GGO4rxwt66b9hsIqFYOnPQ#NowAttachmentiOSStructure "Die NowAttachment- Struktur bietet Funktionen, mit denen Sie Anhänge durch Vergleich des berechneten Hashs validieren können.") -- Anhang angefordert * Fehler: NowDataError * `Zugriffstoken(ZugriffstokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstokenanbieters. * „accessTokenRetrieval" fehlgeschlagen * userSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler vorliegt. * `„attachmentValidation"` 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 * `kann nichtDecodeModell(Decodierungsfehler)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `kann nichtDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ zum Decodieren aus einer Zeichenfolge. * from: Zeichenfolge, die in den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Wert mit Zeichenfolgenumbruch nicht aus JSON decodiert werden kann. * `kann nicht EncodeModel (EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `kannAntwort nichtParse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `ungültigeURL` Wird ausgelöst, wenn eine URL nicht gebildet werden kann. Zum Beispiel, wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind, oder ob es sich um eine leere Zeichenfolge handelt. * `FehlendeAttachmentMetadata` Wird ausgelöst, wenn der Header der Anhangmetadaten fehlt. * `fehltServiceKonfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `fehltSysID` Wird ausgelöst, wenn ein erwarteter sys_id-Parameter fehlt. * `Netzwerk(NetzwerkServiceFehler)` * generischeError(Zeichenfolge) * VorgangAbgebrochen * service Deaktiviert * serverError(Fehler) * systemError(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. Ergebnisse]

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

## NowAttachmentService -- Anhang (für sysId: Zeichenfolge, validAttachment: 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 den Parameter validateAttachment auf `false`setzen. Bei Bedarf können Sie den Anhang zu einem späteren Zeitpunkt validieren, indem Sie die Funktion Attachment.validate() aufrufen.  
Hinweis:  
Diese Methode ist veraltet. Sie sollten stattdessen die Implementierung der Methode „async/wait" verwenden.
{#NAttServiOS-attachment_S_B__table_w4s_d3s_spb__entry__3}

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

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

| Typ | Beschreibung |
|-|-|
| Beliebiger Herausgeber​\<[NowAttachment](https://www.servicenow.com/docs/GGO4rxwt66b9hsIqFYOnPQ#NowAttachmentiOSStructure "Die NowAttachment- Struktur bietet Funktionen, mit denen Sie Anhänge durch Vergleich des berechneten Hashs validieren können."), NowDataError\> | Erfolg: [NowAttachment](https://www.servicenow.com/docs/GGO4rxwt66b9hsIqFYOnPQ#NowAttachmentiOSStructure "Die NowAttachment- Struktur bietet Funktionen, mit denen Sie Anhänge durch Vergleich des berechneten Hashs validieren können.") -- Enthält den angegebenen Anhang. Fehler: NowDataError * `Zugriffstoken(ZugriffstokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstokenanbieters. * „accessTokenRetrieval" fehlgeschlagen * userSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler vorliegt. * `„attachmentValidation"` 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 * `kann nichtDecodeModell(Decodierungsfehler)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `kann nichtDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ zum Decodieren aus einer Zeichenfolge. * from: Zeichenfolge, die in den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Wert mit Zeichenfolgenumbruch nicht aus JSON decodiert werden kann. * `kann nicht EncodeModel (EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `kannAntwort nichtParse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `ungültigeURL` Wird ausgelöst, wenn eine URL nicht gebildet werden kann. Zum Beispiel, wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind, oder ob es sich um eine leere Zeichenfolge handelt. * `FehlendeAttachmentMetadata` Wird ausgelöst, wenn der Header der Anhangmetadaten fehlt. * `fehltServiceKonfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `fehltSysID` Wird ausgelöst, wenn ein erwarteter sys_id-Parameter fehlt. * `Netzwerk(NetzwerkServiceFehler)` * generischeError(Zeichenfolge) * VorgangAbgebrochen * service Deaktiviert * serverError(Fehler) * systemError(Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-attachment_S_B__NowDataErroriOS-ul-enum} |
[Tabelle : 7. Ergebnisse]

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

## NowAttachmentService -- asynchrone Würfe von „attachmentMetadata(filter: Filter, limit: Int)". {#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://www.servicenow.com/docs/f1oEUwQsV9034E1Nr20IIg#FilteriOSStructure "Die Filterstruktur bietet die Möglichkeit, Filter zu konfigurieren, 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: nil -- 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: nil: Gibt alle Metadaten zurück, die die Parameterspezifikationen für filter erfüllen. |
[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 |
|-|-|
| \[NowAttachmentMetadata\] | Wird zurückgegeben, wenn die Methode erfolgreich ist. Array, das die Metadaten für die übereinstimmenden Anhänge enthält. |
| NowDataError | Wird ausgelöst, wenn die Methode fehlschlägt. * `Zugriffstoken(ZugriffstokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstokenanbieters. * „accessTokenRetrieval" fehlgeschlagen * userSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler vorliegt. * `„attachmentValidation"` 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 * `kann nichtDecodeModell(Decodierungsfehler)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `kann nichtDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ zum Decodieren aus einer Zeichenfolge. * from: Zeichenfolge, die in den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Wert mit Zeichenfolgenumbruch nicht aus JSON decodiert werden kann. * `kann nicht EncodeModel (EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `kannAntwort nichtParse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `ungültigeURL` Wird ausgelöst, wenn eine URL nicht gebildet werden kann. Zum Beispiel, wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind, oder ob es sich um eine leere Zeichenfolge handelt. * `FehlendeAttachmentMetadata` Wird ausgelöst, wenn der Header der Anhangmetadaten fehlt. * `fehltServiceKonfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `fehltSysID` Wird ausgelöst, wenn ein erwarteter sys_id-Parameter fehlt. * `Netzwerk(NetzwerkServiceFehler)` * generischeError(Zeichenfolge) * VorgangAbgebrochen * service Deaktiviert * serverError(Fehler) * systemError(Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-attachMeta-async_S_I_O__NowDataErroriOS-ul-enum} |
[Tabelle : 9. Ergebnisse]

{#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, Limit: 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://www.servicenow.com/docs/f1oEUwQsV9034E1Nr20IIg#FilteriOSStructure "Die Filterstruktur bietet die Möglichkeit, Filter zu konfigurieren, 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: nil -- 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: nil: Gibt alle Metadaten zurück, die die Parameterspezifikationen für filter erfüllen. |
| Abschluss | @escaping (Ergebnis​\<\[[NowAttachmentMetadata](https://www.servicenow.com/docs/4oZu3UjoUmNsuX_1h7Jixg#NowAttachmentMetadataiOSStructure "Die NowAttachmentMetadata- Struktur bietet Funktionen, mit denen Sie Anhangmetadaten codieren und verwalten können.")\], NowDataError\>) | Abschluss-Handler, der nach dem Abrufen der Metadaten ausgeführt werden soll. Rückgabewerte für Abschluss-Handler: * Erfolg: NowAttachmentMetadata -- Objekte mit den angeforderten Metadaten. * Fehler: NowDataError * `Zugriffstoken(ZugriffstokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstokenanbieters. * „accessTokenRetrieval" fehlgeschlagen * userSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler vorliegt. * `„attachmentValidation"` 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 * `kann nichtDecodeModell(Decodierungsfehler)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `kann nichtDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ zum Decodieren aus einer Zeichenfolge. * from: Zeichenfolge, die in den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Wert mit Zeichenfolgenumbruch nicht aus JSON decodiert werden kann. * `kann nicht EncodeModel (EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `kannAntwort nichtParse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `ungültigeURL` Wird ausgelöst, wenn eine URL nicht gebildet werden kann. Zum Beispiel, wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind, oder ob es sich um eine leere Zeichenfolge handelt. * `FehlendeAttachmentMetadata` Wird ausgelöst, wenn der Header der Anhangmetadaten fehlt. * `fehltServiceKonfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `fehltSysID` Wird ausgelöst, wenn ein erwarteter sys_id-Parameter fehlt. * `Netzwerk(NetzwerkServiceFehler)` * generischeError(Zeichenfolge) * VorgangAbgebrochen * service Deaktiviert * serverError(Fehler) * systemError(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. Ergebnisse]

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

## NowAttachmentService -- Anhang Metadaten (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 Implementierung der Methode „async/wait" verwenden.
{#NAttServiOS-attachMetadata_S_I__table_ahv_32s_spb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| filter | [Filter](https://www.servicenow.com/docs/f1oEUwQsV9034E1Nr20IIg#FilteriOSStructure "Die Filterstruktur bietet die Möglichkeit, Filter zu konfigurieren, 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: nil -- 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: nil: Gibt alle Metadaten zurück, die die Parameterspezifikationen für filter erfüllen. |
[Tabelle : 12. Parameter]

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

| Typ | Beschreibung |
|-|-|
| AnyPublisher​\<\[[NowAttachmentMetadata](https://www.servicenow.com/docs/4oZu3UjoUmNsuX_1h7Jixg#NowAttachmentMetadataiOSStructure "Die NowAttachmentMetadata- Struktur bietet Funktionen, mit denen Sie Anhangmetadaten codieren und verwalten können.")\], NowDataError\> | Erfolg: NowAttachmentMetadata -- Objekte, die die Metadaten für die übereinstimmenden Anhänge enthalten. Fehler: NowDataError * `Zugriffstoken(ZugriffstokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstokenanbieters. * „accessTokenRetrieval" fehlgeschlagen * userSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler vorliegt. * `„attachmentValidation"` 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 * `kann nichtDecodeModell(Decodierungsfehler)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `kann nichtDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ zum Decodieren aus einer Zeichenfolge. * from: Zeichenfolge, die in den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Wert mit Zeichenfolgenumbruch nicht aus JSON decodiert werden kann. * `kann nicht EncodeModel (EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `kannAntwort nichtParse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `ungültigeURL` Wird ausgelöst, wenn eine URL nicht gebildet werden kann. Zum Beispiel, wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind, oder ob es sich um eine leere Zeichenfolge handelt. * `FehlendeAttachmentMetadata` Wird ausgelöst, wenn der Header der Anhangmetadaten fehlt. * `fehltServiceKonfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `fehltSysID` Wird ausgelöst, wenn ein erwarteter sys_id-Parameter fehlt. * `Netzwerk(NetzwerkServiceFehler)` * generischeError(Zeichenfolge) * VorgangAbgebrochen * service Deaktiviert * serverError(Fehler) * systemError(Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-attachMetadata_S_I__NowDataErroriOS-ul-enum} |
[Tabelle : 13. Ergebnisse]

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

## NowAttachmentService: asynchrone Würfe von „attachmentMetadata(for sysId: String)". {#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 |
|-|-|
| NowAttachmentMetadata | Wird zurückgegeben, wenn die Methode erfolgreich ist. Metadaten für den angeforderten Anhang. |
| NowDataError | Wird ausgelöst, wenn die Methode fehlschlägt. * `Zugriffstoken(ZugriffstokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstokenanbieters. * „accessTokenRetrieval" fehlgeschlagen * userSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler vorliegt. * `„attachmentValidation"` 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 * `kann nichtDecodeModell(Decodierungsfehler)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `kann nichtDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ zum Decodieren aus einer Zeichenfolge. * from: Zeichenfolge, die in den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Wert mit Zeichenfolgenumbruch nicht aus JSON decodiert werden kann. * `kann nicht EncodeModel (EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `kannAntwort nichtParse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `ungültigeURL` Wird ausgelöst, wenn eine URL nicht gebildet werden kann. Zum Beispiel, wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind, oder ob es sich um eine leere Zeichenfolge handelt. * `FehlendeAttachmentMetadata` Wird ausgelöst, wenn der Header der Anhangmetadaten fehlt. * `fehltServiceKonfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `fehltSysID` Wird ausgelöst, wenn ein erwarteter sys_id-Parameter fehlt. * `Netzwerk(NetzwerkServiceFehler)` * generischeError(Zeichenfolge) * VorgangAbgebrochen * service Deaktiviert * serverError(Fehler) * systemError(Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-attachMeta-async_S_O__NowDataErroriOS-ul-enum} |
[Tabelle : 15. Ergebnisse]

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

## NowAttachmentService - AttachmentMetadata (für sysId: Zeichenfolge, Abschluss: @escaping (Ergebnis\<NowAttachmentMetadata, NowDataError\> )) {#ariaid-title9}

Ruft die Metadaten für den Anhang ab, der der angegebenen sys_id zugeordnet ist, und führt dann den Abschluss-Handler 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​\<[NowAttachmentMetadata](https://www.servicenow.com/docs/4oZu3UjoUmNsuX_1h7Jixg#NowAttachmentMetadataiOSStructure "Die NowAttachmentMetadata- Struktur bietet Funktionen, mit denen Sie Anhangmetadaten codieren und verwalten können."), NowDataError\>) | Abschluss-Handler, der nach dem Abrufen der Metadaten ausgeführt werden soll. Rückgabewerte für den Abschluss-Handler: * Erfolg: [NowAttachmentMetadata](https://www.servicenow.com/docs/4oZu3UjoUmNsuX_1h7Jixg#NowAttachmentMetadataiOSStructure "Die NowAttachmentMetadata- Struktur bietet Funktionen, mit denen Sie Anhangmetadaten codieren und verwalten können.") -- Metadaten angefordert * Fehler: NowDataError * `Zugriffstoken(ZugriffstokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstokenanbieters. * „accessTokenRetrieval" fehlgeschlagen * userSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler vorliegt. * `„attachmentValidation"` 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 * `kann nichtDecodeModell(Decodierungsfehler)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `kann nichtDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ zum Decodieren aus einer Zeichenfolge. * from: Zeichenfolge, die in den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Wert mit Zeichenfolgenumbruch nicht aus JSON decodiert werden kann. * `kann nicht EncodeModel (EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `kannAntwort nichtParse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `ungültigeURL` Wird ausgelöst, wenn eine URL nicht gebildet werden kann. Zum Beispiel, wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind, oder ob es sich um eine leere Zeichenfolge handelt. * `FehlendeAttachmentMetadata` Wird ausgelöst, wenn der Header der Anhangmetadaten fehlt. * `fehltServiceKonfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `fehltSysID` Wird ausgelöst, wenn ein erwarteter sys_id-Parameter fehlt. * `Netzwerk(NetzwerkServiceFehler)` * generischeError(Zeichenfolge) * VorgangAbgebrochen * service Deaktiviert * serverError(Fehler) * systemError(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. Ergebnisse]

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

## NowAttachmentService -- „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 Implementierung der Methode „async/wait" 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 |
|-|-|
| AnyPublisher​\<\[[NowAttachmentMetadata](https://www.servicenow.com/docs/4oZu3UjoUmNsuX_1h7Jixg#NowAttachmentMetadataiOSStructure "Die NowAttachmentMetadata- Struktur bietet Funktionen, mit denen Sie Anhangmetadaten codieren und verwalten können.")\], NowDataError\> | Erfolg: NowAttachmentMetadata -- Objekt, das die Metadaten für den angeforderten Anhang enthält. Fehler: NowDataError * `Zugriffstoken(ZugriffstokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstokenanbieters. * „accessTokenRetrieval" fehlgeschlagen * userSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler vorliegt. * `„attachmentValidation"` 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 * `kann nichtDecodeModell(Decodierungsfehler)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `kann nichtDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ zum Decodieren aus einer Zeichenfolge. * from: Zeichenfolge, die in den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Wert mit Zeichenfolgenumbruch nicht aus JSON decodiert werden kann. * `kann nicht EncodeModel (EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `kannAntwort nichtParse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `ungültigeURL` Wird ausgelöst, wenn eine URL nicht gebildet werden kann. Zum Beispiel, wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind, oder ob es sich um eine leere Zeichenfolge handelt. * `FehlendeAttachmentMetadata` Wird ausgelöst, wenn der Header der Anhangmetadaten fehlt. * `fehltServiceKonfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `fehltSysID` Wird ausgelöst, wenn ein erwarteter sys_id-Parameter fehlt. * `Netzwerk(NetzwerkServiceFehler)` * generischeError(Zeichenfolge) * VorgangAbgebrochen * service Deaktiviert * serverError(Fehler) * systemError(Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-attachMetadata_S__NowDataErroriOS-ul-enum} |
[Tabelle : 19. Ergebnisse]

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

## NowAttachmentService -- AttachmentMetadataPaginator(filter: Filter, limit: Int) {#ariaid-title11}

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

| Name | Typ | Beschreibung |
|-|-|-|
| filter | [Filter](https://www.servicenow.com/docs/f1oEUwQsV9034E1Nr20IIg#FilteriOSStructure "Die Filterstruktur bietet die Möglichkeit, Filter zu konfigurieren, 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: nil -- 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: nil: Gibt alle Metadaten zurück, die die Parameterspezifikationen für filter erfüllen. |
[Tabelle : 20. Parameter]

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

| Typ | Beschreibung |
|-|-|
| [Paginator](https://www.servicenow.com/docs/v10kZJDc8lVmwxuiEnD1Ag#PaginatorIOSAPI "Die Klasse „Paginator“ bietet Methoden zum Durchlaufen eines Datensatzes, der durch einen Aufruf der ServiceNow Tabellen -API über NowTableService zurückgegeben wird. Es handelt sich um das Objekt, das von den NowTableService- paginator()- Methoden zurückgegeben wird. Rufen Sie diese Methode nicht außerhalb dieser Umgebung auf.")​\<\[[NowAttachmentMetadata](https://www.servicenow.com/docs/4oZu3UjoUmNsuX_1h7Jixg#NowAttachmentMetadataiOSStructure "Die NowAttachmentMetadata- Struktur bietet Funktionen, mit denen Sie Anhangmetadaten codieren und verwalten können.")\]\> | Erfolg: Array von NowAttachmentMetadata-Objekten. Fehler: NowDataError-Objekt. * `Zugriffstoken(ZugriffstokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstokenanbieters. * „accessTokenRetrieval" fehlgeschlagen * userSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler vorliegt. * `„attachmentValidation"` 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 * `kann nichtDecodeModell(Decodierungsfehler)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `kann nichtDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ zum Decodieren aus einer Zeichenfolge. * from: Zeichenfolge, die in den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Wert mit Zeichenfolgenumbruch nicht aus JSON decodiert werden kann. * `kann nicht EncodeModel (EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `kannAntwort nichtParse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `ungültigeURL` Wird ausgelöst, wenn eine URL nicht gebildet werden kann. Zum Beispiel, wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind, oder ob es sich um eine leere Zeichenfolge handelt. * `FehlendeAttachmentMetadata` Wird ausgelöst, wenn der Header der Anhangmetadaten fehlt. * `fehltServiceKonfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `fehltSysID` Wird ausgelöst, wenn ein erwarteter sys_id-Parameter fehlt. * `Netzwerk(NetzwerkServiceFehler)` * generischeError(Zeichenfolge) * VorgangAbgebrochen * service Deaktiviert * serverError(Fehler) * systemError(Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-attachMetadataPag_S_I__NowDataErroriOS-ul-enum} |
[Tabelle : 21. Ergebnisse]

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

## NowAttachmentService: asynchrone Auslösungen von delete(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 |
|-|-|-|
| sysId | 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 | Wenn die Methode erfolgreich war, wird nichts zurückgegeben. |
| NowDataError | Wird ausgelöst, wenn die Methode fehlschlägt. * `Zugriffstoken(ZugriffstokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstokenanbieters. * „accessTokenRetrieval" fehlgeschlagen * userSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler vorliegt. * `„attachmentValidation"` 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 * `kann nichtDecodeModell(Decodierungsfehler)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `kann nichtDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ zum Decodieren aus einer Zeichenfolge. * from: Zeichenfolge, die in den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Wert mit Zeichenfolgenumbruch nicht aus JSON decodiert werden kann. * `kann nicht EncodeModel (EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `kannAntwort nichtParse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `ungültigeURL` Wird ausgelöst, wenn eine URL nicht gebildet werden kann. Zum Beispiel, wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind, oder ob es sich um eine leere Zeichenfolge handelt. * `FehlendeAttachmentMetadata` Wird ausgelöst, wenn der Header der Anhangmetadaten fehlt. * `fehltServiceKonfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `fehltSysID` Wird ausgelöst, wenn ein erwarteter sys_id-Parameter fehlt. * `Netzwerk(NetzwerkServiceFehler)` * generischeError(Zeichenfolge) * VorgangAbgebrochen * service Deaktiviert * serverError(Fehler) * systemError(Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-delete-async_S_O__NowDataErroriOS-ul-enum} |
[Tabelle : 23. Ergebnisse]

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

## NowAttachmentService -- delete(sysId: Zeichenfolge, Abschluss: @escaping (Ergebnis\<Void, NowDataError\> )) {#ariaid-title13}

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

| Name | Typ | Beschreibung |
|-|-|-|
| sysId | Zeichenfolge | Sys_id des zu löschenden Anhangs. |
| Abschluss | @escaping (Ergebnis\<Void, NowDataError\> ) | Abschluss-Handler, der ausgeführt werden soll, nachdem der Anhang gelöscht wurde. Rückgabewerte für den Abschluss-Handler: * Erfolg: ungültig * Fehler: NowDataError * `Zugriffstoken(ZugriffstokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstokenanbieters. * „accessTokenRetrieval" fehlgeschlagen * userSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler vorliegt. * `„attachmentValidation"` 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 * `kann nichtDecodeModell(Decodierungsfehler)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `kann nichtDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ zum Decodieren aus einer Zeichenfolge. * from: Zeichenfolge, die in den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Wert mit Zeichenfolgenumbruch nicht aus JSON decodiert werden kann. * `kann nicht EncodeModel (EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `kannAntwort nichtParse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `ungültigeURL` Wird ausgelöst, wenn eine URL nicht gebildet werden kann. Zum Beispiel, wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind, oder ob es sich um eine leere Zeichenfolge handelt. * `FehlendeAttachmentMetadata` Wird ausgelöst, wenn der Header der Anhangmetadaten fehlt. * `fehltServiceKonfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `fehltSysID` Wird ausgelöst, wenn ein erwarteter sys_id-Parameter fehlt. * `Netzwerk(NetzwerkServiceFehler)` * generischeError(Zeichenfolge) * VorgangAbgebrochen * service Deaktiviert * serverError(Fehler) * systemError(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. Ergebnisse]

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

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

Löscht den Anhang mit der angegebenen sys_id.
Hinweis:  
Diese Methode ist veraltet. Sie sollten stattdessen die Implementierung der Methode „async/wait" verwenden.
{#NAttServiOS-delete_S__table_svp_2qx_spb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| sysId | 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 |
|-|-|
| Beliebiger Herausgeber\<Void, NowDataError\> | Erfolg: Keine Rückgabe Fehler: NowDataError * `Zugriffstoken(ZugriffstokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstokenanbieters. * „accessTokenRetrieval" fehlgeschlagen * userSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler vorliegt. * `„attachmentValidation"` 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 * `kann nichtDecodeModell(Decodierungsfehler)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `kann nichtDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ zum Decodieren aus einer Zeichenfolge. * from: Zeichenfolge, die in den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Wert mit Zeichenfolgenumbruch nicht aus JSON decodiert werden kann. * `kann nicht EncodeModel (EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `kannAntwort nichtParse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `ungültigeURL` Wird ausgelöst, wenn eine URL nicht gebildet werden kann. Zum Beispiel, wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind, oder ob es sich um eine leere Zeichenfolge handelt. * `FehlendeAttachmentMetadata` Wird ausgelöst, wenn der Header der Anhangmetadaten fehlt. * `fehltServiceKonfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `fehltSysID` Wird ausgelöst, wenn ein erwarteter sys_id-Parameter fehlt. * `Netzwerk(NetzwerkServiceFehler)` * generischeError(Zeichenfolge) * VorgangAbgebrochen * service Deaktiviert * serverError(Fehler) * systemError(Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-delete_S__NowDataErroriOS-ul-enum} |
[Tabelle : 27. Ergebnisse]

{#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(configuration: NowServiceConfiguration, coreServiceProvider: NowCoreServiceProvider) {#ariaid-title15}

Initialisiert eine neue NowAttachmentService-Instanz.
{#NAttServiOS-init_O_O__table_hfm_ry2_tpb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| konfigurieren | [NowServiceKonfiguration](https://www.servicenow.com/docs/t29ejQijYiDvAZOB3b4eYQ#NowServiceConfigurationiOSStruct "Die NowServiceConfiguration- Struktur definiert Konfigurationsinformationen für einen Funktionsservice.") | Konfigurationsinformationen, die zum ordnungsgemäßen Initialisieren des Service erforderlich sind. |
| coreServiceProvider | NowCoreServicebereitstellung | Optional. Objekt, das das NowCoreServiceProvidering-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)

## NowAttachmentService: asynchrone Auslösungen für „upload(data: Data, Configuration: NowAttachmentUploadConfiguration, ProgressUpdate: @escaping ProgressUpdate)" {#ariaid-title16}

Lädt die Anhangdaten hoch und hängt sie an einen Datensatz in einer Tabelle an, wie in der Upload-Konfiguration angegeben.
Der ProgressUpdate -Rückruf enthält Informationen zum Upload-Fortschritt, die Sie dann verwenden können, um UI-Feedback zu geben.
{#NAttServiOS-upload-async_O_O_O_O__table_n5z_mpx_spb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Daten | Daten | Hochzuladender Anhang. |
| konfigurieren | [NowAttachmentUpload-Konfiguration](https://www.servicenow.com/docs/71jnP5NfAgDF7EglScKPLA#NowAttachUploadConfigiOSStruct "Mit der Struktur NowAttachmentUploadConfiguration können Sie die Konfigurationsinformationen für einen Anhang definieren, den Sie in die Instanz ServiceNow hochladen.") | Konfigurationsinformationen, die die Upload-Parameter für den Anhang definieren, z. B.: * Tabelle und Datensatz, an die die Datei angehängt werden soll * Dateiname des Anhangs * Typ des Anhangs * Gibt an, ob die Datei verschlüsselt ist |
| ProgressUpdate | @escaping ProgressUpdate | Abschluss-Handler, der nach dem Abrufen des Anhangs ausgeführt werden soll. Dies wird mehrmals aufgerufen, bis der Upload-Prozess abgeschlossen ist. Rückgabewerte für den Abschluss-Handler: ProgressUpdate: Gibt den aktuellen Fortschritt des Uploads zurück. `ProgressUpdate = (_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 |
|-|-|
| NowAttachmentMetadata | Wird zurückgegeben, wenn die Methode erfolgreich ist. Objekt, das die hochgeladenen Metadaten enthält. |
| NowDataError | Wird ausgelöst, wenn die Methode fehlschlägt. * `Zugriffstoken(ZugriffstokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstokenanbieters. * „accessTokenRetrieval" fehlgeschlagen * userSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler vorliegt. * `„attachmentValidation"` 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 * `kann nichtDecodeModell(Decodierungsfehler)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `kann nichtDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ zum Decodieren aus einer Zeichenfolge. * from: Zeichenfolge, die in den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Wert mit Zeichenfolgenumbruch nicht aus JSON decodiert werden kann. * `kann nicht EncodeModel (EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `kannAntwort nichtParse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `ungültigeURL` Wird ausgelöst, wenn eine URL nicht gebildet werden kann. Zum Beispiel, wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind, oder ob es sich um eine leere Zeichenfolge handelt. * `FehlendeAttachmentMetadata` Wird ausgelöst, wenn der Header der Anhangmetadaten fehlt. * `fehltServiceKonfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `fehltSysID` Wird ausgelöst, wenn ein erwarteter sys_id-Parameter fehlt. * `Netzwerk(NetzwerkServiceFehler)` * generischeError(Zeichenfolge) * VorgangAbgebrochen * service Deaktiviert * serverError(Fehler) * systemError(Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-upload-async_O_O_O_O__NowDataErroriOS-ul-enum} |
[Tabelle : 30. Ergebnisse]

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

## NowAttachmentService - Upload(Daten: Daten, Konfiguration: NowAttachmentUploadConfiguration, ProgressUpdate: @escaping ProgressUpdate, Abschluss: @escaping (Ergebnis\<NowAttachmentMetadata, NowDataError\> )) {#ariaid-title17}

Lädt die Anhangdaten hoch und hängt sie an einen Datensatz in einer Tabelle an, wie in der Upload-Konfiguration angegeben.
Der ProgressUpdate -Rückruf enthält Informationen zum Upload-Fortschritt, die Sie dann verwenden können, um UI-Feedback zu geben.
{#NAttServiOS-upload_O_O_O_O__table_n5z_mpx_spb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Daten | Daten | Hochzuladender Anhang. |
| konfigurieren | [NowAttachmentUpload-Konfiguration](https://www.servicenow.com/docs/71jnP5NfAgDF7EglScKPLA#NowAttachUploadConfigiOSStruct "Mit der Struktur NowAttachmentUploadConfiguration können Sie die Konfigurationsinformationen für einen Anhang definieren, den Sie in die Instanz ServiceNow hochladen.") | Konfigurationsinformationen, die die Upload-Parameter für den Anhang definieren, z. B.: * Tabelle und Datensatz, an die die Datei angehängt werden soll * Dateiname des Anhangs * Typ des Anhangs * Gibt an, ob die Datei verschlüsselt ist |
| ProgressUpdate | @escaping ProgressUpdate | Abschluss-Handler, der nach dem Abrufen des Anhangs ausgeführt werden soll. Dies wird mehrmals aufgerufen, bis der Upload-Prozess abgeschlossen ist. Rückgabewerte für Abschluss-Handler: ProgressUpdate: Gibt den aktuellen Fortschritt des Uploads zurück. `ProgressUpdate = (_bytesWritten: Int64, _totalBytesWritten: Int64, _totalBytesExpectedToWrite: Int64) -> Ungültig` |
| Abschluss | @escaping (Ergebnis\<[NowAttachmentMetadata](https://www.servicenow.com/docs/4oZu3UjoUmNsuX_1h7Jixg#NowAttachmentMetadataiOSStructure "Die NowAttachmentMetadata- Struktur bietet Funktionen, mit denen Sie Anhangmetadaten codieren und verwalten können."), NowDataError\>) | Abschluss-Handler, der nach dem Hochladen der Metadaten ausgeführt werden soll. Rückgabewerte für Abschluss-Handler: * Erfolg: [NowAttachmentMetadata](https://www.servicenow.com/docs/4oZu3UjoUmNsuX_1h7Jixg#NowAttachmentMetadataiOSStructure "Die NowAttachmentMetadata- Struktur bietet Funktionen, mit denen Sie Anhangmetadaten codieren und verwalten können.") -- Objekt mit den Metadaten für den hochgeladenen Anhang. * Fehler: NowDataError * `Zugriffstoken(ZugriffstokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstokenanbieters. * „accessTokenRetrieval" fehlgeschlagen * userSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler vorliegt. * `„attachmentValidation"` 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 * `kann nichtDecodeModell(Decodierungsfehler)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `kann nichtDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ zum Decodieren aus einer Zeichenfolge. * from: Zeichenfolge, die in den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Wert mit Zeichenfolgenumbruch nicht aus JSON decodiert werden kann. * `kann nicht EncodeModel (EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `kannAntwort nichtParse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `ungültigeURL` Wird ausgelöst, wenn eine URL nicht gebildet werden kann. Zum Beispiel, wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind, oder ob es sich um eine leere Zeichenfolge handelt. * `FehlendeAttachmentMetadata` Wird ausgelöst, wenn der Header der Anhangmetadaten fehlt. * `fehltServiceKonfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `fehltSysID` Wird ausgelöst, wenn ein erwarteter sys_id-Parameter fehlt. * `Netzwerk(NetzwerkServiceFehler)` * generischeError(Zeichenfolge) * VorgangAbgebrochen * service Deaktiviert * serverError(Fehler) * systemError(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. Ergebnisse]

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

## NowAttachmentService -- Upload(Daten: Daten, Konfiguration: NowAttachmentUploadConfiguration, ProgressUpdate: @escaping ProgressUpdate) {#ariaid-title18}

Lädt die Anhangdaten hoch und hängt sie an einen Datensatz in einer Tabelle an, wie in der Upload-Konfiguration angegeben.
Der ProgressUpdate -Rückruf enthält Informationen zum Upload-Fortschritt, die Sie dann verwenden können, um UI-Feedback zu geben.  
Hinweis:  
Diese Methode ist veraltet. Sie sollten stattdessen die Implementierung der Methode „async/wait" 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 Ihrer Instanz ServiceNow gesteuert. |
| konfigurieren | [NowAttachmentUploadConfiguration](https://www.servicenow.com/docs/71jnP5NfAgDF7EglScKPLA#NowAttachUploadConfigiOSStruct "Mit der Struktur NowAttachmentUploadConfiguration können Sie die Konfigurationsinformationen für einen Anhang definieren, den Sie in die Instanz ServiceNow hochladen.") | Konfigurationsinformationen, die die Upload-Parameter für den Anhang definieren, z. B.: * Tabelle und Datensatz, an die die Datei angehängt werden soll * Dateiname des Anhangs * Typ des Anhangs * Gibt an, ob die Datei verschlüsselt ist |
| ProgressUpdate | @escaping ProgressUpdate | Abschluss-Handler, der nach dem Abrufen des Anhangs ausgeführt werden soll. Rückgabewerte für den Abschluss-Handler: ProgressUpdate: Gibt den aktuellen Fortschritt des Uploads zurück. Dies wird mehrmals aufgerufen, bis der Upload-Prozess abgeschlossen ist. `ProgressUpdate = (_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 |
|-|-|
| Beliebiger Herausgeber​\<[NowAttachmentMetadata](https://www.servicenow.com/docs/4oZu3UjoUmNsuX_1h7Jixg#NowAttachmentMetadataiOSStructure "Die NowAttachmentMetadata- Struktur bietet Funktionen, mit denen Sie Anhangmetadaten codieren und verwalten können."), NowDataError\> | Erfolg: [NowAttachmentMetadata](https://www.servicenow.com/docs/4oZu3UjoUmNsuX_1h7Jixg#NowAttachmentMetadataiOSStructure "Die NowAttachmentMetadata- Struktur bietet Funktionen, mit denen Sie Anhangmetadaten codieren und verwalten können.") -- Objekt, das die Metadaten für den angeforderten Anhang enthält. Fehler: NowDataError * `Zugriffstoken(ZugriffstokenProviderError)` * AccessTokenProviderError: Fehlercode oder Meldung des Zugriffstokenanbieters. * „accessTokenRetrieval" fehlgeschlagen * userSessionError(_ Fehler: Fehler) Wird ausgelöst, wenn im Zugriffstoken ein Fehler vorliegt. * `„attachmentValidation"` 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 * `kann nichtDecodeModell(Decodierungsfehler)` * DecodingError: Decodierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht aus JSON decodiert werden kann. * `kann nichtDecodeProperty(Typ: Beliebig, von: Zeichenfolge)` * type: Umschlossener Typ zum Decodieren aus einer Zeichenfolge. * from: Zeichenfolge, die in den angegebenen Typ decodiert werden soll. Wird ausgelöst, wenn ein Wert mit Zeichenfolgenumbruch nicht aus JSON decodiert werden kann. * `kann nicht EncodeModel (EncodingError)` * EncodingError: Codierungsfehler erkannt. Wird ausgelöst, wenn ein codierbares Modell nicht in JSON codiert werden kann. * `kannAntwort nichtParse` Wird ausgelöst, wenn eine Antwort von der Instanz nicht im erwarteten Format analysiert werden kann. * `ungültigeURL` Wird ausgelöst, wenn eine URL nicht gebildet werden kann. Zum Beispiel, wenn die Zeichenfolge Zeichen enthält, die in einer URL unzulässig sind, oder ob es sich um eine leere Zeichenfolge handelt. * `FehlendeAttachmentMetadata` Wird ausgelöst, wenn der Header der Anhangmetadaten fehlt. * `fehltServiceKonfiguration` Wird ausgelöst, wenn eine erwartete Servicekonfiguration fehlt. * `fehltSysID` Wird ausgelöst, wenn ein erwarteter sys_id-Parameter fehlt. * `Netzwerk(NetzwerkServiceFehler)` * generischeError(Zeichenfolge) * VorgangAbgebrochen * service Deaktiviert * serverError(Fehler) * systemError(Fehler) Wird ausgelöst, wenn bei einem Netzwerkservice ein Fehler aufgetreten ist. {#NAttServiOS-upload_O_O_O__NowDataErroriOS-ul-enum} |
[Tabelle : 34. Ergebnisse]

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