# Erste Schritte

So fügen Sie einem Flow in Power Automate eine Aktion von PDF Blocks hinzu und verbinden ihn über einen API-Schlüssel mit Ihrem Konto.

PDF Blocks ist ein Connector für Power Automate, Power Apps und Azure Logic
Apps. Dieser Leitfaden konzentriert sich auf Power Automate, das meiste davon
lässt sich aber ebenso auf Azure Logic Apps anwenden.

## Voraussetzungen

Um mit PDF Blocks zu beginnen, brauchen Sie:

- Einen kostenpflichtigen Plan für Power Automate, entweder pro Benutzer oder
  pro Flow.
- Ein Konto bei PDF Blocks. Falls Sie noch keines haben, [erstellen Sie ein
  kostenloses Konto](https://accounts.pdfblocks.com/signup): der Free-Plan
  verlangt keine Kreditkarte.

## Ihr API-Schlüssel

Ihren API-Schlüssel erhalten Sie in Ihrem
[Dashboard](https://accounts.pdfblocks.com).

Dieser API-Schlüssel gibt seinem Inhaber (zum Beispiel Ihrem Konto bei Power
Automate) ausschließlich Zugriff auf den Dienst von PDF Blocks. Wer den
API-Schlüssel besitzt, kann nicht auf Ihre Dokumente oder Ihre privaten
Eingabedaten zugreifen, denn wir speichern Ihre Dokumente und Daten nicht.
Bewahren Sie ihn trotzdem sicher auf und veröffentlichen Sie ihn nicht.

Sie können einen Schlüssel jederzeit im Dashboard widerrufen und einen neuen
erzeugen.

## Schritt 1: PDF Blocks auswählen

Fügen Sie in einem Flow in Power Automate eine neue Aktion hinzu. Suchen Sie im
Bereich **Add an action** nach PDF Blocks.

<Frame caption="Suche nach PDF Blocks im Bereich Add an action.">
  <img src="/images/power-automate/getting-started/search-for-pdf-blocks.png" alt="Suche nach PDF Blocks im Bereich Add an action von Power Automate" />
</Frame>

Die Suche stellt PDF Blocks nicht immer an die erste Stelle: Scrollen Sie
deshalb in den Ergebnissen nach unten, bis Sie zur Gruppe **PDF Blocks**
gelangen. Wenn Sie die gewünschte Aktion nicht sehen, wählen Sie in dieser
Gruppe **Weitere anzeigen** (*See more*), um alle Aktionen von PDF Blocks
aufzulisten, und nehmen Sie dann die passende.

## Schritt 2: Verbindung erstellen

Wenn Sie zum ersten Mal eine Aktion von PDF Blocks zu einem Flow hinzufügen,
fragt Power Automate einige Parameter ab, um eine Verbindung zu erstellen:

<Frame caption="Eine Verbindung in Power Automate erstellen.">
  <img src="/images/power-automate/getting-started/create-a-connection-global.png" alt="Der Bereich zum Erstellen einer Verbindung in Power Automate, mit dem Standardserver" />
</Frame>

Parameter der Verbindung:

- Schreiben Sie in **Connection name** eine beliebige Zeichenfolge, die Sie als
  Namen der Verbindung verwenden möchten. Im Beispiel oben haben wir
  „PDF Blocks Default“ verwendet.
- Schreiben Sie in **API Key** Ihren API-Schlüssel von PDF Blocks. Während Sie
  ihn eingeben, wird er wie jedes andere Passwort durch Punkte maskiert.
- Lassen Sie **Server Hostname** leer, um den Standardserver
  (`api.pdfblocks.com`) zu verwenden.

Drücken Sie **Neu erstellen** (*Create new*), um Ihre Verbindung zu erstellen.
Sobald die Verbindung erstellt ist, können Sie PDF Blocks in jedem Ihrer Flows
verwenden.

### Dokumente in einer bestimmten Region verarbeiten

Lassen Sie **Server Hostname** leer, dann leitet PDF Blocks jede Anfrage an
nahe gelegene Infrastruktur weiter, für die niedrigste Latenz. Damit die
Verarbeitung in einer bestimmten Rechtsordnung bleibt, tragen Sie stattdessen
den Hostnamen dieser Region ein. Um zum Beispiel ausschließlich auf
europäischen Servern zu verarbeiten, schreiben Sie `eu.api.pdfblocks.com` in
das Feld **Server Hostname**, bevor Sie die Verbindung erstellen:

<Frame caption="Verwenden Sie eu.api.pdfblocks.com, um Dokumente in der EU zu verarbeiten.">
  <img src="/images/power-automate/getting-started/create-a-connection-eu.png" alt="Der Bereich zum Erstellen einer Verbindung in Power Automate, mit dem Server-Hostnamen der EU" />
</Frame>

Welche Regionen verfügbar sind und welchen Hostnamen Sie jeweils eintragen,
hängt von Ihrem Plan ab:

| Region                 | Server Hostname           | Verfügbar in                        |
| ---------------------- | ------------------------- | ----------------------------------- |
| Global (Standard)      | _Leer lassen_             | Allen Plänen                        |
| USA                    | `us.api.pdfblocks.com`    | Starter und Business                |
| Europäische Union      | `eu.api.pdfblocks.com`    | Starter und Business                |
| Vereinigtes Königreich | `uk.api.pdfblocks.com`    | Business                            |
| Kanada                 | `ca.api.pdfblocks.com`    | Business                            |
| Australien             | `au.api.pdfblocks.com`    | Business                            |
| Japan                  | `jp.api.pdfblocks.com`    | Business                            |
| Indien                 | `in.api.pdfblocks.com`    | Business                            |
| Brasilien              | `br.api.pdfblocks.com`    | Business                            |
| HIPAA USA              | `hipaa.api.pdfblocks.com` | Business (nur mit unterzeichnetem BAA) |

Siehe [Regionen und Datenresidenz](/docs/api/regions-and-data-residency) für
alle Details zu jedem Endpoint.

## Hilfe erhalten

Brauchen Sie Unterstützung? Öffnen Sie über **Support** in Ihrem
[Dashboard](https://accounts.pdfblocks.com) ein Support-Ticket. Beschreiben Sie
das Problem (Sie können Dateien anhängen), und wir antworten im selben Thread,
mit Benachrichtigungen per E-Mail im weiteren Verlauf des Gesprächs.

Wenn Sie nicht auf Ihr Dashboard zugreifen können, schreiben Sie uns an
[support@pdfblocks.com](mailto:support@pdfblocks.com).