Porovnávané verzie

Kľúč

  • Tento riadok sa pridal
  • Riadok je odstránený.
  • Formátovanie sa zmenilo.

Protokol GDEP

Podporované typy a verzie zariadení  
Konfigurácia komunikačnej linky
Konfigurácia komunikačnej stanice
Konfigurácia meraných bodov
Literatúra
Zmeny a úpravy
Revízie dokumentu

Kotva
typy_verzie
typy_verzie
Podporované typy a verzie zariadení

...

AdresaTypNázov boduPopis
1TxtORcv_Id

64-bitové ID prijatej SMS správy (správa RECEIVE). Po spracovaní správy aplikáciou treba zápisom do tohto meraného bodu oznámiť KOM procesu, že môže potvrdiť prijatie správou RCV_RSP a zároveň sprístupniť aplikácii ďalšiu SMS správu (pokiaľ čaká vo fronte).
[message sequence ID on the Game Platform (64-bit number displayed decimally in ASCII format). It is used for duplicate receipt detection when a session has been re-established after the connection failure.]

2TxtIRcv_Serv_IdParameter serv_id prijatej správy.
[service ID that this message belongs to.]
3TxtIRcv_AppAddrParameter appaddr prijatej správy.
[destination number. It can be short or long number dedicated to the service (External Application). It is identification of the game. It is never encrypted. ]
4TxtIRcv_AppAddrTypeAtribút type parametra appaddr.
5TxtIRcv_MsisdnParameter msisdn prijatej správy.
[source number. Can be encrypted, see the type attribute.]
6TxtIRcv_MsisdnTypeAtribút type parametra msisdn.
7CiRcv_EmployeeParameter employee prijatej správy.
[if application have enabled mark of employee, then element employee has value
  0 – if source MSISDN is NOT employee
  1 – if source MSISDN is employee]
8CiRcv_DcsParameter dcs prijatej správy.
[parameter data_coding of the GDEP protocol (DCS) [SMPP PS v3.4]. (8-bit integer defined in the ASCII). Default = 0.]
9CiRcv_EsmParameter esm prijatej správy.
[parameter esm of the SMPP protocol (DCS) [SMPP PS v3.4]. (8-bit integer defined in the ASCII). Default = 0.]
10TxtIRcv_Recv_DateParameter receive_date prijatej správy.
[time of receive SMS to SMS center.]
11TxtIRcv_CodingAtribút coding parametra content.
[type of coding in the element content. Currently used are:
  text ASCII text,
  base64 content is coded by code base64 – this is used for binary data.]
12TxtIRcv_ContentParameter content prijatej správy.
[nothing but data. Data sent by the subscriber to the External Application (SMS).]
13TxtIRcv_MsgPartParameter msg_part prijatej správy (trojica ref_num/seg_num/tot_seg).
[ref_num - contain a originator generated reference number so that a segmented short message may be reassembled into a single original message
seg_num - sequence number of particular message within the concatenated message
tot_seg - indicating the total number of fragments]

...

AdresaTypNázov boduPopis
101TxtOSnd_Serv_IdParameter serv_id odosielanej správy.
[service ID that this message belongs to.]
102TxtOSnd_Rcv_Msg_Id (o)Parameter rcv_msg_id odosielanej správy.
[ID of received message (RECEIVE) that this message is a response to]
103TxtOSnd_AppAddrParameter appaddr odosielanej správy.
[source number. It can be either short or long (MSISDN) number assigned to the service.]
104CoSnd_AppAddrType (o)Atribút type parametra appaddr.
105TxtOSnd_MsisdnParameter msisdn odosielanej správy.
[destination number. In case of a mobile telephone number, it can be encrypted. In case of a short number, the destination number is the short number only.
Can be encrypted, the type is present in the type attribute.]
106CoSnd_MsisdnType (o)Atribút type parametra msisdn.
107TxtOSnd_BillMsisdn (o)Parameter billmsisdn odosielanej správy.
[MSISDN to which the message will be billed (this tag is only used with specific applications, where the billed subscriber is not the recipient of the message. This option must be approved at the Game Platform by agreement with the marketing dept.)
Can be encrypted, the type is present in the type attribute.]
108CoSnd_BillType (o)Atribút type parametra billmsisdn.
109CoSnd_Flags (o)Parameter flags odosielanej správy.
[32-bit numbers displayed decimally in ASCII format. Flags are combined with OR binary function. Unused bits are reserved.
SMS_FLAG_RECEIPT bit 1 - delivery receipt requested
SMS_FLAG_REPLACE bit 2 - SM replacement requested on SIM card position under bits 4-6
SMS_FLAG_POSITION bit 4-6 - SIM position for SM replacement
position range: from 1 to 7, 0 is unused]
110TxtOSnd_Expiration (o)Parameter expiration odosielanej správy.
[validity period of the SM in the GSM time encoding (i.e. YYMMDDhhmmsst), or the character „-", if not defined]
111TxtOSnd_Delivery (o)Parameter delivery odosielanej správy.
[delivery time of the SM in the GSM time encoding (i.e. YYMMDDhhmmsst), or the character „-", if not defined.]
112TxtOSnd_BillKeyParameter billkey odosielanej správy.
[billing key, 4 characters long string consisting of (0..9) and (A .. Z). Each application will have 4 keys to be used in this field]
113TxtOSnd_Evbill_Id (o)Parameter evbill-id odosielanej správy.
[service identifier in the event billing in case this type of billing method should be used.]
114TxtOSnd_EvbillIdSeq (o)Parameter evbill-id-seq odosielanej správy.
[service identifier in the event billing in case this type of billing method should be used.]
115CoSnd_Dcs (o)Parameter dcs odosielanej správy.
[parameter data_coding of the SMPP protocol (DCS) [SMPP PS v3.4]. (8-bit integer defined in the ASCII). Default = 0.]
116CoSnd_Esm (o)Parameter esm odosielanej správy.
[parameter esm of the SMPP protocol (DCS) [SMPP PS v3.4]. (8-bit integer defined in the ASCII). Default = 0.]
117TxtOSnd_Score (o)Parameter score odosielanej správy.
[game is sending score for the subscriber with – MSISDN. Format:
+score – Game Platform adds this score value to the daily counter
-score – Game Platform subtracts this score value from the daily counter
score – Game Platform replaces the daily counter by this score value
(daily counter is parameter, which is bind to MSISDN, nick, game and day. This counter will be changed only by GDEP protocol)]
118TxtOSnd_ScoreNick (o)Atribút nick parametra score.
[– if this attribute will be used it will define the particularly used nick of the subscriber defined by MSISDN. Score will update the daily counter for this MSISDN and nick. If this attribute will not be used daily counter for MSISDN and default value nick="" will be used.]
119TxtOSnd_ScoreFinish (o)Atribút finished parametra score.
[if this attribute will be used (with the any value, default value will be empty string ""), the Game Platform will add the new issue to the table C_SCORE, where will be add each player so many time how many will finish the game successfully. Use this attribute only after successful finishing of the game by the player.]
120TxtOSnd_CodingParameter content odosielanej správy.
[type of coding in the element content
Currently used are:
text ASCII text base64 content is coded by code base64 – this is used for binary data.]
121TxtOSnd_ContentParameter content odosielanej správy.
[nothing but data. Data sent by the External Application (SMS) to the subscriber.]
122TxtOSnd_Category (o)Parameter category odosielanej správy.
[element can be used to specify category of content that is to be sent, character string 1-64 bytes long]
123Co
Kotva
snd_appdefid
snd_appdefid
Snd_AppDefId
Ľubovolné aplikáciou vygenerované kladné celé číslo, ktoré (pre aplikáciu) definuje zasielanú SMS správu. Potvrdenia o doručení resp. nedoručení SMS-ky budú obsahovať toto číslo (meraný bod Rsp_AppDefId), pokiaľ KOM proces nebol medzitým reštartovaný.
130TxtISnd_64bit_Id64-bitový identifikátor, ktorý nastaví KOM proces pri posielaní SMS správy. Keďže GDEP protokol pracuje s unikátnym 64-bitovým identifikátorom (jeho hodnotu inicializuje GDEP server pri pripojení sa D2000 KOM procesu), potvrdenia o doručení sú vnútorne označené týmto 64-bitovým ID-čkom. Pokiaľ bol KOM proces reštartovaný, po nábehu môžu prísť od GAP servera potvrdenia o doručení správ, ktoré boli poslané ešte pred reštartom. V takom prípade D2000 KOM proces nastaví Snd_AppDefId na hodnotu -1 a aplikácia môže spárovať potvrdenia podľa nastaveného Snd_64bit_Id.

...

AdresaTypNázov boduPopis
131Co
Kotva
rsp_appdefid
rsp_appdefid
Rsp_AppDefId
Príslušné Snd_AppDefId poslanej SMS správy alebo -1, ak správa s takýmto číslom nebola nájdená v zozname odoslaných a nepotvrdených správ (napr. po reštarte KOM procesu).
Po spracovaní potvrdenia o doručení musí aplikácia meraný bod Rsp_AppDefId nastaviť na 0, čo spôsobí jednak poslanie potvrdenia GAP serveru (správa ACC_RSP resp. REC_RSP, podľa toho, aké na akú správu D2000 KOM odpovedá) a jednak D2000 KOM môže nastaviť ďalšiu hodnotu, pokiaľ má v zásobníku ďalšie potvrdenia o doručení.
132CiRsp_ErrNoČíslo chyby: 0- bez chyby, ďalšie možné hodnoty viď norma [1].
Ak bola prijatá správa RECEIPT, tak Rsp_ErrNo kopíruje hodnotu parametra state s výnimkou hodnôt 2 (delivered) a 6 (accepted) - vtedy je správa považovaná za úspešne doručenú a Rsp_ErrNo=0.
133CiRsp_CnfTypeÚroveň potvrdenia správy:
úroveň 1 - správa bola odoslaná GAP serveru (Rsp_ErrN=0) alebo nastala chyba pri posielaní (Rsp_ErrNo=-1)
úroveň 2 - prišla správa ACCEPTED (s nulovým alebo nenulovým chybovým kódom, ktorého hodnota je v Rsp_ErrNo) alebo vypršal timeout Timeout Receive Accept (Rsp_ErrNo=-2)
úroveň 3 - prišla správa RECEIPT alebo vypršal timeout Timeout Receive Receipt (Rsp_ErrNo=-3)
134TxtIRsp_ErrDescTextový popis chyby (pri vypršaní timeoutu) alebo hodnota err_type pri negatívnej správe ACCEPT.
[err_type - type of error, one of SMSC, MMSC, INTERNAL
  • SMSC means the error occurred in SMSC
  • MMSC means the error occurred in MMSC
  • INTERNAL means the error occurred in GAP
]
135TxtI
Kotva
rsp_serv_id
rsp_serv_id
Rsp_Serv_Id
64-bitové ID poslanej SMS správy, ku ktorej sa toto hlásenie vzťahuje.
Hodnoty nasledujúcich bodov sú platné iba pri prijatí správy RECEIPT.
136TxtIRec_Submit_DateParameter submit_date správy RECEIPT.
[date of delivery of sended sent SMS message to SMS center]
137TxtIRec_Done_DateParameter done_date správy RECEIPT.
[date of delivery of sended sent SMS message to destination]
Kotva
state
state
138
CiRec_StateParameter state správy RECEIPT.
[state of the message, can have the following values (as described in [2] SMPP 3.4, chapter 5.2.28 message_state):
  • 1 – enroute - the message is in enroute state
  • 2 – delivered – the message is delivered to destiantion
  • 3 – expired – message validity period has expired
  • 4 – deleted – message has been deleted
  • 5 – undeliverable – message is undeliverable
  • 6 – accepted – message is in accepted state (i.e. has been manually read on behalf of the subscriber by customer service)
  • 7 – unknown – message is in invalid state
  • 8 – rejected – message is in rejected state
]
Poznámka: V prípade, že je prijatá správa RECEIPT so state=1 (prechodný enroute stav), ešte sa raz čaká s timeoutom Timeout Receive Receipt na prijatie správy RECEIPT s finálnym stavom.


139


TxtI


Rec_MsisdnParameter msisdn správy RECEIPT.
[msisdn that the message is delivered to. It can be encrypted.]
140TxtIRec_MsisdnTypeAtribút type parametra msisdn.


Identifikácia stavu komunikácie:

...