Wie man Berichte über Gmail in FastReport VCL sendet und empfängt

2022-07-20

Wie man Berichte über Gmail in FastReport VCL sendet und empfängt

In diesem Artikel wird Ihnen eine neue Unterkategorie von Transporten namens „Mailtransporte“ vorgestellt, die ab Version 2022.2.7 verfügbar ist. Aktuell enthält sie 2 Komponenten, die den Zugriff auf GMail und Outlook ermöglichen.

Die Mailtransporte unterstützen die folgenden Funktionen:
- Speichern und Hochladen von Berichten;
- Speichern von Exportergebnissen.

Unter dem Speichern versteht man den E-Mail-Versand. Unter dem Hochladen versteht man die Verwendung von Dateien, die einer E-Mail angehängt werden, und die E-Mail kann sich dabei in einer beliebigen E-Mail-Kategorie befinden (Posteingang / Gesendet / Entwürfe usw.).

Weitere Informationen zur Verwendung von Outlook finden Sie unter folgendem Link.

Hinweis! Für die Nutzung des HTTPS-Protokolls werden die folgenden OpenSSL-Bibliotheken benötigt: libssl-3.dll und libcrypto-3.dll. Diese Dateien befinden sich im Verzeichnis der Haupt-Demo-Anwendung. Sie müssen die Bibliotheken entweder in den Anwendungsordner oder in das Systemverzeichnis kopieren.

Inhalt

- Hinzufügen von Transporten zur Anwendung und Konfiguration
- Herstellen der Verbindung zu Google Mail
- Zukunft der Mailtransporte

Aktueller Status der Transporte

FastReport verfügt über Komponenten, die "Transporte" genannt werden. Sie werden benötigt, um den Zugriff auf:

- Cloud-Speicher (Dropbox, OneDrive, Box.com, Google.Drive, Yandex.Disk);

- FTP-Server;

- E-Mail (nur E-Mail-Nachrichten werden gesendet) zu ermöglichen;

- Mail-Dienst (Google Mail, Outlook).

Die folgenden Funktionen werden von Cloud-Speicher und FTP-Servern unterstützt:

- Speichern und Hochladen von Berichten;
- Speichern von Exportergebnissen;
- Verwendung von Dateien (z. B. Bilder) bei der Erstellung eines Berichts.

Hinzufügen von Transporten zur Anwendung und Konfiguration

Transport hinzufügen

1. Gehen Sie zur Komponentenpalette in der Embarcadero Rad Studio-Entwicklungsumgebung und erweitern Sie die Registerkarte “FastReport VCL Internet transports”.

2. Wählen Sie die gewünschte Komponente aus und fügen Sie sie dem Anwendungsformular hinzu. Sie können das Kontextmenü der Komponente verwenden. Damit wird die Verbindung direkt von der Entwicklungsumgebung aus hergestellt. Klicken Sie auf das Untermenü “Edit connection”.

Popup-Fenster bei Rechtsklick auf die Komponente

Standardmäßig reagieren die Transporte nur auf die Autorisierungsantwort eines Browsers über Port 9898. Wenn dieser Port bereits belegt ist oder wenn Sie planen, diesen Port in Zukunft zu verwenden, können Sie mit FastReport VCL den Port ändern, indem Sie die ListenerPort-Eigenschaft konfigurieren.

Objektinspektor nach Auswahl eines Transportes

Im Folgenden wird von dem Standard-Port 9898 ausgegangen. Betrachten wir nun die Verbindungsschritte für die Mailtransporte.

Wichtig! Der Benutzer muss nicht jedes Mal alle der folgenden Schritte ausführen, um sich zu autorisieren. Diese Einstellung wird nur einmal vom Cloud Server Administrator vorgenommen. Wenn alle Schritte abgeschlossen sind, können die Autorisierungsdaten von anderen Benutzern verwendet werden.

Herstellen der Verbindung zu Google Mail

Wenn ein Benutzer einen Bericht (oder ein Exportergebnis) mit Hilfe des Transports öffnen (oder speichern) möchte, wird ihm das Standard-Autorisierungsdialogfeld angezeigt (falls er noch nicht autorisiert ist).

Standard-Autorisierungsdialog der Mailtransporte

Klicken Sie auf das Fragezeichen oben rechts im Autorisierungsfenster, um die Seite mit den Verbindungseinstellungen aufzurufen. Dadurch wird der Standardbrowser mit der Einstellungsseite der Google Mail-Anwendung geöffnet. Wenn der Benutzer in Gmail nicht autorisiert ist, wird eine Autorisierungsseite geöffnet, auf der der Benutzer aufgefordert wird, sich bei seinem Google Mail-Konto anzumelden.

Wenn von diesem Konto noch keine Google-API Projekte hinzugefügt worden sind, muss zunächst ein neues Projekt erstellt werden.

Seite der Anwendungseinstellungen

Klicken Sie auf die Schaltfläche “Create project”.

Erstellungsseite eines neuen Projektes

Geben Sie einen Projektnamen ein und klicken Sie auf “Create”.

Schaltfläche zur Auswahl des aktuellen Projekts auf der Seite der Anwendungseinstellungen

Über die Schaltfläche “Select project” wählen Sie das erstellte Projekt.

Auswahl des aktuellen Projekts

Wählen Sie das zuvor erstellte Projekt aus und klicken Sie auf “Open”.

Seite der OAuth-Autorisierungseinstellungen

Gehen Sie zur Registerkarte “OAuth consent screen”.  Wir müssen den Benutzertyp auswählen, der den Cloud-Speicher verwenden können: interne Nutzung mit Zugriff nur für Benutzer des Unternehmens oder für alle Google-Konten. Klicken Sie im Auswahlfeld auf “Create”.

Erste Stufe der OAuth-Autorisierungseinstellungen

Als nächstes müssen Sie den Anwendungsnamen und die Kontakt-E-Mail-Adresse eingeben. Klicken Sie auf “Save and continue”.

In diesem Schritt können Sie den Aktionsbereich konfigurieren, für Google Mail kann er übersprungen werden. Klicken Sie auf “Save and continue”.

Im nächsten Schritt können Sie den Zugriff auf die Anwendung für eine bestimmte Gruppe von Benutzern konfigurieren. Wenn Sie den Zugriff auf die Anwendung sofort veröffentlichen wollen, können Sie diesen Schritt überspringen. Klicken Sie auf “Save and continue”.

Die Anwendung wurde erstellt, gehen Sie zur Registerkarte “Back to dashboard”.

Erfolgreiche Oauth- Autorisierungseinstellung

Gehen Sie zur Registerkarte “OAuth consent screen” und klicken Sie auf “PUBLISH APP”, um die Anwendung zugänglich zu machen. Öffnen Sie den folgenden Link und aktivieren Sie die Google Mail API für das erstellte Projekt, indem Sie auf die Schaltfläche “Enable” klicken.

Einstellung der Zugangsberechtigung auf Gmail API

Jetzt müssen Sie einen Berechtigungsschlüssel generieren, gehen Sie nun zur Registerkarte “Credentials”.

Verwaltung von Berechtigungsschlüsseln

Klicken Sie auf “Create Credentials” und wählen Sie “OAuth client ID” aus.

Mögliche Erstellungstypen für Berechtigungsschlüssel

Sie müssen den Anwendungstyp auswählen (in unserem Fall Desktop App).

Auswahl des Anwendungstyps in den Erstellungen der Berechtigungsschlüssel

Geben Sie einen beliebigen Namen für die Verbindung ein und klicken Sie auf “Create”. Der Autorisierungsclient wird generiert.

Seitenausschnitt mit dem generierten Paar aus ID-Secret

Kopieren Sie die Felder "Client ID" und "Client Secret" in die entsprechenden Eingabefelder des FastReport VCL Autorisierungsdialogs.

Ausgefüllter Standard- Autorisierungsdialog der Mailtransporte

Klicken Sie auf “OK”. Im Standardbrowser sollte sich ein neues Fenster öffnen. Sie werden aufgefordert, ein Konto für die Autorisierung auszuwählen.

Standard-Kontoauswahl für die Autorisierung

Als nächstes wird ein Dialog angezeigt, dass die Anwendung nicht von Google verifiziert wurde. Klicken Sie “Advanced” und gehen Sie zum Anwendungsnamen (unsafe).

Warnung vor fehlender Verifizierung

Es erscheint ein weiteres Dialogfeld, in dem Sie aufgefordert werden, den Zugriff auf die Anwendung zu gewähren. Wählen Sie die Zugriffsrechte aus und klicken Sie auf “Continue”.

Seite mit der Berechtigungsanforderung

Das Browserfenster kann geschlossen werden. Wenn die Verbindung erfolgreich hergestellt wurde, wird ein Standard FastReport VCL Dateibrowser angezeigt.

Standarddialog zum Hochladen angehängter Dateien

Damit ist die Verbindungskonfiguration erfolgreich abgeschlossen. Sie wissen nun, wie eine Verbindung zu GMail in FastReport VCL hergestellt wird.

Zukunft der Mailtransporte 

Funktionsmäßig unterstützen die Cloud-Transporte alle zuvor genannten Funktionen. Die grafische Darstellung von Mailtransporten beim Hochladen wird in nachfolgenden Versionen weiter verbessert. Zurzeit wird die grafische Benutzeroberfläche (GUI) wie bei den Cloud-Speichern verwendet. Kategorien und Nachrichten sind jetzt als Ordner und Anhänge als Dateien implementiert.

Standarddialog zum Hochladen angehängter Dateien

Weitere grafische Verbesserungen sind geplant, um die Benutzerfreundlichkeit zu erhöhen. Zu den funktionalen Verbesserungen des Hochladens gehört eine Nachrichtensuche.

Die grafische Benutzeroberfläche des Nachrichtenfensters wird ebenfalls geringfügig geändert.

Standarddialog zum Senden von Dateien

Gesondert weisen wir auf die vorübergehende Besonderheit beim Senden von Exportergebnissen hin. Wenn der Export mehrere Dateien generiert, wird jede Datei in einer eigenen E-Mail gesendet. Wenn Sie also das Exportergebnis an ein seitenweises PNG-Bild senden möchten, wird jedes Bild in einer separaten E-Mail gesendet.

Fast alle FastReport VCL Exporte generieren nur eine Ausgabedatei (PDF, DOCX, RTF und andere), die meisten Benutzer werden diese Besonderheit nicht bemerken.

Diese Ungenauigkeit wird in zukünftigen Versionen korrigiert. Wenn Sie Fragen haben, kontaktieren Sie bitte unser Support-Team.

12. August 2024

Erstellen und Installieren des Postgres-Plugins in FastReport .NET

In diesem Artikel wird beschrieben, wie Sie mit dem FastReport .NET-Plugin für den Berichtsdesigner aus Visual Studio über den NuGet-Server eine Verbindung zur Datenbank herstellen.
8. August 2024

Installation von FastReport .NET und ihren Komponenten unter Windows

Schritt für Schritt Anleitung zur Online- und manuellen Installation über den Registrierungscode FastReport .NET und seine Komponenten in Windows.
26. Juli 2024

Aktualisierung von HTMLObject als Plugin für FastReport .NET

Ausführliche Anleitung zur Verwendung des neuen HTMLObject-Plugins, das die Aufteilung des HTML-Doms in FastReport-Berichtsobjekte verwendet.
Fast Reports
  • 800-985-8986 (Englisch, die USA)
  • +4930568373928 (Deutsch)
  • +55 19 98147-8148 (Portugiesisch)
  • info@fast-report.com
  • 901 N Pitt Str #325 Alexandria VA 22314

© 1998-2024 Fast Reports Inc.