MailHeaderValue

Zastosowanie

MailHeaderValue() odczytuje wartość wskazanego nagłówka wiadomości e-mail przetwarzanej przy tworzeniu sprawy z poczty przychodzącej.

Nagłówki są dostępne tylko w trakcie tego przebiegu importu i zapisu sprawy. Funkcji używaj wyłącznie w regule automatycznej na etapie startowym. W regule ręcznej (przycisk), okresowej albo po późniejszym otwarciu sprawy funkcja zwraca pusty ciąg.

Zalecenie: na etapie startowym trzymaj jedną regułę automatyczną, która odczyta potrzebne nagłówki i zapisze je w polach sprawy — wtedy kolejne reguły korzystają już z pól, a nie z MailHeaderValue().

Składnia

MailHeaderValue("headerName");

Argumenty

Argument	Typ	Wymagany	Opis
`headerName`	String	Tak	Nazwa nagłówka wiadomości e-mail, np. `To`, `CC`, `From`, `Reply-To`, `Received`, `Subject`, `Date`.

Porównanie nazwy nagłówka jest niezależne od wielkości liter.

Zwracana wartość

Funkcja zwraca tekst (string):

wartość wskazanego nagłówka, albo
pusty ciąg, gdy nagłówek nie istnieje albo nagłówki maila nie są dostępne w bieżącym przebiegu reguły.

Przykłady

Przykład 1: adres z nagłówka `To`

adresat = MailHeaderValue("To");

Wynik: adres e-mail z pola nagłówka To przychodzącej wiadomości — o ile reguła działa w oknie tworzenia sprawy z maila.

Przykład 2: temat wiadomości

temat = MailHeaderValue("Subject");

Wynik: temat wiadomości z nagłówka Subject.

Przykład 3: data wysłania

dataWyslania = MailHeaderValue("Date");

Wynik: data wysłania z nagłówka Date.

Przykład 4: zapis nagłówków do pól przy tworzeniu sprawy

W regule automatycznej na etapie startowym:

if ([CaseMailFrom] != "")
{
    [Adresat] = MailHeaderValue("To");
    [NadawcaMail] = MailHeaderValue("From");
    [TematMaila] = MailHeaderValue("Subject");
}

Dzięki temu późniejsze reguły (ręczne, okresowe, kolejne etapy) czytają pola sprawy zamiast wywoływać MailHeaderValue().

Typowe błędy

Reguła na przycisku

Użycie MailHeaderValue() w regule ręcznej na sprawie wcześniej utworzonej z maila zwykle daje pusty wynik. Nagłówki nie są wtedy dostępne. Rozwiązanie: zapisz wartości przy tworzeniu sprawy (przykład 4).

Reguła okresowa

W przebiegu okresowym nie ma kontekstu nagłówków przychodzącego maila — funkcja zwraca pusty ciąg. Nie używaj jej w regułach okresowych.

Błędna nazwa nagłówka

Nieistniejąca lub literówka w headerName też daje pusty ciąg. Sprawdź dokładną nazwę nagłówka (np. Reply-To).