# `cloud_link` — Öffentlichen Cloud-Freigabelink erzeugen

**Zweck:** Gibt eine Datei im angebundenen Cloud-Speicher per öffentlichem Link frei und schreibt die Link-URL in den Kontext. Optional wird eine lokale Datei zuvor hochgeladen. Standardberechtigung ist „nur lesen"; Passwortschutz und Ablaufdatum werden unterstützt.

**Parameter**

| Name | Pflicht? | Default | Beschreibung |
|---|---|---|---|
| `remote` | **ja** | — | Zielpfad in der Cloud (relativ, ohne führenden `/`) |
| `local` | nein | — | Lokale Datei, die vor der Freigabe an `remote` hochgeladen wird; Upload-Fehler bricht den Task ab |
| `password` | nein | *(keins)* | Passwort für den Freigabelink |
| `expire_days` | nein | `0` (kein Ablauf) | Ablauf des Links in Tagen ab heute |
| `permissions` | nein | `1` | Berechtigungen: `1` = nur lesen, `15` = Vollzugriff |
| `cloud_user` | nein | *(Standardzugang)* | Alias eines konfigurierten Cloud-Zugangs |
| `link_var` | nein | `share_url` | Name der Kontextvariablen für die öffentliche URL |
| `token_var` | nein | *(keine)* | Name der Kontextvariablen für das Share-Token |

**Eingangswerte:** Pfad-Variablen wie `{{latest_pdf_path}}` für `<local>`; alle Felder unterstützen Platzhalter.

**Ausgangswerte:**
- `<link_var>` (Default `share_url`) — öffentliche Freigabe-URL
- `<token_var>` — Share-Token (nur wenn konfiguriert)

```xml
<task type="cloud_link" id="share_pdf">
  <config>
    <remote>Workflow/{{WORKFLOW_ID}}/{{filename}}.pdf</remote>
    <local>{{latest_pdf_path}}</local>
    <expire_days>14</expire_days>
    <link_var>share_url</link_var>
  </config>
</task>
```