logo-softwarestudio-2020-600

j_mail.js

W dzisiejszym cyfrowym świecie automatyczne wysyłanie wiadomości e-mail jest ważnym narzędziem dla firm, które pozwala firmom pozostawać w kontakcie z klientami, zwiększać wydajność i oszczędzać czas. Automatyczne e-maile to te, które są automatycznie wysyłane przez program komputerowy, zwykle wyzwalane przez określone warunki lub zdarzenia.

Automatyczne wiadomości e-mail

Transakcja j_mail.js pozwalająca na wysyłanie wiadomości e-mail bezpośrednio z programu o zdefiniowanej treści z możliwością dodawania załączników.

Automatyczne wiadomości e-mail są często wykorzystywane do celów marketingowych, takich jak wysyłanie biuletynów, promocyjnych wiadomości e-mail i innych form reklamy. Można ich również używać do ostrzegania klientów o zmianach w ich kontach lub usługach, powiadamiania ich o nadchodzących wydarzeniach lub ofertach specjalnych lub dostarczania im aktualnych informacji.

Jednym z najpopularniejszych zastosowań automatycznych wiadomości e-mail jest obsługa klienta. Firmy mogą konfigurować automatyczne odpowiedzi e-mail, które są wysyłane, gdy klienci przesyłają zgłoszenia lub zapytania. Te zautomatyzowane wiadomości e-mail mogą pomóc zapewnić klientom szybką odpowiedź na ich zapytanie i zapewnić lepszą obsługę klienta.

Innym doskonałym zastosowaniem automatycznych wiadomości e-mail są automatyczne przypomnienia. Wiele firm korzysta z automatycznych wiadomości e-mail, aby przypominać klientom o nadchodzących wydarzeniach lub płatnościach albo informować ich o wysłaniu lub dostarczeniu ich zamówień. Pomaga to upewnić się, że klienci nie przegapią ważnych terminów lub płatności, i może przyczynić się do poprawy obsługi klienta.

Wreszcie, automatyczne wiadomości e-mail mogą służyć do automatyzacji ważnych procesów w firmie. Można na przykład wysyłać e-maile, aby przypominać pracownikom o zbliżających się spotkaniach lub zadaniach albo powiadamiać menedżerów o ukończeniu określonych zadań. Może to pomóc zaoszczędzić czas, a także poprawić wydajność w firmie.

Ogólnie rzecz biorąc, automatyczne e-maile to świetny sposób na pozostanie w kontakcie z klientami, zwiększenie wydajności i oszczędność czasu. Mogą być wykorzystywane do różnych celów, od marketingu, przez obsługę klienta, po automatyzację.


Konfiguracja

Konfiguracja transakcji bazuje głównie na trzech skorowidzach KEML, EML oraz EDIT.

Skorowidz KEML

Skorowidz KEML służy do definiowania konta do wysyłania maili. Zapytanie kierowane do skorowidza KEML, odczytuje informację o adresie e-mail zapisywaną w kolumnie SCIEZKA i jest ona podstawiana jako nadawca wiadomości. Kod skorowidza przekazywany jest w adresie URL jako parametr kontoeml transakcji.

SELECT TOP (1) ISNULL(SCIEZKA,'') AS SCIEZKA FROM x_skorowidze WHERE PRX='KEML' AND KOD = @KOD

Skorowidz EML

W skorowidzu definiowany jest szablony wiadomości e-mail wraz z innymi parametrami. Kod skorowidza przekazywany jest w adresie URL jako parametr kodeml transakcji.

SELECT TOP (1) OPIS, UWAGI, IKONA, SCIEZKA2, ISNULL(SCIEZKA,'') AS SCIEZKA, CENA, CENA2 FROM x_skorowidze WHERE PRX='EML' AND KOD = @KOD

  • OPIS– tytuł wiadomości e-mail
  • UWAGI – treść maila, szablon
  • IKONA – kod UID zapytania do ustalenia adresata. Jeśli kolumna IKONA będzie pusta to pole Adresat można uzupełnić ręcznie; do zapytania przekazywany jest jeden parametr – numer referencyjny obiektu, dla którego został wywołany formularz. Konfiguracja wymaga podania code_sql np. 9C9C0417-D354-4641-A6D5-40040700DE81. Sam kod definiujemy w następujący sposób:
    DECLARE @REF_NO bigint = {0}
    SELECT TOP(1) MAIL AS ADRESAT FROM KNKON WHERE NRIDODN=(SELECT TOP(1) NRIDODN FROM CALENDAR WHERE REFNO=@REF_NO AND ACH<>’X’)

    UWAGA: kolumna zapytania musi zwracać dane jako nazwa ADRESAT.
  • SCIEZKA –  jeśli wartość nie jest pusta to w polu DW będzie budowana lista wielokrotnego wyboru na podstawie kodu UID do zapytania budującego te listę; do zapytania przekazywane są dwa parametry wartość, po której będziemy filtrować szukanego odbiorcę oraz numer referencyjny obiektu, dla którego został wywołany formularz
  • CENA –  w kolumnie definiowane jest czy pole UDW ma być widoczne. Jeśli jest wartość = 0 to będzie ukryte, jeśli wartość będzie inna (zalecane jest 1) będzie widoczne
  • CENA2– w kolumnie definiowane jest czy możliwość dodawania załączników jest włączona. Jeśli jest wartość = 0 to przycisk 'Dodaj załącznik’ będzie ukryty, jeśli wartość będzie inna (zalecane jest 1) przycisk będzie widoczny

Skorowidz EDIT

Transakcja pozwala również na edytowanie ustawień edytora tekstu – froali poprzez zdefiniowanie dostępnych opcji w kolumnie UWAGI oraz czcionek w kolumnie KOMENTARZ w skorowidzu EDIT o kodzie TEMPLATE.

SELECT TOP(1) KOMENTARZ as 'czcionki', UWAGI as 'Przyciski' FROM x_skorowidze WHERE PRX = 'edit' and KOD = 'TEMPLATE'

Parametr return

Transakcja obsługuje również parametr return przekazywany w adresie URL. Parametr pozwala na przeniesienia użytkownika do wybranego grida po wysłaniu maila, jednak przeniesienie następuje tylko wtedy gdy transakcja otwierana jest w pełnym oknie. W przypadku otwierania transakcji jako dialogbox, po wysłaniu maila okno jest zamykane.

Parametr kod1

Po przekazaniu w adresie parametru kod1 zostanie wyświetlona nam lista dostępnych szablonów wiadomości email. Szablony konfigurowane są w tabeli x_skorowidze gdzie PRX=’EML’ i KOD1 = kodowi przekazanemu w adresie URL.

Przykładowa konfiguracja:

  • KOD – kod powiązanego skorowidza EML, skąd odczytywane są zapytania do uzupełnienia pola odbiorca itp.
  • OPIS – tytuł wiadomości
  • SCIEZKA2 – nazwa szablonu
  • UWAGI – treść wiadomości e-mail

Lista wyboru szablonów:

Zapytania

Aby rozwiązanie w pełni działało należy sprawdzić czy w projekcie występują następujące zapytania w tabeli _code_sql:

  • 4FD604DD-CB5C-4E60-8924-F6FF52790C04 – zapytanie konieczne do pobrania danych ze skorowidza EML,
  • 8D0509A3-2996-4634-90A6-4026369BD886 – odczytanie klucza licencji edytora Froala,
  • EC8898B2-676E-46DD-9F19-1F1462E947F7 – pobieranie ustawień froali,
  • 5661A63B-6C7F-45DD-BA80-602772CDAAB9 – pobranie danych ze skorowidza KEML,
  • 72374459-4FE0-4615-90D8-B6A815393044 – zapis pozycji do tabel _send oraz _task,
  • 5DA3DD8D-EC4A-4316-8CEF-C266BFEF9441 – zapytanie pozwalające na odczytywanie danych z bazy, które postawianie są w treści maila.
  • 86B0A71B-AA88-42DD-B6EF-BBA0751870C5 – pobranie listy szablonów
  • 91341938-BA9B-4851-B4E5-9CFD3C4B814E – pobranie danych z wybranego szablonu

Przykładowe wywołanie transakcji

.../role_sys/jqs21.aspx?kod=aa33-4913-9d6a&uid=40468AA8-3875-4C6C-A2BE-512F9E654A44&kodeml=REKDEFAULT&kontoeml=DEM&refno=4508130502590200

  • kod=aa33-4913-9d6a&uid=40468AA8-3875-4C6C-A2BE-512F9E654A44 – wywołanie formularza j_mail wynikające z zastosowania transakcji jqs21.aspx. Ten fragment wywołania wynika ze skorowidza JQS21, gdzie pod takim kodem i uidem zapisane jest wywołanie transakcji j_mail
  • kodeml=REKDEFAULT – kod skorowidza EML – zdefiniowanie szablonu maila
  • kontoeml=DEM – kod skorowidza KEML – zdefiniowanie konta do wysyłania maili
  • refno=4508130502590200- nr referencyjny obiektu, dla którego została wywołana transakcja