1.Informacja dla zarządzających i handlowców.

(1)

1.Informacja dla zarządzających i handlowców.

Program "Masz wiadomość wer 2.0"-wersja komercyjna OEM służy do wysyłania i odbierania SMS-ów i MMS-ów przy pomocy komputera.

Do wysyłania SMS\MMS można użyć programy,które już są wykorzystywany, w Państwa firmie(programy nadrzędne).

Może to być np.ZSI (Zintegrowany System Informatyczny), Office, Excel, systemy do

sprzedaży(faktury),zamówienia,rozrachunki, windykacja należności(wezwanie do zapłaty,noty odsetkowe), płace,podatki lokalne itd..

Najprostszym sposobem skorzystania z naszej technologii do wysyłania SMS/MMS jest używanie plików w komputerze.

Oprogramowanie "Masz wiadomość" pełni rolę usługi, która zamienia pliki znajdujące się w katalogu na SMS-y lub MMS-y.

Państwa program nadrzędny kopiuje treści w formie plików (np.

"SMS send,1,+48694988607,Fvat 003.txt") lub

( np.MMS send,1,+48694988607,Fvat 500-zdjecie 1.JPEG) do wybranego katalogu, a system

"Masz widomość" wykonuje resztę pracy-wysła SMSy(plik tekstowy) lub MMSy .

Gdy program nadrzędny umieści plik tekstowy w katalogu, to dowolne powiadomienia zawarte w pliku w tym katalogu, wysłane zostanie do telefonu odbiorcy w formie SMS.

Gdy program nadrzędny umieści w katalogu: fakturę, wezwanie do zapłaty, notę

odsetkową,wymiar podatku itp.- wtedy natychmiast pliki z tego katalogu wysłane zostaną do telefonu odbiorcy w formie MMS.

Nasz kontrahent otrzyma dokument(MMS) lub powiadomienie(SMS).

Pliki do wysłania można do katalogu "wkleić ręcznie" bez użycia programu nadrzędnego.

Program "Masz wiadomość"umożliwia wysłanie tysięcy,setek tysięcy lub milionów SMS-ów lub MMS-ów.

Szybkość wysyłania można skalować przez wybór modemu i ilość używanych (załadowanych do modemu) kart SIM oraz wykorzystanie technologii internetu mobilnego(2G,3G,4G).

Dysponujemy testami szybkości wysyłania.

Projekt "Masz wiadomość" ma otwarty system konfiguracji i wykorzystuje najnowocześniejsze narzędzia i dobre praktyki

(SQL Serwer(procedury dołączone,wyzwalacze),pliki XML,c#).

Wystarczy ,aby Państwa program nadrzędny utworzył np. fakturę w formacie *.PDF, a my udostępnimy nieodpłatnie dodatkową aplikacje HotFolder wer 2.0 na zasadach wolnego oprogramowania(AGPL Ghostscript is provided under the GNU Affero General Public License (AGPL)):

https://imagemagick.org/

https://www.ghostscript.com/

Nasze wolne oprogramowanie HotFolder wer 2.0 tworzy obrazy gotowe do wysyłki.

Oprogramowanie powstało dzięki materiałom zamieszczonym w linkach.

Utwórz więc w katalogu np. plik

MMS send,1,+48694988607,Fvat 21.PDF (ten plik tworzy oprogramowanie w Twojej firmie. Format PDF jest powszechnie wykorzystywany.)

(2)

a HotFolder wer 2.0(Gorący Folder (c#)) zamieni fakturę na zdjęcie(lub zdjęcia)np.

MMS send,1,+48694988607,Fvat 21-zdjecie 1.JPEG MMS send,1,+48694988607,Fvat 21-zdjecie 2.JPEG

(faktura składa się z 2 zdjęć) .Dla każdego operatora można utworzyć osobny katalog.

2.Informacja dla informatyków.

Projekt "Masz wiadomość" wykorzystuje modemy wieloportowe do wysyłania SMS\MMS i może być zainstalowany na dowolnym komputerze, który posiada port USB

i system WIN. Port USB może obsługiwać modemy zawierające nawet 64 porty do obsadzenia kartami SIM. Skalowanie jest praktycznie nieograniczone.

Transact-SQL to świetne narzędzie do zarządzania plikami w katalogach, ponieważ wykorzystuje siłę technologi SQL Serwer do obsługi plików w katalogu.

"Masz wiadomość" wykorzystuje technologię "File Tables" do zarządzania plikami na komputerze.

Trigery(wyzwalacze) i Stored Procedures(procedury dołączone) w "File Tables"służą do wzboogacenia funkcjonalności obsługi kopiowanych(pochodzących z dowolnego programu nadrzędnego) w systemie operacyjnym plików.

Trigery i procedury dołączone wykorzystano do operacji CRUD-INS, DEL, UPDATE, SELECT, które wykonywane są w systemie operacyjnym na plikach.

"Masz wiadomość" wykorzystuje otwarte środowisko "Microsoft SQL Server Management Studio 18".

Stored Procedures, zawarte w projekcie, definiują otwarte środowisko serwera - "Masz wiadomość".

Następna część konfiguracji serwera "Masz wiadomość" jest realizowana przy pomocy pliku XML.W pliku XML wpisujemy dane podane przez operatora telefonii komórkowej i inne dane dotyczące zachowania serwera "Masz wiadomość" .

Plik XML to wygodny i prosty sposób konfigurowania serwera "Masz wiadomość".

Przepustowość modemu(ilość kart SIM) należy dobrać do zakładanego celu(wysyłanie\

odbieranie tysiące, setki tysięcy, miliony SMS\MMS). Nie musimy włączać(obsadzać kartami SIM) wszystkich gniazd kart SIM w wybranym modemie.

Serwer "Masz wiadomość" uruchamia tyle wątków, ile jest włączników w stanie ON

przy kartach SIM i dodatkowo jeden wątek(kopia plików) do wykonania kopii archiwalnej plików (MS/MMS) z katalogu roboczego do katalogu archiwalnego.

Dane do katalogu roboczego przygotowuje program nadrzędny.

Wynik działania wątku-kopii plików jest jednoznaczny z wysyłanym SMS\MMS. Ten wątek realizowany w C# jest także zdefiniowany w Stored Procedures w SQL Serwerze.

Serwer "Masz wiadomość" tworzy automatycznie ,na każdy miesiąc, czytelny plik dziennika(co, kiedy, do kogo i od kogo, i którą kartą SIM wysłano lub odebrano- patrz dokumentacja 3.09).

Dla informatyka dodano dziennik narzędziowy(patrz dokumentacja 3.10), w którym zapisywane są wszystkie operacje wykonywane przy pomocy modemu (AT COMMANDS) oraz którym

(3)

wątkiem (tzn. kartą SIM) i z jakim priorytetem została wykonana każda operacja.

Informacje o wykonywanych poleceniach (AT COMMAND) znajdują się w dokumentacji producenta modemu QUECTEL.

Można skonfigurować różne priorytety na poziomie wysyłanych: SMS-ów\MMS-ów i dotyczy to kart SIM oraz dodatkowo priorytety na poziomie samych plików umieszczonych w katalogu a także na poziomie wątków.

Dzięki zastosowaniu otwartej architektury "SQL Serwer" można dodać np. tabelę

telefonów(spam,wykluczenia(czasowe,stałe...),...) lub inne funkcjonalności dostępne w już użytkowanych programach nadrzędnych.

Serwer wysyłając wiadomość uruchamia transmisje danych(SMS\MMS) wprost z komputera.

3.Dokumentacja.

3.01.Quectel_EC2x&EG9x&EM05_MMS_AT_Commands_Manual_V1.0.pdf 3.02.Quectel_EC2xEG9xEM05_HTTPS_AT_Commands_Manual_V1.0.pdf 3.03.Quectel_EC25&EC21_AT_Commands_Manual_V1.3.pdf

3.04.Quectel_GSM_MMS_AT_Commands_Manual_V1.1.pdf 3.05.Quectel_LTE_Standard_MMS_Application_Note_V1.1.pdf

3.06.https://www.sqlshack.com/sql-server-filetable-the-next-generation-of-sql-filestream/

3.07.https://www.sqlshack.com/sql-server-filetable-use-cases/

3.08.Wybierz modem: https://www.alibaba.com/showroom/quectel_2.html 3.09.LogFile-202012.txt

3.10.LogUtilFile-202012.txt 3.11.Baza danych *.mdf,*.ldf 3.12.XMLFile.xml

3.13.db.udl

3.14.attachments.zip 3.15.gs9533w64.exe

3.16.https://imagemagick.org/index.php 3.17.QCOM_V1.6.zip

4.Pytania.

1.Czy serwer "Masz wiadomość" może pracować w określonych godzinach i dniach tygodnia?

Tak.

W pliku konfiguracyjnym XMLFile.xml jest sekcja:

<scheduler>(12345)12:00-13:00,(12345)15:00-17:00,(67)20:00-22:30</scheduler> , która wymusza prace w określone dni tygodnia i zakresy godzin.

Przykład:

(12345)12:00-13:00 -od poniedziałku do piątku od 12:00-13:00, (67)20:00-22:30 -sobota i niedziela do 20:00 do 22:30 .

Także program nadrzędny może przekazywać dane do katalogu roboczego w wyznaczonych godzinach niezależnie od ustawień serwera.

Wtedy można ustawić pracę serwera:

(1234567)00:00-24:00 a czas wysyłania reguluje program nadrzędny.

2.Czy jest możliwa wysyłka mejlem i zindywidualizowane powiadomienie(np. dzień

(4)

termin płatności i kwota do zapłaty) SMSem.

Tak.

3.Czy można użyć kart SIM różnych dostawców?

Tak.

5.Instrukcja instalacji programu.

5.1.Instalacja bazy danych Dot. wersji SQL Serwer 2019

Plik attachments.zip zawiera scrypt SQLFileTableScript.txt do utworzenia bazy danych.Uruchom dodatkowo skrypty SQLFileTableScriptTrigery.txt

Jeżeli używasz starszej wersji SQL Serwer wykonaj skrypty zawarte w SQLFileTable.txt Wykonaj dodatkowo skrypt00.txt

W procedurze dołączonej CopyOfSendFile (SQLSerwer użyty jest także do operacji MOVE na plikach) jeśli to konieczne zastąp linię:

EXEC master..xp_cmdshell @FileMove poleceniami jak niżej:

EXEC master .. xp_cmdshell "net use u: \\win_rdp_iis\smsmms HaSłOtuWpIsZ EXEC master..xp_cmdshell @FileMove/user:Administrator "

EXEC master .. xp_cmdshell "net use u: / delete"

\\win_rdp_iis\smsmms przykład katalogu, do którego program nadrzędny kopiuje plik np. "SMS send,1,+48694988607,Fvat 003.txt"

Wymagane, gdy masz SQLSerwer na jednej maszynie wirtualnej, a programy nadrzędne na drugiej maszynie wirtualnej.Patrz skrytp skryt01.txt

UWAGA:Technologia SQLFileTable dostępna jest od wersji SQL Serwer 2012 Więcej informacji patrz dokumentacja 3.06

5.2.Test łącza z SQL serwer Użyj programu do testu db.udl

(Przykład składni połączenia 192.168.10.21,1433\\WIN_SQL)

Wybierz bazę danych na serwerze SQLFileTable i przyciśnij przycisk testuj połączenie.

Użyj SQL Server 2019 Configuration Manager(lub starszej wersji SQL Serwer Network Configuration) do definicji połączenia z bazą danych.

5.3.Kopiuj program do obsługi modemu

(5)

Kopiuj wszystkie pliki modem.zip do utworzonego wcześniej katalogu(np. c:\modem) na maszynie fizycznej.Nie uruchamiaj(najpierw skonfiguruj plik XMLFile.xml).

5.4.Konfiguruj plik XMLFile.xml

Plik zawiera przykładowe dane, które wystarczy skorygować i zawiera sekcje:

a)Sekcja <sqlSerwer> zawiera dane do komunikacji z SQL Serwer, b)Sekcja <comSettings> zawiera sekcje <comSetting>,

c)Sekcje <comSetting> ilość sekcji jest dowolna i przypisana do modemu.

Dopuszczalne wartości to 0-4 .Oznacza priorytet wątków tzn priorytet wykorzystania modemów(kart SIM)

Ilość wczytanych dokumentów na 1 wątek(modem)

Ilość prób wysłania po błędzie(liczymy od 0, w przykładzie powtórz 3 razy)

Max. czas oczekiwania na odpowiedź modemu.Tu 30 sek.

Włącz modem na porcie 19

<On>false</On>

Wyłącz modem na porcie 19

Wysyłaj\Odbieraj:

(12345) od poniedziałku do piątku od godz. 12:00 do 13:00 , (67)20:00-22:30 w sobotę i w niedzielę od godz. 20:00-22:30

Setki innych parametrów zawartych w pliku konfiguracyjnym są opisane przy pomocy znaczników XML, których treść definiuje zawartość znacznika..

5.5.Maszyna fizyczna i modem

Przed podłączeniem łącza USB uruchom na maszynie fizycznej Device Manager i sprawdź jakie występują porty szeregowe.

Podłącz modem i zanotuj jakie nowe porty się pojawiły.

Włóż prawidłowo pierwszą kartę SIM i włącz pierwszy modem.

Numery portów przyporządkowane do modemu można wykryć przy pomocy programu

(6)

QCOM_V1.6.EXE dostarczonego przez producenta (AT COMMAND TOOL.zip).

Otwórz port i wpisz polecenie ATE1 . Jeżeli uzyskasz odpowiedź to com jest zidentyfikowany.

Wykryj kolejne porty.

Uwaga-zmiana portu USB generuje kolejne porty.

Więcej informacji o modemie patrz w dokumentacji producenta.

Skoryguj zapisy w pliku XMLFile.XML

<On>true</On> jeśli nie używasz portu wpisz false

Jeżeli korzystasz z sieci Orange nic więcej nie musisz zmieniać.

Modem nie posiada sterowników do starszych wersji systemów serwerowych(WIN2012 serwer).

Modem można podłączyć do WIN2019 serwer nie używając żadnych sterowników.

Do systemów nieserwerowych możesz użyć sterownika producenta-znajduje się w Quectel_LTE&5G_Windows_USB_Driver_V2.2.4.zip

Przykłady instalacji:

1)Jeżeli używasz starszej wersji systemów serwerowych to możesz na maszynie wirtualnej z SQL Serwerm zainstalować bazę danych, na drugiej maszynie wirtualnej

zawierającej "Programy nadrzędne" udostępnij katalog na pliki do wysłania SMS\MMS i katalog na pliki wysłane.

Modem(urządzenie) zaś możesz podłączyć do dowolnego komputera pracującego w sieci.Z tego komputera uzyskaj uprawnienia do 2 katalogów("katalog do wysłania" i "katalog wysłane") na serwerze.

Na komputerze klienckim mapuj katalogi do wysyłki SMS/MMS.Możesz użyć także Edytora obiektów zasad grupy.

W Edytorze obiektów zasad grupy->zakładka użytkownik->ustawienia systemu Windows-

>logowanie

można umieścić skrytpt zawierający "mapowanie katalogu" w katalogu np

C:\Windows\System32\GroupPolicyUsers\S-1-5-21-2328600781-809155739-2840887999-1002\

User\Scripts\Logon użytkownika

2)Możesz też wszystkie składniki aplikacji "Masz wiadomość" i modem(urządzenie)

a także SQL Serwer podłączyć na jednym komputrze(np. z win 8 lub młodszym) podłączonym do sieci a jeden katalog(na pliki do wysłania) udostępnić w sieci innym programom nadrzędnym, znajdującym się w sieci.

3).Wszystkie składniki programu, wraz z programem nadrzędnym, można także umieścić na 1 komputerze lub laptopie.

(7)

5.6.Uruchom program Uruchom program Modem.exe

Program startując czyta dane konfiguracyjne z pliku XMLFile.xml i działa w tle.

W konfiguracji(<LogUtilFile>true</LogUtilFile>) można ustalić czy chcesz plik z logami zawierającymi szczegóły działania systemu operacyjnego i modemu.

Uproszczony plik z logami(logFile) zawiera listę wysłanych\odebranych wiadomości, godzinę ich wysłąnia oraz port(modem).

Pliki z logami tworzone są na każdy rok(np 2020) i miesiąc(np 12) automatycznie np LogUtilFile-202012.txt

5.7.Program nadrzędny wstawia pliki do katalogu Wstaw pliki do katalogu w celu wysłania MMS i SMS np:

MMS send,1,+48694988607,Fvat 100.JPEG SMS send,1,+48694988607,Fvat 003.txt

Do celów testowych możesz utworzyć plik "ręcznie".

Ciąg znaków(iloczyn wszystkich nazw zbiorów) np. "MMS send" dodatkowo określony jest w XMLFile.xml przez <sendMMSLenght>8</sendMMSLenght> stąd programy nadrzędne mogą produkować swoje oznaczenia np.:

MMS send-sprzedaz Zyszek,1,+48694988607,Fvat 100.JPEG

MMS send-ksiegowa 01,1,+48694988607,Wezwanie do zaplaty 100-2021.JPEG podobnie dla SMS

<sendSMSLenght>8</sendSMSLenght>(8 znaków to długość ciągu "SMS send"):

SMS send wodociagi,1,+48694988607,Plukanie sieci 003.txt SMS send wodociagi,1,+48694988607,Awaria ujecia wody 004.txt SMS send oczyszczalnia,1,+48694988607,Informacja 004.txt objaśnienia:

1 -priorytet (1-9)

+48694988607 -nr telefonu

Fvat 100 -identyfikator(np. nr dokumentu)

*.JPEG -rozszerzenie pliku(zdjęcie), MMS

*.txt -rozszerzenie pliku(plik tekstowy), SMS

1.Informacja dla zarządzających i handlowców.