cabrillo.attachments – Client

Der Namespace für Cabrillo JS Anhangfunktionen. Dies ermöglicht das Hinzufügen und Anzeigen von Anlagen.

cabrillo.attachments – addFile(String tableName, String sysId, Object params, String options)

Präsentiert eine Dokumentenauswahl und lädt die ausgewählte Datei hoch.

Wichtig:

Diese Methode ist veraltet. Verwenden Sie stattdessen die addFiles()- 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 Records, an den der Anhang angehängt werden soll.
params	Objekt	Nicht verwendet. Festgelegt auf Null.
Optionen	Zeichenfolge	Nicht verwendet. Festgelegt auf Null.

Tabelle : 2. Ergebnisse

Typ	Beschreibung
promise	Bei Erfolg ein Cabrillo.Attachment-Objekt. Wenn der Vorgang fehlschlägt, ein Fehler.

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(String tableName, String sysId, Object params, Object options)

Präsentiert eine Dokumentauswahl zum Auswählen und Hochladen von Dateien.

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 die künftige Verwendung reserviert. Festgelegt auf Null.
Optionen	Objekt	Optional. Zusätzliche Einstellungen für das Hochladen von Dateien. { "isSingleSelection": Boolean }
options.isSingleSelection	Boolean	Optional. Kennzeichnung, die angibt, ob die Dokumentauswahl zum Hochladen von Dateien eine Mehrfachauswahl zulässt. Gültige Werte: true: Es kann jeweils nur eine Datei zum Hochladen ausgewählt werden. false: Mehrere Dateien zum Hochladen können gleichzeitig ausgewählt werden. Standardwert: False

Tabelle : 4. Ergebnisse

Typ	Beschreibung
Zusage	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.Attachment 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"]

In diesem Beispiel wird eine Schaltfläche zum Hinzufügen mehrerer Anhänge zu einem Incident-Datensatz erstellt und auf Upload-Fehler überprüft.

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.attachments -viewFile(Cabrillo.Attachment attachment, Cabrillo.Rect sourceRect, String sourceBase64Image)

Präsentiert eine Dokumentenauswahl und lädt die ausgewählte Datei hoch.

Hinweis:

Die Skalierung durch Verwendung eines sourceRect-Parameters mit einem sourceBase64-Bild wird nur unter iOS unterstützt. Android ignoriert diese Parameter und öffnet das Bild ohne Skalierungsanimation.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
attachment	Cabrillo.Attachment	Beschreibt den Anhang, der angezeigt werden soll.
sourceRect	Cabrillo.Rect	Optional. Beschreibt das Quellrechteck des Bildes, das vergrößert werden soll.
sourceBase64Image	Zeichenfolge	Optional. Eine Base64-Darstellung des Quellbilds zum Vergrößern.

Tabelle : 6. Ergebnisse

Typ	Beschreibung
promise	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 einem nativen Bildbetrachter angezeigt wurde, sind bei der viewFile()-Methode optionale Argumente für das Rechteck des Bildes auf der Seite sowie ein Base64-codiertes Miniaturbild des Bildes zulässig. Die Miniaturansicht wird mit einer Animation in 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);
});