|
|
## Integration im Allgemeinen
|
|
|
|
|
|
Embedded Office for enaio registriert sich als Microservice automatisch und wird durch den Gateway unter dem Pfad /office angebunden.
|
|
|
Direkte Aufrufe des Embedded Office for enaio ohne Gateway werden nicht unterstützt, da dieser die Authorisierung bereitstellt.
|
|
|
|
|
|
### Beispiele für die Integration
|
|
|
|
|
|
### enaio Richclient
|
|
|
|
|
|
Im enaio RichClient kann embedded office sowohl als Dashlet, vergleichbar mit dem Dokumentenvorschau, als auch als explizite Tabs integiert werden.
|
|
|
Details zur Integration finden Sie unter auf der Seite [Richtclient]({{< ref "richclient.md" >}} "Richtclient").
|
|
|
|
|
|
#### Beispiel Dashlet
|
|
|
|
|
|
Die Integration von embedded office als Dashlet bietet die Möglichkeit, office Dokumente direkt im Client zu zu betrachten wie auch zu bearbeiten ohne hierfür ein separates Fenster öffnen zu müssen.
|
|
|
Je nach Benutzer Scenario kann dies den Arbeitsablauf und das Benutzererlebnis deutlich verbessern.
|
|
|
Zusätzlich kann das Dashlet auch als allgemeine Dokumentenvorschau verwendet werde. Wenn es sich beim selektierten Dokument im Client um ein Office Format handelt wird automatisch ONLYOFFICE zur Anzeige verwendet, ansonsten wird der enaio DocumentViewer eingeblendet.
|
|
|
|
|
|
![Dashlet Integration](/images/dashlet_example.png)
|
|
|
|
|
|
#### Separates Browser
|
|
|
|
|
|
Es ist ist zusätzlich möglich, den `Inhalt bearbeiten` im dem `BeforeOpen` Event so zu verändern, dass das Dokument statt mit Microsoft Office mit embedded office in einem Browser Fenster geöffnet wird. Diese Funktion kann zusammen mit dem Dashlet eingesetzt werden.
|
|
|
|
|
|
|
|
|
### enaio webclient
|
|
|
|
|
|
Im enaio webclient kann embedded office für die Funktion `Inhalt bearbeiten` eingebettet werden.
|
|
|
Details zur Integration finden Sie unter auf der Seite [Webclient]({{< ref "webclient.md" >}} "Richtclient").
|
|
|
|
|
|
#### Beispiel
|
|
|
|
|
|
![](../videos/WebclientExample.webm)
|
|
|
|
|
|
In diesem Beispiel wird ein Dokument im Webclient gesucht und per `Inhalt bearbeiten` geöffnet (Doppelklick ist ebenfalls möglich). Das Dokument öffnet sich in einem separaten Browser Tab (das Verhalten kann im Event individuell ausgestaltet werden). Nach dem Abschluss der Bearbeitung wird der Tab enfach geschlossen. Das Dokument muss nicht explizit gespeichert werden. Wie am Ende des Videos zu sehen ist, wird das Dokument nach dem verlassen des letzten Bearbeiters nach wenigen Sekunden in enaio automatisch gespeichert und eingechecked.
|
|
|
|
|
|
### Android und IOS Apps
|
|
|
|
|
|
Embedded Office for enaio funktioniert sowohl mit der `enaio mobile` App für [Android](https://play.google.com/store/apps/details?id=com.os.bluebird) wie auch [IOS](https://itunes.apple.com/de/app/enaio-mobile/id1391836712?mt=8).
|
|
|
Die Konfiguration erfolgt mit den identischen Events wie im enaio webclient. Es hierbei eine Weiche eingebaut werden, um bei kleineren Bildschirmgrössen die Mobile Version von ONLYOFFICE anzuzeigen.
|
|
|
|
|
|
#### Beispiel IPAD
|
|
|
{{< youtube id="ggZTA8BFSD0" title="Embedded Office for enaio® auf dem iPad" >}}
|
|
|
|
|
|
### coLab
|
|
|
|
|
|
Es ist möglich, embedded office for enaio in coLab zu integrieren.
|
|
|
Details zur Integration finden Sie unter auf der Seite [coLab]({{< ref "colab.md" >}} "coLab").
|
|
|
|
|
|
### Integration in Drittsysteme
|
|
|
|
|
|
embedded office for enaio lässt sich natürlich auch in andere Clients per IFrame bzw. WebControl integrieren.
|
|
|
### Aufruf-URL
|
|
|
|
|
|
Die URL zur Dokumentenbearbeitung ist wie folgt aufgebaut:
|
|
|
`/office/{{type}}/{{mode}}/{{action}}/{{objectTypeId}}/{{objectId}}?auto={{auto}}`
|
|
|
|
|
|
#### Erlaubte Kombinationen
|
|
|
|
|
|
* Desktop
|
|
|
* `/office/desktop/view/view/{{objectTypeId}}/{{objectId}}`
|
|
|
* `/office/desktop/edit/edit/{{objectTypeId}}/{{objectId}}`
|
|
|
* `/office/desktop/edit/review/{{objectTypeId}}/{{objectId}}`
|
|
|
* `/office/desktop/edit/forms/{{objectTypeId}}/{{objectId}}`
|
|
|
* Mobile
|
|
|
* `/office/mobile/view/view/{{objectTypeId}}/{{objectId}}`
|
|
|
* `/office/mobile/edit/edit/{{objectTypeId}}/{{objectId}}`
|
|
|
* `/office/mobile/edit/review/{{objectTypeId}}/{{objectId}}`
|
|
|
* Embedded
|
|
|
* `/office/embedded/view/view/{{objectTypeId}}/{{objectId}}`
|
|
|
|
|
|
#### {{Type}}
|
|
|
|
|
|
Mögliche Editor Typen sind sind:
|
|
|
|
|
|
* desktop - Desktop Editor Modus von OnlyOffice mit allen Funktionen
|
|
|
* mobile - Mobile Editor Modus von OnlyOffice mit eingeschränkten Funktionen
|
|
|
* embedded - Mobile Viewer Modus von OnlyOffice
|
|
|
|
|
|
#### {{Mode}}
|
|
|
|
|
|
Editor Modus:
|
|
|
|
|
|
* view - Anzeigemodus
|
|
|
* edit - Bearbeitungsmodus
|
|
|
|
|
|
#### {{Action}}
|
|
|
|
|
|
Editor Aktion:
|
|
|
|
|
|
* view - Anzeigeaktion
|
|
|
* edit - Bearbeitungsaktion
|
|
|
* review - Review Aktion
|
|
|
* forms - Formular Aktion
|
|
|
|
|
|
#### {{objectTypeId}}
|
|
|
|
|
|
enaio Objekt Typen ID
|
|
|
|
|
|
#### {{objectId}}
|
|
|
|
|
|
enaio Objekt ID
|
|
|
|
|
|
#### {{auto}}
|
|
|
|
|
|
* true - the datatransfer will be started on open
|
|
|
* false - (default) datatransfer will not be started on startup
|
|
|
|