Das Klarflow-Modul für Odoo

Die Klarflow-Apps funktionieren auch ohne dieses Modul. Für die 7 Tage Testzeit und die Nutzung mit Ihrem eigenen Odoo-Login brauchen Sie es nicht.

Das Modul ist kostenlos. Ein Odoo-Administrator installiert es einmal auf dem Odoo-Server. Es ergänzt den Firmen-Login in der App, sofortige Hinweise, Ein- und Auschecken für jeden Mitarbeiter, PDFs mit den eigenen Rechten jedes Benutzers und die Lizenz der Organisation. Die Einschränkungen ohne das Modul stehen unten.

Download

Modul herunterladen (ZIP)

Version: 1.3.1
Datei: klarflow-odoo-module-1.3.1.zip, 25 KB
SHA-256: 1b037e87222b29b91ba022d9ff22650dcc64185e9d7b93c46be8faf482c3f371
Funktioniert mit: Odoo 17, 18 und 19
Lizenz: LGPL-3

Für Skripte: https://kflow.one/assets/downloads/klarflow-odoo-module.zip verweist immer auf die neueste Version.

Was das Modul ergänzt

Anmeldung über den Browser mit Ihrem Firmen-Login: Passwort, Single Sign-on, Zwei-Faktor-Authentifizierung und Passkeys. Odoo zeigt seine eigene Anmeldeseite und eine Seite, auf der Sie der App den Zugriff erlauben.
Ein API-Schlüssel pro Gerät. Beim Abmelden aus einer App wird ihr Schlüssel widerrufen, und ein widerrufener Schlüssel funktioniert sofort nicht mehr.
Ein- und Auschecken in den Apps für jeden Mitarbeiter, wie im Anwesenheitsmenü von Odoo.
Direktchats, gestartet so, wie Discuss sie startet.
PDFs von Rechnungen, Angeboten und Lieferscheinen, erstellt mit den Zugriffsrechten der Person, die sie anfordert.
Die Lizenz der Organisation: Hat Ihre Organisation eine, brauchen die Personen darin kein persönliches Abonnement.
Sofortige Hinweise per Push zu neuen Aktivitäten, Erwähnungen, Direktnachrichten und Freigaben. Sie sind aus, bis ein Administrator die Relay-Adresse und das Ereignis-Geheimnis der Datenbank als Systemparameter einträgt. Die Installation des Moduls allein schaltet sie nicht ein. Diese Werte erhalten Sie unter hallo@kflow.one.

Ohne das Modul

Die Apps lesen und schreiben Ihre Odoo-Daten mit und ohne das Modul. Ohne Modul ändert sich Folgendes.

Funktion	Ohne das Modul
Firmen-Login	Nicht in der App. Benutzer melden sich mit Odoo-Login und Passwort an. Nutzt das Unternehmen Zwei-Faktor-Authentifizierung, Single Sign-on oder Passkeys, erstellen die Benutzer in Odoo einen API-Schlüssel und geben ihn in der App ein. Die App erklärt die Schritte, die Support-Seite listet sie auf.
Gerät sperren	Die Apps können einen Schlüssel nicht selbst widerrufen. Ein Schlüssel bleibt gültig, bis er abläuft oder in Odoo gelöscht wird.
Einchecken	Nur Benutzer mit den Rechten eines Anwesenheits-Verantwortlichen können ein- und auschecken. Mit dem Modul kann es jeder Mitarbeiter, wenn das Unternehmen das Einchecken über das Menü erlaubt.
Direktchats	Sie funktionieren. Unter Odoo 19 kann ein neuer Chat für die andere Person schon vor der ersten Nachricht erscheinen.
PDFs	Nur Datensätze mit einer Kundenportal-Seite erhalten ein PDF. Der Link enthält ein geheimes Token, das jeder nutzen kann, bis es in Odoo zurückgesetzt wird. Eine Lieferung ohne zugehörigen Kundenauftrag hat kein PDF.
Hinweise	Auf iPhone und iPad prüft die App im Hintergrund von Zeit zu Zeit Ihr Odoo und zeigt Mitteilungen zu neuen Genehmigungen, Aktivitäten, Direktnachrichten und Erwähnungen. iOS bestimmt, wie oft das geschieht, daher kommen diese Hinweise nicht sofort. Die Mac-App hat keine Hinweise im Hintergrund.
Lizenz der Organisation	Die Apps sehen die Lizenz Ihrer Organisation nicht. Sie fragen dann nach einem persönlichen Abonnement.

Voraussetzungen

Odoo 17, 18 oder 19, selbst betrieben oder auf Odoo.sh. Das Modul braucht nur die Standard-Apps Base, Web und Discuss, die jedes Odoo hat.
Das Einchecken braucht die App Anwesenheit. PDFs brauchen die App Buchhaltung, Verkauf oder Lager des jeweiligen Dokuments.
Odoo Online kann das Modul nicht aufnehmen, weil es keine Module von außerhalb erlaubt. Die Apps funktionieren dort trotzdem mit dem Custom-Tarif, der den Zugriff über die externe API enthält. Benutzer melden sich mit Login und Passwort oder einem API-Schlüssel an, erhalten Hinweise im Hintergrund auf iPhone und iPad und haben die Funktionen wie unter „Ohne das Modul“ beschrieben.

Installation

Sie müssen Administrator des Odoo-Servers sein. Die Schritte sind für Odoo 17, 18 und 19 gleich.

Auf einem Server, den Sie selbst betreiben

Entpacken Sie den Download. Sie erhalten einen Ordner namens odoo_companion. Behalten Sie diesen Namen.
Kopieren Sie den Ordner in einen Addons-Pfad Ihres Servers: einen Ordner, den addons_path in Ihrer Odoo-Konfiguration aufführt.
Starten Sie Odoo neu.
Melden Sie sich als Administrator an und schalten Sie den Entwicklermodus ein (Einstellungen, dann Entwicklermodus aktivieren).
Öffnen Sie Apps und wählen Sie App-Liste aktualisieren.
Entfernen Sie den Filter „Apps“ aus dem Suchfeld, suchen Sie nach „Klarflow“ und klicken Sie auf Installieren.

Statt der Schritte 4 bis 6 können Sie odoo -d <Datenbank> -i odoo_companion --stop-after-init ausführen und Odoo danach wieder starten.

Mit Docker

Entpacken Sie den Download und legen Sie den Ordner odoo_companion in einen Ordner auf dem Host, zum Beispiel extra-addons.
Binden Sie diesen Ordner im Odoo-Container unter /mnt/extra-addons ein. Das offizielle Odoo-Image hat diesen Pfad in seinem Addons-Pfad. In Docker Compose: ./extra-addons:/mnt/extra-addons unter volumes.
Starten Sie den Container neu.
Machen Sie mit den Schritten 4 bis 6 oben weiter.

Statt den Ordner einzubinden, können Sie ihn in den Container kopieren, solange er in einem Ordner im Addons-Pfad landet und einen Neustart übersteht.

Auf Odoo.sh

Entpacken Sie den Download und fügen Sie den Ordner odoo_companion dem Repository Ihres Projekts hinzu, auf dem Branch, den Sie nutzen möchten.
Committen und pushen Sie. Odoo.sh baut den Branch.
Öffnen Sie den neuen Build, schalten Sie den Entwicklermodus ein und öffnen Sie Apps.
Wählen Sie App-Liste aktualisieren, entfernen Sie den Filter „Apps“, suchen Sie nach „Klarflow“ und klicken Sie auf Installieren.

Prüfen, ob es funktioniert

Öffnen Sie eine Klarflow-App, geben Sie Ihre Serveradresse ein und wählen Sie den Firmen-Login. Die Anmeldeseite Ihres Odoo öffnet sich in einem Browserfenster. Nach der Anmeldung fragt Odoo, ob die App auf Odoo zugreifen darf. Wählen Sie Erlauben, dann ist die App angemeldet. Der Schlüssel, den sie erhält, erscheint in Ihren Odoo-Präferenzen unter Kontosicherheit.

Aktualisieren

Laden Sie die neue Version herunter.
Ersetzen Sie den Ordner odoo_companion auf Ihrem Server durch den neuen.
Starten Sie Odoo neu.
Öffnen Sie Apps, suchen Sie Klarflow und klicken Sie auf Upgrade. Oder führen Sie odoo -d <Datenbank> -u odoo_companion --stop-after-init aus.

Entfernen

Öffnen Sie Apps, suchen Sie Klarflow und wählen Sie Deinstallieren. Danach können Sie den Ordner löschen.

Die API-Schlüssel, die Geräte bereits erhalten haben, sind normale Odoo-Schlüssel. Sie werden nicht gelöscht und bleiben gültig, bis sie ablaufen oder gelöscht werden. Um den Zugriff eines Geräts zu beenden, löschen Sie seinen Schlüssel in den Präferenzen des Benutzers unter Kontosicherheit. Nach dem Entfernen funktionieren neue Anmeldungen mit dem Firmen-Login nicht mehr, und die Apps nutzen die Ausweichwege, die unter „Ohne das Modul“ stehen.

Lizenz und Support

Das Modul ist freie Software unter der LGPL-3. Fragen zum Modul: hallo@kflow.one. Weitere Hilfe auf der Support-Seite.