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


---

# cabrillo.Anhänge -- Client

# cabrillo.Anhänge -- Client {#ariaid-title1}

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

Der Namensbereich für Cabrillo JSAnhangfunktionen. Dies ermöglicht das Hinzufügen und Anzeigen von Anhängen.

## cabrillo.Attachments -- addFile(Zeichenfolge tableName, Zeichenfolge sysId, Objektparameter, Zeichenfolgenoptionen) {#ariaid-title2}

Zeigt eine Dokumentauswahl an und lädt die ausgewählte Datei hoch.
Wichtig:  
Diese Methode ist veraltet. Verwenden Sie [AddFiles()](https://servicenow-prod.fluidtopics.net/RUO6y8rF8jVQBaSBfevmhA#CA-addFiles_S_S_O_S "Zeigt eine Dokumentauswahl zum Auswählen und Hochladen von Dateien an.")Stattdessen Methode.
{#CA-addFile_S_S_O_S__table_yt5_3qw_2bb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| tableName | Zeichenfolge | Tabellenname des Datensatzes, an den der Anhang angehängt werden soll. |
| sysID | Zeichenfolge | Die sys_ID des Datensatzes, an den der Anhang angehängt werden soll. |
| params | Objekt | Nicht Verwendet. Auf Null festlegen. |
| Optionen | Zeichenfolge | Nicht Verwendet. Auf Null festlegen. |
[Tabelle : 1. Parameter]

{#CA-addFile_S_S_O_S__table_yt5_3qw_2bb} {#CA-addFile_S_S_O_S__table_zt5_3qw_2bb__entry__2}

| Typ | Beschreibung |
|-|-|
| Versprechen | Bei Erfolg ein Objekt „Cabrillo.Attachment". Wenn der Vorgang fehlschlägt, ist ein Fehler aufgetreten. |
[Tabelle : 2. Rückgaben]

{#CA-addFile_S_S_O_S__table_zt5_3qw_2bb}  

    var table = 'incident';
    var sysID = 'a9e30c7dc61122760116894de7bcc7bd';

    cabrillo.attachments.addFile(table,
        sysID, 
        null,
        null
    ).then(function(attachment) {
        if (attachment) {
            console.log('Added a new file.', attachment);
        } else {
            console.log('User cancelled adding an attachment.');
        }
    }, function(error) {
        console.log('Failed to attach new file.', error);
    });

## cabrillo.Attachments -- addFiles(Zeichenfolge tableName, Zeichenfolge sysId, Objektparameter, Objektoptionen) {#ariaid-title3}

Zeigt eine Dokumentauswahl zum Auswählen und Hochladen von Dateien an.
{#CA-addFiles_S_S_O_S__table_yt5_3qw_2bb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| tableName | Zeichenfolge | Name der Tabelle, die den Datensatz enthält, an den die Datei angehängt werden soll. |
| sysID | Zeichenfolge | SYS_ID des Datensatzes, an den die Datei angehängt werden soll. |
| params | Objekt | Optional. Für zukünftige Verwendung reserviert. Auf Null festlegen. |
| Optionen | Objekt | Optional. Zusätzliche Einstellungen zum Hochladen von Dateien. { "isSingleSelection": Boolean } |
| Optionen.isEinzelAuswahl | Boolean | Optional. Kennzeichnung, die angibt, ob die Dokumentauswahl zum Hochladen von Dateien die Mehrfachauswahl zulässt. Gültige Werte: * Wahr: Es kann jeweils nur eine Datei zum Hochladen ausgewählt werden. * Falsch: Mehrere hochzuladende Dateien können gleichzeitig ausgewählt werden. {#CA-addFiles_S_S_O_S__ul_nkl_n4f_xwb} Standard: Falsch |
[Tabelle : 3. Parameter]

{#CA-addFiles_S_S_O_S__table_yt5_3qw_2bb} {#CA-addFiles_S_S_O_S__table_wgq_ynf_xwb__entry__2}

| Typ | Beschreibung |
|-|-|
| Versprechen | Enthält alle erfolgreich erstellten Anhänge und alle Fehler. Wenn mehrere Dateien ausgewählt wurden, wird für jede erfolgreich hochgeladene Datei ein Cabrillo.Anhang erstellt, während für jeden nicht erfolgreichen Upload eine Fehlermeldung generiert wird. Datentyp: Objekt { "attachments": [Array], "errors": [Array] } |
| Zusage.Anhänge | Enthält alle erfolgreich erstellten Anhänge. Datentyp: Array "attachments": [Cabrillo.Attachment] |
| Zusage.Fehler | Enthält alle Fehler. Datentyp: Array "errors": ["String"] |
[Tabelle : 4. Rückgaben]

{#CA-addFiles_S_S_O_S__table_wgq_ynf_xwb}  
Dieses Beispiel erstellt eine Schaltfläche zum Hinzufügen mehrerer Anhänge zu einem Incident-Datensatz und überprüft auf Upload-Fehler.

    this.attachMultipleFilesButton = function() {
       c.log("Attempting to add multiple attachments to INC0010453");
       var table = 'incident';
       var sysID = 'fc74aefa1bfb2c10181499f1b24bcb3c';

       cabrillo.attachments.addFiles(table, sysID).then(function(result) {
          if (result) {
             handleMultipleResult(result)
          } else {
             c.log('User cancelled adding an attachment.');
          }
       }, function(error) {
          c.log('Failed to attach new files.', error);
       });
    }

    // A helper function to handle addFiles results 
    function handleMultipleResult(result) {
       c.log('Added multiple attachments.', result);
       if (result.attachments) {
          c.log('Number of new attachments', result.attachments.length);
       }
       if (result.errors) {
          c.log('Number of errors during upload', result.errors.length);
       }
    }

## cabrillo.Anhänge -- Datei anzeigen (Cabrillo.Anhang, Cabrillo.Rect Source Rect, ZeichenfolgenquelleBase64Image) {#ariaid-title4}

Zeigt eine Dokumentauswahl an und lädt die ausgewählte Datei hoch.
Hinweis:  
Die Skalierung mit einem sourceRect-Parameter mit einem sourceBase64-Image wird nur unter iOS unterstützt. Android ignoriert diese Parameter und öffnet das Bild ohne Skalierungsanimation.
{#CA-viewFile_CA_CR_S__table_wvb_ybf_wbb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Anhang | Cabrillo.Anhang | Beschreibt den anzuzeigenden Anhang. |
| QuellenRect | Cabrillo.Rect | Optional. Beschreibt das Quellrechteck des Bildes, das nach oben skaliert werden soll. |
| SourceBase64Image | Zeichenfolge | Optional. Eine base64-Darstellung des Quellbilds, das hochskaliert werden soll. |
[Tabelle : 5. Parameter]

{#CA-viewFile_CA_CR_S__table_wvb_ybf_wbb} {#CA-viewFile_CA_CR_S__table_xvb_ybf_wbb__entry__2}

| Typ | Beschreibung |
|-|-|
| Versprechen | Bei Erfolg ein ungelöstes Objekt, andernfalls ein Fehler. |
[Tabelle : 6. Rückgaben]

{#CA-viewFile_CA_CR_S__table_xvb_ybf_wbb}  

    // A Cabrillo.Attachment dictionary to view
    var attachment = {
        sys_id: '8e99daa3ff133100ba13ffffffffff2d',
        content_type: 'image/jpeg',
        path: '8e99daa3ff133100ba13ffffffffff2d.iix'
    };

    cabrillo.attachments.viewFile(attachment,
        null,
        null
    ).then(function() {
        // It worked. Nothing to do here.
    }, function(error) {
        console.log('Failed to view file.', error);
    });

Um ein Bild zu skalieren, das in einen nativen Bildbetrachter angetippt wurde Datei anzeigen() Die Methode akzeptiert optionale Argumente für das Rechteck des Bilds auf der Seite sowie eine base64-codierte Miniaturansicht des Bilds. Die Miniaturansicht wird mit einer Animation auf das Bild in voller Größe skaliert.

    // Grab image metadata from an image that was tapped
    var imageMetadata = imageMetadataFromEvent(event);

    // Optional rect of image on page
    var imageRect = imageMetadata.rect;

    // Optional base64 encoded image to scale up into native viewer
    var base64EncodedImage = imageMetadata.base64;

    // A Cabrillo.Attachment dictionary to view
    var attachment = {
        sys_id: '8e99daa3ff133100ba13ffffffffff2d',
        content_type: 'image/jpeg',
        path: '8e99daa3ff133100ba13ffffffffff2d.iix'
    }

    cabrillo.attachments.viewFile(attachment,
        imageRect,
        base64EncodedImage
    ).then(function() {
        // It worked. Nothing to do here.
    }, function(error) {
        console.log('Failed to view file.', error);
    });


