> For the complete documentation index, see [llms.txt](https://help.vario-software.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.vario-software.de/vario-cloud-handbuch/system/eigene-werkzeuge-per-lesezeichen.md).

# Eigene Werkzeuge per Lesezeichen

Kleine Zusatzwerkzeuge per Browser-Lesezeichen im geöffneten VARIO Cloud starten: was damit geht, wo die Grenzen liegen und worauf Du bei der Sicherheit achten musst.

Ein Lesezeichen-Werkzeug ist ein kleines Zusatzprogramm, das Du über ein Lesezeichen in Deinem Browser startest, während VARIO Cloud geöffnet ist. Es arbeitet mit Deiner Anmeldung und Deinen Rechten und erledigt Aufgaben, für die Du sonst viele Datensätze einzeln bearbeiten müsstest – ganz ohne App und ohne Installation.

{% hint style="danger" %}

### Keine Funktion von VARIO Cloud – keine Wartung, kein Support

Lesezeichen-Werkzeuge sind eine Technik, keine Funktion von VARIO Cloud. Solche Werkzeuge nutzen interne Abläufe der Oberfläche, die sich mit jeder neuen Version ändern können. VARIO liefert für solche Werkzeuge **keine Wartung** aus und leistet **keinen Support**. Es ist **nicht sichergestellt, wie lange** ein Werkzeug funktioniert und **ob es in jedem Browser** läuft. Ein Update kann jedes Werkzeug ohne Vorankündigung unbrauchbar machen.
{% endhint %}

## Wie funktioniert ein Lesezeichen-Werkzeug?

Du bekommst das Werkzeug als einzelne HTML-Datei. Darin steckt ein Knopf, den Du einmal in Deine **Lesezeichenleiste** ziehst. Klickst Du später auf dieses Lesezeichen, während VARIO Cloud geöffnet ist, legt sich das Werkzeug als Fenster über die Seite.

Das Werkzeug nutzt die Anmeldung, mit der Du gerade in VARIO Cloud arbeitest. Du gibst also kein Passwort und keine Zugangsdaten ein. Es liest und schreibt Daten über dieselbe Schnittstelle wie die Oberfläche und kann deshalb genau das, was Du mit Deinen Rechten auch von Hand tun könntest.

Läuft eine Bearbeitung länger, erneuert VARIO Cloud im Hintergrund Deine Anmeldung. Das Werkzeug wartet dann kurz und zeigt Dir das an; Du musst nichts tun.

## Wofür eignet sich ein Lesezeichen-Werkzeug?

| Idee                                  | Was passiert                                                                                                        |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Kundenpreise erhöhen**              | Alle kundenindividuellen Preise eines Kunden bekommen ab einem Stichtag einen Aufschlag in Prozent als neuen Preis. |
| **Werte aus einer Liste übernehmen**  | Du fügst Artikelnummern und Werte aus Excel ein, siehst eine Vorschau und überträgst sie dann in einem Schritt.     |
| **Datenqualität prüfen**              | Das Werkzeug listet z. B. Artikel ohne EAN oder Kunden ohne Zahlungsbedingung auf, jeweils mit Link zum Datensatz.  |
| **Schnell exportieren**               | Eine Abfrage läuft und das Ergebnis landet als CSV-Datei auf Deinem Rechner.                                        |
| **Zum geöffneten Datensatz arbeiten** | Das Werkzeug erkennt, welcher Artikel, Kunde oder Beleg gerade geöffnet ist, und arbeitet direkt damit.             |
| **Vor einem Import prüfen**           | Eine eingefügte Liste wird mit Deinen Stammdaten verglichen: Was ist neu, was würde sich ändern?                    |
| **Mehrere Schritte zusammenfassen**   | Ein kleiner Assistent erledigt eine Abfolge von Arbeitsschritten, die Du sonst einzeln durchklicken würdest.        |

## Wo liegen die Grenzen?

* **Nur solange der Tab offen ist.** Ein Lesezeichen-Werkzeug läuft nicht zeitgesteuert, nicht nachts und nicht automatisch beim Speichern.
* **Nur mit Deinen Rechten.** Fehlt Dir ein Recht, fehlt es auch dem Werkzeug.
* **Nicht in jedem Browser und auf jedem Gerät.** Firmenbrowser mit strengen Vorgaben können solche Lesezeichen sperren. Tablets, Smartphones und MDE-Geräte haben meist keine Lesezeichenleiste.
* **Keine Einbindung in VARIO Cloud.** Es gibt keine eigenen Menüpunkte, Dialoge oder Kacheln.
* **Automatische Updates nur über das DMS.** Hast Du den Knopf aus einer HTML-Datei gezogen, musst Du ihn nach jeder Änderung des Werkzeugs erneut in die Lesezeichenleiste ziehen. Holt das Lesezeichen das Werkzeug aus dem DMS, genügt eine neue Revision – siehe Abschnitt **Werkzeug über das DMS verteilen und aktualisieren** weiter unten.
* **Nicht als Werkzeug erkennbar.** Änderungen erscheinen in VARIO Cloud so, als hättest Du sie selbst vorgenommen.

## Worauf musst Du bei der Sicherheit achten?

Ein Lesezeichen-Werkzeug arbeitet mit **allen Rechten Deines Benutzers**. Ein manipuliertes Werkzeug könnte deshalb alles lesen, ändern oder löschen, was Du darfst, Daten nach außen senden oder Dich auf der echten VARIO-Cloud-Adresse nach Deinem Passwort fragen.

* **Nutze nur Werkzeuge aus vertrauenswürdiger Quelle**, z. B. direkt von Deinem VARIO-Ansprechpartner. Lass die Datei bei Bedarf von Deiner IT prüfen.
* **Ziehe nie Knöpfe aus unbekannten Dateien, E-Mails oder Webseiten** in Deine Lesezeichenleiste.
* **Arbeite mit einem Benutzer ohne Administratorrechte**, der nur die Rechte hat, die das Werkzeug braucht.
* **Gib in einem Werkzeug nie Passwörter oder Zugangsdaten ein.** Ein Lesezeichen-Werkzeug braucht sie nicht.
* **Prüfe vor dem Schreiben die Vorschau** und starte bei Massenänderungen zuerst mit wenigen Datensätzen.
* **Liegt das Werkzeug im DMS, dürfen nur wenige vertrauenswürdige Personen das Dokument ändern.** Wer eine neue Revision hochlädt, bestimmt, was beim nächsten Klick bei allen Benutzern ausgeführt wird.

## So richtest Du ein Werkzeug ein

{% stepper %}
{% step %}

### Lesezeichenleiste einblenden

In den meisten Browsern blendest Du die Lesezeichenleiste mit **Strg+Umschalt+B** ein (Mac: **Cmd+Umschalt+B**).
{% endstep %}

{% step %}

### Knopf in die Lesezeichenleiste ziehen

Öffne die HTML-Datei des Werkzeugs im Browser und ziehe den Knopf mit gedrückter Maustaste in die Lesezeichenleiste. Ein normaler Klick auf den Knopf startet das Werkzeug nicht.
{% endstep %}

{% step %}

### Werkzeug in VARIO Cloud starten

Öffne VARIO Cloud, melde Dich an und klicke in der Lesezeichenleiste auf das neue Lesezeichen. Ein zweiter Klick schließt das Werkzeug wieder.
{% endstep %}
{% endstepper %}

## Werkzeug über das DMS verteilen und aktualisieren

Statt das Werkzeug als Datei weiterzugeben, kann es als HTML-Datei in Deinem DMS liegen. Das Lesezeichen enthält dann nur einen kleinen Lader, der bei jedem Klick die aktuelle Fassung über einen öffentlichen Link aus dem DMS holt. Für ein Update lädst Du im DMS eine neue Revision hoch. Alle Benutzer arbeiten beim nächsten Klick mit der neuen Fassung, ohne ihr Lesezeichen zu ändern.

{% hint style="warning" %}
Wer das Dokument im DMS ändern darf, bestimmt, was bei jedem Klick auf das Lesezeichen ausgeführt wird – mit den Rechten des Benutzers, der gerade klickt. Lege das Werkzeug deshalb so ab, dass nur wenige vertrauenswürdige Personen es ändern dürfen.

Über den öffentlichen Link kann jeder die Datei lesen, der den Link kennt. Sie darf also keine Passwörter oder anderen vertraulichen Angaben enthalten.
{% endhint %}

{% stepper %}
{% step %}

### Werkzeug im DMS ablegen

Lade die HTML-Datei des Werkzeugs in Dein DMS hoch.
{% endstep %}

{% step %}

### Öffentlichen Link anlegen

Öffne das Dokument, wechsle in den Tab **»Öffentliche Links«** und klicke auf **»Teilen«**. Stelle **„Erlaubte Anzahl der Verwendungen“** auf **Unbegrenzt** und lass **„Gültigkeit in Minuten“** leer. Kopiere anschließend den Link.

Mit **Einmalig** funktioniert das Lesezeichen nur beim ersten Klick, mit einer Gültigkeit nur bis zu deren Ablauf.
{% endstep %}

{% step %}

### Lesezeichen anlegen

Öffne die Einrichtungsseite, die Du zusammen mit dem Werkzeug bekommen hast, füge den kopierten Link ein und ziehe den Knopf in die Lesezeichenleiste.
{% endstep %}
{% endstepper %}

### Werkzeug aktualisieren

Öffne das Dokument im DMS, wechsle in den Tab **»Revisionen«** und lade über **»Revision«** die neue Datei hoch. Beim nächsten Klick auf das Lesezeichen startet die neue Fassung. Am Lesezeichen und am öffentlichen Link änderst Du nichts.

### Wenn das Werkzeug nicht startet

| Anzeige                                                   | Ursache und Lösung                                                                                                                                                                |
| --------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Werkzeug konnte nicht geladen werden: HTTP 404**        | Der öffentliche Link ist abgelaufen, gelöscht oder war nur einmal verwendbar. Lege einen neuen Link mit **Unbegrenzt** und ohne Gültigkeit an und richte das Lesezeichen neu ein. |
| **Werkzeug konnte nicht geladen werden: Failed to fetch** | Du hast das Lesezeichen nicht in einem Tab mit VARIO Cloud angeklickt.                                                                                                            |
| Das Werkzeug zeigt noch die alte Fassung                  | Die neue Datei ist nicht als aktuelle Revision gespeichert. Prüfe den Tab **»Revisionen«**.                                                                                       |

Das Lesezeichen funktioniert nur in dem Mandanten, in dessen DMS das Werkzeug liegt.

## Wann ist eine App oder ein Skript die bessere Wahl?

| Du brauchst …                                                  | Besser geeignet                                                                                                                                                           |
| -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Eine Aufgabe, die regelmäßig oder automatisch laufen soll      | [Skripte](https://help.vario-software.de/vario-cloud-handbuch/system/skripte.md) und [Workflows](https://help.vario-software.de/vario-cloud-handbuch/system/workflows.md) |
| Eine Lösung für viele Benutzer mit eigenen Rechten und Support | Eine [App](https://help.vario-software.de/vario-cloud-handbuch/grundlagen-und-konzepte/app-konzept.md)                                                                    |
| Eine dauerhafte Anbindung an ein anderes System                | Eine [App](https://help.vario-software.de/vario-cloud-handbuch/grundlagen-und-konzepte/app-konzept.md) oder die REST-API                                                  |

Wie ein Lesezeichen-Werkzeug technisch aufgebaut ist, beschreibt die [Entwickler-Dokumentation zu Browser-Werkzeugen](https://developer.vario-software.de/documentation/rest-api/browser-tools).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.vario-software.de/vario-cloud-handbuch/system/eigene-werkzeuge-per-lesezeichen.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
