روش های ایمیل

روش های ایمیل

روش های ایمیل
روش‌های ایمیل برای ارسال ایمیل از یک برنامه، معمولاً با پیوست‌هایی که حاوی نتایج شبیه‌سازی هستند، استفاده می‌شوند.
 
نام
نحو
شرح
emailFromAddress
String emailFromAddress()
ایمیل را از آدرس سرور COMSOL یا تنظیمات برگزیده برمی‌گرداند.
sendEmail
sendEmail(String subject, String bodyText)
یک ایمیل با موضوع و متن مشخص شده به گیرنده(های) پیش فرض ارسال می کند.
sendEmail
sendEmail(String subject, String bodyText, ModelEntity… modelEntity)
یک ایمیل به گیرنده(های) پیش فرض با موضوع مشخص شده، متن اصلی و صفر یا بیشتر پیوست های ایجاد شده از گره های گزارش، صادرات و جدول در مدل تعبیه شده ارسال می کند.
sendEmail
sendEmail(String toAddress, String subject, String bodyText, ModelEntity… modelEntity)
یک ایمیل به گیرنده(های) مشخص شده با موضوع مشخص شده، متن اصلی و صفر یا بیشتر پیوست های ایجاد شده از گره های گزارش، صادرات و جدول در مدل تعبیه شده ارسال می کند.
userEmailAddress
String userEmailAddress()
آدرس(های) ایمیل کاربر مربوط به کاربر وارد شده فعلی یا یک رشته خالی را در صورتی که کاربر آدرس ایمیلی را پیکربندی نکرده باشد برمی گرداند.
روش های کلاس ایمیل
کلاس EmailMessage می تواند برای ایجاد پیام های ایمیل سفارشی استفاده شود.
 
نام
نحو
شرح
EmailMessage
EmailMessage mail = New EmailMessage()
یک شی EmailMessage جدید ایجاد می کند.
EmailMessage.setServer
mail.setUser(String name, String password)
میزبان و پورت سرور ایمیل (SMTP) را برای استفاده برای این پیام ایمیل تنظیم می کند.
EmailMessage.setUser
mail.setUser(String name, String password)
نام کاربری و رمز عبور را برای استفاده برای احراز هویت سرور ایمیل (SMTP) تنظیم می کند. این متد باید بعد از متد setServer فراخوانی شود.
EmailMessage.setSecurity
mail.setSecurity(String security)
نوع امنیت اتصال را برای ارتباط سرور ایمیل (SMTP) تنظیم می کند. مقادیر معتبر «none» ، «startls» و «tls» هستند. این متد باید بعد از متد setServer فراخوانی شود.
EmailMessage.setFrom
mail.setFrom(String fromAddress)
آدرس from را تنظیم می کند.
EmailMessage.setTo
mail.setTo(String… to)
آدرس ها را تنظیم می کند.
EmailMessage.setCc
mail.setCc(String… cc)
آدرس های سی سی را تنظیم می کند.
EmailMessage.setBcc
mail.setBcc(String… bcc)
آدرس های bcc را تنظیم می کند.
EmailMessage.setSubject
mail.setSubject(String subject)
خط موضوع ایمیل را تنظیم می کند. توجه داشته باشید که کاراکترهای خط جدید مجاز نیستند.
EmailMessage.setBodyText
mail.setBodyText(String body)
متن ایمیل را به صورت متن ساده تنظیم می کند. یک ایمیل می تواند حاوی متن و متن HTML باشد.
EmailMessage.setBodyHtml
mail.setBodyHtml(String body)
متن ایمیل را به عنوان متن HTML تنظیم می کند. یک ایمیل می تواند حاوی متن و متن HTML باشد.
EmailMessage.attachFile
mail.attachFile(String filename)
یک پیوست از یک فایل اضافه می کند. نوع MIME پیوست با پسوند نام فایل تعیین می شود.
EmailMessage.attachFile
mail.attachFile(String filename, String mimeType)
یک پیوست از یک فایل با نوع MIME مشخص شده اضافه می کند.
EmailMessage.attachFromModel
mail.attachText(String text, String mimeSubType)
یک پیوست ایجاد شده از یک گزارش، صادرات یا ویژگی جدول را در مدل اضافه می کند.
EmailMessage.attachText
mail.attachFromModel(ModelEntity modelEntity)
یک پیوست متنی با یک نوع MIME فرعی مشخص شده، مانند ساده یا HTML اضافه می کند.
EmailMessage.attachBinary
mail.attachBinary(byte[] binary, String mimeType)
یک پیوست از یک آرایه بایت با نوع MIME مشخص شده اضافه می کند.
EmailMessage.send
mail.send()
ایمیل را به سرور ایمیل (SMTP) ارسال می کند. یک شی ایمیل فقط یک بار می تواند ارسال شود.
هر رشته آدرس به , cc و bcc می تواند حاوی چندین آدرس ایمیل باشد که با کاما یا کاراکتر نقطه ویرگول از هم جدا شده اند. فضای خالی قبل و بعد از کاراکتر جداکننده مجاز است.
تنظیمات ایمیل
برای تنظیم تنظیمات برگزیده برای سرور ایمیل خروجی (SMTP)، صفحه ایمیل کادر گفتگوی Preferences را باز کنید، همانطور که در شکل زیر نشان داده شده است.
COMSOL Server مجموعه ای مشابه از اولویت های ایمیل را ارائه می دهد.
کد مثال
کد زیر یک ایمیل ارسال می کند و یک گزارش را پیوست می کند:
EmailMessage mail = new EmailMessage();
mail.setTo(emailTo);
mail.setSubject(“Tubular Reactor Simulation”);
mail.setBodyText(“The computation has finished. Please find the report attached.”);
mail.attachFromModel(model.result().report(“rpt1”));
mail.send();
این کد در برنامه Tubular Reactor اجرا می شود که به عنوان یک نمونه کاربردی در Application Libraries موجود است. شکل زیر بخشی از رابط کاربری را با یک فیلد ورودی برای آدرس ایمیل نشان می دهد.
شکل زیر شی فرم مربوطه و پنجره تنظیمات را نشان می دهد.
کد زیر مشابه است اما تنظیمات سرور ایمیل را نیز پیکربندی می کند.
EmailMessage mail = new EmailMessage();
mail.setServer(“smtp.myemail.com”, 587);
mail.setUser(“user@myemail.com”, “password”);
mail.setSecurity(“starttls”);
mail.setFrom(“user@myemail.com”);
mail.setTo(“otheruser@somedomain.com”);
mail.setSubject(“Tubular reaction simulation”);
mail.setBodyText(“The computation has finished”);
mail.send();