Rövid útmutató: E-mailek küldése az Azure Communication Services használatával

Feljegyzés

Ossza meg velünk gondolatait és visszajelzéseit az Azure Communication Servicesről ezen rövid felméréssel.

Ez a rövid útmutató bemutatja, hogyan küldhet e-maileket az E-mail SDK-k használatával.

Ismerkedés az Azure Communication Services szolgáltatással a Communication Services Try E-mail használatával e-mailek küldéséhez.

Előfeltételek

Ennek a gyors üzembe helyezésnek a elvégzése néhány USD cent vagy annál kisebb költséggel jár az Azure-fiókjában.

E-mail küldése az e-mail kipróbálásával

Az E-mail kipróbálásával megkezdheti az e-mailek küldését a kívánt címzetteknek az Azure Communication Services használatával, valamint ellenőrizheti az alkalmazás konfigurációját az e-mailek küldéséhez. Emellett segít az e-mail-értesítések fejlesztésének elindításában a választott nyelv kódrészletével.

Üzenet küldése címzettnek, valamint az üzenet tárgyának és törzsének megadása

  1. A kiépített Azure Communication Service-erőforrás áttekintési lapján kattintson az E-mail kipróbálása elemre a bal oldali navigációs panelEn, az E-mail alatt.

    Képernyőkép az e-mail kipróbálása bal oldali navigációs panelről.

  2. Válasszon egy ellenőrzött tartományt a legördülő listából.

    Képernyőkép a verfied tartományról a legördülő listából.

  3. A küldendő e-mail írása

    • Címzett e-mail-címének megadása
    • Tárgy megadása
    • Az e-mail törzsének írása

    Képernyőkép a csatlakozáshoz használt ellenőrzött e-mail-tartományok szűréséről és kiválasztásáról.

  4. Kattintson a Küldés gombra

    Képernyőkép az egyik ellenőrzött e-mail-tartomány összekapcsolt állapotáról.

  5. Sikeresen elküldött e-mail.

    Képernyőkép a sikeres e-mail-küldésről.

  6. Mostantól a mintakódrészletet is átmásolhatja, hogy küldjön egy e-mailt, amelyet a mintaprojektben használva értesítéseket küldhet.

    • Válassza ki a választott nyelvet

    • Kattintson a Csatlakozás beszúrása gombra

    • Kattintson a Másolás gombra

      Képernyőkép az e-mailek küldéséhez küldendő kódrészletről.

  7. Az e-mail-kód kódrészlete készen áll az értesítési projektben való használatra.

Ismerkedés az Azure Communication Services szolgáltatással az Azure CLI kommunikációs bővítményével e-mailek küldéséhez.

Ennek a gyors üzembe helyezésnek a elvégzése néhány USD cent vagy annál kisebb költséggel jár az Azure-fiókjában.

Előfeltételek

Előfeltételek ellenőrzése

  • Egy terminál vagy parancsablakban futtassa a parancsot annak az --version ellenőrzéséhez, hogy telepítve van-e az Azure CLI és a kommunikációs bővítmény.
  • Az e-mail kommunikációs szolgáltatások erőforrásával ellenőrzött tartományok megtekintéséhez jelentkezzen be az Azure Portalra. Keresse meg az E-mail kommunikációs szolgáltatások erőforrást, és nyissa meg a Tartományok kiépítése lapot a bal oldali navigációs panelen.

Beállítás

A bővítmény hozzáadása

Adja hozzá az Azure CLI Azure Communication Services-bővítményét a az extension parancs használatával.

az extension add --name communication

Bejelentkezés az Azure CLI-be

Be kell jelentkeznie az Azure CLI-be. Bejelentkezhet a az login parancs terminálról való futtatásával, és megadhatja a hitelesítő adatait.

A kapcsolati sztring tárolása környezeti változóban

A környezeti változót AZURE_COMMUNICATION_CONNECTION_STRING úgy konfigurálhatja, hogy az Azure CLI-kulcsok műveleteit használja anélkül, hogy át kellene --connection_string adnia a kapcsolati sztring. Környezeti változó konfigurálásához nyisson meg egy konzolablakot, és válassza ki az operációs rendszert az alábbi lapokról. Cserélje le <connectionString> a tényleges kapcsolati sztring.

Feljegyzés

Ne tárolja a kapcsolati sztring titkosítatlan környezeti változóként éles környezetekhez. Ez csak tesztelési célokra szolgál. Éles környezetekben új kapcsolati sztring kell létrehoznia. Javasoljuk, hogy titkosítsa a kapcsolati sztring, és rendszeresen módosítsa őket.

setx AZURE_COMMUNICATION_CONNECTION_STRING "<yourConnectionString>"

Miután hozzáadta a környezeti változót, előfordulhat, hogy újra kell indítania minden futó programot, amelynek szüksége lehet a környezeti változó beolvasására, beleértve a konzolablakot is. Ha például a Visual Studiót használja szerkesztőként, indítsa újra a Visual Studiót a példa futtatása előtt.

E-mail küldése

az communication email send
	--connection-string "yourConnectionString"
	--sender "<donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net>"
	--to "<emailalias@emaildomain.com>"
	--subject "Welcome to Azure Communication Services Email" --text "This email message is sent from Azure Communication Services Email using Azure CLI." 

Végezze el ezeket a csereeket a kódban:

  • Cserélje le <yourConnectionString> a kapcsolati sztring.
  • Cserélje le <emailalias@emaildomain.com> azt az e-mail-címet, amelyre üzenetet szeretne küldeni.
  • Cserélje le <donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net> az ellenőrzött tartomány MailFrom címére.

A fenti parancs lekérdezést is végez a messageId azonosítón, és visszaadja az e-mail kézbesítésének állapotát. Az állapot az alábbiak egyike lehet:

Állapot neve Leírás
NotStarted Ezt az állapotot jelenleg nem küldjük el a szolgáltatásunktól.
Futó Az e-mail-küldési művelet jelenleg folyamatban van, és folyamatban van a feldolgozás.
Sikeres Az e-mail küldési művelet hiba nélkül befejeződött, és az e-mail kézbesítetlen. Az e-mail-kézbesítés ezen a szakaszon túli részletes állapotát az Azure Monitoron vagy az Azure Event Griden keresztül szerezheti be. Megtudhatja, hogyan iratkozhat fel e-mailes eseményekre
Sikertelen Az e-mail-küldési művelet nem volt sikeres, és hiba történt. Az e-mail nem lett elküldve. Az eredmény tartalmaz egy hibaobjektumot, amely további részleteket tartalmaz a hiba okáról.

Választható paraméterek

Az alábbi választható paraméterek érhetők el az Azure CLI-ben.

  • --html html-alapú e-mail törzs helyett --text használható.

  • --importance az e-mail fontossági típusát állítja be. Ismert értékek: magas, normál és alacsony. Az alapértelmezett érték normál.

  • --to beállítja az e-mail-címzettek listáját.

  • --cc a szén-dioxid-másolási e-mail-címeket állítja be.

  • --bcc beállítja a vak szén-dioxid-másolási e-mail-címeket.

  • --reply-to adja meg a Válasz e-mail címet.

  • --disable-tracking azt jelzi, hogy le kell-e tiltani a felhasználói előjegyzések nyomon követését ehhez a kéréshez.

  • --attachments beállítja az e-mail-mellékletek listáját.

  • --attachment-types az e-mail melléklettípusok listáját a mellékletek sorrendjében állítja be.

Emellett használhatja azoknak a címzetteknek --cc--bcc--toa listáját is, Legalább egy címzettnek vagy címzettnek --to--cc--bcckell lennie.

Ismerkedés az Azure Communication Services szolgáltatással a Communication Services C# E-mail ügyfélkódtárával e-mailek küldéséhez.

Tipp.

Az Azure Communication Servicesben az e-mail-küldési élményt úgy kezdheti el, hogy közvetlenül az egyszerű e-mail-küldési és speciális e-mail-küldési mintakódot hagyja ki a GitHubon.

Az e-mail objektum modelljének ismertetése

Az alábbi osztályok és felületek kezelik az Azure Communication Services levelezési ügyféloldali kódtárának néhány fő funkcióját c#-hoz.

Név Leírás
EmailAddress Ez az osztály tartalmaz egy e-mail-címet és egy megjelenítendő névre vonatkozó lehetőséget.
EmailAttachment Ez az osztály létrehoz egy e-mail-mellékletet egy egyedi azonosító, egy e-mail melléklet MIME típusú sztring és a tartalom bináris adatainak elfogadásával.
EmailClient Ez az osztály minden e-mail funkcióhoz szükséges. Példányosíthatja a kapcsolati sztring, és e-maileket küldhet vele.
EmailClientOptions Ez az osztály hozzáadható az E-mailClient-példányhoz egy adott API-verzió megcélzásához.
EmailContent Ez az osztály tartalmazza az e-mail tárgyát és törzsét. Meg kell adnia legalább egy Egyszerű szöveges vagy Html-tartalmat
EmailCustomHeader Ez az osztály lehetővé teszi egy név- és értékpár hozzáadását egy egyéni fejléchez. Az e-mail fontossága ezen fejléceken keresztül is megadható az "x-priority" vagy az "x-msmail-priority" fejlécnévvel
EmailMessage Ez az osztály egyesíti a feladót, a tartalmat és a címzetteket. Egyéni fejléceket, mellékleteket és válasz e-mail-címeket is hozzáadhat.
EmailRecipients Ez az osztály tartalmazza az e-mail címzettjeinek e-mailcímcím objektumainak listáját, beleértve a CC & titkos másolat címzettjeinek választható listáit is.
EmailSendOperation Ez az osztály az aszinkron e-mail-küldési műveletet jelöli, és az e-mail-küldési API-hívásból kapja vissza.
EmailSendResult Ez az osztály tartalmazza az e-mail-küldési művelet eredményeit. Rendelkezik műveletazonosítóval, műveletállapotmal és hibaobjektummal (ha van ilyen).

A EmailSendResult az alábbi állapotot adja vissza az elvégzett e-mail-műveleten.

Állapot Leírás
NotStarted Ezt az állapotot jelenleg nem küldjük el a szolgáltatásunktól.
Futó Az e-mail-küldési művelet jelenleg folyamatban van, és folyamatban van a feldolgozás.
Sikeres Az e-mail küldési művelet hiba nélkül befejeződött, és az e-mail kézbesítetlen. Az e-mail-kézbesítés ezen a szakaszon túli részletes állapotát az Azure Monitoron vagy az Azure Event Griden keresztül szerezheti be. Megtudhatja, hogyan iratkozhat fel e-mailes eseményekre
Sikertelen Az e-mail-küldési művelet nem volt sikeres, és hiba történt. Az e-mail nem lett elküldve. Az eredmény tartalmaz egy hibaobjektumot, amely további részleteket tartalmaz a hiba okáról.

Előfeltételek

Ennek a gyors üzembe helyezésnek a elvégzése néhány USD cent vagy annál kisebb költséggel jár az Azure-fiókjában.

Feljegyzés

A saját ellenőrzött tartományunkból is küldhetünk e-mailt. Egyéni ellenőrzött tartományok hozzáadása az e-mail kommunikációs szolgáltatáshoz.

Előfeltételek ellenőrzése

  • Egy terminál vagy parancsablakban futtassa a dotnet parancsot annak ellenőrzéséhez, hogy telepítve van-e a .NET-ügyfélkódtár.
  • Az E-mail kommunikációs szolgáltatások erőforráshoz társított altartományok megtekintéséhez jelentkezzen be az Azure Portalra, keresse meg az E-mail kommunikációs szolgáltatások erőforrást, és nyissa meg a Tartományok kiépítése lapot a bal oldali navigációs panelen.

Új C#-alkalmazás létrehozása

Egy konzolablakban (például parancsmag, PowerShell vagy Bash) a dotnet new paranccsal hozzon létre egy új konzolalkalmazást a névvel EmailQuickstart. Ez a parancs egy egyszerű ""Helló világ!" alkalmazás" C#-projektet hoz létre egyetlen forrásfájllal: Program.cs.

dotnet new console -o EmailQuickstart

Módosítsa a könyvtárat az újonnan létrehozott alkalmazásmappára, és használja a dotnet build parancsot az alkalmazás fordításához.

cd EmailQuickstart
dotnet build

Telepítse a(z) csomagot

Miközben továbbra is az alkalmazáskönyvtárban van, telepítse az Azure Communication Services e-mail ügyfélkódtárát a .NET-csomaghoz a dotnet add package parancs használatával.

dotnet add package Azure.Communication.Email

Az e-mail-ügyfél létrehozása hitelesítéssel

Nyissa meg Program.cs , és cserélje le a meglévő kódot a következőre, hogy irányelveket adjon hozzá using a névtér és a Azure.Communication.Email program végrehajtásának kiindulópontjaként.

using System;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;

using Azure;
using Azure.Communication.Email;

namespace SendEmail
{
  internal class Program
  {
    static async Task Main(string[] args)
    {

    }
  }
}

Az e-mail-ügyfél hitelesítéséhez többféle lehetőség is rendelkezésre áll:

Nyissa meg a Program.cs egy szövegszerkesztőben, és cserélje le a Main metódus törzsét kódra a kapcsolati sztring inicializálásáhozEmailClient. Az alábbi kód lekéri az erőforrás kapcsolati sztring egy nevesített COMMUNICATION_SERVICES_CONNECTION_STRINGkörnyezeti változóból. Megtudhatja, hogyan kezelheti az erőforrás kapcsolati sztring.

// This code demonstrates how to fetch your connection string
// from an environment variable.
string connectionString = Environment.GetEnvironmentVariable("COMMUNICATION_SERVICES_CONNECTION_STRING");
EmailClient emailClient = new EmailClient(connectionString);

Egyszerű e-mail-küldés

Az e-mail létrehozása

E-mail küldéséhez a következőkre van szükség:

  • Adja meg az e-mail tárgyát és törzsét.
  • Adja meg a feladó címét. Hozza létre az e-mail-üzenetet a Feladó adataival, amelyet az ellenőrzött tartományból kapott MailFrom-címmel.
  • Adja meg a címzett címét.
  • Hívja meg a SendAsync metódust. Adja hozzá ezt a kódot a metódus végéhez Main a Program.cs:

Cserélje le a tartomány adatait, és szükség szerint módosítsa a tartalmat, a címzett adatait


//Replace with your domain and modify the content, recipient details as required

var subject = "Welcome to Azure Communication Service Email APIs.";
var htmlContent = "<html><body><h1>Quick send email test</h1><br/><h4>This email message is sent from Azure Communication Service Email.</h4><p>This mail was sent using .NET SDK!!</p></body></html>";
var sender = "donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net";
var recipient = "emailalias@contoso.com";

Az e-mail küldési állapotának elküldése és lekérése

E-mail küldéséhez a következőkre van szükség:

  • Hívja meg az e-mail-kérelmet aszinkron műveletként küldő SendAsync metódust. Hívja meg az Azure.WaitUntil.Completed metódust, ha a metódusnak várnia kell a visszatérésre, amíg a hosszan futó művelet befejeződik a szolgáltatásban. Hívja meg az Azure.WaitUntil.Started metódust, ha a metódusnak a művelet elindítása után vissza kell térnie.
  • A SendAsync metódus a "Sikeres" EmailSendStatus értéket adja vissza, ha az e-mail kézbesítésre ki van adva, és máskülönben kivételt jelez. Adja hozzá ezt a kódot a metódus végéhez Main a Program.cs:
try
{
    Console.WriteLine("Sending email...");
    EmailSendOperation emailSendOperation = await emailClient.SendAsync(
        Azure.WaitUntil.Completed,
        sender,
        recipient,
        subject,
        htmlContent);
    EmailSendResult statusMonitor = emailSendOperation.Value;
    
    Console.WriteLine($"Email Sent. Status = {emailSendOperation.Value.Status}");

    /// Get the OperationId so that it can be used for tracking the message for troubleshooting
    string operationId = emailSendOperation.Id;
    Console.WriteLine($"Email operation id = {operationId}");
}
catch (RequestFailedException ex)
{
    /// OperationID is contained in the exception message and can be used for troubleshooting purposes
    Console.WriteLine($"Email send operation failed with error code: {ex.ErrorCode}, message: {ex.Message}");
}

E-mail kézbesítési állapotának lekérése

A EmailSendOperation csak az e-mail-művelet állapotát adja vissza. A tényleges e-mail-kézbesítési állapot lekéréséhez feliratkozhat a "EmailDeliveryReportReceived" eseményre, amely az e-mail-kézbesítés befejezésekor jön létre. Az esemény a következő kézbesítési állapotot adja vissza:

  • Szállított.
  • Sikertelen.
  • Karanténba.

Részletekért lásd: E-mail események kezelése.

Most már feliratkozhat az e-mail-üzemeltetési naplókra is, amelyek az e-mail szolgáltatásból küldött üzenetek kézbesítési metrikáival kapcsolatos információkat nyújtanak.

  • E-mail küldése működési naplók – részletes információkat nyújt az e-mail-szolgáltatás e-mail-kérelmek küldéséhez.
  • E-mail állapotfrissítés működési naplói – üzenet- és címzettszintű kézbesítési állapotfrissítéseket biztosít az e-mail-szolgáltatás e-mail-kérelmek küldéséhez.

Hozzáférési naplók az e-mail kommunikációs szolgáltatáshoz.

A kód futtatása

Futtassa az alkalmazást az alkalmazáskönyvtárból a dotnet run paranccsal.

dotnet run

Mintakód

A mintaalkalmazást letöltheti a GitHubról

Ismerkedés az Azure Communication Services szolgáltatással a Communication Services JS E-mail ügyféloldali kódtárával e-mailek küldéséhez.

Tipp.

Az Azure Communication Servicesben az e-mail-küldési élményt úgy kezdheti el, hogy közvetlenül az egyszerű e-mail-küldési és speciális e-mail-küldési mintakódot hagyja ki a GitHubon.

Az e-mail objektummodell ismertetése

Az alábbi osztályok és felületek kezelik az Azure Communication Services e-mail ügyféloldali kódtárának néhány fő funkcióját JavaScripthez.

Név Leírás
EmailAddress Ez az osztály tartalmaz egy e-mail-címet és egy megjelenítendő névre vonatkozó lehetőséget.
EmailAttachment Ez az osztály létrehoz egy e-mail-mellékletet egy egyedi azonosító, egy e-mail melléklet MIME típusú sztring és a tartalom bináris adatainak elfogadásával.
EmailClient Ez az osztály minden e-mail funkcióhoz szükséges. Példányosíthatja a kapcsolati sztring, és e-maileket küldhet vele.
EmailClientOptions Ez az osztály hozzáadható az E-mailClient-példányhoz egy adott API-verzió megcélzásához.
EmailContent Ez az osztály tartalmazza az e-mail tárgyát és törzsét. Meg kell adnia legalább egy Egyszerű szöveges vagy Html-tartalmat.
EmailCustomHeader Ez az osztály lehetővé teszi egy név- és értékpár hozzáadását egy egyéni fejléchez. Az e-mail fontossága ezen fejléceken keresztül is megadható az "x-priority" vagy az "x-msmail-priority" fejlécnévvel.
EmailMessage Ez az osztály egyesíti a feladót, a tartalmat és a címzetteket. Egyéni fejléceket, mellékleteket és válasz e-mail-címeket is hozzáadhat.
EmailRecipients Ez az osztály tartalmazza az e-mail címzettjeinek e-mailcímcím objektumainak listáját, beleértve a CC & titkos másolat címzettjeinek választható listáit is.
EmailSendResult Ez az osztály tartalmazza az e-mail-küldési művelet eredményeit. Rendelkezik műveletazonosítóval, műveletállapotmal és hibaobjektummal (ha van ilyen).
EmailSendStatus Ez az osztály az e-mail-küldési művelet állapotkészletét jelöli.

A EmailSendResult az alábbi állapotot adja vissza az elvégzett e-mail-műveleten.

Állapot neve Leírás
isStarted Igaz értéket ad vissza, ha az e-mail-küldési művelet jelenleg folyamatban van, és feldolgozás alatt áll.
isCompleted Igaz értéket ad vissza, ha az e-mail-küldési művelet hiba nélkül befejeződött, és az e-mail kézbesítetlen. Az e-mail-kézbesítés ezen a szakaszon túli részletes állapotát az Azure Monitoron vagy az Azure Event Griden keresztül szerezheti be. Megtudhatja, hogyan iratkozhat fel e-mailes eseményekre
eredmény Olyan tulajdonság, amely akkor létezik, ha az e-mail-küldési művelet befejeződött.
error Az a tulajdonság, amely akkor létezik, ha az e-mail-küldési művelet nem volt sikeres, és hiba történt. Az e-mail nem lett elküldve. Az eredmény tartalmaz egy hibaobjektumot, amely további részleteket tartalmaz a hiba okáról.

Előfeltételek

Ennek a gyors üzembe helyezésnek a elvégzése néhány USD cent vagy annál kisebb költséggel jár az Azure-fiókjában.

Feljegyzés

A saját ellenőrzött tartományunkból is küldhetünk e-mailt. Egyéni ellenőrzött tartományok hozzáadása az e-mail kommunikációs szolgáltatáshoz.

Előfeltételek ellenőrzése

  • Egy terminál vagy parancsablakban futtassa node --version a Node.js telepítésének ellenőrzéséhez.
  • Az e-mail kommunikációs szolgáltatások erőforrásával ellenőrzött tartományok megtekintéséhez jelentkezzen be az Azure Portalra, keresse meg az E-mail kommunikációs szolgáltatások erőforrást, és nyissa meg a Tartományok kiépítése lapot a bal oldali navigációs panelen.

Az alkalmazáskörnyezet beállítása

Új Node.js-alkalmazás létrehozása

Először nyissa meg a terminált vagy a parancsablakot, hozzon létre egy új könyvtárat az alkalmazáshoz, és navigáljon hozzá.

mkdir email-quickstart && cd email-quickstart

Futtassa npm init -y az alapértelmezett beállításokkal rendelkező package.json fájl létrehozásához.

npm init -y

Szövegszerkesztővel hozzon létre egy send-email.js nevű fájlt a projekt gyökérkönyvtárában. Módosítsa az package.json "fő" tulajdonságát "send-email.js" értékre. Az alábbi szakasz bemutatja, hogyan adhatja hozzá a rövid útmutató forráskódját az újonnan létrehozott fájlhoz.

Telepítse a(z) csomagot

npm install A parancs használatával telepítheti az Azure Communication Services e-mail ügyfélkódtárát JavaScripthez.

npm install @azure/communication-email --save

A --save beállítás függőségként sorolja fel a tárat a package.json fájlban.

Az e-mail-ügyfél létrehozása hitelesítéssel

Az e-mail-ügyfél hitelesítéséhez többféle lehetőség is rendelkezésre áll:

Importálja az EmailClientet az ügyfélkódtárból, és példányosíthatja a kapcsolati sztring.

Az alábbi kód lekéri az erőforrás kapcsolati sztring egy, a dotenv-csomag használatával elnevezett COMMUNICATION_SERVICES_CONNECTION_STRING környezeti változóból. npm install A parancs használatával telepítse a dotenv-csomagot. Megtudhatja, hogyan kezelheti az erőforrás kapcsolati sztring.

npm install dotenv

Adja hozzá a következő kódot a send-email.js:

const { EmailClient } = require("@azure/communication-email");
require("dotenv").config();

// This code demonstrates how to fetch your connection string
// from an environment variable.
const connectionString = process.env['COMMUNICATION_SERVICES_CONNECTION_STRING'];
const emailClient = new EmailClient(connectionString);

Az egyszerűség kedvéért ez a rövid útmutató kapcsolati sztring használ, éles környezetben azonban a szolgáltatásnevek használatát javasoljuk.

Egyszerű e-mail-küldés

E-mail küldése

E-mail küldéséhez hívja meg a függvényt az beginSend EmailClientből. Ez a metódus egy lekérdezést ad vissza, amely ellenőrzi a művelet állapotát, és lekéri az eredményt, amint befejeződött.


async function main() {
  const POLLER_WAIT_TIME = 10
  try {
    const message = {
      senderAddress: "<donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net>",
      content: {
        subject: "Welcome to Azure Communication Services Email",
        plainText: "This email message is sent from Azure Communication Services Email using the JavaScript SDK.",
      },
      recipients: {
        to: [
          {
            address: "<emailalias@emaildomain.com>",
            displayName: "Customer Name",
          },
        ],
      },
    };

    const poller = await emailClient.beginSend(message);

    if (!poller.getOperationState().isStarted) {
      throw "Poller was not started."
    }

    let timeElapsed = 0;
    while(!poller.isDone()) {
      poller.poll();
      console.log("Email send polling in progress");

      await new Promise(resolve => setTimeout(resolve, POLLER_WAIT_TIME * 1000));
      timeElapsed += 10;

      if(timeElapsed > 18 * POLLER_WAIT_TIME) {
        throw "Polling timed out.";
      }
    }

    if(poller.getResult().status === KnownEmailSendStatus.Succeeded) {
      console.log(`Successfully sent the email (operation id: ${poller.getResult().id})`);
    }
    else {
      throw poller.getResult().error;
    }
  } catch (e) {
    console.log(e);
  }
}

main();

Végezze el ezeket a csereeket a kódban:

  • Cserélje le <emailalias@emaildomain.com> azt az e-mail-címet, amelyre üzenetet szeretne küldeni.
  • Cserélje le <donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net> az ellenőrzött tartomány MailFrom címére.

A kód futtatása

a csomópont paranccsal futtassa a send-email.js fájlhoz hozzáadott kódot.

node ./send-email.js

Mintakód

A mintaalkalmazást letöltheti a GitHubról

Ismerkedés az Azure Communication Services szolgáltatással a Communication Services Java E-mail SDK használatával e-mailek küldéséhez.

Tipp.

Az Azure Communication Servicesben az e-mail-küldési élményt úgy kezdheti el, hogy közvetlenül az egyszerű e-mail-küldési és speciális e-mail-küldési mintakódot hagyja ki a GitHubon.

Az e-mail objektummodell ismertetése

Az alábbi osztályok és felületek kezelik a Pythonhoz készült Azure Communication Services E-mail SDK főbb funkcióit.

Név Leírás
EmailAddress Ez az osztály tartalmaz egy e-mail-címet és egy megjelenítendő névre vonatkozó lehetőséget.
EmailAttachment Ez az interfész létrehoz egy e-mail-mellékletet egy egyedi azonosító, egy e-mail melléklet MIME típusú sztring és egy tartalombájt sztring elfogadásával.
EmailClient Ez az osztály minden e-mail funkcióhoz szükséges. Példányosíthatja a kapcsolati sztring, és e-maileket küldhet vele.
EmailMessage Ez az osztály egyesíti a feladót, a tartalmat és a címzetteket. Egyéni fejléceket, mellékleteket és válasz e-mail-címeket is hozzáadhat.
EmailSendResult Ez az osztály tartalmazza az e-mail-küldési művelet eredményeit. Rendelkezik műveletazonosítóval, műveletállapotmal és hibaobjektummal (ha van ilyen).
EmailSendStatus Ez az osztály az e-mail-küldési művelet állapotkészletét jelöli.

A EmailSendResult az alábbi állapotot adja vissza az elvégzett e-mail-műveleten.

Állapot neve Leírás
NOT_STARTED Ezt az állapotot jelenleg nem küldjük el a szolgáltatásunktól.
IN_PROGRESS Az e-mail-küldési művelet jelenleg folyamatban van, és folyamatban van a feldolgozás.
SUCCESSFULLY_COMPLETED Az e-mail küldési művelet hiba nélkül befejeződött, és az e-mail kézbesítetlen. Az e-mail-kézbesítés ezen a szakaszon túli részletes állapotát az Azure Monitoron vagy az Azure Event Griden keresztül szerezheti be. Megtudhatja, hogyan iratkozhat fel e-mailes eseményekre
SIKERTELEN Az e-mail-küldési művelet nem volt sikeres, és hiba történt. Az e-mail nem lett elküldve. Az eredmény tartalmaz egy hibaobjektumot, amely további részleteket tartalmaz a hiba okáról.

Előfeltételek

A rövid útmutató elvégzése néhány cent (USD) vagy még kevesebb költséggel jár az Azure-fiókját illetően.

Előfeltételek ellenőrzése

  • Egy terminál vagy parancsablakban futtassa mvn -v a Maven telepítését.
  • Az e-mail kommunikációs szolgáltatások erőforrásával ellenőrzött tartományok megtekintéséhez jelentkezzen be az Azure Portalra. Keresse meg az E-mail kommunikációs szolgáltatások erőforrást, és nyissa meg a Tartományok kiépítése lapot a bal oldali navigációs panelen.

Az alkalmazáskörnyezet beállítása

Az e-mailek küldésére szolgáló környezet beállításához kövesse az alábbi szakaszok lépéseit.

Új Java-alkalmazás létrehozása

Nyissa meg a terminált vagy a parancsablakot, és lépjen arra a könyvtárra, ahol létre szeretné hozni a Java-alkalmazást. Futtassa a következő parancsot a Java-projekt létrehozásához a maven-archetype-quickstart sablonból.

mvn archetype:generate -DarchetypeArtifactId="maven-archetype-quickstart" -DarchetypeGroupId="org.apache.maven.archetypes" -DarchetypeVersion="1.4" -DgroupId="com.communication.quickstart" -DartifactId="communication-quickstart"

A generate cél létrehoz egy olyan könyvtárat, amelynek neve megegyezik az artifactId értékkel. Ebben a könyvtárban az src/main/java könyvtár tartalmazza a projekt forráskódját, az src/test/java könyvtár a tesztforrást, a pom.xml fájl pedig a projekt projektobjektum-modelljét (POM).

Telepítse a(z) csomagot

Nyissa meg a pom.xml fájlt a szövegszerkesztőben. Adja hozzá a következő függőségi elemet a függőségek csoportjához.

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-communication-email</artifactId>
    <version>1.0.0-beta.2</version>
</dependency>

Az alkalmazás-keretrendszer beállítása

Nyissa meg a /src/main/java/com/communication/quickstart/App.java szövegszerkesztőben, adjon hozzá importálási irányelveket, és távolítsa el az utasítást System.out.println("Hello world!"); :

package com.communication.quickstart;

import com.azure.communication.email.models.*;
import com.azure.communication.email.*;
import com.azure.core.util.polling.PollResponse;
import com.azure.core.util.polling.SyncPoller;

public class App
{
    public static void main( String[] args )
    {
        // Quickstart code goes here.
    }
}

Az e-mail-ügyfél létrehozása hitelesítéssel

Az e-mail-ügyfél hitelesítéséhez többféle lehetőség is rendelkezésre áll:

Az ügyfél hitelesítéséhez példányt kell létrehoznia a EmailClient kapcsolati sztring. Megtudhatja, hogyan kezelheti az erőforrás kapcsolati sztring. Az ügyfelet inicializálhatja bármely egyéni HTTP-ügyféllel is, amely implementálja a com.azure.core.http.HttpClient felületet.

Ügyfél példányosításához adja hozzá a következő kódot a main metódushoz:

// You can get your connection string from your resource in the Azure portal.
String connectionString = "endpoint=https://<resource-name>.communication.azure.com/;accesskey=<access-key>";

EmailClient emailClient = new EmailClientBuilder()
    .connectionString(connectionString)
    .buildClient();

Az egyszerűség kedvéért ez a rövid útmutató kapcsolati sztring használ, éles környezetben azonban a szolgáltatásnevek használatát javasoljuk.

Egyszerű e-mail-küldés

E-mail küldéséhez hívja meg a függvényt a beginSendEmailClient. Ez a metódus egy lekérdezést ad vissza, amellyel ellenőrizheti a művelet állapotát, és lekérheti az eredményt, amint befejeződött. Vegye figyelembe, hogy az e-mail küldésére irányuló kezdeti kérés nem lesz elküldve, amíg meg nem hívja a poll metódust, vagy megvárjuk a lekérdezés befejezését.

EmailMessage message = new EmailMessage()
    .setSenderAddress("<donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net>")
    .setToRecipients("<emailalias@emaildomain.com>")
    .setSubject("Welcome to Azure Communication Services Email")
    .setBodyPlainText("This email message is sent from Azure Communication Services Email using the Java SDK.");

try
{
    SyncPoller<EmailSendResult, EmailSendResult> poller = emailClient.beginSend(message, null);

    PollResponse<EmailSendResult> pollResponse = null;

    Duration timeElapsed = Duration.ofSeconds(0);
    Duration POLLER_WAIT_TIME = Duration.ofSeconds(10);

    while (pollResponse == null
            || pollResponse.getStatus() == LongRunningOperationStatus.NOT_STARTED
            || pollResponse.getStatus() == LongRunningOperationStatus.IN_PROGRESS)
    {
        pollResponse = poller.poll();
        System.out.println("Email send poller status: " + pollResponse.getStatus());

        Thread.sleep(POLLER_WAIT_TIME.toMillis());
        timeElapsed = timeElapsed.plus(POLLER_WAIT_TIME);

        if (timeElapsed.compareTo(POLLER_WAIT_TIME.multipliedBy(18)) >= 0)
        {
            throw new RuntimeException("Polling timed out.");
        }
    }

    if (poller.getFinalResult().getStatus() == EmailSendStatus.SUCCEEDED)
    {
        System.out.printf("Successfully sent the email (operation id: %s)", poller.getFinalResult().getId());
    }
    else
    {
        throw new RuntimeException(poller.getFinalResult().getError().getMessage());
    }
}
catch (Exception exception)
{
    System.out.println(exception.getMessage());
}

Végezze el ezeket a csereeket a kódban:

  • Cserélje le <emailalias@emaildomain.com> azt az e-mail-címet, amelyre üzenetet szeretne küldeni.
  • Cserélje le <donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net> az ellenőrzött tartomány MailFrom címére.

A kód futtatása

  1. Lépjen a pom.xml fájlt tartalmazó könyvtárra, és fordítsa le a projektet a mvn parancs használatával.

    mvn compile
    
  2. Hozza létre a csomagot.

    mvn package
    
  3. Futtassa a következő mvn parancsot az alkalmazás végrehajtásához.

    mvn exec:java -D"exec.mainClass"="com.communication.quickstart.App" -D"exec.cleanupDaemonThreads"="false"
    

Mintakód

A mintaalkalmazást letöltheti a GitHubról

Ismerkedés az Azure Communication Services szolgáltatással a Communication Services Python E-mail SDK használatával e-mailek küldéséhez.

Tipp.

Az Azure Communication Servicesben az e-mail-küldési élményt úgy kezdheti el, hogy közvetlenül az egyszerű e-mail-küldési és speciális e-mail-küldési mintakódot hagyja ki a GitHubon.

Az e-mail objektummodell ismertetése

Az alábbi JSON-üzenetsablon & válaszobjektum a Pythonhoz készült Azure Communication Services E-mail SDK néhány fő funkcióját mutatja be.

message = {
    "content": {
        "subject": "str",  # Subject of the email message. Required.
        "html": "str",  # Optional. Html version of the email message.
        "plainText": "str"  # Optional. Plain text version of the email
            message.
    },
    "recipients": {
        "to": [
            {
                "address": "str",  # Email address. Required.
                "displayName": "str"  # Optional. Email display name.
            }
        ],
        "bcc": [
            {
                "address": "str",  # Email address. Required.
                "displayName": "str"  # Optional. Email display name.
            }
        ],
        "cc": [
            {
                "address": "str",  # Email address. Required.
                "displayName": "str"  # Optional. Email display name.
            }
        ]
    },
    "senderAddress": "str",  # Sender email address from a verified domain. Required.
    "attachments": [
        {
            "contentInBase64": "str",  # Base64 encoded contents of the attachment. Required.
            "contentType": "str",  # MIME type of the content being attached. Required.
            "name": "str"  # Name of the attachment. Required.
        }
    ],
    "userEngagementTrackingDisabled": bool,  # Optional. Indicates whether user engagement tracking should be disabled for this request if the resource-level user engagement tracking setting was already enabled in the control plane.
    "headers": {
        "str": "str"  # Optional. Custom email headers to be passed.
    },
    "replyTo": [
        {
            "address": "str",  # Email address. Required.
            "displayName": "str"  # Optional. Email display name.
        }
    ]
}

response = {
    "id": "str",  # The unique id of the operation. Uses a UUID. Required.
    "status": "str",  # Status of operation. Required. Known values are:
        "NotStarted", "Running", "Succeeded", and "Failed".
    "error": {
        "additionalInfo": [
            {
                "info": {},  # Optional. The additional info.
                "type": "str"  # Optional. The additional info type.
            }
        ],
        "code": "str",  # Optional. The error code.
        "details": [
            ...
        ],
        "message": "str",  # Optional. The error message.
        "target": "str"  # Optional. The error target.
    }
}

Az response.status értékeket az alábbi táblázatban részletesebben ismertetjük.

Állapot neve Leírás
Bejövő forgalom Az e-mail-küldési művelet jelenleg folyamatban van, és folyamatban van a feldolgozás.
Sikeres Az e-mail küldési művelet hiba nélkül befejeződött, és az e-mail kézbesítetlen. Az e-mail-kézbesítés ezen a szakaszon túli részletes állapotát az Azure Monitoron vagy az Azure Event Griden keresztül szerezheti be. Megtudhatja, hogyan iratkozhat fel e-mailes eseményekre
Sikertelen Az e-mail-küldési művelet nem volt sikeres, és hiba történt. Az e-mail nem lett elküldve. Az eredmény tartalmaz egy hibaobjektumot, amely további részleteket tartalmaz a hiba okáról.

Előfeltételek

Ennek a gyors üzembe helyezésnek a elvégzése néhány USD cent vagy annál kisebb költséggel jár az Azure-fiókjában.

Feljegyzés

A saját ellenőrzött tartományunkból is küldhetünk e-mailt. Egyéni ellenőrzött tartományok hozzáadása az e-mail kommunikációs szolgáltatáshoz.

Előfeltételek ellenőrzése

  • Egy terminál vagy parancsablakban futtassa a parancsot annak python --version ellenőrzéséhez, hogy telepítve van-e a Python.
  • Az e-mail kommunikációs szolgáltatások erőforrásával ellenőrzött tartományok megtekintéséhez jelentkezzen be az Azure Portalra. Keresse meg az E-mail kommunikációs szolgáltatások erőforrást, és nyissa meg a Tartományok kiépítése lapot a bal oldali navigációs panelen.

Az alkalmazáskörnyezet beállítása

Az e-mailek küldésére szolgáló környezet beállításához kövesse az alábbi szakaszok lépéseit.

Új Python-alkalmazás létrehozása

  1. Nyissa meg a terminált vagy a parancsablakot. Ezután a következő paranccsal hozzon létre egy virtuális környezetet, és aktiválja azt. Ez a parancs létrehoz egy új könyvtárat az alkalmazás számára.

    python -m venv email-quickstart
    
  2. Lépjen a virtuális környezet gyökérkönyvtárára, és aktiválja az alábbi parancsokkal.

    cd email-quickstart
    .\Scripts\activate
    
  3. Szövegszerkesztővel hozzon létre egy send-email.py nevű fájlt a projekt gyökérkönyvtárában, és adja hozzá a program struktúráját, beleértve az alapvető kivételkezelést is.

    import os
    from azure.communication.email import EmailClient
    
    try:
        # Quickstart code goes here.
    except Exception as ex:
        print('Exception:')
        print(ex)
    

A következő szakaszokban a rövid útmutató összes forráskódját hozzáadja a létrehozott send-email.py fájlhoz.

Telepítse a(z) csomagot

Amíg továbbra is az alkalmazáskönyvtárban van, telepítse az Azure Communication Services e-mail SDK for Python-csomagot az alábbi paranccsal.

pip install azure-communication-email

Az e-mail-ügyfél létrehozása hitelesítéssel

Az e-mail-ügyfél hitelesítéséhez többféle lehetőség is rendelkezésre áll:

E-mail-cím példányosítása a kapcsolati sztring. Megtudhatja, hogyan kezelheti az erőforrás kapcsolati sztring.

# Create the EmailClient object that you use to send Email messages.
email_client = EmailClient.from_connection_string(<connection_string>)

Az egyszerűség kedvéért ez a rövid útmutató kapcsolati sztring használ, éles környezetben azonban a szolgáltatásnevek használatát javasoljuk.

Egyszerű e-mail-küldés

E-mail küldése

E-mail küldéséhez a következőkre van szükség:

  • Hozza létre az üzenetet a következő értékekkel:
    • senderAddress: Érvényes feladói e-mail-cím, amely az e-mail-kommunikációs szolgáltatás erőforrásához csatolt tartomány áttekintési paneljének MailFrom mezőjében található.
    • recipients: Egy objektum, amely tartalmazza az e-mail címzettjeinek listáját, és opcionálisan a CC & BCC e-mail címzettjeinek listáját.
    • content: Egy e-mail tárgyát és opcionálisan egyszerű szöveges vagy HTML-tartalmát tartalmazó objektum.
  • Hívja meg a begin_send metódust, amely a művelet eredményét adja vissza.
message = {
    "content": {
        "subject": "This is the subject",
        "plainText": "This is the body",
        "html": "<html><h1>This is the body</h1></html>"
    },
    "recipients": {
        "to": [
            {
                "address": "<emailalias@emaildomain.com>",
                "displayName": "Customer Name"
            }
        ]
    },
    "senderAddress": "<donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net>"
}

poller = email_client.begin_send(message)
print("Result: " + poller.result())

Végezze el ezeket a csereeket a kódban:

  • Cserélje le <emailalias@emaildomain.com> azt az e-mail-címet, amelyre üzenetet szeretne küldeni.
  • Cserélje le <donotreply@xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.azurecomm.net> az ellenőrzött tartomány MailFrom címére.

Az e-mail kézbesítés állapotának lekérése

Az e-mail-kézbesítés állapotát úgy kérdezhetjük le, hogy beállítunk egy hurkot a Művelet állapotobjektumán, amelyet a EmailClient metódusa begin_send ad vissza:

POLLER_WAIT_TIME = 10

try:
    email_client = EmailClient.from_connection_string(connection_string)

    poller = email_client.begin_send(message);

    time_elapsed = 0
    while not poller.done():
        print("Email send poller status: " + poller.status())

        poller.wait(POLLER_WAIT_TIME)
        time_elapsed += POLLER_WAIT_TIME

        if time_elapsed > 18 * POLLER_WAIT_TIME:
            raise RuntimeError("Polling timed out.")

    if poller.result()["status"] == "Succeeded":
        print(f"Successfully sent the email (operation id: {poller.result()['id']})")
    else:
        raise RuntimeError(str(poller.result()["error"]))

except Exception as ex:
    print(ex)

A kód futtatása

Futtassa az alkalmazást az alkalmazáskönyvtárból a python paranccsal.

python send-email.py

Mintakód

A mintaalkalmazást letöltheti a GitHubról

Előfeltételek

E-mail küldése

Ha új lépést szeretne hozzáadni a munkafolyamathoz az Azure Communication Services e-mail-összekötőjével, kövesse az alábbi lépéseket:

  1. A tervezőben nyissa meg a logikai alkalmazás munkafolyamatát.

    Fogyasztás

    1. Az új műveletet hozzáadni kívánt lépés alatt válassza az Új lépés lehetőséget. Másik lehetőségként az új művelet lépések közötti hozzáadásához vigye az egérmutatót a lépések közötti nyíl fölé, jelölje ki a pluszjelet (+), és válassza a Művelet hozzáadása lehetőséget.

    2. A Művelet kiválasztása keresőmezőben válassza a Standard lehetőséget. A keresőmezőbe írja be a Communication Services e-mail címét.

    3. A műveletek listájában válassza az E-mail küldése lehetőséget.

      Képernyőkép az Azure Communication Services e-mail-összekötő e-mail küldése műveletről.

    Standard

    1. Az új művelet hozzáadásához szükséges lépés alatt válassza a pluszjelet (+). Másik lehetőségként az új művelet lépések közötti hozzáadásához vigye az egérmutatót a lépések közötti nyíl fölé, jelölje ki a pluszjelet (+), és válassza a Művelet hozzáadása lehetőséget.

    2. A Művelet kiválasztása keresőmező alatt válassza az Azure-t. A keresőmezőbe írja be a Communication Services e-mail címét.

    3. A műveletek listájában válassza az E-mail küldése lehetőséget.

  2. Adja meg a kapcsolat nevét.

  3. Adja meg az Azure Communications Service-erőforrás kapcsolati sztring. A sztring megkereséséhez kövesse az alábbi lépéseket:

    1. Nyissa meg az Azure Communication Service-erőforrást az Azure Portalon.

    2. Az erőforrásmenü Gépház területén válassza a Kulcsok lehetőséget, és másolja a kapcsolati sztring.

      Képernyőkép az Azure Communication Services Csatlakozás ion sztringről.

  4. Amikor elkészült, válassza a Létrehozás lehetőséget.

  5. A Feladó mezőben használja az előfeltételekben konfigurált e-mail-címet. Adja meg a To, Subject és Body mezők értékeit, például:

    Képernyőkép az Azure Communication Services e-mail-összekötő e-mail-művelet bemenetének küldéséhez.

  6. Mentse a munkafolyamatot. A tervező eszköztárán válassza a Mentés lehetőséget.

A munkafolyamat tesztelése

Attól függően, hogy használatalapú vagy standard munkafolyamattal rendelkezik-e, manuálisan indítsa el a munkafolyamatot:

  • Használat: A tervező eszköztárán válassza az Eseményindító futtatása parancsot>.
  • Standard: A munkafolyamat menüjében válassza az Áttekintés lehetőséget. Az eszköztáron válassza az Eseményindító futtatása parancsot>.

A munkafolyamat létrehoz egy felhasználót, kiad egy hozzáférési jogkivonatot a felhasználónak, majd eltávolítja és törli a felhasználót. A munkafolyamat sikeres futtatása után ellenőrizheti ezeknek a műveleteknek a kimenetét.

E-mailt kell kapnia a megadott címre. Az e-mail-üzenet állapotának lekérése művelet használatával ellenőrizheti az e-mail küldése műveleten keresztül küldött e-mailek állapotát is. További műveletekért tekintse át az Azure Communication Services e-mail-összekötő referenciadokumentációját.

Munkafolyamat-erőforrások törlése

A logikaialkalmazás-erőforrás, a munkafolyamat és a kapcsolódó erőforrások törléséhez tekintse át , hogyan tisztíthatja meg a használati logikai alkalmazás erőforrásait , vagy hogyan tisztíthatja meg a standard logikai alkalmazás erőforrásait.

Hibaelhárítás

E-mail kézbesítés

Az e-mail-kézbesítéssel kapcsolatos problémák elhárításához lekérheti az e-mail kézbesítés állapotát a kézbesítés részleteinek rögzítéséhez.

Fontos

A küldési művelet állapotának lekérdezésével visszaadott sikeres eredmény csak azt a tényt ellenőrzi, hogy az e-mail sikeresen elküldve lett-e kézbesítésre. Ha további információt szeretne kapni a kézbesítés címzett végi állapotáról, hivatkoznia kell az e-mail-események kezelésére.

E-mail-szabályozás

Ha azt látja, hogy az alkalmazás le van függesztve, annak az lehet az oka, hogy az e-mailek küldése szabályozva van. Ezt naplózással vagy egyéni szabályzat implementálásával is kezelheti.

Feljegyzés

Ez a tesztkörnyezet beállítása segít a fejlesztőknek az alkalmazás létrehozásának megkezdésében. Ha az alkalmazás készen áll az élő adásra, fokozatosan kérheti a küldő kötet növelését. Küldjön támogatási kérést a kívánt küldési korlát növeléséhez, ha a sebességkorlátot meghaladó mennyiségű üzenetet kell küldenie.

Azure Communication Service-erőforrások eltávolítása

A Communication Services-előfizetések törléséhez és eltávolításához törölheti az erőforrást vagy az erőforráscsoportot. Az erőforráscsoport törlése minden más társított erőforrást is töröl. További információ az erőforrások tisztításáról.

Következő lépések

Ebben a rövid útmutatóban megtanulta, hogyan küldhet e-maileket az Azure Communication Services használatával. A következőket is érdemes lehet elvégeznie:

  • További információ az e-mailekkel kapcsolatos fogalmakról.
  • Ismerkedjen meg az e-mail ügyféloldali kódtárával.
  • További információ arról , hogyan küldhet csevegőüzenetet a Power Automate-ből az Azure Communication Services használatával.
  • További információ az Azure Communication Services felhasználóinak és hozzáférési jogkivonatainak létrehozására és kezelésére szolgáló hozzáférési jogkivonatok bejelentkezéséről.