Integration von Document Viewer SDKs mit Cloud‑Speicher und Kollaborationsplattformen
← Back to Blog7 min read

Integration von Document Viewer SDKs mit Cloud‑Speicher und Kollaborationsplattformen

Integration von Document Viewer SDKs mit Cloud‑Speicher und Kollaborationsplattformen
Integration von Document Viewer SDKs mit Cloud‑Speicher und Kollaborationsplattformen
Die Integration eines Dokumentenbetrachter‑SDKs mit Cloud‑Speicher und Kollaborationsplattformen ermöglicht es, nahtlose, sichere und durchsuchbare Dokumentenerlebnisse direkt aus Ihrer .NET‑Anwendung bereitzustellen. Mit Doconut — einem universellen Dokumentenbetrachter für .NET‑Back‑Ends—können Sie PDFs, Office‑Dateien, CAD‑Zeichnungen und Bilder nativ rendern, OCR‑gestützte Suche hinzufügen, Echtzeit‑Annotationen aktivieren und das Drucken steuern, während die Daten in Ihrer gewählten Cloud‑ oder On‑Premise‑Umgebung verbleiben. Dieser Leitfaden zeigt Senior‑Entwicklern und Software‑Architekten, wie Doconut in Azure Blob, Amazon S3 oder Google Cloud Storage eingebunden wird und wie der Betrachter über kollaborative Portale wie Microsoft Teams, SharePoint oder benutzerdefinierte React‑basierte Arbeitsbereiche bereitgestellt wird.


Warum cloud‑native Dokumentenanzeige für moderne .NET‑Apps wichtig ist

Plattformübergreifende Konsistenz mit einem einzigen .NET‑Core

Unternehmen entfernen sich von rein desktop‑basierten Dokumentenwerkzeugen und setzen auf web‑first Erlebnisse, die unter Windows laufen. Doco­nuts serverseitige Rendering‑Engine läuft auf .NET 6 und höher und liefert stets pixel‑perfekte Ergebnisse, unabhängig vom zugrunde liegenden Betriebssystem. Da der Betrachter mit Streams arbeitet, können Sie eine Datei aus jedem Cloud‑Bucket holen, sie direkt an die Doconut‑Komponente übergeben und gerenderte Seiten oder Thumbnails an den Client zurückgeben, ohne die Datei jemals auf die Festplatte zu schreiben.

Reduzierung von Latenz und Bandbreite

Wenn ein Dokument in Azure Blob Storage liegt, erzeugt das Herunterladen der gesamten Datei zum Client nur, um die erste Seite anzuzeigen, unnötige Latenz. Doconut unterstützt die on‑demand Generierung von Thumbnails, sodass Sie zunächst eine niedrigauflösende Vorschau anfordern und das vollständige Rendering erst beim Scrollen des Benutzers laden. Dieses Muster ist besonders wertvoll für große CAD‑Zeichnungen (DWG, DXF), die mehrere hundert Megabyte umfassen können.

Sicherheits‑first Verarbeitung

Alle rechenintensiven Vorgänge bleiben auf dem Server. Durch die Nutzung von Doco­nuts server‑seitiger Verarbeitung behalten Sie vertrauliche PDFs, Rechtsverträge oder medizinische Aufzeichnungen innerhalb Ihres privaten VNet oder hinter einer Unternehmens‑Firewall. Es wird kein Drittanbieter‑SaaS aufgerufen, und der Betrachter streamt niemals rohe Bytes zum Browser‑Engine — nur Bildkacheln oder HTML‑Snippets, die Sie im Hintergrund erzeugen.


Anbindung von Doconut an gängige Cloud‑Speicherdienste

Allgemeiner Integrationsansatz

  1. Dokumenten‑Stream erhalten – Verwenden Sie das SDK Ihres gewählten Cloud‑Anbieters (Azure Blob, Amazon S3, Google Cloud Storage), um die Datei in ein Stream‑Objekt herunterzuladen.
  2. Stream an Doconut übergeben – Der Doconut‑Betrachter akzeptiert einen Stream zusammen mit optionalen Rendering‑Optionen. Das eliminiert die Notwendigkeit temporärer Dateien auf dem Web‑Server.
  3. Viewer‑Token erzeugen – Doconut gibt einen Token zurück, der das geöffnete Dokument eindeutig für die aktuelle Sitzung identifiziert. Der Token kann als JSON an das Front‑End zurückgegeben und für nachfolgende Seiten‑Render‑ oder Annotations‑Aufrufe verwendet werden.
  4. Seiten on‑demand rendern – Das Front‑End ruft den Doconut‑Endpunkt mit dem Token und der gewünschten Seitennummer auf; Doconut liefert ein Bild oder ein HTML‑Fragment zurück.

Da der gesamte Workflow ausschließlich mit Streams arbeitet, erfordert das Austauschen von Azure‑Code gegen Amazon S3 oder Google Cloud Storage nur eine Änderung im Cloud‑SDK‑Aufruf, der den Stream erzeugt; der Rest der Doconut‑Pipeline bleibt unverändert.

Umgang mit Multi‑Tenant‑Speicher

In einem SaaS‑DMS kann jeder Mandant einen eigenen Bucket oder Präfix besitzen. Da Doconut mit Streams arbeitet, können Sie den korrekten Bucket zur Laufzeit ermitteln, das Dokument öffnen und den Token auf die Claims des aktuellen Benutzers beschränken. Doco­nuts interner Cache (IDistributedCache) lässt sich auf Redis oder Azure Cache for Redis konfigurieren, sodass wiederholte Anfragen für dieselbe Seite aus dem Speicher bedient werden, anstatt erneut gerendert zu werden.


Echtzeit‑Annotation und OCR in kollaborativen Workflows aktivieren

Annotations‑Plugin: Einen statischen Betrachter in ein Review‑Hub verwandeln

Doconut liefert ein Annotation Plugin, das Benutzern ermöglicht, Text zu markieren, Notizzettel hinzuzufügen oder Freihand‑Formen zu zeichnen. Nachdem ein Dokument geöffnet wurde, holen Sie sich einen Annotation‑Manager aus dem Betrachter, fügen Annotation‑Objekte hinzu oder ändern sie und speichern den Annotations‑Zustand als XML. Das Speichern des XML neben dem Dokumenteintrag ermöglicht versionierte Review‑Historien, und das Laden des XML bei späteren Öffnungen stellt den genauen visuellen Zustand wieder her.

OCR‑gestützte Suche für gescannte PDFs

Gescannte Verträge, Belege oder medizinische Bilder liegen häufig als reine Bild‑PDFs vor. Doco­nuts Search Plugin führt automatisch OCR auf dem Server aus, sobald Sie es in der Betrachter‑Konfiguration aktivieren. Die OCR‑Engine läuft innerhalb des serverseitigen Stacks, sodass der extrahierte Text Ihr geschütztes Umfeld nie verlässt. Nach Abschluss der OCR können Sie die Search‑API aufrufen, um passende Seitennummern und Begrenzungsrechtecke zu erhalten, die die UI hervorheben kann. Da die OCR serverseitig erfolgt, können Sie den extrahierten Text zudem in Azure Cognitive Search, Elasticsearch oder einen anderen Suchdienst indexieren, um sofortige Volltextsuche über das gesamte Repository zu ermöglichen.

Zusammenarbeit über geteilte Tokens

In Teams‑ oder SharePoint‑Integrationen erzeugen Sie typischerweise einen kurzlebigen Token, der die Dokument‑ID, Benutzer‑Berechtigungen und einen Zeitstempel kodiert. Der Token‑String, den Doconut aus dem Aufruf OpenDocument zurückgibt, kann in ein JWT eingebettet oder in einem Cache‑Eintrag gespeichert werden. Wenn ein anderer Benutzer den geteilten Link anklickt, wird derselbe Token verwendet, um den Betrachter zu re‑hydrieren, wobei Annotationen und OCR‑Layer für alle Beteiligten erhalten bleiben.


Sichere serverseitige Konvertierung und kontrolliertes Drucken mit Doconut

Viele Unternehmen müssen eingehende Word‑, Excel‑ oder CAD‑Dateien in PDF konvertieren, um sie zu archivieren, oder eine „Drucken‑nur‑nach‑Freigabe“‑Richtlinie durchsetzen. Doco­nuts Converter Plugin deckt diese Szenarien ab, ohne dass Microsoft Office oder Drittanbieter‑Dienste nötig sind. Sie rufen die Konvertierungs‑API auf dem Server auf, übergeben den Quell‑Dateipfad (oder Stream) und das gewünschte Ausgabeformat. Die Konvertierung läuft vollständig im Backend und erzeugt ein PDF, das in Ihrem Dokumenten‑Repository abgelegt werden kann.

Sobald das PDF existiert, können Sie Controlled Printing direkt in der Betrachter‑UI aktivieren. Doconut stellt eine Methode bereit, um Druckrechte für einen gegebenen Dokument‑Token zu setzen. Wenn der Benutzer den Druck‑Button klickt, prüft Doconut das Flag und liefert entweder einen druckbaren Bild‑Stream oder eine freundliche Meldung „Drucken deaktiviert“. Dieser Ansatz eliminiert die Notwendigkeit von benutzerdefiniertem JavaScript, um den Browser‑Druckdialog zu blockieren.

Auditing von Druckaktivitäten

Da die Druckanfrage über die Doconut‑Middleware läuft, können Sie in die Logging‑Pipeline von ASP.NET Core einhaken, um zu erfassen, wer wann was gedruckt hat. Speichern Sie den Audit‑Eintrag in einer SQL‑Tabelle oder leiten Sie ihn an ein SIEM‑System weiter – ein Muss für Rechts‑Tech‑ oder Gesundheits‑Lösungen, bei denen jeder Dokumentenzugriff nachverfolgbar sein muss.


Best Practices für Skalierung und Performance in plattformübergreifenden Umgebungen

  1. Verteiltes Caching nutzen – Doco­nuts interner Seiten‑Tile‑Cache kann von Redis, Azure Cache oder jeder IDistributedCache‑Implementierung unterstützt werden. Integrieren Sie den Dokument‑Versions‑Hash in die Cache‑Schlüssel, um veraltete Bilder nach einer Konvertierung zu vermeiden.
  2. Background‑Jobs für Massenkonvertierung einsetzen – Beim Onboarding eines großen Archivs Aufgaben mit Hangfire oder Azure Functions in die Warteschlange stellen. Die Doconut‑Viewer‑Klasse arbeitet mit IHostedService‑Workern, weil sie Streams akzeptiert und Tokens zurückgibt, ohne einen HTTP‑Context zu benötigen.
  3. Bildauflösung pro Gerät anpassen – Mobile Geräte profitieren von einer niedrigeren ImageResolution (150‑200 DPI), während Desktop‑Workstations 300 DPI für CAD‑Details anfordern können. Passen Sie die Auflösung anhand des User‑Agent‑Strings oder einer clientseitigen Einstellung an.
  4. Lazy Loading von Annotationen aktivieren – Speichern Sie das Annotations‑XML in einer separaten Tabelle und laden Sie es erst, wenn der Benutzer das Annotations‑Panel öffnet. Das reduziert die anfängliche Payload und beschleunigt das Rendering der ersten Seite.
  5. Speicherverbrauch überwachen – Das Rendern hochauflösender CAD‑Seiten kann speicherintensiv sein. Konfigurieren Sie den .NET‑GC im Produktions‑Modus für Server‑Mode (<gcServer enabled="true"/>) und setzen Sie vernünftige Time‑outs, um runaway Rendering‑Jobs zu verhindern.
  6. CDN für statische Assets einsetzen – Die JavaScript‑ und CSS‑Bundles des Betrachters sind statisch. Stellen Sie sie über Azure CDN, CloudFront oder Cloudflare bereit, um Millisekunden vom ersten Seiten‑Load abzuschneiden, besonders für global verteilte Teams.

Durch die Befolgung dieser Richtlinien können Sie tausende gleichzeitige Nutzer über Kontinente hinweg unterstützen und gleichzeitig die Latenz für die erste Seite unter 200 ms halten – ein Benchmark, den viele Unternehmensportale anstreben.


Schnellstart mit Doco­nuts kostenlosem Testzugang

Der schnellste Weg, Doconut zu evaluieren, besteht darin, das kostenlose Testpaket von der offiziellen Website herunterzuladen, das NuGet‑Paket zu einem neuen ASP.NET Core‑Projekt hinzuzufügen und dem Quick‑Start‑Guide zu folgen. Innerhalb weniger Minuten haben Sie einen funktionalen Betrachter, der Dokumente aus Azure Blob zieht, Annotationen ermöglicht, OCR‑basierte Suche ausführt und sichere serverseitige Konvertierung leistet. Für schritt‑für‑schritt Anleitungen besuchen Sie die Doconut‑Dokumentation und beginnen Sie noch heute mit dem Aufbau Ihrer cloud‑nativen Dokumentenerfahrung.

Bereit, Ihre Dokumenten‑Workflows zu transformieren? Registrieren Sie sich jetzt für den Doconut‑Testzugang und sehen Sie, wie einfach es ist, sichere, durchsuchbare und kollaborative Dokumentenerlebnisse in jeder .NET‑Anwendung zu liefern.

#document viewer#.NET#cloud integration#collaboration#OCR#Dokumentenbetrachter#Cloud-Integration#Zusammenarbeit