Datový typ OG - MessageForSend

Objekt se používá pro definici emailu na různé příjemce. V objektu je možné přidat soubory, které se spolu s emailem odešlou jako přílohy. Pro odesílání se používá metoda OG.Send.

Vlastnosti objektu

Název	Popis
string Subject	Předmět emailu.
string Body	Zpráva emailu.
int Priority	Priorita emailu.
bool IsHtml	Příznak, zda bude emailu odeslán jako HTML nebo PlainText.
int NotificationId	Id upozornění.
Notification Notification	Objekt pro upozornění.
int EmailTemplateId	Id emailové šablony.
EmailTemplate EmailTemplate	Objekt emailové šablony.
string EmailFrom	Email odesílatele.
string EmailTo	Seznam příjemců TO oddělených středníky.
string EmailBc	Seznam příjemců BC oddělených středníky.
string EmailCc	Seznam příjemců CC oddělených středníky.
EmailAttachmentList Attachements	Seznam příloh emailu.
bool SendEmailAsOne	Příznak, zda se má email odeslat na každého příjemce zvlášť (FALSE). Jinak bude odeslán na všechny příjemce najednou (TRUE).
EmailOwnerType OwnerType	Typ vlastníka emailu.
int? OwnerId	Id vlastníka emailu.
DataRow AssignEmailForDataRow	Záznam ze třídy, kterému má být email přiřazen.
void AddVariable( string name, object value)	Funkce přidá proměnnou k emailu.
void AddTo(object value)	Metoda přidá příjemce k TO.
void AddBc(object value)	Metoda přidá příjemce k BC.
void AddCc(object value)	Metoda přidá příjemce k CC.

Email můžete definovat pomocí vlastností Subject a Body. Druhou možností je zadat vlastnost NotificationId nebo Notification. V takovém případě bude obsah emailu převzat z upozornění.

Vyplněním vlastností EmailTemplateId nebo EmailTemplate bude pro email použita šablona. V případě definice upozornění, které bude mít vlastní nastavení emailové šablony, bude tato šablona ignorována a použita bude ta nastavená v tomto objektu.

Pokud není zadán email odesílatele (EmailFrom), pak se použije email ze souboru web.config.

Příjemce emailu lze zadat přímo do vlastností EmailTo, EmailBc nebo EmailCc. Pokud zadáváte více příjemců, oddělte je středníkem.

Pro jednotlivé přidávání příjemců použijte metody AddTo, AddBc nebo AddCc. Jako vstup můžete ale také použít email, Person, PersonList, PersonInfo, PersonInfoList.

Vlastnosti OwnerId a OwnerType slouží ke svázání emailu a objektu, který jej vygeneroval. V seznamu odeslaných emailů se tato informace zobrazuje v poli Vlastník.

Pokud email patří konkrétnímu záznamu ze třídy, pak vyplňte vlastnost AssignEmailForDataRow.

 

Pro email můžete přidat různé textové proměnné pomocí funkce AddVariable. Ty budou před odesláním do emailu vloženy.

Proměnnou v emailu použijete v poli Subject nebo Body nebo ji zadáte přímo v notifikaci. V textu stačí uvést následující příkaz definice proměnné url.

{{var.url}}

 

Příklad:

var m = OG.Email.CreateMessage();

m.AddTo( dr['solvers']);
m.AddCc( dr['manager']);

m.AddVariable('name', OGActualDataRow['name']);
m.AddVariable('url', OGActualDataRow.DetailUrl);

var modIT = OG.Model.GetByCode('it');
m.Notification = OG.Notification.GetAll().GetDefaultByCode( modIT.Id, 'New_RFC');
m.SendEmailAsOne = true;   //odeslat jako jeden email

OG.Email.Send(m);