# Send Mail

Dieser Funktionsblock ermöglicht es Benutzern, E-Mails über die Gmail API zu senden. Er unterstützt das Senden von Nachrichten mit optionalen Anhängen und ermöglicht nahtlose Kommunikation direkt aus der Benutzeroberfläche.

## 📥 Eingänge <a href="#inputs" id="inputs"></a>

`Subject` Die Betreffzeile der E-Mail.

`Content` Der Textinhalt der E-Mail.

`Sender Address` Die E-Mail-Adresse, von der die E-Mail gesendet wird. Bitte stellen Sie sicher, dass diese Adresse mit der Gmail API aktiviert ist.

`Mail API Password` Das Passwort oder anwendungsspezifische Passwort für das E-Mail-Konto des Absenders.

`Receiver Address` Die E-Mail-Adresse des Empfängers.

`Attachment File Path` Der Dateipfad zu einem Anhang, den Sie in die E-Mail einfügen möchten. Dieser Eingang ist optional.

`Trigger` Ein Boolesches Signal, das zum Auslösen des Versandvorgangs der E-Mail verwendet wird.

## 📤 Ausgänge <a href="#outputs" id="outputs"></a>

`Success` Eine Boolesche Ausgabe, die angibt, ob die E-Mail erfolgreich gesendet wurde.

## 🕹️ Steuerungen <a href="#controls" id="controls"></a>

* **Aktuell unterstützter Versand**: Informationslabels, die die Anforderungen von Gmail zum Senden von E-Mails beschreiben.
* **Aktivierung der Absender-E-Mail**: Gibt Hinweise darauf, dass die Absender-E-Mail über die Gmail API aktiviert werden muss.

## 🎨 Funktionen <a href="#features" id="features"></a>

`Attachment Support` Benutzer können Anhänge aus ihrem lokalen Dateisystem beim Senden von E-Mails hinzufügen.

`Gmail API Integration` Nutzt die Gmail API für sichere E-Mail-Kommunikation.

`Error Handling` Der Block versucht, Ablaufzeiten der SMTP-Sitzung elegant zu handhaben und stellt die Verbindungen nahtlos wieder her.

## 📝 Nutzungshinweise <a href="#usage" id="usage"></a>

1. **Set Up Sender Address**: Geben Sie die Gmail-Adresse des Absenders ein und stellen Sie sicher, dass sie über die Gmail API aktiviert ist.
2. **Compose Email**: Füllen Sie die Felder `Subject` und `Content` aus, um die E-Mail zu erstellen.
3. **Add Attachment (Optional)**: Wenn Sie einen Anhang einfügen möchten, geben Sie den Dateipfad im Feld `Attachment File Path` an.
4. **Trigger Sending**: Aktivieren Sie den Parameter `Trigger`, um die E-Mail zu senden.

## 📊 Bewertung <a href="#evaluation" id="evaluation"></a>

Bei Auslösung erstellt der Funktionsblock die E-Mail und versucht, sie zu senden. Der Erfolgsstatus wird ausgegeben und bestätigt, ob die Sendaktion erfolgreich war.

## 🛠️ Fehlersuche <a href="#troubleshooting" id="troubleshooting"></a>

<details>

<summary>E-Mail konnte nicht gesendet werden</summary>

Stellen Sie sicher, dass das E-Mail-Konto des Absenders korrekt eingerichtet und für den API-Zugriff aktiviert ist. Überprüfen Sie auch, ob das angegebene Passwort korrekt ist.

</details>

<details>

<summary>Anhang nicht gefunden</summary>

Wenn Sie eine Fehlermeldung zu Anhängen erhalten, stellen Sie sicher, dass der angegebene Dateipfad gültig ist und die Datei an diesem Ort vorhanden ist.

</details>

<details>

<summary>Sitzungsablauf</summary>

Wenn Sie Warnungen über Sitzungsausfälle erhalten, warten Sie einen kurzen Moment und versuchen Sie dann, die Aktion erneut auszulösen. Der Block verarbeitet die Wiederverbindung der Sitzung automatisch.

</details>


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.augelab.com/german/function-blocks/input-output/communication/send-mail.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.