Push Access Protocol

Účelem Odeslání push zprávy je doručit push zprávu z Push Iniciátoru na Push proxy bránu, která pak musí zprávu doručit uživatelskému agentu v mobilním zařízení v bezdrátové síti. Push zpráva obsahuje řídicí entitu a obsahovou entitu a MŮŽE obsahovat entitu funkcionality. Řídicí entita je XML dokument s řídicími informacemi (push-zprávou), kterou PPG použije pro zpracování a doručení zprávy. Obsahová entita reprezentuje obsah, který má být odeslán na bezdrátové zařízení. Entity se schopnostmi obsahuje schopnosti, které Push Iniciátor předpokládá, že klient má, a má formát RDF definovaný v User Agent Profile (UAProf). PPG MŮŽE používat informace o funkcionalitě pro validaci, že zpráva je zobrazitelná na mobilním zařízení. Odezva na push požadavek je XML dokument (push-odezva, část 9.3), který indikuje počáteční přijetí nebo selhání. PPG MUSÍ přinejmenším XML řídicí entity ve zprávě validovat podle DTD a oznámit výsledek v odezvě. PPG MŮŽE indikovat pomocí oznámení o průběhu zpracování (anglicky progress-note) (jestliže ji požaduje Push iniciátor atributem progress-notes-requested), které další validace byly dokončeny. Obsah a počet progress-notes závisí na implementaci. Typická odezva může obsahovat progress notes pro každou fázi interního zpracování. Použité fáze zpracování závisí na implementaci. Push zpráva může být určena více příjemcům. Odezva na takovou zprávu odpovídá původní zprávě, takže se posílá jedna odezva pro každou push zprávu, bez ohledu na to, kolik adresy příjemců obsahuje. Pokud si Push Iniciátor přeje dostat informace o výsledku doručení, pak MUSÍ požádat o notifikaci o výsledku v push zprávě a poskytnout adresu (například URL), kam má být notifikace poslána.

Tuto operaci používá PPG pro informování iniciátora o konečném výsledku doručení push zprávy, pokud to Push Iniciátor požadoval. Tato notifikace oznamuje Push Iniciátorovi, že odeslaná zpráva byla doručena (potvrzení bylo přijato z bezdrátového zařízení), vypršela doba její platnosti (expirovala), byla zrušena nebo při jejím zpracování a doručování došlo k chybě. Pokud došlo k chybě při zpracování zprávy, Push Iniciátor by MĚL být okamžitě informován o chybě vrácením notifikace a zpráva nesmí být doručována příjemcům. Jinak notifikace MUSÍ být poslána, až když je proces doručování zprávy dokončen. Proces doručování je považován za dokončený, pokud zpráva už nebude doručována, pokud například expirovala. Pokud je odeslání push zprávy indikováno jako zamítnuté, pak notifikace o výsledku nebude poslána. Push Iniciátor MUSÍ při push operaci uvést adresu (například URL), na kterou má být notifikace zaslána.

Push Iniciátor může zrušit push zprávu odeslanou na PPG před jejím konečným doručením. PPG odpoví indikací, zda požadavek byl úspěšný nebo ne.

Operace dotaz na stav zprávy umožňuje, aby si Push Iniciátor vyžádal aktuální status dříve odeslané zprávy. Pokud je status požadován pro zprávu adresovanou více příjemcům, MUSÍ PPG vrátit jednu odezvu obsahující výsledky dotazu na stav pro všechny příjemce.

Tato operace umožňuje, aby se Push Iniciátor dotázal PPG na funkcionalitu mobilního zařízení. Odezva je vícedílný MIME multipart/related dokument obsahující ccq-response (část 9.11) element v XML dokumentu a jako druhou entitu, skutečné informace o funkcionalitě klienta v RDF definované v User Agent Profile UAProf. PPG MŮŽE přidat další schopnosti ke schopnostem oznámeným mobilním zařízením, pokud bude provádět transformace zprávy na formát podporovaný klientem. Jestliže například klient podporuje obrazový formát JPEG, ale ne GIF, a PPG bude konvertovat GIF soubory na JPEG, pak PPG může oznámit na PI, že klient podporuje JPEG i GIF soubory. Oznámené schopnosti mohou být kombinací schopností PPG a klienta a mohou být odvozené ze schopností sdělených v rámci relace nebo zjištěné z CC/PP serveru. Schopnosti mohou být zjištěny i implementačně závislými prostředky.

Existují scénáře, ve kterých Push Iniciátor může chtít poslat stejnou zprávu více příjemcům. Místo odeslání několika stejných push zpráv různým příjemcům může Push Iniciátor odeslat jedinou push zprávu adresovanou více příjemcům. Tato část objasňuje chování při odeslání zprávy více příjemcům. Když PPG vrátí odezvu na push zprávu, po odeslání push zprávy pro více příjemců odpovídá odezva původní zprávě, bez ohledu na počet příjemců zadaný v původní zprávě (vrací se jedna odezva pro každé odeslání push zprávy). Když Push Iniciátor vyžaduje status (část 9.8) pro zprávu odeslanou s více adresami, MUSÍ PPG odpovědět jedinou statusquery odezvou (část 9.9) obsahující jednotlivé statusy. Totéž platí, když je v dotazu na status zprávy poslané více příjemcům zadán pouze push-id (bez adresy). Notifikace o výsledku (část 9.6) MUSÍ být PPG poslat pro každého příjemce, jestliže výsledek notifikace je požadovaný Push Iniciátorem během odeslání zprávy více příjemcům. V případech, kdy se zpráva pošle více příjemcům a později si iniciátor vyžádá zrušení zprávy (anglicky cancel), PPG MŮŽE poslat zpátky jednotlivé odezvy pro každého z příjemců nebo MŮŽE poslat odezvy pro více nebo všechny příjemců. Podpora více adres v PPG je NEPOVINNÁ.

Existují scénáře, ve kterých může PPG expandovat jednu adresu použitou PI na více adres pro doručení. Jedna adresa použitá v bezdrátové síti může také adresovat více zařízení (například broadcast). Tento typ služby je použitelný pro šíření informací zajímavých pro širokou populaci (například zprávy, počasí a dopravní informace). Tato část vysvětluje chování pro operace obsahující multicast a broadcast adresy. Protože expanze adres se provádí v PPG nebo až v bezdrátové síti, chování mezi PI a PPG se nesmí lišit od chování v případě, že adresa by adresovala jen jedno zařízení. Proto odezva obsahuje jednu adresu, která byla použita v původní zprávě od PI.

Řídicí entita je ta část MIME těla, která obsahuje XML dokument obsahující jeden pap element definovaný v části 9.1. Řídicí entita MUSÍ být obsažena v každém PAP požadavku i odezvě. Řídicí entita MUSÍ být první entitou v multipart/related MIME zprávě.

Obsahová entita je ta část MIME zprávy, která nese obsah, který má být odeslán na bezdrátové zařízení. PAP nestanovuje typ obsahu; může to být libovolný typ popsaný v MIME. Obsahová entita se používá pouze při odeslání push zprávy a není přítomná v žádném jiném požadavku nebo odezvě. Obsahová entita MUSÍ být druhou entitou v MIME multipart/related zprávě.

Entita popisující schopnosti zařízení je částí MIME těla, která obsahuje podmnožina funkcionalit bezdrátového zařízení/uživatelského agenta očekávanou Push Iniciátorem. Formát popisující schopnosti je uveden v User Agent Profile UAProf. Pokud je přítomná, entita popisující schopnosti, MUSÍ být třetí entitou při odeslání Push zprávy MIME multipart/related zprávě a MUSÍ být druhou entitou v odezvě na dotaz na schopnosti klienta.

V tomto článku byl použit překlad textu z článku Push Access Protocol na anglické Wikipedii.

• Push Proxy Gateway
• WAP brána
• Wireless Application Protocol

• Push Access Protocol Specification, Version 29-Apr-2001