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
- Egy Azure-fiók, aktív előfizetéssel. Fiók ingyenes létrehozása.
- Az operációs rendszer legújabb . NET Core-ügyfélkódtára .
- Kiépített tartománnyal létrehozott és kész Azure Email Communication Services-erőforrás – Első lépések az e-mail-kommunikációs erőforrás létrehozásával
- E-mail tartományhoz csatlakoztatott aktív Communication Services-erőforrás. Ismerkedés az e-mail-erőforrás kommunikációs erőforrással való csatlakoztatásával
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
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.
Válasszon egy ellenőrzött tartományt a legördülő listából.
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
Kattintson a Küldés gombra
Sikeresen elküldött e-mail.
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.
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
- Egy Azure-fiók, aktív előfizetéssel. Fiók ingyenes létrehozása.
- Kiépített tartománnyal létrehozott és kész Azure Email Communication Services-erőforrás. Ismerkedés az e-mail-kommunikációs erőforrás létrehozásával.
- Egy e-mail tartományhoz és annak kapcsolati sztring csatlakoztatott aktív Azure Communication Services-erőforrás. Első lépésként csatlakoztassa az e-mail kommunikációs erőforrást egy Azure-beli kommunikációs erőforráshoz.
- A legújabb Azure CLI.
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
--to
a listáját is, Legalább egy címzettnek vagy címzettnek --to
--cc
--bcc
kell 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ó elfogadásával, az e-mail melléklet MIME típusú sztringgel, a tartalom bináris adataival és egy opcionális tartalomazonosítóval, amely beágyazott mellékletként definiálja azt. |
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
- Egy Azure-fiók, aktív előfizetéssel. Fiók ingyenes létrehozása.
- Az operációs rendszer legújabb . NET Core-ügyfélkódtára .
- Kiépített tartománnyal létrehozott és kész Azure Email Communication Services-erőforrás – Első lépések az e-mail-kommunikációs erőforrás létrehozásával
- Egy e-mail tartományhoz és egy kapcsolati sztringhez csatlakoztatott aktív Communication Services-erőforrás. Ismerkedés az e-mail-erőforrás kommunikációs erőforrással való csatlakoztatásával
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_STRING
kö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);
Feljegyzés
Javasoljuk, hogy a manuális lekérdezés (e-mail küldése aszinkron állapot-lekérdezéssel) használatával küldjön e-maileket.
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
Amikor meghívja a SendAsyncet az Azure.WaitUntil.Started szolgáltatással, a metódus a művelet elindítása után visszatér. A metódus a EmailSendOperation objektumot adja vissza. Meghívhatja az UpdateStatusAsync metódust az e-mail-művelet állapotának frissítéséhez.
A visszaadott EmailSendOperation objektum tartalmaz egy EmailSendStatus objektumot, amely a következőket tartalmazza:
- Az E-mail küldése művelet aktuális állapota.
- Hibaobjektum a hiba részleteivel, ha az aktuális állapot hibás állapotban van.
/// Send the email message with WaitUntil.Started
EmailSendOperation emailSendOperation = await emailClient.SendAsync(
Azure.WaitUntil.Started,
sender,
recipient,
subject,
htmlContent);
/// Call UpdateStatus on the email send operation to poll for the status
/// manually.
try
{
while (true)
{
await emailSendOperation.UpdateStatusAsync();
if (emailSendOperation.HasCompleted)
{
break;
}
await Task.Delay(100);
}
if (emailSendOperation.HasValue)
{
Console.WriteLine($"Email queued for delivery. Status = {emailSendOperation.Value.Status}");
}
}
catch (RequestFailedException ex)
{
Console.WriteLine($"Email send failed with Code = {ex.ErrorCode} and Message = {ex.Message}");
}
/// 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}");
Futtassa az alkalmazást az alkalmazáskönyvtárból a dotnet run
paranccsal.
dotnet run
Mintakód
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ó elfogadásával, az e-mail melléklet MIME típusú sztringgel, a tartalom bináris adataival és egy választható tartalomazonosítóval, amely beágyazott mellékletként definiálja azt. |
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. |
hiba | 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
- Node.js (~14).
- Egy Azure-fiók, aktív előfizetéssel. Fiók ingyenes létrehozása.
- Kiépített tartománnyal létrehozott és kész Azure Email Communication Services-erőforrás. Ismerkedés az e-mail-kommunikációs erőforrás létrehozásával.
- Egy e-mail tartományhoz és annak kapcsolati sztring csatlakoztatott aktív Azure Communication Services-erőforrás. Első lépésként csatlakoztassa az e-mail kommunikációs erőforrást egy Azure-beli kommunikációs erőforráshoz.
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
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 a felület létrehoz egy e-mail mellékletet egy egyedi azonosító, egy e-mail melléklet MIME típusú sztring, egy tartalombájt sztring és egy opcionális tartalomazonosító elfogadásával, amely beágyazott mellékletként határozza meg. |
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
- Egy Azure-fiók, aktív előfizetéssel. Fiók ingyenes létrehozása.
- A Java Development Kit (JDK) 8- vagy újabb verziója.
- Apache Maven.
- Üzembe helyezett Communication Services-erőforrás és kapcsolati sztring. További részletekért lásd : Communication Services-erőforrás létrehozása.
- Hozzon létre egy Azure Email Communication Services-erőforrást az e-mailek küldésének megkezdéséhez.
- Egy fejlesztési környezethez tartozó felügyelt identitás beállítása: Hozzáférés engedélyezése felügyelt identitással.
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.
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
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.*;
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.
Szinkron ü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 aszinkron ü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>";
EmailAsyncClient emailClient = new EmailClientBuilder()
.connectionString(connectionString)
.buildAsyncClient();
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
Egy e-mail az SDK objektumával EmailMessage
készíthető el.
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.");
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 elküldéséhez hívja meg a függvényt a beginSend
EmailClient
.
A szinkronizálási ügyfél hívása beginSend
egy SyncPoller
objektumot 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ést a metódus meghívása után azonnal elküldi a beginSend
rendszer. Az e-mailek küldése hosszú ideig futó művelet. Fontos megjegyezni, hogy a getFinalResult()
poller metódusa blokkoló művelet, amíg el nem éri a terminálállapotot (SUCCESSFULLY_COMPLETED
vagy FAILED
) . Az ajánlott módszer a manuális lekérdezések elvégzése az alkalmazás igényeinek megfelelő időközönként, az alábbi mintában bemutatott módon.
try
{
SyncPoller<EmailSendResult, EmailSendResult> poller = emailClient.beginSend(message, null); // This will send out the initial request to send an email
PollResponse<EmailSendResult> pollResponse = null;
Duration timeElapsed = Duration.ofSeconds(0);
Duration POLLER_WAIT_TIME = Duration.ofSeconds(10);
// Polling is done manually to avoid blocking the application in case of an error
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());
}
A kód futtatása
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
Hozza létre a csomagot.
mvn package
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
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 |
---|---|
Folyamatban | 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
- Egy Azure-fiók, aktív előfizetéssel. Fiók ingyenes létrehozása.
- Python 3.7+.
- Kiépített tartománnyal létrehozott és kész Azure Email Communication Services-erőforrás. Ismerkedés az e-mail-kommunikációs erőforrás létrehozásával.
- Egy e-mail tartományhoz és annak kapcsolati sztring csatlakoztatott aktív Azure Communication Services-erőforrás. Első lépésként csatlakoztassa az e-mail kommunikációs erőforrást egy Azure-beli kommunikációs erőforráshoz.
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
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
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
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
Előfeltételek
Aktív előfizetéssel rendelkező Azure-fiók, vagy ingyenes Azure-fiók létrehozása.
Egy aktív Azure Communication Services-erőforrás, vagy hozzon létre egy Communication Services-erőforrást.
Aktív Azure Logic Apps-erőforrás (logikai alkalmazás) és munkafolyamat, vagy hozzon létre egy új logikaialkalmazás-erőforrást és munkafolyamatot a használni kívánt eseményindítóval. Az Azure Communication Services e-mail-összekötője jelenleg csak műveleteket biztosít, ezért a logikai alkalmazás munkafolyamata legalább egy eseményindítót igényel. Létrehozhat használati vagy standard logikai alkalmazáserőforrást.
Az Azure Communication Services e-mail-erőforrása konfigurált tartománnyal vagy egyéni tartománnyal.
Egy Azure Email-tartományhoz csatlakoztatott Azure Communication Services-erőforrás.
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:
A tervezőben nyissa meg a logikai alkalmazás munkafolyamatát.
Fogyasztás
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.
A Művelet kiválasztása keresőmezőben válassza a Prémium lehetőséget. A keresőmezőbe írja be az Azure Communication Email nevet.
A műveletek listájában válassza az E-mail küldése lehetőséget.
Standard
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.
A Művelet hozzáadása keresőmezőben válassza a Prémium lehetőséget a futtatókörnyezet legördülő listájában. A keresőmezőbe írja be az Azure Communication Email nevet.
A műveletek listájában válassza az E-mail küldése lehetőséget.
Adja meg a kapcsolat nevét.
Adja meg az Azure Communications Service-erőforrás kapcsolati sztring. A sztring megkereséséhez kövesse az alábbi lépéseket:
Nyissa meg az Azure Communication Service-erőforrást az Azure Portalon.
Az erőforrás menü Beállítások területén válassza a Kulcsok lehetőséget, és másolja a kapcsolati sztring.
Amikor elkészült, válassza a Létrehozás lehetőséget.
A Feladó mezőben használja az előfeltételekben konfigurált e-mail-címet. Adja meg az E-mail, a Tárgy és a Törzs mezők értékeit, például:
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.