cabrillo.Anhänge – Client

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 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)

    Zeigt eine Dokumentauswahl an und lädt die ausgewählte Datei hoch.

    Wichtig:
    Diese Methode ist veraltet. Verwenden Sie AddFiles() Stattdessen Methode.
    Tabelle : 1. Parameter
    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 : 2. Rückgaben
    Typ Beschreibung
    Versprechen Bei Erfolg ein Objekt „Cabrillo.Attachment“. Wenn der Vorgang fehlschlägt, ist ein Fehler aufgetreten.
    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)

    Zeigt eine Dokumentauswahl zum Auswählen und Hochladen von Dateien an.

    Tabelle : 3. Parameter
    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.

    Standard: Falsch

    Tabelle : 4. Rückgaben
    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"]

    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)

    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.
    Tabelle : 5. Parameter
    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 : 6. Rückgaben
    Typ Beschreibung
    Versprechen Bei Erfolg ein ungelöstes Objekt, andernfalls ein Fehler.
    // 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);
    });