> For the complete documentation index, see [llms.txt](https://hub.equipme.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hub.equipme.io/pro/dokumentation/automation/connectors/utilities.md).

# Hilfsmodule: Lists und PDF

Hilfsmodule Lists und PDF für Provider: Kundenbestände abgleichen, Listen zusammenführen, Übergabeprotokolle und Berichte als PDF für Kunden erzeugen.

**Pfad:** „Automation“ → „Workflows“ → Flow-Designer → Module **„Lists“** und **„PDF“**

Die Hilfsmodule **Lists** und **PDF** gehören zu equipme und ergänzen das Modul [„Equipme Pro“](https://hub.equipme.io/pro/dokumentation/automation/connectors/equipme-pro.md) und die übrigen Connectoren in [Workflows](https://hub.equipme.io/pro/dokumentation/automation/workflows.md). Sie verbinden kein eigenes System, sondern verarbeiten Daten im Flow: Listen vergleichen und zusammenführen sowie Dokumente als PDF erzeugen.

## Wofür?

* **Bestandsabgleich je Kunde:** Serviceinstanzen eines Kunden in Pro mit der Geräteliste aus seiner Geräteverwaltung oder deinem ERP vergleichen – fehlende, neue und abweichende Geräte getrennt bearbeiten.
* **Mitarbeiterabgleich je Kunde:** Mitarbeiterliste eines Kunden in Pro mit der Liste aus seinem HR-System vergleichen.
* **Listen zusammenführen:** Ergebnisse mehrerer Kunden oder Quellen zu einer Liste verbinden, z. B. für einen Gesamtbericht.
* **Übergabeprotokoll und Lieferschein:** Bei jeder Auslieferung ein PDF mit Kunde, Gerät, Seriennummer und Empfänger erzeugen und an den Kunden senden.
* **Kundenberichte:** Bestand oder offene Aufträge eines Kunden monatlich als PDF-Bericht verschicken.

## Voraussetzungen

* Das freigeschaltete [Automation-Modul](https://hub.equipme.io/pro/dokumentation/automation.md)
* **Lists:** keine Verbindung nötig.
* **PDF:** eine Verbindung des [equipme Connectors](https://hub.equipme.io/pro/dokumentation/automation/connectors/equipme-pro.md) mit dem API-Key aus Equipme Pro. Die Umwandlung läuft über equipme.

## Verbindung einrichten

Die Komponenten des Moduls **Lists** funktionieren ohne Verbindung.

Für **HtmlToPdf** im Modul **PDF**:

1. Komponente *HtmlToPdf* auf die Arbeitsfläche ziehen.
2. **Connect account** klicken und die bestehende Pro-Verbindung auswählen oder eine neue mit **Label** und **API Key** anlegen (siehe [equipme Connector – Pro-Module](https://hub.equipme.io/pro/dokumentation/automation/connectors/equipme-pro.md#verbindung-einrichten)).
3. Die Verbindung erscheint unter **„Accounts“**.

## Trigger

Die Hilfsmodule haben **keine Trigger**. Sie arbeiten mit den Daten vorheriger Komponenten.

## Modul „Lists“

| Komponente | Zweck                                                                | Wichtige Optionen               |
| ---------- | -------------------------------------------------------------------- | ------------------------------- |
| Compare    | Zwei Listen vergleichen und die Einträge auf vier Ausgänge verteilen | Origin, Update, Key, Attributes |
| Join       | Zwei Listen zu einer Liste zusammenführen                            | Array 1, Array 2                |

### Compare

*Compare* vergleicht eine Ausgangsliste (**Origin**) mit einer neuen Liste (**Update**). Beide Eingänge erwarten eine **Liste** – bei equipme-Komponenten also den Output Type „All items at once“.

| Option     | Bedeutung                                                                                                                                            |
| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| Origin     | Die Ausgangsliste, z. B. die Serviceinstanzen eines Kunden aus Pro.                                                                                  |
| Update     | Die neue Liste, z. B. die Geräte aus der Geräteverwaltung des Kunden.                                                                                |
| Key        | Pflicht. Ein oder mehrere Felder (durch Komma getrennt), die einen Eintrag eindeutig kennzeichnen, z. B. das Feld mit der Seriennummer oder `email`. |
| Attributes | Optional. Felder (durch Komma getrennt), deren Änderung einen Eintrag als „geändert“ markiert. Leer: Es wird nur auf neu und entfallen geprüft.      |

Ausgänge:

| Ausgang   | Inhalt                                                                                                                                                                                             |
| --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| added     | Einträge, die nur in **Update** vorkommen (neu).                                                                                                                                                   |
| changed   | Einträge in beiden Listen, bei denen sich mindestens eines der **Attributes** unterscheidet. Felder aus beiden Listen werden zusammengeführt, bei gleichen Feldnamen gilt der Wert aus **Update**. |
| removed   | Einträge, die nur in **Origin** vorkommen (entfallen).                                                                                                                                             |
| unchanged | Einträge in beiden Listen ohne Änderung. Bei gleichen Feldnamen gilt der Wert aus **Origin**.                                                                                                      |

Gut zu wissen:

* Groß- und Kleinschreibung wird beim Vergleich ignoriert.
* Die Feldnamen von **Key** und **Attributes** müssen in **beiden** Listen gleich heißen. Heißt ein Feld im Fremdsystem anders, benenne es vorher um (z. B. mit einer Komponente, die die Liste neu aufbaut).
* Jeder Ausgang liefert eine Liste – auch eine leere. Um Einträge einzeln weiterzuverarbeiten, die Liste anschließend in Einzeleinträge aufteilen.
* Kommt ein Schlüssel in einer Liste mehrfach vor, zählt nur der letzte Eintrag.
* Vergleiche **je Kunde**: Filtere beide Listen auf denselben Kunden, sonst erscheinen Geräte anderer Kunden als „removed“.

### Join

*Join* hängt **Array 2** an **Array 1** an und gibt eine gemeinsame Liste aus. Doppelte Einträge werden **nicht** entfernt.

## Modul „PDF“

| Komponente | Zweck                                                                | Wichtige Optionen                                                  |
| ---------- | -------------------------------------------------------------------- | ------------------------------------------------------------------ |
| HtmlToPdf  | HTML-Inhalt in ein PDF umwandeln und als Datei im Flow bereitstellen | Title, Header, Body, Footer, Ränder, Paper Size, Paper Orientation |

### HtmlToPdf

| Option                             | Bedeutung                                                                                                                    |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| Title                              | Dateiname des PDFs (ohne Endung). Leer: „document.pdf“.                                                                      |
| Header                             | Optional. HTML für die Kopfzeile jeder Seite, z. B. dein Logo und deine Firmenanschrift.                                     |
| Body                               | Pflicht. HTML des Inhalts. Variablen aus vorherigen Komponenten (Kunde, Gerät, Seriennummer …) lassen sich direkt einsetzen. |
| Footer                             | Optional. HTML für die Fußzeile jeder Seite, z. B. Datum oder Unterschriftszeile.                                            |
| Margin Top / Left / Right / Bottom | Ränder in Pixeln. Ohne Angabe: oben 130 (ohne Header 40), links und rechts 45, unten 100.                                    |
| Paper Size                         | „A4“ (Standard), „A3“, „A5“, „A6“, „Letter“, „Legal“, „Tabloid“, „D“, „E“. „None“ entspricht A4.                             |
| Paper Orientation                  | Ausrichtung der Seite, Standard „Portrait“. Für breite Tabellen eignet sich ein größeres Papierformat (z. B. „A3“).          |

Ergebnis: **File ID**, **File Name** und **Content Type**. Die **File ID** übergibst du an Komponenten, die Dateien annehmen – z. B. **Email › Send Email** (Feld „Attachments“), **Equipme Pro › Upload Service Instance Attachments** oder *AddTicketAttachment* im Connector [Zoho Desk](https://hub.equipme.io/pro/dokumentation/automation/connectors/zoho-desk.md).

{% hint style="info" %}
Verwende einfaches HTML mit eingebettetem CSS (`<style>` im Body). Bilder bindest du am besten über eine öffentlich erreichbare URL oder als eingebettete Daten ein.
{% endhint %}

## Beispiele

### Übergabeprotokoll je Auslieferung

1. **Equipme Pro › New Fulfillment Order** – Trigger, Transaction types „Delivery Request“.
2. **PDF › HtmlToPdf** – Title „Übergabeprotokoll {Kunde} {Seriennummer}“, Header mit deinem Logo, Body mit Kunde, Standort, Empfänger, Gerät, Seriennummer und Datum, Footer mit Unterschriftsfeldern.
3. **Email › Send Email** – an den Ansprechpartner des Kunden, Attachments = File ID aus Schritt 2.
4. **Equipme Pro › Upload Service Instance Attachments** – PDF als Anhang an der Serviceinstanz ablegen.

### Gerätebestand eines Kunden abgleichen

1. **Scheduler** – wöchentlich.
2. **Equipme Pro › List Service Instances** – gefiltert auf den Kunden, Output Type „All items at once“.
3. Geräteliste des Kunden abrufen, z. B. aus seiner Geräteverwaltung per Connector oder **HTTP**. Feld für die Seriennummer so benennen wie in Pro.
4. **Lists › Compare** – Origin = Schritt 2, Update = Schritt 3, Key = Seriennummer.
5. Ausgang **added** → Ticket oder E-Mail „Gerät ohne Serviceinstanz“; Ausgang **removed** → Prüfung, ob das Gerät zurückgegeben wurde.

### Monatlicher Kundenbericht

1. **Scheduler** – am Monatsersten.
2. **Equipme Pro › List Customers** – Output Type „One item at a time“.
3. **Equipme Pro › List Service Instances** – Bestand des Kunden.
4. **PDF › HtmlToPdf** – Bestand als HTML-Tabelle, Paper Size „A4“.
5. **Email › Send Email** – Bericht an den Ansprechpartner des Kunden.

## Hinweise und Grenzen

* *Compare* und *Join* arbeiten im Speicher des Flows. Sehr große Listen (viele tausend Einträge) verlangsamen den Flow – vergleiche besser je Kunde.
* Ein Rand von 0 wird nicht übernommen, dann gilt der Standardwert. Für randlose Seiten 1 eintragen.
* *HtmlToPdf* zählt als Anfrage an equipme und unterliegt dem Anfragelimit des API-Keys (10 Anfragen pro Sekunde).

## Fehlersuche

| Problem                                                  | Ursache / Lösung                                                                                 |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| *Compare* meldet alle Einträge als „added“ und „removed“ | Die **Key**-Felder heißen in beiden Listen unterschiedlich oder sind leer. Feldnamen angleichen. |
| *Compare* meldet Geräte anderer Kunden als „removed“     | Origin ist nicht auf denselben Kunden gefiltert wie Update.                                      |
| *Compare* oder *Join* bricht ab                          | Ein Eingang ist keine Liste. Bei equipme-Komponenten Output Type „All items at once“ wählen.     |
| *HtmlToPdf*: Fehler beim Verbinden                       | API-Key der Pro-Verbindung prüfen.                                                               |
| PDF ist leer oder falsch formatiert                      | Body muss gültiges HTML enthalten. CSS im `<style>`-Block einbetten.                             |
| Kopf- oder Fußzeile überlappt den Inhalt                 | Margin Top bzw. Margin Bottom erhöhen.                                                           |

Protokolle jeder Ausführung findest du unter **„Insights“**.

## Häufige Fragen

**Kann ich das PDF mit meinem eigenen Briefkopf gestalten?**

Ja. Header, Body und Footer sind frei gestaltbares HTML. Lege Logo, Anschrift und Farben im Header bzw. Footer ab und verwende den Flow für alle Kunden.

**Muss die Geräteliste des Kunden dieselben Felder haben wie Pro?**

Nur die Felder in **Key** und **Attributes** müssen in beiden Listen gleich heißen. Alle anderen Felder werden unverändert durchgereicht.

**Wo landet das erzeugte PDF?**

Als Datei im Flow. Dauerhaft gespeichert wird es erst, wenn du es weitergibst – z. B. als E-Mail-Anhang, als Anhang an der Serviceinstanz oder an einem Ticket.


---

# 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://hub.equipme.io/pro/dokumentation/automation/connectors/utilities.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.
