Apprendre à intégrer ONLYOFFICE à la gestion électronique des documents créés sur Nextcloud

ONLYOFFICE ne modifie pas le code source. En effet, le service doit permettre d’ajouter les modules utilisateur, les modules complémentaires, les packs ou les applications.

Nextcloud permet aux développeurs d'ajouter leurs propres applications pour améliorer le partage avec des fonctionnalités supplémentaires. Toutes ces applications sont disponibles dans l'App Store, y compris l’application d'intégration de ONLYOFFICE pour Nextcloud.

Le code source de l’application est également disponible sur GitHub. Vous pouvez l’y récupérer, le compiler et le déposer sur le serveur Nextcloud dans la catégorie des applications. Ce code peut ainsi servir d’exemple lors de la création de votre propre connecteur.

Après avoir compilé l’application, configurez-la en suivant les étapes ci-dessous.

Comme cité précédemment, Nextcloud et ses modules complémentaires sont écrits en langage PHP, c’est pourquoi tous les exemples de code dans cet article sont écrits en PHP.

Pour accéder aux fichiers, il faut créer une fonction de rappel. Elle est conçue pour renvoyer les demandes de ONLYOFFICE Document Server vers la GED.

En fonction des paramètres de la demande, des actions correspondantes peuvent être exécutées sur la GED (par exemple, récupérer le contenu d'un fichier ou enregistrer un fichier). Il est essentiel d’avoir une interaction directe entre le Document Server et la GED qui assure un accès anonyme aux fichiers téléchargés ou enregistrés. Cela veut dire que l’interaction entre le Document Server et la GED s’effectue seulement du côté serveur, sans demander de données d'autorisation d'utilisateur de la part du client, données telles que les cookies du navigateur.

La sécurité y est assurée au moyen de la technologie JWT. Les données sont vérifiées à l'aide d'une signature numérique. Le Document Server ajoute JWT à la demande en utilisant le mot de passe de son fichier de configuration, et la GED le vérifie en utilisant, à son tour, le mot de passe de son fichier de configuration. La fonction de rappel exécute la demande seulement dans le cas où la signature est correctement validée.

Pour la GED, la fonction de rappel est sollicitée lorsque les demandes sont envoyées aux URL suivantes :

"routes" => [
   ["name" => "callback#download", "url" => "/download", "verb" => "GET"],
   ["name" => "callback#track", "url" => "/track", "verb" => "POST"],
   ...
]

La validation de la signature est exécutée pour les demandes entrantes :

try {
    $decodedHeader = \Firebase\JWT\JWT::decode($header,
        $this->config->GetDocumentServerSecret(), array("HS256"));
} catch (\UnexpectedValueException $e) {
    return new JSONResponse(["message" => $this->trans->t("Access denied")],
        Http::STATUS_FORBIDDEN);
}

Le Document Server demande le contenu du fichier à la GED :

class CallbackController extends Controller {
    public function download($doc) {
        $file = $this->getFile($doc);
        return new DataDownloadResponse($file->getContent(), $file->getName(),
            $file->getMimeType());
    }
    ...
}

Pour enregistrer le fichier dans la GED :

class CallbackController extends Controller {
    public function track($doc, $status, $url) {
        $error = 1;
        switch ($status) {
            case "MustSave":
                $file = $this->getFile($doc);
                if (($newData = $this->Request($url))) {
                    $file->putContent($newData);
                    $error = 0;
                }
                break;
            case "Editing":
            case "Closed":
                $error = 0;
                break;
        }
        return new JSONResponse(["error" => $error], Http::STATUS_OK);
    }
    ...
}

La réponse doit être la suivante :

{"error": 0}

Le travail avec ONLYOFFICE pour les utilisateurs définitifs commence par les boutons tels que « Ouvrir », « Modifier », « Créer nouveau » ou « Convertir ». Ces actions peuvent être associées aux types de fichiers correspondants :

• « Voir » : docx, xlsx, pptx, csv, txt, pdf ;
• « Modifier » : docx, xlsx, pptx, csv, txt ;
• « Créer nouveau » : docx, xlsx, pptx, txt ;
• « Convertir » : en Office Open XML formats (docx, xlsx, pptx): doc, docm, dot, dotx, epub, htm, html, odp, odt, pot, potm, potx, pps, ppsm, ppsx, ppt, pptm, rtf, xls, xlsm, xlsx, xlt, xltm, xltx.

(Il faut également tenir compte des types de droits d'accès qui sont réservés aux utilisateurs).

Nextcloud permet d’exécuter les scripts côté client et d’ajouter les boutons à leur menu contextuel. Le code ci-dessous permet de créer un bouton pour ouvrir un fichier docx :

fileList.fileActions.registerAction({
    name: "onlyofficeOpen",
    displayName: t(OCA.Onlyoffice.AppName, "Open in ONLYOFFICE"),
    mime: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
    permissions: OC.PERMISSION_READ,
    iconClass: "icon-onlyoffice-open",
    actionHandler: function(fileName, context) {
            window.open(OC.generateUrl("/apps/" + OCA.Onlyoffice.AppName +
                "/" + context.fileInfoModel.id);
        }
});

Lorsque l’utilisateur clique sur un bouton d'action, une nouvelle page avec les configurations d'initialisation est générée. À cette étape, ONLYOFFICE vérifie s’il est possible d'ouvrir le fichier et si l’utilisateur est doté de droits d'accès nécessaires.

En outre, des paramètres supplémentaires de l'éditeur, tels que les paramètres de l'interface, peuvent être configurés. Par exemple, document.permissions.download = false supprime le bouton de téléchargement du fichier de l'éditeur, et editorConfig.lang = "de-DE" change la langue de l'interface en allemand.

Dans Nextcloud, ce mécanisme est implanté en tant que gestionnaire de demandes, séparément :

class EditorController extends Controller {
    public function config($fileId) {
        $file = $this->getFile($fileId);
        $fileName = $file->getName();
        $ext = strtolower(pathinfo($fileName, PATHINFO_EXTENSION));
        $formats = [
            "docx" => [ "type" => "text" ],
            "xlsx" => [ "type" => "spreadsheet" ],
            "pptx" => [ "type" => "presentation" ]
        ];
        $params = [
            "document" => [
                "fileType" => $ext,
                "key" =>  $this->getKey($file),
                "title" => $fileName,
                "url" => $this->getUrl($fileId),
            ],
            "documentType" => $format[$ext]["type"]
        ];
        if ($file->isUpdateable()) {
            $params["editorConfig"]["callbackUrl"] = $this->urlGenerator->linkToRouteAbsolute(
                $this->appName . ".callback.track", ["doc" => $fileId]);
        } else {
            $params["editorConfig"]["mode"] = "view";
        }
        return $params;
    }
    ...
}

À cette étape, les paramètres suivants du document sont définis :

• "fileType" : définit le type du fichier pour le document source que l’on ouvre pour la lecture ou l’édition ;
• "key" : définit l’unique identifiant du document pour qu’il soit reconnu par le service. Dans le cas où l’identifiant envoyé est reconnu par le service, le document sera récupéré du cache. À chaque fois que le document est modifié et enregistré, l’identifiant est généré à nouveau ;
• "title" : définit le nom que vous choisissez pour le document en cours de lecture ou de rédaction. Ce nom peut également être attribué au document lors de son téléchargement ;
• "url" : définit une adresse URL absolue où le document source en cours de lecture ou de rédaction est stocké.

Plusieurs utilisateurs peuvent modifier le même fichier au même moment. Dans ce cas, la modification est possible grâce à l'utilisation du même document.key pour le même fichier, ouvert simultanément par plusieurs utilisateurs :

private function getKey($file) {
    $instanceId = $this->config->getSystemValue("instanceid");
    $key = $instanceId . "_" . $file->getId() . "_" . $file->getMtime();
    return $key;
}

Ajoutez la signature JWT pour protéger les configurations contre les changements indésirés :

if (!empty($this->config->GetDocumentServerSecret())) {
    $token = \Firebase\JWT\JWT::encode($params, $this->config->GetDocumentServerSecret());
    $params["token"] = $token;
}

L'application d'intégration possède des paramètres généraux, tels que l'adresse du Document Server, ainsi que des paramètres personnels d’utilisateur, tels que les préférences utilisateur. Vous pouvez configurer l'application en utilisant des fichiers de configuration côté serveur ou en créant une page web de paramètres. Dans l’application d’intégration de ONLYOFFICE pour Nextcloud, les paramètres de connexion sont disponibles sur la page Administrateur. La capture d’écran ci-dessous représente la page Administrateur de la dernière version de l’application. Comme vous le voyez, la page a été renouvelée avec la division des paramètres perso et administratifs en deux sections. En outre, l’interface de l’éditeur, dès maintenant, peut être personnalisée.