DOKUMENTACJA IMPLEMENTACJI MECHANIZMÓW OBSŁUGI AHMES SMS (html)

Podobne dokumenty
DOKUMENTACJA IMPLEMENTACJI MECHANIZMÓW OBSŁUGI AHMES SMS (soap)

3S TeleCloud - Aplikacje Instrukcja użytkowania usługi 3S SMS SYSTEM

Tworzenie stron internetowych z wykorzystaniem HTM5, JavaScript, CSS3 i jquery. Łukasz Bartczuk

INSTRUKCJA AKTYWACJI I OBSŁUGI BRAMKI SMS DLA FIRM. (Bramka SMS dla małych Firm, Bramka SMS Pro)

Dokumentacja smsapi wersja 1.4

Formularze HTML. dr Radosław Matusik. radmat

Komunikator wewnętrzny. funkcjonalność podstawowa bs4 intranet

SKRÓCONA INSTRUKCJA OBSŁUGI POCZTY ELEKTRONICZNEJ ZIMBRA WEBMAIL

Wysyłanie komunikatów do ucznia/ opiekuna przez nauczyciela

Aplikacje WWW - laboratorium

FORMULARZE Formularz ma formę ankiety, którą można wypełnić na stronie. Taki formularz może być np. przesłany pocztą elektroniczną .

Zajęcia 4 - Wprowadzenie do Javascript

Wprowadzenie do Internetu Zajęcia 5

Formularze w PHP dla początkujących

Instrukcja obsługi serwisu VoiceContact

SYSTEM ZARZĄDZANIA DANYMI OSOBOWYMI - INSTRUKCJA UŻYTKOWNIKA

INSTRUKCJA OBSŁUGI PANELU WEBMAIL

LABORATORIUM 2 WSTĘP DO SIECI TELEINFORMATYCZNYCH TABELE I FORMULARZE

INSTRUKCJA OBSŁUGI APLIKACJI WEBFAX DLA

Instrukcja obsługi certyfikatów w programie pocztowym MS Outlook Express 5.x/6.x

dokumentacja.md 4/1/2019 Aplikacja dostępna jest tutaj. Może z niej korzystać każdy członek ZHP posiadający konto Office365.

E-czeki - zakładanie listy odbiorców, raport uprawnień (Bankowość Elektroniczna dla Klientów Korporacyjnych Getin Noble Bank SA)

Ćwiczenie 7 - Formularze

Dokumentacja Skryptu Mapy ver.1.1

obecnie tabeli nie stosuje się do budowy struktury witryny (stosuje się za to pozycjonowanie elementów i warstwy) faktycznie wymagają

DWM-157. Modem USB HSPA+ Podręcznik użytkownika

Finanse VULCAN. Jak wprowadzić fakturę sprzedaży?

INSTRUKCJA OBSŁUGI APLIKACJI WEBFAX DLA UŻYTKOWNIKA

Mobilny CRM BY CTI 1

Wykład 03 JavaScript. Michał Drabik

GroupWise WebAccess Basic Interface

Integracja sklepu internetowego z serwisem aukcyjnym Swistak.pl

Komunikator podręcznik użytkownika podręcznik użytkownika

Tworzenie kampanii mailowych. Tworzenie kampanii mailowych.

Instrukcja integratora - obsługa dużych plików w epuap2

Funkcje dodatkowe. Wersja 1.2.1

W tej sekcji znajdują się foldery gromadzące wszystkie pliki znajdujące się w Twoim projekcie. Nazwa folderu odpowiada rodzaj owi załącznika.

Instalowanie dodatku Message Broadcasting

INSTRUKCJA OBSŁUGI APLIKACJI WEBFAX DLA UŻYTKOWNIKA

Aplikacje WWW - laboratorium

Instrukcja użytkownika

Zarządzanie bazą danych

UONET+ moduł Dziennik. Praca z rozkładami materiału nauczania

Podstawy JavaScript ćwiczenia

JavaScript - wykład 4. Zdarzenia i formularze. Obsługa zdarzeń. Zdarzenia. Mysz. Logiczne. Klawiatura. Beata Pańczyk

Z poradnika dowiesz się jak zautomatyzować kampanie marketingowe za pomocą narzędzi i różnego typu autoresponderów dostępnych w GetResponse.

Data wydania: Projekt współfinansowany przez Unię Europejską ze środków Europejskiego Funduszu Społecznego

Panel dla agentów. Instrukcja obsługi dla agentów

SYSTEM INFORMATYCZNY KS-SEW

Instrukcja obsługi aplikacji MobileRaks 1.0

Kopiowanie przy użyciu szyby skanera. 1 Umieść oryginalny dokument na szybie skanera stroną zadrukowaną skierowaną w dół, w lewym, górnym rogu.

1. Proszę wejść na stronę: poczta.home.pl i zalogować się do nowej skrzynki za pomocą otrzymanych danych.

Budowa dokumentu HTML 5

Integracja z pocztą Gmail. Integracja Poczta Google. Wersja 1.0 SPIS TREŚCI

Elektroniczna Skrzynka Podawcza

Sprawdzenie czy połączenie przebiegło poprawnie if (mysqli_connect_errno()) { echo Błąd; Połączenie z bazą danych nie powiodło się.

Instrukcja obsługi aplikacji Karty Pojazdów dla Dealerów Samochodowych

Przetwarzanie dokumentów XML i zaawansowane techniki WWW Zdarzenia w JavaScript (Zajęcia r.)

Tworzenie pliku źródłowego w aplikacji POLTAX2B.

Instrukcja importu przesyłek. z Menedżera Sprzedaży do aplikacji Webklient

Pierwsze logowanie do systemu Uczniowie Optivum NET

Obsługa przesyłek InPost w aplikacji Komornik SQL

Panel Konta - instrukcja. Warszawa, 2013 r

Uczniowie Optivum NET + Moduł Użytkownik

Przewodnik... Tworzenie ankiet

Miejskie Wodociągi i Oczyszczalnia sp. z o.o. w Grudziądzu. ibok. Internetowe Biuro Obsługi Klienta. Instrukcja obsługi

INSTRUKCJA UŻYTKOWANIA USŁUGI mobile e-bank EBS

1. MILLENET WPROWADZENIE 1 2. CERTYFIKAT INTERNETOWY 2 3. PIERWSZE LOGOWANIE 2 4. POSTAWOWE POJĘCIA 8 5. INSTRUKCJA UŻYTKOWNIKA 15

FORMULARZE. G. Przęczek

Dokumentacja systemu NTP rekrut. Autor: Sławomir Miller

KS-ZSA. Centralne zarządzanie znacznikami zamawiania towaru (BlackList)

Programowanie internetowe

Oracle Application Express

INSTRUKCJA ADMINISTRATORA KLIENTA

Diagnoza Szkolna Pearsona. Instrukcja obsługi

Format HTML. Wybrane działy Informatyki Stosowanej. Definicja i przeznaczenie Struktura dokumentu Znaczniki Formularze i komponenty

Dokumentacja SMS przez FTP

Klient poczty elektronicznej - Thunderbird

Asystent jakie to proste!

,Aplikacja Okazje SMS

Aplikacje WWW - laboratorium

Baza numerów Wersja 1.1

Dostęp do poczty za pomocą przeglądarki internetowej

REJESTRACJA NOWEJ DRUKARNI W SYSTEMIE PRINTING-CENTER

Obsługa kalendarza wizyt w serwisie elekarze. Podręcznik użytkownika

Jak wykonać przeniesienie kontaktów do Firmowej Książki Odbiorców?

Podręcznik użytkownika Systemu Extranet

INSTRUKCJA OBSŁUGI PROGRAMU. ver

Co nowego w systemie Kancelaris 3.31 STD/3.41 PLUS

Podręcznik użytkownika Publikujący aplikacji Wykaz2

WEBTRUCKER INSTRUKCJA OBSŁUGI V.2.6

Funkcje dodatkowe. Wersja 1.2.1

Wdrożenie modułu płatności eservice dla systemu QuickCart 6.0

Przewodnik użytkownika systemu e-faktur

ADRESOWA WITAJ W INFORMATORZE TALK FUSION O KSIĄŻCE ADRESOWEJ

Kadry Optivum, Płace Optivum

Instrukcja użytkownika. Aplikacja Smart Paczka DPD

Aplikacje WWW - laboratorium

I. Program II. Opis głównych funkcji programu... 19

Outlook Express - konfigurowanie i korzystanie.

Transkrypt:

Ahmes Sp. z o.o. ul. Lewicka 13/15 02-547 Warszawa tel: (22) 113 10 00, fax: (22) 203 63 21, e-mail: biuro@ahmes.pl, http://www.ahmes.pl DOKUMENTACJA IMPLEMENTACJI MECHANIZMÓW OBSŁUGI AHMES SMS (html) 2013-03-04

Spis treści WPROWADZENIE... 3 WYSYŁANIE SMS ów... 4 Proste wysłanie wiadomości... 4 Ustalenie typu wysyłanej wiadomości... 4 Ustawienie daty wysłania wiadomości... 5 Ustawienie grupy kontaktów, jako odbiorcę... 5 KSIĄŻKA ADRESOWA... 6 Wylistowanie grup w książce adresowej... 6 Dodanie grupy do książki adresowej... 6 Usunięcie grupy z książki adresowej... 7 Wylistowanie numerów danej grupy w książce adresowej... 7 Dodawanie numeru do danej grupy książki adresowej... 8 Usuwanie numeru z grupy książki adresowej... 8 HISTORIA SMS ów... 9 Wylistowanie wysłanych wiadomości... 9 Stronicowanie wysłanych wiadomości... 9 Filtrowanie po dacie wysłanych wiadomości... 9 Pobieranie historii w formacie CSV... 10 ZAPLANOWANE WIADOMOŚCI SMS... 10 Wylistowanie zaplanowanych wiadomości SMS... 10 Usuwanie zaplanowany wiadomości... 11 2

WPROWADZENIE Dokumentacja pokazuje dostęp do usługi przy pomocy biblioteki napisanej w języku JavaScript. Rozwiązanie pozwala pisać interfejs do usługi tylko za pomocą języka HMLT5. Do korzystania z usługi potrzebne są parametry user_name i user_password odzwierciedlające dane uwierzytelniające w witrynie http://partners.ahmes.pl. Na każdej stronie web, która będzie korzystać z naszej biblioteki, dodać należy odwołanie do trzech bibliotek: <script src="http://code.jquery.com/jquery-1.9.1.js"> <script type="text/javascript" src="http://knockoutjs.com/downloads/knockout-2.2.1.js"> <script type="text/javascript" src="http://partners.ahmes.pl/api/ahmessmsapi-1.0.js"> 3

WYSYŁANIE SMS ów Do wysyłania sms ów służy funkcja wewnętrzna o nazwie SendSmsViewModel Przykład zaimplementowania funkcji na stronie: <script type="text/javascript"> $(document).ready(function () { ko.applybindings(new SendSmsViewModel("[nazwa użytkwonika]", }); "[hasło]")); Proste wysłanie wiadomości Do wysłania w prosty sposób wiadomości należy użyć np. dwóch znaczników input. Jednego do wprowadzenia treści wiadomości i jednego do wprowadzenia numeru adresata. Potrzebny jest także element do wywołania akcji wysłania wiadomości np. button. <input data-bind="value: To" /> <textarea data-bind="value: Message"></textarea> <button data-bind="click: sendsms">wyślij wiadomość</button> Jeżeli wiadomość zostanie pozytywnie wysłana pola(to i Message) zostaną wyczyszczone. Ustalenie typu wysyłanej wiadomości Rozróżnia się dwa typy wiadomości do wysłania(sms i FLASH). Domyślnie wysyłane są wiadomości typu SMS. Dla zmiany typu wiadomości należy użyć np. znaczników input typu radio. <label> <input type="radio" checked="checked" name="messagetype" value="1" data-bind="checked:sendsmstype"/> SMS </label> <label> <input type="radio" name="messagetype" value="0" data-bind="checked:sendsmstype" style="width:25px;"/> FLASH </label> 4

Ustawienie daty wysłania wiadomości Usługa pozwala ustawić datę wysłania wiadomości. Jeżeli data zostanie ustawiona na wcześniejszą, lub równą bieżącej to wiadomość zostanie wysłana natychmiast. Datę należy wstawiać np. do znaczników input typu text w formacie RRRR-MM-DD GG:MM:SS. <input type="text" data-bind="value: SendSmsDate" /> Ustawienie grupy kontaktów, jako odbiorcę Jedną z funkcjonalności jest wybór odbiorców wiadomości między indywidualnym numerem, a grupą kontaktów(edycja grupy kontaktów opisana jest poniżej). Należy użyć wtedy np. standardowego znacznika input typu text do wprowadzania indywidualnego obiorcy, oraz znacznika select do wprowadzania grupy odbiorców. Wybór pomiędzy typami odbiorów można zaimplementować przy użyciu znaczników input typu radio. <input data-bind="value: To, visible: SendToType() === '1'" /> <select data-bind="options: AddressBookCollection, value: GroupName, visible: SendToType() === '0', optionscaption: 'Wybierz grupę...'"/> <h3>typ odbiorcy:</h3> <label> <input type="radio" checked="checked" value="1" name="receivertype" databind="checked:sendtotype, valueupdate: 'keydown'" style="width:25px;"/> Numer </label> <label> <input type="radio" name="receivertype" value="0" data-bind="checked:sendtotype, valueupdate: 'keydown'" style="width:25px;"/> Grupa </label> 5

KSIĄŻKA ADRESOWA Do edycji książki adresowej służy funkcja wewnętrzna o nazwie AddressBookViewModel. Przykład zaimplementowania funkcji na stronie: <script type="text/javascript"> $(document).ready(function () { ko.applybindings(new AddressBookViewModel("[nazwa użytkwonika]", }); "[hasło]")); Wylistowanie grup w książce adresowej Do wylistowania grup książki adresowej należy użyć tabeli, lub znaczników do listujących (ul). <table> <thead> <th>nazwa grupy</th> <th>data dodania</th> </thead> <tbody data-bind="foreach: AddressBookCollection"> <td data-bind="text: Name"<td> <td data-bind="text: CreateDate"></td> </tbody> </table> Dodanie grupy do książki adresowej Aby dodać grupę kontaktów należy wprowadzić nazwę grupy np. przy użyciu znacznika input typu text, oraz wywołać zdarzenie dodania np. w formularzu przy użyciu znacznika button. <form data-bind="submit: addaddressbookclick"> <input data-bind="value: AddressBookNameToAdd"/> <button type="submit" />Dodaj grupę</button> </form> W przypadku poprawnego dodania grupy pole nazwa grupy w polu input zostanie usunięta i zostanie dodana nowa nazwa grupy do listy grup, w przeciwnym wypadku zostanie wywołany w przeglądarce komunikat o błędzie w dodaniu grupy. 6

Usunięcie grupy z książki adresowej Aby usunąć grupę z książki adresowej należy np. dodać nową kolumnę w tabeli listującej wszystkie grupy i dodać w niej znacznik a usuwający daną grupę. <td data-bind="text: Name"></td> <td data-bind="text: CreateDate"></td> <td><a href="#" data-bind="click: $root.removeaddressbookclick">usuń</a></td> W przypadku poprawnego usunięcia grupy zostanie ona usunięta z listy grup, w przeciwnym wypadku zostanie wywołany w przeglądarce komunikat o błędzie w usunięciu grupy. Wylistowanie numerów danej grupy w książce adresowej Żeby wylistować wszystkie numery danej grupy należy ustawić daną grupę na liście, jako zaznaczoną. Jest to możliwe poprzez dodanie dodatkowego parametru, do danego elementu na liście. <td data-bind="text: Name, click: $root.selectaddressbookclick"></td> <td data-bind="text: CreateDate, click: $root.selectaddressbookclick"></td> Zaznaczoną grupę kontaktu można wyświetlić np. w formie tabeli, albo listy (ul). <table> <thead> <th>numer</th> <th>data dodania</th> </thead> <tbody data-bind="foreach: AddressBookNumberCollection"> <td data-bind="text: Number"></td> <td data-bind="text: CreateDate"></td> </tbody> </table> 7

Dodawanie numeru do danej grupy książki adresowej Aby dodać numer do grupy książki adresowej należy najpierw zaznaczyć daną grupę i wprowadzić nazwę grupy np. przy użyciu znacznika input typu text, oraz wywołać zdarzenie dodania np. w formularzu przy użyciu znacznika button. <form data-bind="submit: addaddressbooknumberclick"> <input data-bind="value: AddressBookNumberMsisdnToAdd"/> <button type="submit" />Dodaj numer</button> </form> W przypadku poprawnego dodania numeru do grupy numer dodany w polu input zostanie wyczyszczone i zostanie dodany numer do widocznej grupy, w przeciwnym wypadku zostanie wywołany w przeglądarce komunikat o błędzie w dodaniu grupy. Usuwanie numeru z grupy książki adresowej Aby usunąć numer z grupy należy np. dodać nową kolumnę w tabeli listującej wszystkie numery i dodać w niej znacznik a usuwający dany numer. <td data-bind="text: Number"></td> <td data-bind="text: CreateDate"></td> <td> <a href="#" data-bind="click: $root.removeaddressbooknumberclick">usuń</a> </td> W przypadku poprawnego usunięcia numeru zostanie on usunięta z listy, w przeciwnym wypadku zostanie wywołany w przeglądarce komunikat o błędzie w usunięciu numeru. 8

HISTORIA SMS ów Do przeglądania historii wysłanych smów służy funkcja wewnętrzna o nazwie HistoryViewModel. Przykład zaimplementowania funkcji na stronie: <script type="text/javascript"> $(document).ready(function () { ko.applybindings(new HistoryViewModel("[nazwa użytkwonika]", "[hasło]")); }); Wylistowanie wysłanych wiadomości Do wylistowania historii wysłanych wiadomości należy użyć tabeli, lub znaczników listujących (ul). <tbody data-bind="foreach: SendSmsCollection"> <td data-bind="text: To"></td> <td data-bind="text: Report"></td> <td data-bind="text: SendDate"></td> </tbody> Stronicowanie wysłanych wiadomości Do stronicowania historii wysłanych wiadomości należy ustawić ile będzie elementów na danej stronie np. przy użyciu znacznika select i uruchomić zdarzenie przejścia do następnej/poprzedniej strony np. za pomocą znacznika buton. <button data-bind="click: PrevPageClick" >Poprzednia</button> <strong data-bind="text: PageSelected"></strong> <button data-bind="click: NextPageClick" >Następna</button> <select data-bind=" options:availablepagecounts, value: PageCount, event: { change: PageCountChanged }"></select> Filtrowanie po dacie wysłanych wiadomości Do filtrowania historii wysłanych wiadomości po dacie należy wstawić np. dwa pola input (data początkowa filtru i końcowa) typu text. Data edytowana w tych polach(np. przy użyciu pluginów) powinna być w formacie RRRR-MM-DD GG:MM:SS. <input data-bind="value: StartDate, event: { change: PageCountChanged }" /> <input data-bind="value: EndDate, event: { change: PageCountChanged }" /> 9

Pobieranie historii w formacie CSV Do pobierania historii wiadomości należy wywołać zdarzenie np. przy użyciu znacznika button. Pobierane wyniki mogą być filtrowane po dacie tak jak to zostało opisane w podpunkcie powyżej. <button data-bind="click: DownloadCsvCollectionClick">Pobierz w pliku CSV</button> ZAPLANOWANE WIADOMOŚCI SMS Do przeglądania i usuwania zaplanowanych wiadomości służy wewnętrzna funkcja PlannedSmsViewModel. Przykład zaimplementowania funkcji na stronie: <script type="text/javascript"> $(document).ready(function () { ko.applybindings(new PlannedSmsViewModel("[nazwa użytkwonika]", "[hasło]")); }); Wylistowanie zaplanowanych wiadomości SMS Do wylistowania zaplanowanych wiadomości należy użyć tabeli, lub znaczników listujących (ul). <table> <thead> <th>adresat</th> <th>data wysłania</th> <th>id grupy odbiorców</th> </thead> <tbody data-bind="foreach: PlannedSmsCollection"> <td data-bind="text: To"></td> <td data-bind="text: SendDate"></td> <td data-bind="text: MessageId"></td> </tbody> </table> 10

Usuwanie zaplanowanych wiadomości Aby usunąć pojedynczego odbiorcę, lub wszystkich odbiorców z zaplanowanej wiadomości należy np. dodać dodatkowe kolumny do tabeli listującej zaplanowane wiadomości wywołujące dane zdarzenia. Przykład użycia z dwoma metodami usuwania: <td data-bind="text: To"></td> <td data-bind="text: SendDate"></td> <td data-bind="text: MessageId"></td> <td> <a href="#" data-bind="click: $root.deleteplannetsmssingleclick"> Usuń odbiorcę </a> </td> <td> <a href="#" data-bind="click: $root.deleteplannetsmsgroupclick"> Usuń grupę odbiorców </a> </td> W przypadku poprawnego usunięcia odbiorcy zostanie usunięty z listy, w przeciwnym wypadku zostanie wywołany w przeglądarce komunikat o błędzie w usunięciu odbiorcy. 11