Dokumente im Browser bearbeiten

Briefe, Tabellen und Präsentationen bearbeiten Sie direkt in Octoserv, ohne die Datei herunterzuladen und wieder hochzuladen. Der Editor sieht aus wie ein Office-Programm und liest und schreibt Word-, Excel- und PowerPoint-Dateien. Dieses Bearbeiten im Browser gehört zu jeder Octoserv-Installation, Sie brauchen dafür kein Zusatzmodul.


Wofür ist diese Funktion?

Sie öffnen ein Dokument aus der Dokumentenablage oder aus der Akte eines Kontakts oder einer Firma, ändern es und sind fertig. Es gibt kein Speichern-Symbol, das Sie vergessen könnten: Der Editor sichert Ihre Änderungen laufend. Jede Sicherung ist eine neue Version des Dokuments, die vorherige bleibt erhalten. Zwei Personen können dasselbe Dokument gleichzeitig öffnen und sehen die Änderungen des anderen.

Dazu kommen drei Hilfen für den Alltag:

Die Seite Dokumente in der Listenansicht mit dem Knopf Neues Dokument und an einem Word-Dokument den Knöpfen Bearbeiten, PDF und Vorlage
Die Seite Dokumente: oben „Neues Dokument“, bei einem Word-Dokument die Knöpfe „Bearbeiten“, „PDF“ und „Vorlage“.

Voraussetzungen


So verwenden Sie es

Ein Dokument öffnen und bearbeiten

  1. Öffnen Sie die Seite Dokumente oder die Akte eines Kontakts oder einer Firma und suchen Sie das Dokument in der Dateien-Box.
  2. Klicken Sie bei einer Office-Datei auf Bearbeiten. In der Dateien-Box ist das der Stift neben dem Dokument.
  3. Das Dokument öffnet sich in voller Höhe. Schreiben, formatieren, Tabellen und Bilder einfügen: alles wie in Ihrem Office-Programm.
  4. Sie müssen nichts speichern. Mit dem Pfeil oben links kehren Sie dorthin zurück, wo Sie das Dokument geöffnet haben.

Im Journal des Kontakts steht danach „Dokument bearbeitet“ mit Ihrem Namen. Die früheren Stände bleiben als Versionen erhalten.

Diese Dateiarten öffnen sich im Editor:

ArtDateiendungen
Worddocx, doc, odt, rtf, txt
Excelxlsx, xls, ods, csv
PowerPointpptx, ppt, odp

Andere Dateien, zum Beispiel PDF, öffnen sich wie bisher in der Vorschau.

Alte Dateiformate: Eine Datei im alten Format (doc, xls, ppt, odt) wird beim Speichern zu einer Datei im neuen Format (docx, xlsx, pptx). Der Dateiname ändert sich entsprechend, die alte Version bleibt als Version erhalten.

Gemeinsam bearbeiten

  1. Sie öffnen ein Dokument und arbeiten darin.
  2. Eine Kollegin öffnet dasselbe Dokument über Bearbeiten.
  3. Sie arbeiten beide in derselben Datei und sehen die Änderungen des anderen. Es entsteht keine zweite Kopie und kein Konflikt zwischen zwei Ständen.

Ein neues Dokument anlegen

  1. Auf der Seite Dokumente klicken Sie oben auf Neues Dokument. Schneller geht es in der Navigation: Unter Dokumente steht der Unterpunkt Neues Dokument; er öffnet die Seite Dokumente gleich mit dem Dialog. In der Akte eines Kontakts oder einer Firma klicken Sie in der Dateien-Box auf das Dokument-Symbol.
  2. Tragen Sie bei Bedarf einen Namen ein. Ohne Namen vergibt Octoserv einen.
  3. Auf der Seite Dokumente können Sie zusätzlich einen Kontakt wählen (freiwillig). Dann wird das Dokument diesem Kontakt zugeordnet und erscheint in seiner Dateien-Box, und der Dialog bietet auch „Brief aus einer Vorlage“ an. Ohne Kontakt sehen das Dokument alle, die Dokumente sehen dürfen.
  4. Klicken Sie auf Word-Dokument, Excel-Tabelle oder PowerPoint-Präsentation.
  5. Das leere Dokument wird angelegt und im Editor geöffnet. Auf der Seite Dokumente liegt es im geöffneten Ordner, in der Dateien-Box wird es beim Kontakt oder bei der Firma abgelegt.

Den Unterpunkt „Neues Dokument“ in der Navigation sehen alle, die Dokumente ändern dürfen, sobald der Dokumentenserver eingetragen ist. Schließen Sie den Dialog, bleiben Sie auf der Seite Dokumente.

Der Dialog Neues Dokument in der Dateien-Box eines Kontakts mit den Knöpfen für Word, Excel und PowerPoint und der Auswahl einer Briefvorlage
Der Dialog „Neues Dokument“: oben ein leeres Dokument, darunter ein Brief aus einer Vorlage.

Ein Brief aus einer Vorlage

Eine Briefvorlage ist ein Word-Dokument, in dem an den Stellen, die sich je Empfänger ändern, Codes in geschweiften Klammern stehen. Octoserv ersetzt die Codes durch die Werte des Kontakts oder der Firma. Die Vorlage selbst bleibt dabei unverändert.

Beispiel: eine Terminbestätigung für einen Kontakt.

  1. Legen Sie auf der Seite Dokumente ein neues Word-Dokument an und nennen Sie es „Terminbestätigung“. Alternativ laden Sie eine vorhandene .docx-Datei hoch.
  2. Schreiben Sie den Brief und setzen Sie die Codes ein, zum Beispiel:
    {contact.salutation_line},
    vielen Dank für Ihr Interesse, {contact.first_name}. Wir bestätigen Ihren Termin gern.
    Mit freundlichen Grüßen, {user.name}
  3. Klicken Sie bei dem Dokument auf Vorlage. Es ist jetzt eine Briefvorlage. Nur Word-Dokumente (.docx) können Vorlagen sein. Die Vorlage kennzeichnen darf, wer das Dokument besitzt oder alle Dokumente bearbeiten darf.
  4. Öffnen Sie den Kontakt, klicken Sie in der Dateien-Box auf Neues Dokument, wählen Sie unter „Brief aus einer Vorlage“ die Vorlage und klicken Sie auf Brief erstellen.
  5. Der Brief wird mit den Werten des Kontakts gefüllt, bei ihm abgelegt und im Editor geöffnet. Sie können ihn noch anpassen und dann mit PDF als PDF speichern.

Die wichtigsten Codes. Die vollständige Liste steht im Dialog „Neues Dokument“ unter „Codes, die Sie in eine Briefvorlage schreiben können“; es sind dieselben wie in E-Mails.

CodeErgebnis
{contact.salutation_line}die fertige Anredezeile, zum Beispiel „Sehr geehrte Frau Muster“ (nach der Anrede im Kontakt; ohne Anrede „Guten Tag Anna Muster“)
{contact.first_name}, {contact.last_name}, {contact.full_name}Vorname, Nachname, vollständiger Name
{contact.street_1}, {contact.postal_code}, {contact.city}, {contact.country}die Anschrift des Kontakts
{company.name}der Name der Firma
{user.name}Ihr Name als Schreibender
{date}das heutige Datum
Hinweis: Ein Code darf mitten im Wort formatiert sein, auch wenn Word ihn beim Tippen in mehrere Teile zerlegt hat. Er wird im Text, in der Kopf- und in der Fußzeile ersetzt. Hat ein Code für den Datensatz keinen Wert, bleibt die Stelle leer; nach dem Erstellen nennt eine Meldung diese Codes.

Dieselbe Briefvorlage können Sie auch für einen Brief an viele Kontakte auf einmal nehmen: siehe Serienbriefe und Lettershop.

Codes oder Werte: der Bereich „Platzhalter“ im Editor

Ein Code wie {contact.first_name} wird nur an einer Stelle ausgefüllt: wenn Sie aus einer Briefvorlage mit „Brief aus einer Vorlage“ einen Brief erstellen. In jedem anderen Dokument bleibt ein Code stehen, wie er geschrieben ist. Deshalb gilt: Codes gehören nur in Briefvorlagen. In einen fertigen Brief gehören die echten Werte.

Im Editor eines Word-Dokuments finden Sie im Reiter Plugins den Bereich Platzhalter. Er zeigt die Codes nach Gruppen, mit einem Suchfeld. Was ein Klick einfügt, hängt vom Dokument ab:

Das Dokument ist …Ein Klick fügt ein …
eine Briefvorlageden Code an der Schreibmarke, zum Beispiel {contact.first_name}. Er wird später beim Erstellen eines Briefs ausgefüllt.
einem Kontakt zugeordnetden echten Wert dieses Kontakts, zum Beispiel „Maria“, nicht den Code. Der Bereich zeigt zu jedem Code den Wert, etwa „Vorname: Maria“. Bei mehreren Kontakten wählen Sie oben den Kontakt. Steht dort „leer“, hat der Kontakt keinen Wert, und es lässt sich nichts einfügen. Sie sehen nur Werte von Kontakten, die Sie auch in der Kontaktliste sehen dürfen.
weder Vorlage noch einem Kontakt zugeordnetnichts. Ordnen Sie das Dokument einem Kontakt zu oder machen Sie es zur Briefvorlage, beides mit den Knöpfen über dem Editor („Kontakt zuordnen“, „Als Briefvorlage verwenden“). Danach klicken Sie im Bereich „Platzhalter“ auf „Aktualisieren“.

Beispiel: Sie schreiben Maria Muster einen Brief. Ordnen Sie das Dokument Maria zu, öffnen Sie im Editor „Platzhalter“ und klicken Sie auf „Straße“. Im Brief steht dann zum Beispiel „Hauptstraße 5“. Wollen Sie denselben Brief an viele Kontakte schicken, machen Sie ihn stattdessen zur Briefvorlage und schreiben Codes hinein.

Den Bereich „Platzhalter“ gibt es nur in Word-Dokumenten und nur, wenn Sie das Dokument bearbeiten dürfen. In Excel-Tabellen und PowerPoint-Präsentationen gibt es ihn nicht, und dort prüft Octoserv auch keine Codes.

Vergessene Codes: Steht in einem Word-Dokument, das keine Briefvorlage ist, nach dem Speichern noch ein Code, zeigt die Seite Dokumente daneben „Offene Codes“. Beim nächsten Öffnen nennt ein Hinweis über dem Editor die Codes. „PDF“ erstellt dann kein PDF, sondern nennt die Codes, die noch ausgefüllt oder gelöscht werden müssen.

Ihre Unterschrift und Ihr Name im Brief

Mit {sender.signature} setzen Sie die Unterschrift des Benutzers ein, der den Brief erstellt (der angemeldete Benutzer, der „Brief erstellen“ oder den Serienbrief startet). In Word entsteht ein Bild von etwa 15 mm Höhe, das Seitenverhältnis bleibt. Hat der Benutzer keine Unterschrift im Profil hinterlegt oder ist kein Benutzer beteiligt (zum Beispiel bei einem Flow), bleibt die Stelle leer; es wird nie die Unterschrift eines anderen Benutzers genommen. In E-Mails bleibt der Code leer, dort steht die Signatur des Postfachs.

Beispiel: Unter „Mit freundlichen Grüßen“ steht in der Vorlage {sender.signature} und darunter {sender.name}. Die eingesetzte Unterschrift ist ein Bild wie eine eingescannte Unterschrift. Für Verträge, die unterschrieben werden müssen, nutzen Sie die Online-Unterschrift.

Als PDF speichern

  1. Klicken Sie bei dem Office-Dokument auf PDF.
  2. Octoserv speichert eine PDF-Datei als neues Dokument neben dem Original: im selben Ordner, bei denselben Kontakten und Firmen.

So haben Sie den Brief versandfertig und das bearbeitbare Original zugleich. Stehen in einem Word-Dokument, das keine Briefvorlage ist, noch Codes, entsteht kein PDF; die Meldung nennt die Codes (siehe Codes oder Werte).


Einrichtung (Administratoren)

Der Editor braucht einen eigenen Dokumentenserver, ONLYOFFICE Docs (Community). Er läuft auf einem Server Ihres Unternehmens und wird von Ihrem Administrator oder Ihrem IT-Dienstleister bereitgestellt. Octoserv bringt ihn nicht mit.

Die Karte ONLYOFFICE Docs unter Einstellungen, API-Keys mit der Adresse des Dokumentenservers, dem JWT-Geheimnis und dem Knopf Verbindung prüfen
Die Karte „ONLYOFFICE Docs“ unter Einstellungen › API-Keys. Die Adresse im Bild ist ein Beispiel.
  1. Der Dokumentenserver braucht ein JWT-Geheimnis (Einstellung JWT_SECRET), einen langen Zufallstext.
  2. Öffnen Sie Einstellungen › API-Keys und die Karte „ONLYOFFICE Docs“. Tragen Sie die Adresse des Dokumentenservers mit https ein, zum Beispiel https://office.beispiel.de/, und klicken Sie auf Speichern.
  3. Tragen Sie darunter dasselbe JWT-Geheimnis ein. Es wird verschlüsselt gespeichert und nie wieder angezeigt; die Karte nennt nur, ob es gesetzt ist.
  4. Klicken Sie auf Verbindung prüfen. Der Test fragt den Server und lässt ihn ein leeres Dokument in PDF umwandeln. Das beweist, dass die Signatur stimmt und der Server Ihre Installation erreicht.

Der Dokumentenserver muss die Adresse Ihrer Installation aufrufen können und darf sie nicht als privaten Zugriff sperren. Seine eigenen Adressen müssen öffentlich unter der eingetragenen Adresse erreichbar sein.

Leeren Sie die Adresse und speichern Sie, schaltet das den Editor wieder ab. Alle Knöpfe verschwinden, die Dokumente bleiben unberührt.


Wenn etwas nicht klappt

Meldung oder BeobachtungWas Sie tun
Die Knöpfe „Bearbeiten“ und „Neues Dokument“ fehlenEs ist noch kein Dokumentenserver eingetragen. Bitten Sie Ihren Administrator, die Einrichtung abzuschließen.
Statt „Bearbeiten“ steht „Ansehen“Ihnen fehlt das Recht, Dokumente zu bearbeiten.
Die Prüfung meldet „lehnt die Signatur ab“Das JWT-Geheimnis in Octoserv und im Dokumentenserver ist nicht gleich.
Die Prüfung meldet „kann die Datei nicht abrufen“Der Dokumentenserver erreicht diese Installation nicht. Prüfen Sie Adresse, Firewall und die Sperre privater Adressen im Dokumentenserver.
Der Editor lädt nichtPrüfen Sie die Adresse in den API-Keys. Sie muss mit https beginnen und öffentlich erreichbar sein.

Verwandte Seiten