showBlob

Diese Funktion zeigt ein Blob-Objekt (Binary Large Object) in einem docViewer-Steuerelement an. Sie wird verwendet, um verschiedene Dokumenttypen wie PDFs, Bilder oder andere Dateien direkt in der Benutzeroberfläche anzuzeigen, ohne dass der Benutzer die Datei herunterladen oder eine externe Anwendung öffnen muss.

Syntax

app.showBlob(controlId, blobData)

Parameters

Parameter	Type	Description
controlId	String	Die ID des docViewer-Steuerelements, in dem das Blob angezeigt werden soll
blobData	Blob	Das Blob-Objekt, das den Inhalt des Dokuments enthält

Return Value

Diese Funktion gibt keinen Wert zurück.

Examples

Example 1: Anzeigen eines PDF-Anhangs in einem docViewer:

// PDF-Anhang abrufen und in einem docViewer anzeigen
const pdfBlob = app.getAttachmentByFileName("invoice.pdf");
app.showBlob("documentViewer", pdfBlob);

Example 2: Anzeigen eines dynamisch generierten Berichts:

// Bericht erstellen und anzeigen
const reportBlob = app.createReport("invoiceReport", {
  parameters: {
    customerNumber: app.getFieldValue("customerNumber"),
    invoiceDate: app.getFieldValue("invoiceDate")
  }
});

// Bericht im Viewer anzeigen
app.showBlob("reportViewer", reportBlob);

Example 3: Anzeigen einer Unterschrift als Bild:

// Unterschrift als Bild abrufen und anzeigen
const signatureBlob = app.getSignatureImageBlob("signatureField");
app.showBlob("signaturePreview", signatureBlob);

Example 4: Anzeigen eines Anhangs aus einem Konfigurationsdatensatz:

// Anhang aus einem Konfigurationsdatensatz abrufen
const documentId = app.getConfigRecordAttachmentIdByFileName("templates", 1001, "contract.pdf");
if (documentId) {
  const documentBlob = app.getAttachmentById(documentId);
  app.showBlob("contractViewer", documentBlob);
} else {
  app.showErrorMessage("Dokument fehlt", "Die Vertragsvorlage konnte nicht gefunden werden.");
}

Related Functions

• getAttachmentByFileName() - Abrufen eines Anhangs nach Dateinamen
• getAttachmentById() - Abrufen eines Anhangs nach seiner ID
• getSignatureImageBlob() - Abrufen einer Unterschrift als Blob
• createReport() - Erstellen eines Berichts, der als Blob angezeigt werden kann
• createReportPdfBlob() - Erstellen eines PDF-Berichts als Blob
• printBlob() - Drucken eines Blobs direkt
• downloadAttachment() - Herunterladen eines Anhangs anstelle der Anzeige
• getConfigRecordAttachmentIdByFileName() - Abrufen einer Anhangs-ID aus einem Konfigurationsdatensatz

Notes

• Die Funktion unterstützt die Anzeige verschiedener Dokumenttypen, einschließlich PDF, Bilder (PNG, JPG, SVG) und HTML.
• Das docViewer-Steuerelement muss im Formular vorhanden sein und vom Typ "docViewer" sein.
• Die Anzeige erfolgt direkt im Browser mit den integrierten Anzeigefunktionen des Browsers.
• Bei großen Dokumenten kann die Ladezeit je nach Größe und Komplexität des Dokuments variieren.
• Ein Blob-Objekt enthält Binärdaten und kann durch verschiedene API-Funktionen wie getAttachmentById(), getAttachmentByFileName(), createReport() oder getSignatureImageBlob() erzeugt werden.