Skip to main content

MailHeaderValue

Aktualizacja

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).

Powiązane tematy