SAP How-to Guide
"#$%&' (')*+#,.-$/0' 1+2%3'4 5&/67#38 .95 :'6;'/<'3 =/6'2/-
How-To…Subscription & Notification with SAP NetWeaver Gateway - Android + Code Sample
Applicable Releases: Sybase Unwired Platform 2.1.1 SAP NetWeaver Gateway 2.0
Version 1.0 February 2012
9&*'3@3#4E)6/+40'3<%)'+/8'0 8'+6%#+'4/3'6*'63/4'8/3G0#76*'%33'0@')6%<')#8@/+%'0DM/6/)#+6/%+'4%+ 6*%04#)E8'+60'3<'0%+7#38/6%#+/&@E3@#0'0#+&-D:/6%#+/& @3#4E)60@')%7%)/6%#+08/-3-D (*' %+7#38/6%#+ %+ 6*%0 4#)E8'+6 %0 @3#@3%'6/3- 6# .95D :# @/36 #7 6*%0 4#)E8'+6 8/- $' 3'@3#4E)'4H )#@%'4H #3 63/+08%66'4 %+ /+- 7#38 #3 7#3 /+- @E3@#0' 2%6*#E6 6*' 'F@3'00 @3%#3 23%66'+ @'38%00%#+ #7 .95 9=D (*%0 4#)E8'+6 %0 / @3'&%8%+/3- <'30%#+ /+4 +#6 0E$^')6 6# -#E3 &%)'+0' /,3''8'+6 #3 /+- #6*'3 /,3''8'+6 2%6* .95D (*%0 4#)E8'+6 )#+6/%+0 #+&- %+6'+4'4 063/6',%'0H 4'<'@8'+60H /+4 7E+)6%#+/&%6%'0 #7 6*' .95\ @3#4E)6 /+4 %0 +#6 %+6'+4'4 6# $' $%+4%+, E@#+ .95 6# /+- @/36%)E&/3 )#E30' #7 $E0%+'00H @3#4E)6 063/6',-H /+4Q#3 4'<'@8'+6D 5&'/0' +#6' 6*/6 6*%0 4#)E8'+6 %0 0E$^')6 6# )*/+,' /+4 8/- $' )*/+,'4 $- .95 /6 /+- 6%8' 2%6*#E6 +#6%)'D .95/00E8'0+#3'0@#+0%$%&%6-7#3 '33#30#3#8%00%#+0%+6*%0 4#)E8'+6D.954#'0+#6 2/33/+66*'/))E3/)-#3)#8@&'6'+'00#76*'%+7#38/6%#+H6'F6H,3/@*%)0H &%+G0H#3#6*'3%6'80)#+6/%+'42%6*%+6*%0 8/6'3%/&D(*%04#)E8'+6%0@3#<%4'42%6*#E6/ 2/33/+6-#7/+-G%+4H'%6*'3'F@3'00# 3%8@&%'4H%+)&E4%+,$E6+#6&%8%6'46# 6*'%8@&%'42/33/+6%'0#78'3)*/+6/$%&%6-H7%6+'007#3/@/36%)E&/3@E3@#0'H# 3+#+_%+73%+,'8'+6D .950*/&&*/<'+# &%/$%&%6-7#34/8/,'0#7/+-G%+4%+)&E4%+,2%6*#E6 &%8%6/6%#+4%3')6H0@')%/&H%+4%3')6H#3)#+0'`E'+6%/&4/8/,'06*/68/-3'0E&673#86*' E0'#76*'0'8/6'3%/&0D(*%0&%8%6/6%#+0*/&&+#6 /@@&-%+)/0'0#7%+6'+6# 3,3#00+',&%,'+)'D (*' 06/6E6#3- &%/$%&%6- 7#3 @'30#+/& %+^E3- /+4 4'7')6%<' @3#4E)60 %0 +#6 /77')6'4D .95 */0 +# )#+63#& #<'3 6*' %+7#38/6%#+ 6*/6 -#E 8/- /))'00 6*3#E,* 6*' E0' #7 *#6 &%+G0 )#+6/%+'4 %+ 6*'0' 8/6'3%/&0 /+4 4#'0 +#6 '+4#30' -#E3 E0' #7 6*%34_@/36- ;'$ @/,'0 +#3 @3#<%4' /+- 2/33/+6- 2*/60#'<'3 3'&/6%+, 6# 6*%34_@/36- ;'$ @/,'0D
> ?#@-3%,*6 ABCA .95 9=D 9&& 3%,*60 3'0'3<'4D :# @/36 #7 6*%0 @E$&%)/6%#+ 8/- $' 3'@3#4E)'4 #3 63/+08%66'4 %+ /+- 7#38 #3 7#3 /+- @E3@#0' 2%6*#E6 6*' 'F@3'00 @'38%00%#+ #7 .95 9=D (*' %+7#38/6%#+ )#+6/%+'4 *'3'%+ 8/- $' )*/+,'4 2%6*#E6 @3%#3 +#6%)'D .#8'0#762/3'@3#4E)608/3G'6'4$-.959= /+4%604%063%$E6#30)#+6/%+@3#@3%'6/3-0#762/3')#8@#+'+60 #7#6*'30#762/3'<'+4#30D "%)3#0#76H;%+4#20HIF)'&HJE6#GH/+45#2'35#%+6/3' 3',%06'3'463/4'8/3G0#7"%)3#0#76?#3@#3/6%#+D KL"HMLAHMLA1+%<'30/&M/6/$/0'H.-06'8%H.-06'8%NH.-06'8@H .-06'
[email protected]'8FH.-06'8OH.-06'8OCBH.-06'8OPH OCBHOPH%.'3%'0H@.'3%'0HF.'3%'0HO.'3%'0H'.'3<'3HOQR"HOQJ.H%NQJ.H.QSPBH J.QSPBHJ.QTBBH9.QTBBH.QSPB5/3/&&'&I+6'3@3%0'.'3<'3H 5#2'3R"H5#2'393)*%6')6E3'H5J;IUVWH5J;IUVH5J;IUNWH5J;IUNH5J;IUHJ@'+5#2'3H5#2'35?HL/6)*5%@'0HL&/4'?'+6'3H.-06'8.6#3/,'H=5X.H Y9?"5HUI(9K:HMLA?#++')6HU9?XHU'4$##G0H J.QAH5/3/&&'&.-0@&'FH"R.QI.9H9KZHK+6'&&%,'+6"%+'3H;'$.@*'3'H:'67%+%6-H(%<#&%/+4 K+7#38%F/3' 63/4'8/3G0#33',%06'3'463/4'8/3G0#7KL"?#3@#3/6%#+D [%+EF %0 6*' 3',%06'3'4 63/4'8/3G #7 [%+E0 (#3&40 %+ 6*' 1D.D /+4 #6*'3 )#E+63%'0D 94#$'H6*'94#$',#H 9)3#$/6H5#06.)3%@6H/+4U'/4'3/3''%6*'363/4'8/3G0#33',%06'3'4 63/4'8/3G0#794#$'.-06'80K+)#3@#3/6'4%+6*' 1+%6'4.6/6'0/+4Q#3#6*'3)#E+63%'0D J3/)&'%0/3',%06'3'463/4'8/3G#7J3/)&'?#3@#3/6%#+D 1:KZHZQJ@'+HJ.XQCH/+4"#6%7 /3'3',%06'3'463/4'8/3G0#76*'J@'+=3#E@D ?%63%FHK?9H53#,3/8:'%,*$#3*##4H"'6/X3/8'H;%+X3/8'HR%4'#X3/8'H/+4"E&6%;%+/3'63/4'8/3G0#3 3',%06'3'463/4'8/3G0#7?%63%F.-06'80HK+)D Y("[HZ"[HZY("[/+4;S?/3' 63/4'8/3G0#33',%06'3'463/4'8/3G0#7;S?\H;#3&4;%4' ;'$?#+0#36%E8H"/00/)*E0'660K+06%6E6'#7(')*+#,-D ]/%0/3',%06'3'463/4'8/3G#7.E+ "%)3#0-06'80HK+)D ]/
.95 aY#2_6#b =E%4'0 /3' %+6'+4'4 6# 0%8@&%7- 6*' @3#4E)6 %8@&'8'+66/6%#+D ;*%&' 0@')%7%) @3#4E)6 7'/6E3'0 /+4 @3#)'4E3'0 6-@%)/&&- /3' 'F@&/%+'4 %+ /
LE0%+'00 J$^')60 /+4 6*' LE0%+'00 J$^')60 ,#H LE0%+'00J$^')60H ?3-06/&
@3/)6%)/& $E0%+'00 )#+6'F6H %6 %0 +#6 %8@&%'4 6*/6 6*#0' 7'/6E3'0 /+4 @3#)'4E3'0
U'@#360H ?3-06/& M')%0%#+0H ;'$ K+6'&&%,'+)'H Z)'&0%E0H /+4 #6*'3 LE0%+'00
/3' 6*' #+&- /@@3#/)* %+ 0#&<%+, / 0@')%7%) $E0%+'00 @3#$&'8 E0%+, .95
J$^')60 @3#4E)60 /+4 0'3<%)'0 8'+6%#+'4 *'3'%+ /0 2'&& /0 6*'%3 3'0@')6%<'
:'6;'/<'3D .*#E&4 -#E 2%0* 6# 3')'%<' / 44%6%#+/& %+7#38/6%#+H )&/3%7%)/6%#+ #3
,#0 /3' 63/4'8/3G0 #3 3',%06'3'4 63/4'8/3G0 #7 LE0%+'00 J$^')60 .#762/3'
0E@@#36H @&'/0' 3'7'3 6# .95 ?#+0E&6%+,D
[64D LE0%+'00 J$^')60 %0 /+ .95 )#8@/+-D
9+- 0#762/3' )#4%+, /+4Q#3 )#4' &%+'0 Q 063%+,0 ca?#4'bd %+)&E4'4 %+ 6*%0 4#)E8'+6/6%#+ /3' #+&- 'F/8@&'0 /+4 /3' +#6 %+6'+4'4 6# $' E0'4 %+ / @3#4E)6%<' 0-06'8 '+<%3#+8'+6D (*' ?#4' %0 #+&- %+6'+4'4 $'66'3 'F@&/%+ /+4 <%0E/&%O' 6*' 0-+6/F /+4 @*3/0%+, 3E&'0 #7 )'36/%+ )#4%+,D .95 4#'0 +#6 2/33/+6 6*' )#33')6+'00 /+4 )#8@&'6'+'00 #7 6*' ?#4' ,%<'+ *'3'%+H /+4 .95 0*/&& +#6 $' &%/$&' 7#3 '33#30 #3 4/8/,'0 )/E0'4 $- 6*' E0/,' #7 6*' ?#4'H 'F)'@6 %7 0E)* 4/8/,'0 2'3' )/E0'4 $- .95 %+6'+6%#+/&&- #3 ,3#00&- +',&%,'+6D M%0)&/%8'3 .#8' )#8@#+'+60 #7 6*%0 @3#4E)6 /3' $/0'4 #+ ]/
9&*'3@3#4E)6/+40'3<%)'+/8'0 8'+6%#+'4/3'6*'63/4'8/3G0#76*'%33'0@')6%<')#8@/+%'0DM/6/)#+6/%+'4%+ 6*%04#)E8'+60'3<'0%+7#38/6%#+/&@E3@#0'0#+&-D:/6%#+/& @3#4E)60@')%7%)/6%#+08/-3-D (*' %+7#38/6%#+ %+ 6*%0 4#)E8'+6 %0 @3#@3%'6/3- 6# .95D :# @/36 #7 6*%0 4#)E8'+6 8/- $' 3'@3#4E)'4H )#@%'4H #3 63/+08%66'4 %+ /+- 7#38 #3 7#3 /+- @E3@#0' 2%6*#E6 6*' 'F@3'00 @3%#3 23%66'+ @'38%00%#+ #7 .95 9=D (*%0 4#)E8'+6 %0 / @3'&%8%+/3- <'30%#+ /+4 +#6 0E$^')6 6# -#E3 &%)'+0' /,3''8'+6 #3 /+- #6*'3 /,3''8'+6 2%6* .95D (*%0 4#)E8'+6 )#+6/%+0 #+&- %+6'+4'4 063/6',%'0H 4'<'@8'+60H /+4 7E+)6%#+/&%6%'0 #7 6*' .95\ @3#4E)6 /+4 %0 +#6 %+6'+4'4 6# $' $%+4%+, E@#+ .95 6# /+- @/36%)E&/3 )#E30' #7 $E0%+'00H @3#4E)6 063/6',-H /+4Q#3 4'<'@8'+6D 5&'/0' +#6' 6*/6 6*%0 4#)E8'+6 %0 0E$^')6 6# )*/+,' /+4 8/- $' )*/+,'4 $- .95 /6 /+- 6%8' 2%6*#E6 +#6%)'D .95/00E8'0+#3'0@#+0%$%&%6-7#3 '33#30#3#8%00%#+0%+6*%0 4#)E8'+6D.954#'0+#6 2/33/+66*'/))E3/)-#3)#8@&'6'+'00#76*'%+7#38/6%#+H6'F6H,3/@*%)0H &%+G0H#3#6*'3%6'80)#+6/%+'42%6*%+6*%0 8/6'3%/&D(*%04#)E8'+6%0@3#<%4'42%6*#E6/ 2/33/+6-#7/+-G%+4H'%6*'3'F@3'00# 3%8@&%'4H%+)&E4%+,$E6+#6&%8%6'46# 6*'%8@&%'42/33/+6%'0#78'3)*/+6/$%&%6-H7%6+'007#3/@/36%)E&/3@E3@#0'H# 3+#+_%+73%+,'8'+6D .950*/&&*/<'+# &%/$%&%6-7#34/8/,'0#7/+-G%+4%+)&E4%+,2%6*#E6 &%8%6/6%#+4%3')6H0@')%/&H%+4%3')6H#3)#+0'`E'+6%/&4/8/,'06*/68/-3'0E&673#86*' E0'#76*'0'8/6'3%/&0D(*%0&%8%6/6%#+0*/&&+#6 /@@&-%+)/0'0#7%+6'+6# 3,3#00+',&%,'+)'D (*' 06/6E6#3- &%/$%&%6- 7#3 @'30#+/& %+^E3- /+4 4'7')6%<' @3#4E)60 %0 +#6 /77')6'4D .95 */0 +# )#+63#& #<'3 6*' %+7#38/6%#+ 6*/6 -#E 8/- /))'00 6*3#E,* 6*' E0' #7 *#6 &%+G0 )#+6/%+'4 %+ 6*'0' 8/6'3%/&0 /+4 4#'0 +#6 '+4#30' -#E3 E0' #7 6*%34_@/36- ;'$ @/,'0 +#3 @3#<%4' /+- 2/33/+6- 2*/60#'<'3 3'&/6%+, 6# 6*%34_@/36- ;'$ @/,'0D
> ?#@-3%,*6 ABCA .95 9=D 9&& 3%,*60 3'0'3<'4D :# @/36 #7 6*%0 @E$&%)/6%#+ 8/- $' 3'@3#4E)'4 #3 63/+08%66'4 %+ /+- 7#38 #3 7#3 /+- @E3@#0' 2%6*#E6 6*' 'F@3'00 @'38%00%#+ #7 .95 9=D (*' %+7#38/6%#+ )#+6/%+'4 *'3'%+ 8/- $' )*/+,'4 2%6*#E6 @3%#3 +#6%)'D .#8'0#762/3'@3#4E)608/3G'6'4$-.959= /+4%604%063%$E6#30)#+6/%+@3#@3%'6/3-0#762/3')#8@#+'+60 #7#6*'30#762/3'<'+4#30D "%)3#0#76H;%+4#20HIF)'&HJE6#GH/+45#2'35#%+6/3' 3',%06'3'463/4'8/3G0#7"%)3#0#76?#3@#3/6%#+D KL"HMLAHMLA1+%<'30/&M/6/$/0'H.-06'8%H.-06'8%NH.-06'8@H .-06'
[email protected]'8FH.-06'8OH.-06'8OCBH.-06'8OPH OCBHOPH%.'3%'0H@.'3%'0HF.'3%'0HO.'3%'0H'.'3<'3HOQR"HOQJ.H%NQJ.H.QSPBH J.QSPBHJ.QTBBH9.QTBBH.QSPB5/3/&&'&I+6'3@3%0'.'3<'3H 5#2'3R"H5#2'393)*%6')6E3'H5J;IUVWH5J;IUVH5J;IUNWH5J;IUNH5J;IUHJ@'+5#2'3H5#2'35?HL/6)*5%@'0HL&/4'?'+6'3H.-06'8.6#3/,'H=5X.H Y9?"5HUI(9K:HMLA?#++')6HU9?XHU'4$##G0H J.QAH5/3/&&'&.-0@&'FH"R.QI.9H9KZHK+6'&&%,'+6"%+'3H;'$.@*'3'H:'67%+%6-H(%<#&%/+4 K+7#38%F/3' 63/4'8/3G0#33',%06'3'463/4'8/3G0#7KL"?#3@#3/6%#+D [%+EF %0 6*' 3',%06'3'4 63/4'8/3G #7 [%+E0 (#3&40 %+ 6*' 1D.D /+4 #6*'3 )#E+63%'0D 94#$'H6*'94#$',#H 9)3#$/6H5#06.)3%@6H/+4U'/4'3/3''%6*'363/4'8/3G0#33',%06'3'4 63/4'8/3G0#794#$'.-06'80K+)#3@#3/6'4%+6*' 1+%6'4.6/6'0/+4Q#3#6*'3)#E+63%'0D J3/)&'%0/3',%06'3'463/4'8/3G#7J3/)&'?#3@#3/6%#+D 1:KZHZQJ@'+HJ.XQCH/+4"#6%7 /3'3',%06'3'463/4'8/3G0#76*'J@'+=3#E@D ?%63%FHK?9H53#,3/8:'%,*$#3*##4H"'6/X3/8'H;%+X3/8'HR%4'#X3/8'H/+4"E&6%;%+/3'63/4'8/3G0#3 3',%06'3'463/4'8/3G0#7?%63%F.-06'80HK+)D Y("[HZ"[HZY("[/+4;S?/3' 63/4'8/3G0#33',%06'3'463/4'8/3G0#7;S?\H;#3&4;%4' ;'$?#+0#36%E8H"/00/)*E0'660K+06%6E6'#7(')*+#,-D ]/%0/3',%06'3'463/4'8/3G#7.E+ "%)3#0-06'80HK+)D ]/
.95 aY#2_6#b =E%4'0 /3' %+6'+4'4 6# 0%8@&%7- 6*' @3#4E)6 %8@&'8'+66/6%#+D ;*%&' 0@')%7%) @3#4E)6 7'/6E3'0 /+4 @3#)'4E3'0 6-@%)/&&- /3' 'F@&/%+'4 %+ /
LE0%+'00 J$^')60 /+4 6*' LE0%+'00 J$^')60 ,#H LE0%+'00J$^')60H ?3-06/&
@3/)6%)/& $E0%+'00 )#+6'F6H %6 %0 +#6 %8@&%'4 6*/6 6*#0' 7'/6E3'0 /+4 @3#)'4E3'0
U'@#360H ?3-06/& M')%0%#+0H ;'$ K+6'&&%,'+)'H Z)'&0%E0H /+4 #6*'3 LE0%+'00
/3' 6*' #+&- /@@3#/)* %+ 0#&<%+, / 0@')%7%) $E0%+'00 @3#$&'8 E0%+, .95
J$^')60 @3#4E)60 /+4 0'3<%)'0 8'+6%#+'4 *'3'%+ /0 2'&& /0 6*'%3 3'0@')6%<'
:'6;'/<'3D .*#E&4 -#E 2%0* 6# 3')'%<' / 44%6%#+/& %+7#38/6%#+H )&/3%7%)/6%#+ #3
,#0 /3' 63/4'8/3G0 #3 3',%06'3'4 63/4'8/3G0 #7 LE0%+'00 J$^')60 .#762/3'
0E@@#36H @&'/0' 3'7'3 6# .95 ?#+0E&6%+,D
[64D LE0%+'00 J$^')60 %0 /+ .95 )#8@/+-D
9+- 0#762/3' )#4%+, /+4Q#3 )#4' &%+'0 Q 063%+,0 ca?#4'bd %+)&E4'4 %+ 6*%0 4#)E8'+6/6%#+ /3' #+&- 'F/8@&'0 /+4 /3' +#6 %+6'+4'4 6# $' E0'4 %+ / @3#4E)6%<' 0-06'8 '+<%3#+8'+6D (*' ?#4' %0 #+&- %+6'+4'4 $'66'3 'F@&/%+ /+4 <%0E/&%O' 6*' 0-+6/F /+4 @*3/0%+, 3E&'0 #7 )'36/%+ )#4%+,D .95 4#'0 +#6 2/33/+6 6*' )#33')6+'00 /+4 )#8@&'6'+'00 #7 6*' ?#4' ,%<'+ *'3'%+H /+4 .95 0*/&& +#6 $' &%/$&' 7#3 '33#30 #3 4/8/,'0 )/E0'4 $- 6*' E0/,' #7 6*' ?#4'H 'F)'@6 %7 0E)* 4/8/,'0 2'3' )/E0'4 $- .95 %+6'+6%#+/&&- #3 ,3#00&- +',&%,'+6D M%0)&/%8'3 .#8' )#8@#+'+60 #7 6*%0 @3#4E)6 /3' $/0'4 #+ ]/
Document History !"#$%&'( *&+,-"'
!&,#+-.(-"'
CDBB
X%306 #77%)%/& 3'&'/0' #7 6*%0 ,E%4'
Typographic Conventions
Icons
/0.& 1(02&
!&,#+-.(-"'
6#"'
Example Text
;#340 #3 )*/3/)6'30 `E#6'4 73#8 6*' 0)3''+D (*'0' %+)&E4' 7%'&4 +/8'0H 0)3''+ 6%6&'0H @E0*$E66#+0 &/$'&0H 8'+E +/8'0H 8'+E @/6*0H /+4 8'+E #@6%#+0D ?3#00_3'7'3'+)'0 6# #6*'3 4#)E8'+6/6%#+
345%.2& (&4(
I8@*/0%O'4 2#340 #3 @*3/0'0 %+ $#4- 6'F6H ,3/@*%) 6%6&'0H /+4 6/$&' 6%6&'0
Example text
X%&' /+4 4%3')6#3- +/8'0 /+4 6*'%3 @/6*0H 8'00/,'0H +/8'0 #7 3%/$&'0 /+4 @/3/8'6'30H 0#E3)' 6'F6H /+4 +/8'0 #7 %+06/&&/6%#+H E@,3/4' /+4 4/6/$/0' 6##&0D
Example text
10'3 '+63- 6'F60D (*'0' /3' 2#340 #3 )*/3/)6'30 6*/6 -#E '+6'3 %+ 6*' 0-06'8 'F/)6&- /0 6*'- /@@'/3 %+ 6*' 4#)E8'+6/6%#+D
EXAMPLE TEXT
R/3%/$&' E0'3 '+63-D 9+,&' $3/)G'60 %+4%)/6' 6*/6 -#E 3'@&/)' 6*'0' 2#340 /+4 )*/3/)6'30 2%6* /@@3#@3%/6' '+63%'0 6# 8/G' '+63%'0 %+ 6*' 0-06'8D g'-0 #+ 6*' G'-$#/34H 7#3 'F/8@&'H F2 #3 ENTERD
!&,#+-.(-"' ?/E6%#+ :#6' #3 K8@#36/+6 IF/8@&' U')#88'+4/6%#+ #3 (%@
Table of Contents 78
9$,-'&,, 1#&'5+-" 888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888 7
:8
95#;<+"$'= 6'>"+%5(-"' 888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888 7 ADC
.95 LE0%+'00 .E%6' DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD A
ADA
.95 :'6;'/<'3 =/6'2/- DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD A
ADS
.-$/0' 1+2%3'4 5&/67#38 c.15d h J+&%+' M/6/ 53#F- cJM5d DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD S
ADT
?&%'+60 h .-$/0' JM/6/ .Mg M'<'@8'+6 DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD T
ADN
53#)'00 X DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD N
ADV
J77&%+'QJ+&%+'DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD J77&%+'QJ+&%+' DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD i
ADj
5E0*Q5E&& DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD i
?8
10,(&% @+&+&A$-,-(&, 8888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888 7B
C8
/5,;, 8888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888 77
D8
E5(&F50 G"'>-<$+5(-"' 888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888 7: NDC
H8
L8
O8
Q8
?*')G 6*' .15 ."NP M'06%+/6%#+ %+ =/6'2/-D DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD CS
1I@JK!@ G"'>-<$+5(-"' G"'>-<$+5 (-"' 8888888888888888888888888888888888888888888888888888888888888 88888888888888888888888888888888888888888888888888888888888 7C VDC
?3'/6' .')E3%6- ?#+7%,E3/6%#+ DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD CT
VDA
?3'/6' 9@@&%)/6%#+ 9@@&%)/6% #+ DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD CV
VDS
?3'/6' 9@@&%)/6%#+ 9@@&%)/6%# + ?#++')6%#+ DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD Ci
G"'>-<$+-'< (M& !&N&2".%&'( 3'N-+"'%&'( 8888888888888888888888888888888888888888888888888888888888888888888888888888888888888 :B jDC
M#2+/4 6*' KMI DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD AB
jDA
.'66%+, E@ 6*' 9+43#%4 .Mg "/+/,'3 DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD AC
jDS
1@4/6' -#E 9+43#%4 .Mg 2%6* ADA 95K i [%$3/3%'0 DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD DDDDDDDD AA
jDT
?3'/6' /+ 9+43#%4 53#^')6 53#^ ')6 DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD AA
jDN
K8@#36%+, [%$3/3%'0 6# -#E3 9+43#%4 9@@&%)/6%#+ 53#^')6 DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD AN
jDV
.'66%+, 53#^')6 53#@'36%'0 DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD AV
!&N&2".-'< 0"$+ P..2-#5(-"' 888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888 :L iDC
9 6-@%)/& 6-@%)/ & /@@&%)/6%#+ /@@&%)/6% #+ DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD Aj
iDA
K+%6%/&%O/6%#+ DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD Ai
iDS
?/&&%+, =/6'2/- .'3<%)'0 DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD SS
iDT
?3'/6%+, h M'&'6%+, M'& '6%+, .E$0)3%@6%#+0 DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD DDDDDDDDDDDDDDDDDDDDDDDDDDD SP
iDN
U')'%<%+, :#6%7%)/6%#+0 DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD TS
R$''-'< (M& 15%.2& P..2-#5(-"' 88888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888 CD PDC
9@@&%)/6%#+ .63E)6E3' DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD TN
PDA
53'@/3%+, 6*' 9@@&%)/6%#+ DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD TV
PDS
UE++%+, 6*' /@@&%)/6%#+ DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD Tj
7B8
S"(->-#5(-"' R"$(-'< 34.25-'&= 888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888888 DB
778
G"%%$'-#5(-"' P+#M-(($+&, T!&N-#& 1.->-#U 8888888888888888888888888888888888888888888888888888888888888888888888888888888 D7
7:8
P..&'=-4 V 1$W,#+-.(-"' 1 $W,#+-.(-"' G"22(-"' 888888888888888888888888888888888888888 888888888888888888888888888888888888888888888888888888888888 D:
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
1. Business Scenario .95 :'6;'/<'3 =/6'2/- #77'30 6*' /$%&%6- 6# 0'+4 +#6%7%)/6%#+0 6# / 4'<%)' /+4 E0'3 2*# */<' 0E$0)3%$'4 6# / 0E%6/$&' =/6'2/- 0'3<%)'D (*%0 )/@/$%&%6- 4#'0 +#6 +''4 6# $' 8#$%&%6- )'+63%) *#2'<'3 7#3 6*' @E3@#0' #7 6*%0 4#)E8'+6 2' 0*/&& /00E8' %6 %0D (*' %&&E063/6%#+ $' *%,*&%,*60 6*' $/0%) @3'8%0' $'*%+4 +#6%7%)/6%#+0 2%6* .95 :'6;'/<'3 =/6'2/-D (*%0 )/@/$%&%6- %0 4%77'3'+6 6# .15f0 M/6/ ?*/+,' :#6%7%)/6%#+ 7E+)6%#+ /+4 %0 +#6 )#<'3'4 %+ 6*%0 4#)E8'+6D X#3 6*%0 4#)E8'+6 2' 2%&& 4%0)E00 *#2 6# )3'/6' /+ 9+43#%4 /@@&%)/6%#+ 6# )#+0E8' 0E$0)3%@6%#+ /+4 +#6%7%)/6%#+ '+/$&'4 =/6'2/- 0'3<%)'0 <%/ .15D .E$0)3%@6%#+ /+4 :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- /& -#E 6# 0'+4 '<'+60 6# 6*' 8#$%&' 4'<%)' 7#3 )*/+,'0 #7 / 0@')%7%) .95 J$^')6D Y-@#6*'6%)/&&- -#E )#E&4 0E$0)3%$' 6# /&& +'2 '8@-'' *%3'0 #3 0/&'0 #34'3 )3'/6%#+ '<'+60 /+4 @E0* 6*'0' 6# /+ %+6'3'06'4 E0'3 #3 4'<%)'D
2. Background Information L'7#3' 2' )3'/6' 6*' 9+43#%4 /@@&%)/6%#+ %6 %0 %8@#36/+6 6# 4'0)3%$' *#2 '/)* )#8@#+'+6 %0 E0'4 %+ 6*' /3)*%6')6E3' /$#<' /+4 *#2 %6 7%60 %+6# 6*' .E$0)3%@6%#+ h :#6%7%)/6%#+ @3#)'00 7 #7 .95 :'6;'/<'3 =/6'2/-D (*%0 4#)E8'+6 %0 #+' #7 / +E8$'3 #7 ,E%4'0 6*/6 )#<'3 6*%0 6#@%)D KN&+N-&F •
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ J<'3<%'2
E5(&F50 G"'>-<$+5(-"' •
•
•
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- l ='+'3/6%#+ (##&0 Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- l ?E06#8 M'<'@8'+6 cJM/6/ ?*/++'&d Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- l ;#3G7
G2-&'( !&N&2".%&'( X 1I@ G"'>-<$+5(-"' •
•
•
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- l %J. W ?#4' ./8@&' Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- l 9+43#%4 W ?#4' ./8@&' Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- l L&/)G$'33- W ?#4' ./8@&'
9@3%& ABCA
C
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
2.1 SAP Business Suite (*' .95 LE0%+'00 .E%6' 3'@3'0'+60 6*' $E0%+'00 ,%) #3 /@@&%)/6%#+ &/-'3 3'0@#+0%$&' 7#3 *#&4%+, 6*' /)6E/& $E0%+'00 4/6/D .95 IU5H ?U" h .U" /3' 'F/8@&'0 #7 .95 LE0%+'00 .E%6' /@@&%)/6%#+0 /+4 3'@3'0'+6 6*' )#3' )/6%#+ 7#3 6*' /@@&%)/6%#+ ,%)D K+ 6*' )#+6'F6 #7 =/6'2/- /+4 UI.(7E& 0'3<%)'0 #$^')60 0E)* /0 5E3)*/0' J34'3H I8@-'' /+4 "/6'3%/& )/+ $' 'F@#0'4 6# /& 3%#E0 )&%'+60 6# %+6'3/)6 E0%+, ?3'/6'H U'/4H mE'3-H 1@4/6' /+4 M'&'6' 8'6*#40D M'<'@'30 /+4 /3)*%6')60 +''4 6# )*##0' $'62''+ ,'+'3/6%+, =/6'2/- 0'3<%)'0 #77 'F%06%+, '+6%6%'0 0E)* /0 LJUQUX? h .)3''+ (3/+0/)6%#+0 #3 %8@&'8'+6 / @3#,3/88/6%) 0'3<%)' &'<'3/,%+, 6*' J4/6/ ?*/++'& 73/8'2#3GD .'' M'0%,+ M')%0%#+0 /+4 R/3%/6%#+0 7#3 8#3' %+7#38/6%#+D
2.2 SAP NetWeaver Gateway .95 :'6;'/<'3 =/6'2/- %0 / UI.( '+/$&'3 6*/6 %0 /%&/$&' /0 / .95 :'6;'/<'3 9@@&%)/6%#+ .'3<'3 9L95 c9. 9L95d /44_#+H 2*%)* -#E )/+ %+06/&& #+ 6#@ #7 -#E3 'F%06%+, .95 LE0%+'00 .E%6' #3 /@@&%)/6%#+ @&/67#38D .95 :'6;'/<'3 =/6'2/- #77'30 4'<'@8'+6 /+4 ,'+'3/6%#+ 6##&0 6# )3'/6' JM/6/ 0'3<%)'0 6# / 3%'6- #7 )&%'+6 4'<'@8'+6 6##&0D (*%0 %0 6*' <'*%)&' 6# )#++')6 .95 LE0%+'00 .E%6' 4/6/ /+4 7E+)6%#+/&%6- 6# 6*' 6/3,'6 )&%'+60H @&/67#380 /+4 @3#,3/88%+, 73/8'2#3GD K+ 6*%0 4#)E8'+6 2' 0*/&& 4'0)3%$' 6*' 0E$0)3%@6%#+ /+4 +#6%7%)/6%#+ 0)'+/3%# 2%6* / 06/+4/+' =/6'2/- %+06/+)' %+6',3/6%+, 2%6* / 0'@/3/6' $/)G_'+4 LE0%+'00 .E%6' /@@&%)/6%#+ 0'3<'3D
9@3%& ABCA
A
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
2.3 Sybase Unwired Platform (SUP) & Online Data Proxy (ODP) X#3 6*' @E3@#0' #7 6*%0 4#)E8'+6 2' 0*/&& /00E8' / 8#$%&' 4'<%)' 0)'+/3%# /+4 *'+)' .15 @&/-0 / <'3%8@#36/+6 3#&' %+ 6*%0 0)'+/3%#D (*' 4%/,3/8 $' %&&E063/6'0 6*' %+)&E0%#+ #7 .15 %+ 6*' /3)*%6')6E3' %+4'@'+4'+6 #7 0')E3%6- /+4 S34 @/36- 4'<%)' 0@')%7%) 8'00/,%+, 0'3<%)'0D
.-$/0' 1+2%3'4 5&/67#38 %0 .95f0 8#$%&%6- @&/67#38 /+4 @3#<%4'0 3%#E0 )/@/$%&%6%'0 $'-#+4 6*' 0)#@' #7 0E$0)3%@6%#+ /+4 +#6%7%)/6%#+ 4%0)E00'4 %+ 6*%0 4#)E8'+6D K+ /44%6%#+ 6# .15 6*' J+&%+' M/6/ 53#F- cJM5d %0 / &%,*62'%,*6 '4%6%#+ #7 6*' .-$/0' 1+2%3'4 5&/67#38 6*/6 @3#<%4'0 / 3#$E06 8#$%&' %+73/063E)6E3' 7#3 '+6'3@3%0' K( #3,/+%O/6%#+0 6# 0')E3'&- 3#&E6 /+4 8/+/,' 6*' 4'@-8'+6 #7 &%,*6_2'%,*6 /@@&%)/6%#+0 %+ / )#+63#&&'4 /+4 8#+%6#3'4 /@@3#/)*D X#3 6*' @E3@#0' #7 6*%0 4#)E8'+6 .15 h JM5 3'7'3 6# 6*' 0/8' )/@/$%&%6- #3 )#8@#+'+6D K7 -#E %+06/&& .15 %+ 7E&& -#E */<' 6*' JM5 )/@/$%&%6%'0 /&3'/4- '8$'44'4 /+4 +# 7E36*'3 /)6%#+ %0 3'`E%3'4D (*' JM5 #3 .15 %+06/&&/6%#+ #@6%#+ @3#<%4'0 6*' 7#&%+, %+ 6*' )#+6'F6 #7 0E$0)3%@6%#+ /+4 +#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/-n • • • • • • • •
M'<%)' h 10'3 J+$#/34%+, 9@@&%)/6%#+ )3'/6%#+ /+4 8/+/,'8'+6 .')E3%6- @3#7%&%+, .')E3' @3#F- )#++')6%#+ 6# .95 :'6;'/<'3 =/6'2/- /$063/)6%+, .95 LE0%+'00 .E%6' 9@@&%)/6%#+0 :#6%7%)/6%#+ `E'E%+, h 3#E6%+, 6# 0@')%7%) 4'<%)' M'<%)' #+&%+' < #77&%+' 4'6'38%+/6%#+ M'<%)' @E0* +#6%7%)/6%#+ 3',%063/6%#+ ?#++')6%<%6- 6# S34 5/36- 8'00/,%+, 0'3<%)'0D 95:.H LI. '6)D
9@3%& ABCA
S
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
2.4 Clients & Sybase OData SDK Development (# %+6',3/6' )&%'+60 2%6* .15 %+6# .95 :'6;'/<'3 =/6'2/-H .95 */0 4'&%<'3'4 / +E8$'3 #7 4'<%)' 0@')%7%) &%$3/3%'0 6*/6 /$063/)6 6*' 4'<'@'3 73#8 /)6%<%6%'0D (*%0 %0 G+#2+ /0 6*' JM/6/ .Mg /+4 )#+0%060 #7 / )#&&')6%#+ #7 3E+6%8' &%$3/3%'0 /+4 )&/00'0D :#6' 7#3 =/6'2/- 06/+4/+' c+#+_.15d 0)'+/3%#0 6*'0' &%$3/3%'0 /3' +#6 3'`E%3'4D X#3 8#3' %+7#38/6%#+ @&'/0' 6*' JM/6/D#3, 2'$0%6' *'3'D (*' .95 JM/6/ .Mg 0E@@#360 9+43#%4H L&/)GL'33- /+4 %J. @&/67#380 /+4 %6 %0 $/0'4 #+ 6*' +/6%<' 4'<%)' .Mg0 #7 6*' @&/67#380D (*'3' %0 /+ %8@&'8'+6/6%#+ 7#3 '/)* @&/67#38D :/6%<' /@@&%)/6%#+0 %+06/&&'4 #+ 6*' 4'<%)'0 /& 6*' )&%'+6 /@@&%)/6%#+ 6# &'<'3/,' 6*' 0E@@#36 @3#<%4'4 $6*' ,%<'+ @&/67#38H 7#3 'F/8@&'n •
•
• •
94/@6 6# '/)* 4'<%)'f0 7#38 7/)6#3 c7#3 'F/8@&'H /E6#8/6%) &/-#E6d IF@%6 4%77'3'+6 %+@E6 8'6*#40 c7#3 'F/8@&'H 6#E)* 0)3''+H G'-$#/34 #3 63/)G$/&&d ?/)*' 4/6/ %+ +/6%<' 4'<%)' 4/6/ 06#3'0 7#3 $'66'3 @'37#38/+)' (%,*6&- %+6',3/6' 2%6* 6*' 7'/6E3'0 #7 6*' 4'<%)'
(*' 8/%+ 7E+)6%#+ #7 6*' &%$3/3%'0 %0 6# @3#<%4' 6*' 7#&%+, *%,*_&'<'& /$063/)6'4 7E+)6%#+0D X#3 8#3' %+7#38/6%#+ @&'/0' 0'' 6*' #77%)%/& *'&@ 4#)E8'+6/6%#+ *'3'D •
•
•
• •
@5+,-'< l 5/30%+, #7 JM/6/ Z"[ 6# +/6%<' JM/6/ #$^')60H R/&%4/6' JM/6/ Z"[H 53#<%4' '/0- /))'00 6# /&& JM/6/ X%'&40 /+4 063E)6E3'0 <%/ #$^')60D G5#M& Y5'5<&%&'( V .6#3%+,Q/))'00%+, JM/6/ #$^')60 %+ 8'8#3-H I77%)%'+6 0'/3)* JM/6/ '+63%'0 %+ 8'8#3-H "/+/,%+, 0%O' #7 ?/)*'D @&+,-,(&'#& V .6#3%+, #$^')60 /+4 3/2 4/6/ #+ 6*' @*-0%)/& 06#3/,' #7 6*' 4'<%)'H I/0- /+4 `E%)G /))'00 6# 06#3'4 #$^')60 /+4 3/2 4/6/H M/6/ I+)3-@6%#+ 1$.."+(5W-2-(0 V ?#88#+ 'F)'@6%#+ /+4 '33#3 */+4&%+,H I<'+6 ,,%+,H (3/)%+, c.95 5/00@#36d 1I@ G"''(-N-(0 V .-+)*3#+#E0 /+4 /0-+)*3#+#E0 Y((5 3'`E'06 */+4&%+,H ?#8@3'00'0 @/-/4 */+4&%+,H U'`E'06 6-@'0 /0 0E@@#36 $- JM/6/ 53#6#)#&H ?#++')6%#+ @##&0 7#3 #@6%8/& @'37#38/+)'
X#3 #E3 0/8@&' /@@&%)/6%#+ 2' 0*/&& E0' / 0E$0'6 #7 2*/6 %0 /%&/$&' /$#<' /+4 7#)E0 #+ ?/)*' "/+/,'8'+6H M/6/ 5/30'3H ?#++')6%<%6-H .')E3%6-H .E@@#36/$%&%6- h ?#+7%,E3/6%#+D
9@3%& ABCA
T
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
2.5 Process Flow (*' .E$0)3%@6%#+ /+4 :#6%7%)/6%#+ 0)'+/3%# %0 'F@&/%+'4 ,3'/6'3 4'6/%& 2%6*%+ 6*' 4#)E8'+6 aY#2_ (#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- l J<'3<%'2bD X#3 6*' @E3@#0' #7 $3'<%6- 6*' 7#&%+, *%,*_&'<'& @3#)'00 0E88/3%O'0 #E3 0)'+/3%#D (*' 7#&%+, %&&E063/6%#+ 4'@%)60 6*' $/0%) /3)*%6')6E3' %+4'@'+4'+6 #7 S34 @/36- 8'00/,%+, /+4 0')E3%6- )#8@#+'+60H 7#&'4 $- / 4'0)3%@6%#+ #7 '/)* 06'@ %+ 6*' @3#)'00D :#6' 6*' E0' #7 0')E3%6- 7%3'2/&&0H 3'&/- 0'3<'30 /+4 S34 @/36- 8'00/,%+, 0'3<%)'0 /3' &'76 #E6 #7 6*' 4%/,3/8 %+6'+6%#+/&&-D
2.5.1 Step 1 - Registration (SUP) (*%0 @3#)'00 )/+ $' /E6#8/6'4 *#2'<'3 7#3 6# 'F@&/%+ 'F/)6&- 2*/6 %0 )#+7%,E3'4 / .15 948%+%063/6#3 ,0 #+6# 6*' .-$/0' ?#+63#& ?'+6'3 /+4 )3'/6'0 6*' 7#&%+,n • •
•
•
?3'/6'0 /+ /@@&%)/6%#+D ?3'/6'0 / 0')E3%6- @3#7%&' 6# 4'6'38%+' *#2 E0'3 2%&& $' /E6*'+6%)/6'4 %+ .15D ?3'/6'0 /+ /@@&%)/6%#+ )#++')6%#+ 6*/6 $%+40 / .15 10'3H 9@@&%)/6%#+ KMH .')E3%6- 53#7%&' /+4 /)6%6%#+ )#4'0D "/%+6/%+0 /@@&%)/6%#+ )#++')6%#+ @3#@'36%'0 2%6* =/6'2/- 0'3<%)' 1U[ /+4 @E0* '+4@#%+6 1U[D
9@3%& ABCA
N
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
2.5.2 Step 2 – SUP Activation (Client) 10%+, 6*' .95 J4/6/ .Mg 6*' 4'<'@'3 )3'/6'0 / 8#$%&' /@@&%)/6%#+ %+ 6*' /@@3#@3%/6' KMI /+4 /6 3E+6%8' 6*' )&%'+6 @3#,3/88/6%)/&&- #<'3 Y((5Q0n • •
• • • •
?#++')60 6# .15 9)6%6'0 6*' E0'3 /+4 $%+40 / 4'<%)' KM 6# 6*' /@@&%)/6%#+ )#++')6%#+ )3'/6'4 %+ 6*' 7%306 06'@D U',%06'30 6*' 8#$%&' /@@&%)/6%#+ 7#3 @E0* +#6%7%)/6%#+0D TZ"'< ."22 %+%6%/6'4d U'63%'<'0 6*' =/6'2/- 1U[0 73#8 6*' .15 /@@&%)/6%#+ )#++')6%#+ @3#@'36%'0 U'63%'<'0 6*' @E0* 1U[ '+4@#%+6 7#38 6*' .15 /@@&%)/6%#+ )#++')6%#+ @3#@'36%'0 U'63%'<'0 8'00/,'0 73#8 .15 7#E+4 %+ 6*' /@@&%)/6%#+ )#++')6%#+ `E'E'
2.5.3 Step 3 – Calling Gateway Services (Client) J+)' 6*' /)6%6%#+ /+4 %+%6%/&%O/6%#+ %0 4#+' 6*' )&%'+6 6*'+ )/&&0 6*' ,/6'2/- 0'3<%)'0 / +#38/& /@@&%)/6%#+ %+4'@'+4'+6 #7 / 0E$0)3%@6%#+ /+4 +#6%7%)/6%#+ 0)'+/3%#D K7 -#E 2'3' 4'<'@%+, /+ 06/+4/34 .15Q=/6'2/'+/$&'4 /@@&%)/6%#+ -#E )#E&4 06#@ *'3' /+4 ^E06 @'37#38 ?U1M #@'3/6%#+0 #7 -#E3 ?#&&')6%#+0D (*' %+%6%/& =/6'2/- .'3<%)' )/&&0 %+ 0'`E'+)' c#+)' #+&-dn • •
=/6'2/- .'3<%)' M#)E8'+6 l 0'+4H 3')'%<'H @/30' h )/)*' =/6'2/- "'6/4/6/ M#)E8'+6 l 0'+4H 3')'%<'H @/30' h )/)*'
.E$0'`E'+6 M/6/ ?/&&0 c/0 8/+- /0 3'`E%3'4dn •
• •
M/6/ ?#&&')6%#+Q0D K+ #E6 )/0' 2' @'37#38 / 0%8@&' `E'3- #+ X&%,*6?#&&')6%#+ l 0'+4H 3')'%<'H @/30' h )/)*' M%0@&/- #+ 0)3''+D ?/&& /0 8/+- )#&&')6%#+0 /0 -#E +''4 /+4 @'37#38 )3'/6'H 3'/4H E@4/6' h 4'&'6' #@'3/6%#+0 /0 3'`E%3'4D
9@3%& ABCA
V
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
2.5.4 Step 4 - Create Subscription (Client) L'7#3' / E0'3 )/+ 3')'%<' /+- +#6%7%)/6%#+0 6*' )&%'+6 /@@&%)/6%#+ +''40 6# 0E$0)3%$' 'F@&%)%6&- 6# / =/6'2/0'3<%)' '+6%6- 6*/6 %0 0E$0)3%@6%#+ '+/$&'4D ;' 2%&& 6/&G 8#3' /$#E6 *#2 6# '+/$&' =/6'2/- .'3<%)'0 7#3 0E$0)3%@6%#+ %+ #6*'3 Y#2_(# ,E%4'0 $E6 7#3 +#2 2' )/+ /00E8' 6*/6 7#3 / ,%<'+ =/6'2/- .'3<%)' 0E)* /0 .X[K=Y( 0E$0)3%@6%#+ %0 '+/$&'4D
2.5.5 Step 4 - Trigger Notification (Backend) J+)' / 0E$0)3%@6%#+ */0 $''+ )3'/6'4 /,/%+06 / 0E%6/$&' I+6%6- #3 ?#&&')6%#+ 6*' )&%'+6 2/%60 7#3 / +#6%7%)/6%#+D :#38/& $E0%+'00 @3#)'00%+, #))E30 %+ 6*' L/)G'+4 E+6%& / 63%,,'3 %0 7%3'4 /+4 06/360 6*' +#6%7%)/6%#+ @3#)'00 $/)G 6# =/6'2/-H .15 /+4 6*' #$0'3<%+, 4'<%)' /+4 E0'3D M'@'+4%+, #+ *#2 6*' =/6'2/- .'3<%)' 2/0 %8@&'8'+6'4 6*' 63%,,'3 8/- $' 'F')E6'4 $- +#38/& $E0%+'00 @3#)'00%+, 0E)* /0 / 5E3)*/0' J34'3 ?3'/6' #3 ./&'0 J34'3 ?*/+,' 2*%)* 7#3)'0 / LE0%+'00 J$^')6 U'@#0%6#3- #$^')6 06/6' )*/+,'D (*%0 8'6*#4 %0 / .95 )#+)'@6 /+4 %0 &'<'3/,'4 $- .95 LE0%+'00 ;#3G7 /+4 8/+- #6*'3 /@@&%)/6%#+0D X#3 8#3' %+7#38/6%#+ */<' / #G /6 63/+0/)6%#+0 .;JC h .;JAD K7 -#E )*##0' 6# E0' 6*' )E06#8 4'<'@8'+6 /@@3#/)* G+#2+ /0 6*' JM/6/ ?*/++'& -#E 2%&& +''4 6# %8@&'8'+6 6*' 63%,,'3 -#E30'&7 %+ 6*' /@@3#@3%/6' $E0%+'00 @3#)'00 )/6%#+H 0E)* /0 / 'F%6 #3 L9MKD 90-+)*3#+#E0 )#88E+%)/6%#+0 $'62''+ 6*' L/)G'+4 0-06'8 /+4 =/6'2/- /3' 'F')E6'4 E0%+, L/)G,3#E+4 U'8#6' XE+)6%#+ )/&&0 cL=UX?dD J+)' / +#6%7%)/6%#+ */0 $''+ 3')'%<'4 %+ =/6'2/- 6*' 8'00/,' %0 0'+6 6# .15 <%/ / ."NP UX? M'06%+/6%#+D .15 /&2/-0 &%06'+0 #+ / 0'6 1U[ 7#3 %+$#E+4 Y((5Q0 +#6%7%)/6%#+0 )#8%+, 73#8 =/6'2/- /+4 6*%0 &E' 2/0 06#3'4 %+ 6*' /@@&%)/6%#+ )#++')6%#+ @3#@'36%'0 %+ .15 /+4 /&0# 2#E&4 $' 4'7%+'4 %+ 6*' ."NP Y((5 M'06%+/6%#+n *66@nQQ*#06n@#36Q=;?Q.15:#6%7%)/6%#+Q D
2.5.6 Step 5 - Receive Notification (Client) K+ .15 6*' 0'3<'3 )*')G0 %7 6*' 8#$%&' 4'<%)' %0 #+&%+' /+4 6*'+ 0'+40 6*' 8'00/,' 6# 6*' 4'<%)' <%/ / 3'0@#+0' E0%+, 6*' +, @#&& )#++')6%#+ '06/$&%0*'4 )#+6%+E#E0&- /6 /@@&%)/6%#+ %+%6%/&%O/6%#+D (*' 4'<%)' /@@&%)/6%#+ /))'@60 6*' 8'00/,' #3 +#6%7%)/6%#+ <%/ / 06/+4/34 )&/00 8'6*#4 /+4 6*'+ 6*' 4'<'@'3 )/+ 'F')E6' /+- /)6%#+ *' #3 0*' 2/+60D :#6' l X#3 9+43#%4 0)'+/3%#0 .95 #+&- 0E@@#360 #+&%+' 0)'+/3%#0D 5&'/0' 0'' 6*' +'F6 )*/@6'3 7#3 8#3' %+7#38/6%#+ 3',/34%+, @E0*Q@E&& /+4 #77&%+'Q#+&%+'D
9@3%& ABCA
j
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
2.6 Offline/Online J77&%+' /+4 #+&%+' )/@/$%&%6%'0 /3' 0E@@#36'4 ,'+'3%)/&&- 2%6* .15 *#2'<'3 2%6* 9+43#%4 /+4 6*' )E33'+6 &/)G #7 0E@@#36 7#3 ?AM" #+&- #+&%+' 0)'+/3%#0 /3' /%&/$&'D ;*'+ / +#6%7%)/6%#+ /33%<'0 %+ .15 6*' 0'3<'3 4'6'38%+'0 %7 / 4'<%)' %0 #77&%+' #3 #+&%+' /+4 3#E6'0 6*' +#6%7%)/6%#+ <%/ JM5 c4'7/E&6d 8')*/+%08 #3 S 34 @/36- 8'00/,%+, 0'3<%)' %7 )#+7%,E3'4 /@@3#@3%/6'&-D (*' 7#&%+, 4'0)3%$'0 '/)* %+ 8#3' 4'6/%&n
2.6.1 Offline 9 4'<%)' %0 #77&%+' 2*'+ %6 %0 +#6 )#++')6'4 6# .15 /+4 6*' /@@&%)/6%#+ %0 +#6 %+ 7#3',3#E+4D o#E 8/- $' %+ /+ /3'/ 2*'3' )#++')6%<%6- %0 3'063%)6'4 0E)* /0 / @&/+' #3 6E++'&D K+ 0E)* 0%6E/6%#+0 +#6%7%)/6%#+0 )/++#6 3'/)* 6*' @*#+' #3 8#$%&' 4'<%)'D :#6%7%)/6%#+0 /3' 06#3'4 %+ 6*' 8'00/,%+, `E'E'0 /+4 #+)' / 4'<%)' 3'_ )#++')60 2%6* .15 6*' +#6%7%)/6%#+0 /3' 0'+4 6# 6*' 4'<%)' %+ @E0* 0)'+/3%#0D K7 -#E */<' / L&/)G$'33- #3 %J. 4'<%)' -#E )/+ %+6',3/6' <'+4#3 0@')%7%) 8'00/,%+, 0'3<%)'0 0E)* 95:.D (*%0 )#+7%,E3/6%#+ %0 @'37#38'4 %+ 6*' /@@&%)/6%#+ )#++')6%#+ @3#@'36%'0 %+ .15 .??D K+ 6*%0 0)'+/3%# -#E 4'<%)' 8/- */<' K+6'3+'6 )/@/$%&%6- -'6 +#6 'F@&%)%6&- )#++')6'4 6# .15D X#3 9+43#%4 #+&- #+&%+' 0)'+/3%#0 /3' 0E@@#36'4D
2.6.2 Online 9 4'<%)' %0 4'6'38%+'4 6# $' #+&%+' %7 %0 */0 )#++')6%<%6- 6# .15 /+4 %+%6%/6'4 #3 06/36'4 6*' )&%'+6 )#88E+%)/6%#+0 'F@&%)%6&-D K+ /44%6%#+ 6# 6*%0 6*' 4'<%)' 8E06 3',%06'3 7#3 @E0* +#6%7%)/6%#+0D o#E )/+ )*')G %7 / 4'<%)' %0 #+&%+' #3 #77&%+' <%/ 6*' .15 .?? /@@&%)/6%#+ )#++')6%#+ 0)3''+D ;' 2%&& 4'8#+063/6' 6*%0 )/@/$%&%6- 2%6* #E3 0/8@&' /@@&%)/6%#+D
2.7 Push/Pull .95 :'6;'/<'3 =/6'2/- h .15 0E@@#360 62# 6-@'0 #7 +#6%7%)/6%#+0D (*'- /3' 4'0)3%$'4 $' %+ 7E36*'3 4'6/%& /+4 /3' %8@&'8'+6'4 <%/ )#+7%,E3/6%#+ /+4 /@@&%)/6%#+ 4'0%,+ 2%6*%+ 6*' KMID 5E0* %0 2*'3' 6*' +#6%7%)/6%#+0 /3' 0'+6 6# 4'<%)' /+4 @E&& %0 2*'3' 6*' 4'<%)' 'F@&%)%6&- 3'`E'060 6*' +#6%7%)/6%#+0D
2.7.1 Pull :#6%7%)/6%#+0 /3' 06#3'4 %+ .95 :'6;'/<'3 =/6'2/- 7#3 &/6'3 3'63%'& 'F@&%)%6&- 8/4' $- 6*' )&%'+6D (*' )&%'+6 +''40 6# )/&& / 0'@/3/6' =/6'2/- 0'3<%)' 6*/6 )#8'0 06/+4/34 /+4 %0 4'@'+4'+6 #+ 6*' 73/8'2#3G E0'4 /6 4'0%,+ 6%8' 2%6*%+ =/6'2/-D %D'D .5S h .5A */<' 4%77'3'+6 1U[0D (*' @'30%06:#6%7%)/6%#+0 '&'8'+6 %+ 6*' 0E$0)3%@6%#+ )3'/6' 06'@ 4'7%+'0 %7 @E0* #3 @E&& %0 E0'4D (*%0 /@@3#/)* %0 '77')6%<'&- /+ 'F@&%)%6 3'`E'06Q3'0@#+0' 8/4' 73#8 6*' )&%'+6 /0 %7 -#E 2'3' /66'8@6%+, 6# `E'3- / X&%,*6 0'3<%)' -#E 2#E&4 $' `E'3-%+, / :#6%7%)/6%#+ 0'3<%)'D K+ 0E)* )/0'0 .15 4#'0 +#6 @'37#38 /+- `E'E%+, 7E+)6%#+/&%6- #3 )#88E+%)/6%#+0 6# S34 @/36 8'00/,%+, 0'3<%)'0 &%G' 95:. '6)D
9@3%& ABCA
i
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
2.7.2 Push (*' @E0* 0)'+/3%# %0 2*'3' +#6%7%)/6%#+0 /3' 0'+6 73#8 .15 6# 6*' M'<%)' %+ #+' #7 62# 8'6*#40D (*'0' 8'6*#40 /3' 4'0)3%$'4 $' /+4 )/+ $' E0'4 6#,'6*'3 <%/ )#+7%,E3/6%#+ 6# 8/F%8%O' 6*' 3'/)* #7 +#6%7%)/6%#+0 6# -#E3 4'<%)'D ;*'+ / 4'<%)' %0 )#++')6'4 6# .15 /+4 3',%06'3'4 7#3 @E0* +#6%7%)/6%#+0 %6 %0 4'6'38%+'4 6# $' #+&%+' /+4 6*'3'7#3' JM5 2%&& $' E0'4D K7 / 4'<%)' %0 +#6 )#++')6'4 6# .15 6*'+ 6*' S34 5/36- "'00/,%+, .'3<%)' 2%&& $' E0'4 %7 )#+7%,E3'4 )#33')6&- %+ .15 .??D
2.7.2.1 ODP :#6%7%)/6%#+0 /3' 0'+6 6# 6*' 4'<%)' E0%+, / .15 @3#6#)#& &'<'3/,%+, / +, @#&& 8')*/+%08D 90 '/)* 8#$%&' 4'<%)' 4#'0 +#6 */<' / 4%0)3'6' 2'$ 0'3<'3 /443'00'4 E+%`E'&-H 6*' 4'<%)' /6 6*' %+%6%/&%O/6%#+ 06/,' '06/$&%0*'0 / )#++')6%#+ 6# .15 c3'`E'06d /+4 G''@0 %6 /&%<' 7#3 / 4'7/E&6 #7 N 8%+E6'0D K7 / +#6%7%)/6%#+ %0 0'+6 6# .15 %+ 6*%0 6%8' %6 %0 0'+6 6# 6*' 4'<%)' /0 6*' 4%3')6 3'0@#+0'D (*%0 0%8E&/6'0 / @E0* $- /&2/-0 8/%+6/%+%+, /+ #@'+ )#++')6%#+ 6*/6 .15 )/+ 3'0@#+4 6# <%/ / +#38/& 3'`E'06Q3'0@#+0' )-)&'D .# %+ 7/)6 6*' @E0* %0 3'/&&- )&%'+6 %+%6%/6'4D .15 @/00'0 #+ 2*/6 '<'3 %6 ,'60 73#8 =/6'2/-D
2.7.2.2 3rd Party (APNS + BES) :#6%7%)/6%#+0 /3' 0'+6 73#8 .15 <%/ / S 34 @/36 8'00/,%+, 0'3<%)' 0E)* /0 95:.D (*' @E0*'4 8'00/,' )/+ $' 3')'%<'4 %7 6*' /@@&%)/6%#+ %0 p$/)G,3#E+4a c#3 #77&%+'d #3 p7#3',3#E+4a <%/ 9@@&'f0 95:. )*/++'&D (*' 4'<%)' /+4 /@@&%)/6%#+ 4#'0+f6 */<' 6# $' 4%3')6&- 3'/)*/$&' 6# .15 0'3<'3D 95:. 2#3G0 %7 6*' 4'<%)' %0 %+ 6*' @E$&%) K+6'3+'6 /+4 +#6 /$&' 6# )#++')6 6# .15D
CAUTION
(*' 4%/,3/8 /$#<' %0 #+' <'3- 0%8@&' 'F/8@&' 6# 'F@&/%+ *#2 @E0* 6')*+#,- 2#3G0 2%6* .15D (*' &/+40)/@' %+ 6*' @3#4E)6%#+ 0-06'8 2#E&4 */<' /44%6%#+/& '&'8'+60 0E)* /0 / 3'&/- 0'3<'3 6# */+4&' 7%3'2/&&
9@3%& ABCA
P
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
3. System Prerequisites (*' 7#&%+, /3' 6*' @3'3'`E%0%6'0 6# )#8@&'6' 6*' 06'@0 %+ 6*%0 ,E%4'n •
o#E */<' /))'00 6# / :'6;'/<'3 jDBA .5V #3 *%,*'3 0-06'8H 2*%)* 6*' .95 :'6;'/<'3 =/6'2/9L95 /44_#+0 */<' $''+ %+06/&&'4D
•
o#E */<' .15 ADC %+06/&&'4D
•
L/)G'+4 .95 /@@&%)/6%#+ 2%6* 6*' K;qLI5 =/6'2/- /44_#+ %+06/&&'4D
•
?#++')6%#+0 $'62''+ .95 :'6;'/<'3 =/6'2/- 0-06'8 /+4 $/)G'+4 .95 /@@&%)/6%#+ /3' )#+7%,E3'4D
•
o#E */<' / 0E$0)3%@6%#+ /+4 +#6%7%)/6%#+ '+/$&'4 0'3<%)' )#+7%,E3'4 %+ =/6'2/- 0E)* /0 U"(.9"5[IX[K=Y(D
•
o#E */<' /))'00 6# 6*' .-$/0' M'<'@'3 ;#3G0@/)' c3'`E%3'4 &%$3/3%'0d
•
o#E */<' /))'00 6# .15 .??D
9@3%& ABCA
CB
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
4. Tasks (*' 0)'+/3%# 4'6/%&'4 %+ 6*%0 4#)E8'+6 */0 7#E3 8/^#3 )#+7%,E3/6%#+ 06'@0D (*' 7%306 %0 / @3'_3'`E%0%6' 6# '+0E3' -#E */<' 6*' 0/8@&' .X[K=Y( ,/6'2/- 0'3<%)' 3E++%+, %+ -#E3 0-06'8D (*'3' /3' / )#E@&' #7 3%/6%#+0 #7 6*%0 0'3<%)' 4'@'+4%+, #+ 6*' .5 &'<'& #7 -#E3 =/6'2/- %+06/+)'D X#&%+, 6*%0 2' 8#<' %+6# .15 /+4 @'37#38 6*' )#+7%,E3/6%#+ 7#3 8/+E/& E0'3 #+$#/34%+,D J+)' 6*%0 %0 4#+' 2' 2%&& #G /6 6*' 9+43#%4 4'<'@8'+6 '+<%3#+8'+6 /+4 4%0)E00 6*' )#4%+, 06'@0 6# ,'6 /+ /@@&%)/6%#+ 2#3G%+,D (*' )#4' 0/8@&' /66/)*'4 4'8#+063/6'0 *#&%06%)/&&- /+4 )/+ $' 3E+ '/0%&-D K6 %0 %8@#36/+6 6# '8@*/0%O' /+0/8@&' )#4' %0 @E3'&- 7#3 =&%"',(+5(-"' .$+.",&, /+4 +#6 7#3 @3#4E)6%#+D 90@')60 0E)* /0 063#+, 0')E3%68')*/+%080H @'30%06'+)'H 9+43#%4 3'&'/0' )#8@/6%$%&%6- /+4 /@@&%)/6%#+ 06/6' )*/+,'0 /3' +#6 )#<'3'4D
Subscription
1
2 OData
3
SUP (ODP)
4 OData
SAP NetWeaver Gateway
RFC bgRFC
SAP Business Suite
5 Notification
1(&.
P'=+"-=
1I@
E5(&F50
E5(&F50 G"'>-<$+5(-"' •
•
?*')G 6*' .'3<%)' %0 /%&/$&' "/%+6/%+ M'06%+/6%#+0 7#3 ?&%'+6 :#6%7%)/6%#+0
1I@JK!@ G"'>-<$+5(-"' •
•
•
.')E3%6- 53#7%&' 9@@&%)/6%#+ Q 9@@&%)/6%#+ ('8@&/6' 9@@&%)/6%#+ ?#++')6%#+
P'=+"-= V G"'>-<$+-'< 0"$+ !&N&2".%&'( 3'N-+"'%&'( •
•
•
•
•
•
M#2+/4 6*' KMI .'66%+, E@ 6*' 9+43#%4 .Mg "/+/,'3 1@4/6' 9+43#%4 .Mg 2%6* [%$3/3%'0 ?3'/6' /+ 9+43#%4 53#^')6 K8@#36%+, [%$3/3%'0 6# -#E3 9+43#%4 9@@&%)/6%#+ 53#^')6 .'66%+, 53#^')6 53#@'36%'0
P'=+"-= V !&N&2". 0"$+ 5..2-#5(-"' •
•
•
•
9@3%& ABCA
K+%6%/&%O/6%#+ ?/&&%+, =/6'2/- .'3<%)'0 ?3'/6%+, h M'&'6%+, .E$0)3%@6%#+0 U')'%<%+, :#6%7%)/6%#+0
CC
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
5. Gateway Configuration L'7#3' 2' )/+ $E%&4 /+ /@@&%)/6%#+ -#E +''4 6# */<' / ,/6'2/- 0'3<%)' )#+7%,E3'4 /+4 /%&/$&'D (*'3' / 8/+- 2/-0 6# )3'/6' / 0'3<%)' E0%+, =/6'2/- /+4 #6*'3 aY#2DD(#b ,E%4'0 'F@&%)%6&- 4'0)3%$' 6*' 3'`E%3'4 06'@0 6# )#+7%,E3' 0E)* 0)'+/3%#0D X#3 6*' @E3@#0' #7 4%0)E00%#+ /+4 #E3 0/8@&' )#4' 2' 2%&& $' 3'7'3'+)%+, U"(.9"5[IX[K=Y(H 2*%)* %0 0*%@@'4 2%6* /&& =/6'2/- %+06/+)'0D (*' 6-@%)/& 1U[ 7#3 6*%0 0'3<%)' )/+ $' 0''+ $'D :#6' 7#3 .5S '+/$&'4 0'3<%)'0 6*%0 1U[ 8/- 4%77'3D 5&'/0' #77%)%/& *'&@ 7#3 8#3' %+7#38/6%#+D •
*66@nQQ,/6'2/-0'3<'3n@#36Q0/@Q#@EQ04/6/QK;X:MQU"(.9"5 [IX[K=Y(
J+)' -#E */<' / )3'/6'4 #3 '+/$&'4 -#E 0'3<%)' 6# $' 0E$0)3%@6%#+ /+4 +#6%7%)/6%#+ '+/$&'4 6*' 8'6/4/6/ 4#)E8'+6 /+4 0'3<%)' 4#)E8'+6 0*#E&4 3'7&')6 6*%0D L' %0 /+ 'F/8@&' #7 6*' 0'3<%)' 4#)E8'+6 73#8 6*' U"(.9"5[IX[K=Y(D o#E )/+ 0'' 6*' 0'3<%)' 4#)E8'+6 %+4%)/6'0 %6 %0 0E$0)3%@6%#+ /+4 +#6%7%)/6%#+ '+/$&'4 /+4 6*/6 6*' X&%,*6?#&&')6%#+ )/+ $' 0E$0)3%$'4 /,/%+06D
L' %0 /+ 'F/8@&' #7 6*' 8'6/4/6/ 4#)E8'+6D o#E )/+ 0'' 6*' 8'6/4/6/ 4#)E8'+6 %+4%)/6'0 %6 %0 0E$0)3%@6%#+ /+4 +#6%7%)/6%#+ '+/$&'4 /+4 /)6E/&&- 0*#20 6*' 0)*'8/ #7 6*' '/)*D (*/6 6'&&0 E0 2*/6 /+ %+$#E+4 +#6%7%)/6%#+ 2#E&4 #G &%G' /+4 *#2 6*' )&%'+6 95K )/+ '/0%&- )#<'36 6# )#+0E8/$&' 4/6/ 6-@'0D ?#+<'30'&- %6 /&0# 0*#20 E0 2*/6 / 0E$0)3%@6%#+ 3'`E'06 2#E&4 #G &%G' 73#8 / @/-/4 @'30@')6%<'D ;' 2%&& E0' 6*%0 2*'+ 2' )3'/6' 6*' 0E$0)3%@6%#+ *%,*&%,*6'4 &/6'3 %+ 6*%0 4#)E8'+6D
9@3%& ABCA
CA
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
K6 %0 %8@#36/+6 6# +#6' 6*/6 6*' .E$0)3%@6%#+ ?#&&')6%#+ /)60 &%G' /+- #6*'3 ?#&&')6%#+D o#E )/+ )3'/6'H E@4/6'H 4'&'6'H 3'/4 /+4 `E'3- /+- 0E$0)3%@6%#+0 E0%+, 6*' Y((5 R'3$ )#8$%+/6%#+ 2%6* /+ /@@3#@3%/6' 1U[ /+4 @/-/4D X#3 8#3' %+7#38/6%#+ @&'/0' 0'' p9@@'+4%F l .E$0)3%@6%#+ ?#&&')6%#+a 7#3 8#3' %+7#38/6%#+D
5.1 Check the SUP SM59 Destination in Gateway. (*%0 06'@ %0 4'0)3%$'4 %+ #6*'3 4#)E8'+60 /+4 %0 0@')%7%) 6# 6*' ,/6'2/- )#+7%,E3/6%#+D 96 3E+6%8' 2*'+ / +#6%7%)/6%#+ %0 )3'/6'4 %+ ,/6'2/- %6 #G0 /6 2*# )3'/6'4 6*' 0E$0)3%@6%#+ /+4 8/6)*'0 / 4'&%<'3- /443'00 E0'4 %+ 6*' @/-/4 #+ )3'/6%#+ /+4 6*'+ )*')G0 %7 / ."NP M'06%+/6%#+ 'F%060 2%6* 6*' 0/8' 0'3<'3Q@#36QE3&D (*%0 1U[ 4'6'38%+'0 *#2 6# 0'+4 6*' +#6%7%)/6%#+ 6# .15D X#3 .15 0)'+/3%#0 6*%0 0*#E&4 $' )#+06/+6 /+4 '`E/& 6# $'D aQ=;?Q.15:#6%7%)/6%#+b #+ @#36 iBBB 0E$^')6 6# 0')E3%6- /+4 ..[D
9@3%& ABCA
CS
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
6. SUP/ODP Configuration L'7#3' 2' /)6E/&&- )3'/6' /+ 9+43#%4 /@@&%)/6%#+ 2' +''4 6# )#+7%,E3' .15 E0%+, 6*' .-$/0' ?#+63#& ?'+6'3D (*' 06'@0 /3' '/0- /+4 2#E&4 $' @'37#38'4 $- /+ /48%+%063/6#3D K+ 0#8' )/0'0 6*'0' 06'@0 8/- $' /E6#8/6'4 c#+$#/34%+,d $E6 6# ,/%+ / )&'/3 E+4'306/+4%+, #7 2*/6 %0 */@@'+%+, %6 %0 $'+'7%)%/& 6# )3'/6' 6*'0' 8/+E/&&-D K6 %0 3'/&&- %8@#36/+6 6# 4# 6*'0' 06'@0 @3%#3 6# )3'/6%+, /+4 3E++%+, /+ /@@&%)/6%#+ #+ / 4'<%)' /0 6*'3' /3' G'- '+6%6%'0 #E3 J4/6/ .Mg 95K #3 )&%'+6 /@@&%)/6%#+ 2%&& %+6'3/)6 2%6* 4-+/8%)/&&- /6 3E+6%8'D
6.1 Create Security Configuration K+ 6*' .-$/0' ?#+63#& ?'+63' -#E +''4 6# ,%+ /+4 )3'/6' / 0')E3%6)#+7%,E3/6%#+ 6# 4'6'38%+' *#2 -#E3 /@@&%)/6%#+ 2%&& $' /E6*'+6%)/6'4 %+ .15D (*'3' /3' / )#E@&' #7 #@6%#+0 /%&/$&' /+4 /3' 4%0)E00'4 %+ 7E36*'3 4'6/%& %+ #6*'3 4#)E8'+60D X#3 'F6'3+/& /E6*'+6%)/6%#+ .15 )*')G0 /+#6*'3 0-06'8 /))#34%+, 6# 6*' #@6%#+ 0'&')6'4 /+4 6*'+ 3'0@#+40 2%6* 0E))'00 #3 7/%&E3'D .15 4#'0 +#6 *#&4 6*' 0')E3%6- %+7#38/6%#+ %+ 6*' 0'3<'3 $E6 )*')G0 6*' 'F6'3+/& @3#<%4'3 %+ &%+' 2%6* -#E3 )#3@#3/6' 0')E3%6- 063/6',-D (*' 7#&%+, #@6%#+0 /3' /%&/$&'n • • • •
Y5'$52 I,&+ K'W"5+=-'< V S" P$(M&'(-#5(-"' IF6'3+/& 9E6*'+6%)/6%#+ l 10'3+/8'Q5/002#34 IF6'3+/& 9E6*'+6%)/6%#+ l ..JA IF6'3+/& 9E6*'+6%)/6%#+ l ?'36%7%)/6'0
X#3 6*' @E3@#0' #7 #E3 0%8@&' /@@&%)/6%#+ 2' 2%&& $' E0%+, %5'$52 $,&+ "'W"5+=-'< /+4 *'+)' 2%&& )3'/6' / 0')E3%6- @3#7%&' 2%6* +# /E6*'+6%)/6%#+ 3'`E%3'8'+60D (*' 7#&%+, 06'@0 4'0)3%$' 6*%0 )#+7%,E3/6%#+D CD AD
[#, #+6# 6*' .-$/0' ?#+63#& ?'+6'3D ?&%)G #+ 6*' .')E3%6- :#4' #+ 6*' &'76 */+4 0%4'D
9@3%& ABCA
CT
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
SD
?&%)G #+ a:'2b %+ 6*' 8/%+ 6/$ /+4 '+6'3 / +'2 :/8' 0E)* /0 a"/+E/&10'3J+$#/34%+,bD
TD
X%+4 6*' +'2&- )3'/6'4 @3#7%&' /0 / )*%&4 6# 6*' .')E3%6- +#4' #+ 6*' &'76 */+4 0%4'D K+ 6*' 8/%+ 0)3''+ )&%)G 6*' 6/$' a9E6*'+6%)/6%#+b /+4 6*'+ )&%)G 6*' $E66#+ a:'2bD
ND
9 +'2 0)3''+ 2%&& /@@'/3 %+ 4%/,E'D X3#8 6*' @E&& 4#2+ #@6%#+ 0'&')6 a:#.')[#,%+"#4E&'b /+4 )&%)G aJgbD
9@3%& ABCA
CN
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
96 6*%0 06/,' 2' +#2 */<' / 0')E3%6- @3#7%&' 2%6* +# 0')E3%6- 3'`E%3'8'+60D J7 )#E30' %+ @3#4E)6%#+ -#E 2#E&4 +#6 */<' 6*%0 /+4 2#E&4 0'&')6 / 063#+, &'<'& #7 /E6*'+6%)/6%#+D X#3 6*' @E3@#0' #7 #E3 /@@&%)/6%#+ /+4 / 4'<'@8'+6 '+<%3#+8'+6 %6 8''60 #E3 +''40D X#3 8#3' %+7#38/6%#+ #+ JM5Q.15 0')E3%6- #@6%#+0 @&'/0' 3'7'3 6# 6*' /@@3#@3%/6' *'&@ 4#)E8'+6/6%#+ *'3'n •
*66@nQQ%+7#)'+6'3D0-$/0'D)#8Q*'&@Q%+4'FD^0@r6#@%)sQ)#8D0-$/0'D%+7#)'+6'3D4)BCACADBCNAQ4#)Q*68&Q 8`ECAVTNTNTCATTAD*68&
6.2 Create Application (*' +'F6 06'@ %0 6# )3'/6' /+ /@@&%)/6%#+ #$^')6 %+ .15 .?? 3'@3'0'+6%+, #E3 "#$%&' /@@&%)/6%#+D (*%0 %0 6*' G'- /0 %0 /& E0 6# 0@')%7- 6*' 0')E3%6- @3#7%&' /+4 )#++')6%<%6- 1U[0 @#%+6%+, 6# =/6'2/-D J6*'3 #@6%#+0 )/$ $' )#+7%,E3'4 *'3' 0E)* /0 S34 @/36- 8'00/,%+, )#++')6%#+0 &%G' 95:.D (*%0 06'@ )3'/6'0 / 6'8@&/6' 6*/6 2' )/+ $%+4 /@@&%)/6%#+ E0'30 6# %+ 6*' +'F6 06'@D CD AD
K+ .?? )&%)G #+ 6*' a9@@&%)/6%#+0b +#4' %+ 6*' &'76 */+4 %+4'FD K+ 6*' a9@@&%)/6%#+0b 6/$ #+ 6*' 3%,*6 */+4 0%4' )&%)G #+ a:'2bD
SD
K+ 6*' 4%/,E' $#F 7%&& %+ 6*' 4'6/%&0 /0 @'3 $' E0%+, a=/6'2/-qX&%,*6q5E0*bD X#3 6*' 0')E3%6)#+7%,E3/6%#+ 0'&')6 6*' @3#7%&' -#E )3'/6'4 %+ 6*' @3'<%#E0 06'@ a"/+E/&10'3J+$#/34%+,b /+4 0'&')6 / &%4 4#8/%+D K6 %0 %8@#36/+6 6# 0'&')6 6*' a?#+7%,E3' /44%6%#+/& 0'66%+,0b /6 6*' $#66#8 /+4 6*' )&%)G a:'F6bD
9@3%& ABCA
CV
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
TD
K+ 0)3''+ 0*#2+ -#E +''4 6# 8/%+6/%+ 6*' 53#F- 6/$ 0'66%+,0 /+4 '+6'3 6*' 1U[ @#%+6%+, 6# -#E3 =/6'2/- 0'3<%)'D (*%0 0)3''+ )3'/6'0 / 6'8@&/6' 6*/6 2' 2%&& E0' /0 2' /44 4'<%)' E0'30 %+ 0E$0'`E'+6 06'@0D /5;& '"(& "> (M& (&%.25(& '5%&[ 5, F& F-22 $,& (M-, -' (M& '&4( ,(&.8 /&%.25(& S5%& l a=/6'2/-qX&%,*6q5E0*q4'7/E&6q"/+E/&10'3J+$#/34%+,b "/%+6/%+ 6*' 7#&%+, 1U[0 %+ 6*' a5UJZob 6/$D ;*-r L#6* 6*' /@@&%)/6%#+ '+4@#%+6 /+4 @E0* '+4@#%+6 &E'0 2%&& $' 4-+/8%)/&&- 3'63%'<'4 $- 6*' )&%'+6 /@@&%)/6%#+ /6 3E+6%8' 6# @3#<%4' &/+40)/@' /$063/)6%#+D (*%0 )#E&4 $' m9 #3 53#4E)6%#+ /+4 %6 /& -#E 6# /$063/)6 $'62''+ 6%'30D •
•
9@3%& ABCA
9@@&%)/6%#+ I+4@#%+6 l (*%0 %0 6*' =/6'2/- 1U[ #E3 /@@&%)/6%#+ %0 $#E+4 6#D K+ #E3 )/0' 6*%0 %0 6*' 7&%,*6 0'3<%)' 0*%@@'4 2%6* /&& =/6'2/- %+06/+)'0D K6 3'@3'0'+60 6*' 06/36%+, @&/)' 7#3 -#E3 /@@&%)/6%#+ 73#8 2*%)* /6 3E+6%8' -#E3 )&%'+6 /@@&%)/6%#+ 2#E&4 0E77%F ?#&&')6%#+0 #3 t8'6/4/6/ )/&&0 6# 3'63%'<' /+4 +/<%,/6' 6*3#E,* -#E3 /@@&%)/6%#+D *66@nQQ=9(I;9oYJ.(n5JU(Q0/@Q#@EQ04/6/QK;X:MQU"(.9"5[IX[K=Y( 5E0* I+4@#%+6 _ (*%0 %0 6*' .15 '+63- @#%+6 7#3 %+$#E+4 +#6%7%)/6%#+0 )#8%+, 73#8 =/6'2/-D 5&'/0' #G /6 6*' )*/@6'3 a:#6%7%)/6%#+ U#E6%+, IF@&/%+'4u 6# 0'' *#2 6*%0 %0 E0'4 /6 3E+6%8' /+4 8/@@'4 6# 4'<%)' 2*'+ 6*' +#6%7%)/6%#+ /33%<'0 %+ .15D 9&0# 6*%0 /443'00 2%&& 8/6)* 6*' ."NP 4'06%+/6%#+ )3'/6'4 $- 6*' =/6'2/- 948%+%063/6#3D *[email protected].(niBBBQ=;?Q.15:#6%7%)/6%#+
Cj
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
L'7#3' -#E )&%)G aX%+%0*b */<' / #G /6 6*' 95:. /+4 L&/)G$'33- 5E0* :#6%7%)/6%#+ 6/$0D (*%0 2#E&4 $' 2*'3' -#E )#+7%,E3' )#++')6%<%6- 6# 6*'0' 0'3<%)'0D X#3 9+43#%4 2' #+&- 0E@@#36 #+&%+' @E0*Q@E&& /+4 6*'3'7#3' 2' 4# +#6 +''4 6# 8/%+6/%+ 6*'0'D ?&%)G aX%+%0*bD o#E3 +'2&- )3'/6'4 /@@&%)/6%#+ 0*#2 %0 +#2 <%0%$&' /+4 %7 -#E )&%)G a9@@&%)/6%#+ ?#++')6%#+ ('8@&/6'b 6/$ -#E 2%&& 0'' / +'2 6'8@&/6' )3'/6'4 %+ 6*%0 06'@D
6.3 Create Application Connection :#2 6*/6 2' */<' /+ /@@&%)/6%#+ )3'/6'4 2%6* / E0'7E& 6'8@&/6'H 2' )/+ +#2 8/+E/&&- #+$#/34 E0'30D (*%0 E0'3 2%&& 3'@3'0'+6 6*' 8#$%&' 4'<%)' E0'3D ;' 4# 6*%0 $- )3'/6%+, aU',%06'3%+,b /+4 a9@@&%)/6%#+ ?#++')6%#+bD CD AD
K+ 6*' a9@@&%)/6%#+0b 0)3''+ )&%)G #+ 6*' a9@@&%)/6%#+ ?#++')6%#+0b 6/$D ?&%)G 6*' aU',%06'3b $E66#+D
SD
J+ 6*' 0)3''+ @3#<%4'4 '+6'3 / E0'3+/8' 2' 2%&& E0' /6 3E+6%8'D :#6' 6*%0 %0 E0'3 %0 +#6 6*' ,/6'2/- 9L95 E0'3 $E6 / /$063/)6'4 4'<%)' E0'3 2*%)* 2%&& $' 0@')%7%'4 %+ 4'<%)' /@@&%)/6%#+D
9@3%& ABCA
Ci
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
TD
J+ 6*' 0)3''+ @3#<%4'4 0'&')6 6*' 6'8@&/6' 2' )3'/6'4 '/3&%'3D (*%0 2%&& @3'_7%&& 8/+- 7%'&40 /+4 $%+4 6*' )#++')6%<%6- @/3/8'6'30 %+ $/)G,3#E+4D
ND
J+ 6*' 0)3''+ @3#<%4'4 )*')G 6*' a.@')%7- /)6%6%#+ )#4'b 3/4%# $#F /+4 8/%+6/%+ /+ /)6%6%#+ )#4' 0E)* /0 a/$)bD ;' 2%&& E0' 6*'0' &E'0 %+ 6*' 9+43#%4 ^/ )#4' &/6'3v
CD
?&%)G 6*' aJgbD
AD
J+)' 6*%0 06'@ %0 )#8@&'6' -#E )/+ +#2 0'' -#E3 E0'3 */0 $''+ #+_$#/34'4 8/+E/&&-D :#6%)' 6*/6 6*' .6/6E0 %0 a5'+4%+, 9)6%6%#+bD (*%0 2%&& */@@'+ /6 3E+6%8' #+)' 6*' 4'<%)' )#++')60 6# .15 E0%+, 6*' J4/6/Q.15 &%$3/3%'0D o#E )/+ /&0# 0'' a5'+4%+, K6'80b %+ 6*' `E'E'D ;' 2%&& 0'' *#2 6*%0 )*/+,'0 #+)' 2' ,'6 /+ /@@&%)/6%#+ 3E++%+,D
SD
?&%)G #+ 6*' a53#@'36%'0b $E66#+D J+ 6*' 0)3''+ 4%0@&/-'4 -#E 2%&& 0'' 6*' @3#@'36%'0 8/%+6/%+'4 '/3&%'3 2*'+ 2' )3'/6'4 6*' 6'8@&/6'D "/G' 0E3' 6*' '+4@#%+6 *#060 +/8'0 /3' )#33')6 /+4 2%&& $' /))'00%$&' 73#8 -#E3 .15 0'3<'3 /+4 M'<%)' #3 4'<'@8'+6 '+<%3#+8'+6D
9@3%& ABCA
CP
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
7. Configuring the Development Environment :#2 6*/6 2' */<' / =/6'2/- 0'3<%)' 3'/4- /+4 6*' )#+7%,E3/6%#+ %+ .15QJM5 %0 )#8@&'6' &'60 #G /6 6*' 06'@0 3'`E%3'4 6# ,'6 /+ 9+43#%4 /@@&%)/6%#+ 2#3G%+,D (*' 7%306 06'@ %0 6# 0'6 E@ -#E3 4'<'@8'+6 /+4 )#33')6&- 3'7'3'+)' 6*' .15QJ4/6/ .Mg &%$3/3%'0D
7.1 Download the IDE CD
M#2+/4 6*' ]/ .6/+4/34 I4%6%#+ cV 1@4/6' ATd M'<'@8'+6 g%6 73#8 6*' 7#&%+, 1U[n *66@nQQ222D#3/)&'D)#8Q6')*+'62#3GQ^/
AD
M#2+/4 I)&%@0' Y'&%#0 cSDVDAd 73#8 6*' 7#&%+, 1U[n *66@nQQ222D')&%@0'D#3,Q4#2+/40Q
SD
.6/36 6*' I)&%@0' '+<%3#+8'+6 /+4 @'37#38 6*' 7#&%+,n •
•
•
?&%)G P==D K+ 6*' 944 U'@#0%6#3- 4%/,H '+6'3 / S5%& 7#3 6*' +'2 @&E,%+D
•
I+6'3 #+' #7 6*' 7#&%+, 7#3 IRZn
•
*66@0nQQ4&_00&D,##,&'D)#8Q/+43#%4Q')&%@0'Q
•
*66@nQQ4&_00&D,##,&'D)#8Q/+43#%4Q')&%@0'Q
•
?&%)G K]D
•
.'&')6 6*' !&N&2".&+ /""2, )*')G$#F /+4 )&%)G S&4(D
•
U'<%'2 6*' 6##&0 6# $' 4#2+/4'4D
•
?&%)G S&4(D
•
•
9@3%& ABCA
X3#8 6*' \&2. 8'+EH 0'&')6 6',(522 S&F 1">(F5+&D
U'/4 /+4 /))'@6 6*' &%)'+0' /,3''8'+6 /+4 )&%)G ^-'-,MD J+)' 6*' %+06/&&/6%#+ %0 )#8@&'6'H 3'06/36 I)&%@0'D
AB
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
7.2 Setting up the Android SDK Manager (*' 9+43#%4 .Mg "/+/,'3 */+4&'0 6*' 9+43#%4 &%$3/3- <'30%#+0 0@')%7%) 6# / 4'<%)' JD. 3'&'/0' &%G' ADA '6)D o#E +''4 6# 4#2+/4 6*%0 /+4 %+06/&& 6*' 3'`E%3'4 &%$3/3%'0 %+ #E3 )/0' ADAD J+)' 2' */<' 4#+' 6*%0 2' )/+ %+6',3/6' %6 %+6# #E3 I)&%@0' '+<%3#+8'+6D CD AD SD
M#2+/4 6*' 9+43#%4 .Mg "/+/,'3 $/0'4 #+ -#E3 0-06'8 3'`E%3'8'+60 73#8 6*' 7#&%+, 1U[n *66@nQQ4'<'@'3D/+43#%4D)#8Q04GQ%+4'FD*68& M#2+/4 6*' O%@ 7%&' 0E)* /0 /+43#%4_04Gq3CN_2%+4#20DO%@D 1+O%@ 6*' /3)*%<' 6# / )/6%#+ #7 -#E )*##0%+,D
TD
K+ 6*' I)&%@0' '+<%3#+8'+6H 73#8 6*' ;%+4#2 8'+EH 0'&')6 @+&>&+&'#&,D
ND
K+ 6*' &'76 +/<%,/6%#+ @/+'H 0'&')6 6*' P'=+"-= +#4'D
VD
?&%)G 9+"F,& 6# 0'/3)* 7#3 6*' )/6%#+ 2*'3' -#E */<' 06#3'4 6*' 9+43#%4 .MgD
jD
?&%)G P..20 /+4 K]D
9@3%& ABCA
AC
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
7.3 Update you Android SDK with 2.2 API 8 Libraries CD
K+ 6*' I)&%@0' '+<%3#+8'+6H 73#8 6*' ;%+4#2 8'+EH 0'&')6 P'=+"-= 1!] Y5'5<&+D
AD
(*' /%&/$&' 9+43#%4 &%$3/3%'0 2%&& $' &%06'4D
SD
?*')G P'=+"-= :8: /+4 /+- #6*'3 @/)G/,'0 -#E 2%0* 6# 4#2+/4D o#E 8/- 2/+6 6# )3'/6' /+ 9+43#%4 /@@&%)/6%#+ 7#3 / 4'<%)' 2%6* / &/6'3 #@'3/6%+, 0-06'8 <'30%#+D K6 %0 E@ 6# -#E 6# 4')%4' 2*/6 -#E +''4 *'3'D Kf<' E0'4 ADA 7#3 / $/0%) /@@&%)/6%#+D
TD
?&%)G 6',(522 @5#;5<&,
7.4 Create an Android Project ;' /00E8' -#E */<' / $/0%) E+4'306/+4%+, #7 )3'/6%+, 9+43#%4 @3#^')60 /+4 /3' 7/8%&%/3 2%6* 9+43#%4 @3#,3/88%+,D (*' @E3@#0' #7 6*%0 4#)E8'+6 %0 +#6 6# 'F@&/%+ 9+43#%4 $'06 @3/)6%)'0 $E6 3/6*'3 4'8#+063/6' 6*' G'- 95%f0 /+4 8'6*#4#,- /00#)%/6'4 2%6* %+6',3/6%+, .15 /+4 :'6;'/<'3 =/6'2/- 7#3 0E$0)3%@6%#+ /+4 +#6%7%)/6%#+ 0)'+/3%#0D CD
X3#8 6*' 6##&$/3H 0'&')6 S&F _w @+"_(_wP'=+"-=_wP'=+"-= @+"_(D
AD
K+ 6*' :'2 9+43#%4 53#^')6 2%O/34H 0'&')6 ?3'/6' +'2 @3#^')6 /+4 '+6'3 6*' @3#^')6 +/8' E5(&F50^2-
9@3%& ABCA
AA
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
SD
?&%)G S&4(D
TD
.'&')6 6*' W$-2= (5+<&( 73#8 6*' 9+43#%4 U'&'/0' [%$3/3%'0 -#E 4#2+/4'4 %+ 6*' @3'<%#E0 06'@D ID,D 9+43#%4 ADA 95K iD
ND
?&%)G S&4(8
VD
I+6'3 / 0E%6/$&' @/)G/,' +/8' &%G' #,58,5.8#"%D K7 -#E 2#E&4 &%G' 6# E0' #E3 0/8@&' )#4' K 0E,,'06 -#E 06%)G 6# )0/D0/@D)#8 6*/6 2/- -#E )/+ '/0%&- )#@- /+4 @/06' 6*' )&/00'0 %+6# -#E3 @3#^')6 2%6* &%66&' /&6'3/6%#+D
9@3%& ABCA
AS
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
jD
?&%)G ^-'-,M8
o#E 2%&& +#2 */<' /+ '8@6- @3#^')6 6*/6 3'@3'0'+6 6*' 06/36%+, @#%+6 7#3 4'<'@8'+6D (*' +'F6 06'@ %0 6# /44 6*' .95 0*%@@'4 &%$3/3%'0 0@')%7%) 6# J4/6/ .Mg /+4 .15D
9@3%& ABCA
AT
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
7.5 Importing Libraries to your Android Application Project CD
K+ -#E3 KMI @3#^')6 063E)6E3' )3'/6' / 7#&4'3 )/&&'4 2-W8
AD
?#@- 6*' .15QJ4/6/ .Mg [%$3/3%'0 )'+63/&&- 73#8 6*' 7#&%+, )/6%#+n x1+2%3'45&/67#38qK+06/&&M%3wy"#$%&'.MgyJM/6/y9+43#%4y&%$3/3%'0y • • • • • • • •
0E@_^0#+D^/3 ?&%'+6[%$D^/3 .1553#F-?&%'+6D^/3 .M"?/)*'D^/3 .M"?#88#+D^/3 .M"?#++')6%<%6-D^/3 .M"5/30'3D^/3 .M"5'30%06'+)'D^/3
K+ 6*' KMI %8@#36 6*' 7%&'0 6# -#E3 @3#^')6 E+4'3 6*' 4%3')6#3- 2-W8 o#E )/+ 4# 6*%0 $- 0'&')6%+, 2-W /+4 3%,*6 )&%)G 6# 7%+4 6*' 8'+E %6'8 6Y@KR/8 .'&')6 73#8 ^-2& 10,(&% /+4 @#%+6 6# 6*' @*-0%)/& 7%&' )/6%#+0D "/G' 0E3' 6*'- /3' *%,*&%,*6'4D o#E 0*#E&4 '+4 E@ 2%6* / @3#^')6 063E)6E3' 0%8%&/3 6*' %8/,' $'D
9@3%& ABCA
AN
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
7.6 Setting Project Properties :#2 6*/6 #E3 &%$3/3%'0 /3' %+ #E3 @3#^')6 063E)6E3' 2' +''4 6# 0'6 6*' @3#^')6 @3#@'36%'0 /+4 $E%&4 @/6* 0# 6*'- /3' 3'7'3'+)'4 )#33')6&-D CD
?&%)G #+ 6*' 6#@ +#4' #7 -#E3 @3#^')6 %+ 6*' &'76 */+4 %+4'F /+4 3%,*6 )&%)G 6# 0'&')6 @+".&+(-&,8
AD
.'&')6 `5N5 9$-2= @5(M 73#8 6*' %+4'F /+4 0'&')6 6*' Z-W+5+-&, 6/$ #+ 6*' 8/%+ 0)3''+ 6# 6*' 3%,*6D
SD
.'&')6 P== `PR,a $E66#+H )/6' /+4 *%,*&%,*6 /&& 6*' ]/3 7%&'0 73#8 %+ 6*' +'2&- )3'/6'4 2-W 0E$4%3')6#3-D
CD
?&%)G K]8
AD
?&%)G 6*' K+=&+ 5'= 34."+( 6/$ /+4 0*#E&4 +#2 0'' -#E ]/3 7%&'0 /3' /%&/$&' 7#3 0'&')6%#+D
SD
.'&')6 6*' 62# @3#^')6 =/6'2/-X&%,*65E0* %6'80 /+4 0'&')6 9"(("%8
TD
?*')G 6*' 3/4%# $#F'0 7#3 /&& 6*' &%$3/3%'0 -#E ^E06 %8@#36'4 %+6# 6*' 2-W 4%3')6#3-D
ND
?&%)G K]8
o#E /3' +#2 3'/4- 6# 06/36 4'<'@%+, -#E3 .15QJM5 =/6'2/- '+/$&'4 /@@&%)/6%#+D (*%0 @3#)'00 %0 6*' 0/8' 7#3 '<'3- @3#^')6 0# %6 8/G'0 0'+0' 6# )#@- 6*' &%$3/3- 7%&'0 0#8'2*'3' */+4-D JE3 +'F6 )*/@6'3 2%&& #G /6 6*' 95Kf0 /%&/$&' /+4 6*' ,'+'3/& @3#)'00 7#3 4'<'@%+, /+ /@@&%)/6%#+ 2%6* 0E$0)3%@6%#+ /+4 +#6%7%)/6%#+ 0)'+/3%#0D 5&'/0' 3'7'3 6# 6*' 'F/8@&' @3#^')6 )*/@6'3 6# 0'' *#2 6# @&E, %+ 6*' 0*%@@'4 )#4' 0/8@&' %+6# 6*' 063E)6E3' -#E ^E06 )3'/6'4 /$#<'D (*' ?*/@6'3 4'<'@%+, -#E3 /@@&%)/6%#+ 6/&G0 /$#E6 6*' $/0%) 06'@0 /+4 6*' /@@3#/)* 2%6*#E6 06'@@%+, 6*3#E,* )#@-Q@/06'H 2*%)* %0 +#6 6*' /%8 *'3'D
9@3%& ABCA
AV
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
8. Developing your Application :#2 2' /3' 3'/4- 6# 4'<'@ /+ /@@&%)/6%#+ /+4 6/&G /$#E6 6*' 95Kf0 /%&/$&' 6# %+6',3/6' /+4 9+43#%4 /@@&%)/6%#+ 2%6* .15 /+4 =/6'2/-D (*%0 )*/@6'3 2%&& 6/&G /$#E6 6*' 06'@0 /+4 )#4' 'F/8@&'0 %+ %0#&/6%#+D K6 4#'0 +#6 ,# %+6# $'06 @3/)6%)' 7#3 9+43#%4 /@@&%)/6%#+ 4'0%,+D (*' 0/8@&' /@@&%)/6%#+ /00#)%/6'4 2%6* 6*%0 4#)E8'+6 %0 @E3'&- / 4'8#+063/6%#+ #7 *#2 6*' )#4' )/+ $' 'F')E6'4D X#3 @3#4E)6%<' 0)'+/3%#0 %6 %0 3')#88'+4'4 +#6 6# E0' 6*%0 'F/8@&' /0 %6 4#'0+z6 )/6'3 7#3 0')E3%6-H 06/6' )*/+,'H @'30%06'+)'H 8#4'& <%'2 )#+63#& @/66'3+0 '6)D K6 %0 ^E06 /+ IZ9"5[ID Y#2 -#E &'<'3/,' "R? /+4 &%06'+'3 )&/00'0 %0 E@ 6# -#ED o#E 8/- 2/+6 6# 0'@/3/6' 6*%0 8#3' /+4 @3#<%4' / 08/&&'3 E+%6 #7 #@'3/6%#+ /+4 %6 2#E&4 $' 3')#88'+4'4 2*'+ )#+0%4'3%+, @3#4E)6%<' 0)'+/3%#0D (*%0 )*/@6'3 )/+ $' 3'7'3'+)'4 2%6* 06'@0 #3 95Kf0 &%06'4 %+ 6*' .-$/0' Y'&@ ;'$0%6' *'3'n *66@nQQ%+7#)'+6'3D0-$/0'D)#8Q*'&@Q6#@%)Q)#8D0-$/0'D%+7#)'+6'3D4)BCjBiDBACAQ4#)Q*68&Q+G3CSCNVjVVPSPCAD* 68&
8.1 A typical application (*' 06/+4/34 J4/6/Q.15Q=/6'2/- '+/$&'4 /@@&%)/6%#+ 7#& 0%8%&/3 @3#)'00 #3 @/66'3+ %+4'@'+4'+6 #7 /+- 0E$0)3%@6%#+ /+4 +#6%7%)/6%#+ 3'`E%3'8'+6D (*' 7#&%+, 06'@0 *%,*&%,*6 6*' /@@3#/)* 2%6* 6*' 0E$0'`E'+6 0')6%#+0 ,%<%+, 8#3' 4'6/%& @'3 06'@D K */<' &'76 #E6 0#8' #@6%#+/& 06'@0H 2*%)* '8$3/)' /&6'3+/6' 0')E3%6- /+4 @'30%06'+)' /)6%<%6%'0 /+4 @#00%$&' 97/3%/ %+6',3/6%#+D 5&'/0' 3'7'3 6# 6*' *'&@ 4#)E8'+6/6%#+ 8'+6%#+'4 /$#<' 6# E+4'306/+4 2*/6 @#00%$%&%6%'0 'F%06D 78
6'-(-52-b5(-"' .15 J+$#/34%+, U',%06'3 7#3 5E0* :#6%7%)/6%#+0 c[#+, 5#&&d U'63%'<' I+4@#%+60 .6/36%+, 6*' )&%'+6
• • • •
:8
G522-'< E5(&F50 1&+N-#&, ='6 .'3<%)' M#)E8'+6 ='6 "'6/4/6/ M#)E8'+6 ='6 M/6/ cX&%,*6 ?#&&')6%#+d M%0@&/-
• • • •
?8
G+&5(-'< X !&2&(-'< 1$W,#+-.(-"', ?3'/6' .E$0)3%@6%#+ M'&'6' .E$0)3%@6%#+
• •
C8
R&-N-'< S"(->-#5(-"', ?/@6E3%+, %+$#E+4 +#6%7%)/6%#+0
•
9@3%& ABCA
Aj
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
8.2 Initialization (*' %+%6%/&%O/6%#+ @*/0' 06/36 6*' /@@&%)/6%#+ /+4 '06/$&%0*'0 )#++')6%#+ 6# .15 2%6* /44%6%#+/& 3',%063/6%#+ /)6%<%6%'0D ;' 2%&& 06'@ 6*3#E,* '/)* #7 6*'0' /+4 0*#2 0#8' 0/8@&' )#4' 7#3 '/)*D U'8'8$'3 6*' 0/8@&' /@@&%)/6%#+ /00#)%/6'4 2%6* 6*%0 4#)E8'+6 4'8#+063/6'0 *#2 6*'- /&& 2#3G 6#,'6*'3 %+ 0'`E'+)' $#E+4 6# / E0'3 %+6'37/)'D L'7#3' 2' '<'+ )#++')6 -#E 8E06 %+%6%/&%O' 6*' #$^')60 #3 &%$3/3%'0 2' %8@#36'4 @3'<%#E0&-D X3#8 6*' 6#6/& .Mg &%$3/3%'0 /%&/$&' 6*' 7#&%+, 2%&& $' E0'4 %+ #E3 /@@&%)/6%#+D
o#E )/+ 0'' 73#8 6*' )#4' 0+%@@'6 /$#<' 2' +''4 6# %+%6%/&%O' 6*' #$^')60 6*/6 2%&& $' E0'4 %+ 6*' @3#^')6H 0E)* /0 @3'7'3'+)'0H ,,'3H @/30'3H )/)*'H @/3/8'6'30 /+4 3'`E'06 8/+/,'3D (*'- 2%&& $' E0'4 /6 &'+,6* 4E3%+, #E3 %+6'3/)6%#+ /+4 )/&&%+, #7 =/6'2/- 0'3<%)'0D Kf<' )3'/6'4 / 8'6*#4 6# 23/@ 6*'0' 06'@0 +'/6&$E6 6*'3' %0 +#6*%+, 06#@@%+, -#E 73#8 @E66%+, 6*%0 %+6# #+'D Y#2 -#E 0',8'+6 -#E3 )#4' %0 E@ 6# -#ED
9@3%& ABCA
Ai
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
8.2.1 SUP Onboarding 90 2' /3' E0%+, .15 %+ 6*%0 0#&E6%#+ 2' +''4 3',%06'3 6*' 4'<%)'QE0'3 2%6* .15 /6 3E+6%8' E0%+, 6*' 8/6)*%+, /)6%6%#+ )#4' /+4 E0'3 2' )3'/6'4 8/+E/&&- %+ .15D Y/<' / #G /6 6*' )#4' 0+%@@'6 /+4 0'' *#2 %0 %6 'F')E6'4D o#E )/+ 0'' 2' )*')G 6# 0'' %7 6*' 4'<%)' %0 /&3'/4- 3',%06'3'4 2%6* 6*' L##&'/+ )*')GD
U'8'8$'3 6*' a9+4-Q/$)b E0'3 /+4 /)6%6%#+ )#4' )#8$%+/6%#+r Y'3' %0 2*'3' %6 %0 E0'4D
9@3%& ABCA
AP
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
8.2.2 Start the client K+ 6*' 0/8' 0',8'+6 #7 )#4' 2' 06/36 6*' )&%'+6 6# %+%6%/6' 6*' )#88E+%)/6%#+0 0E)* 6*/6 6*' 8'00/,'0 %+ 6*' @'+4%+, `E'E' #7 6*' /@@&%)/6%#+ )#++')6%#+ 7#3 6*' ,%<'+ 4'<%)' /3' 0'+6 6# 6*' /@@&%)/6%#+D K6 %0 #++' &%+' #7 )#4'D K7 6*' 4'<%)' */0 /&3'/4- $''+ 3',%06'3'4 6*' )&%'+6 +''40 6# $' 06/36'4 'F@&%)%6&-D K7 %6 */0 +#6 $''+ 3',%06'3'4 6*' 8'00/,%+, */@@'+0 /E6#8/6%)/&&- 2*'+ -#E )/&& 6*' 3',%063/6%#+ 8'6*#4 /+4 0# %0 +#6 +''4'4D .'' $'D
9@3%& ABCA
SB
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
8.2.3 Register for Push Notifications (Long Poll) K+ 6*' 0/8' 0',8'+6 #7 )#4' 2' +''4 6# 3',%06'3 6*' /@@&%)/6%#+ 7#3 +#6%7%)/6%#+0D K6 %0 /0 0%8@&' /0 #+' &%+ #7 )#4' $E6 %6 6')*+%)/&&- G%)G0 #77 / +, @#&& 2*%)* )#+6%+E#E0&- 0'+40 / 3'`E'06 6# .15 '<'3- N 8%+E6'0 0# .15 )/+ 0'+4 +#6%7%)/6%#+0 $/)G /0 @/36 #7 6*' 3'0@#+0'D (*%0 2/0 4%0)E00'4 %+ 6*' )*/@6'3 aL/)G,3#E+4 K+7#38/6%#+ l 5E0* < 5E&&bD o#E )/+ 0'' 6*/6 2' @/00 a6*%0b 6# 6*' 8'6*#4D (*%0 6'&&0 6*' @3#,3/8 6*/6 6*%0 )&/00 2%&& &%06'+ 7#3 +#6%7%)/6%#+0 <%/ / 0@')%7%) 8'6*#4D 90 8'+6%#+'4 @3'<%#E0&- -#E )/+ %8@&'8'+6 -#E3 #2+ 0'@/3/6' )&/00 6# G''@ 6*' 0%O' 3'/0#+/$&' /+4 %8@3#<' /+43#%4 /@@&%)/6%#+ 4'0%,+D ;' 2%&& 6/&G /$#E6 6*%0 %+ 6*' +'F6 )*/@6'3D
K7 -#E 3'/&&- 2/+6'4 6# 0'' *#2 6*%0 2#3G0 -#E )#E&4 0'6 E@ / *66@ 63/)' @3#,3/8 6# 0%6 $'62''+ .15 /+4 6*' 4'<%)' /+4 &%06'+ #+ 6*' NBBB @#36 7#3 Y((5D
9@3%& ABCA
SC
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
8.2.4Retrieve Endpoints K+ 6*' 0/8' 0',8'+6 #7 )#4' 2' +''4 6# 3'63%'<' 6*' 62# 1U[0 6*/6 2'3' 8/%+6/%+'4 8/+E/&&- $- 6*' .15 948%+%063/6#3D U'8'8$'3 2' 4%4 6*%0 %+ 6*' .15 )#+7%,E3/6%#+ 06'@0r J+)' 3'63%'<'4H 2' 0/<' 6*'8 6# )/& 3%/$&'0 /+4 E0' 6*'8 &/6'3D K6 %0 E@ 6# 6*' 4'<'@'3 6# 0/<' #3 ^E06 )*')G 6*' '+4@#%+6 '/)* 6%8'D (*' .Mg #77'30 / &%06'+'3 6# +#6%7- 6*' )&%'+6 /6 3E+6%8' %7 / )*/+,' %+ 6*' 1U[0 */0 6/G'+ @&/)'D K6 %0 E@ 6# -#E 6# %8@&'8'+6 2*/6 %0 0E%6/$&' 7#3 -#E3 /@@&%)/6%#+ 4'0%,+ $'06 @3/)6%)'D P..2-#5(-"' 3'=."-'( X#3 6*' 9@@&%)/6%#+ I+4@#%+6 #3 =/6'2/- .'3<%)' M#)E8'+6 1U[ 2' )/+ 6*'+ 4-+/8%)/&&- $E%&4 1U[0 /6 3E+6%8' 2%6* @/36%)E&/3 0E77%F'0 6# )/&& 0'3<%)' %+ 6*' 2/- 2' 2%0*D (*' 'F/8@&' )/+ $' 0''+ $'D 9@@&%)/6%#+ 1U[ s *66@nQQ,/6'2/-0'3<'3n@#36Q0/@Q#@EQ04/6/QK;X:MQU"(.9"5[IX[K=Y( (*'+ 2' )/+ $E%&4 6*%0 %+6# 3%#E0 )#8$%+/6%#+0 /6 3E+6%8' 0E)* /0 n • •
9@@&%)/6%#+ 1U[ W aQX&%,*6?#&&')6%#+b 9@@&%)/6%#+ 1U[ W aQL##G%+,?#&&')6%#+b
@$,M 3'=."-'( (*' 5E0* '+4@#%+6 2%&& $' E0'4 &/6'3 2*'+ 2' )3'/6' / 0E$0)3%@6%#+D ;' 2%&& 4-+/8%)/&&- %+0'36 %6 %+6# 6*' @/-/4 #7 / 0E$0)3%@6%#+ 3'`E'06 0# %+ =/6'2/- 6*' +#6%7%)/6%#+ 2%&& )#8' $/)G 6# 6*' )#33')6 .15 &/+40)/@' 4'@'+4'+6 1U[D
9@3%& ABCA
SA
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
8.3 Calling Gateway Services 96 3E+6%8' 6*' 9+43#%4 /@@&%)/6%#+ 2%&& +''4 6# %+6'3/)6 2%6* =/6'2/- 0'3<%)'0D (# 4# 6*%0 2' +''4 6# E0' 6*' )#++')6%<%6- &%$3/3%'0 6# $E%&4 J4/6/ 3'`E'060 /+4 0'+4 6*'8 '%6*'3 /0 / $/6)* c0-+)*3#+#E0&-d #3 %+ %0#&/6%#+D (*' @3#)'00 %0 /&2/-0 6*' 0/8' 2%6* '<'3- J4/6/ /@@&%)/6%#+ 3E++%+, 6*3#E,* .15D o#E +''4 6# /&2/-0 3'63%'<' 6*' .'3<%)' M#)E8'+6H 6*'+ 3'63%'<' 6*' 8'6/4/6/ 4#)E8'+6 /+4 7%+/&&'F')E6' M/6/ )/&&0 6# @'37#38 ?U1M #@'3/6%#+0 2%6* -#E3 /)6E/& 0'3<%)'D ;' +''4 6# ,'6 6*' 0'3<%)' 4#)E8'+6 /+4 8'6/4/6/ 4#)E8'+6 7%306 /0 6*%0 *#&40 %8@#36/+6 0)*'8/ %+7#38/6%#+ 7#3 6*' 0E$0'`E'+6 )#&&')6%#+ )/&&0D 90 /+ 'F/8@&' 6*'3' %0 +# @#%+6 )/&&%+, / X&%,*6 ?#&&')6%#+ 2*'+ -#E 4#+z6 '<'+ G+#2 2*/6 6*' 063E)6E3' #7 / X&%,*6 8/- $'D .# %60 %8@#36/+6 6# 'F')E6' 6*'0' %+ / @/36%)E&/3 #34'3 /+4 )#+63#& %6 0'`E'+6%/&&-D Y#2 %0 6*%0 4#+'r 10%+, 6*' 95Kf0 2' '/0%&- $E%&4 3'`E'06 /+4 0'+4 6*'8 6# 6*' 3'`E'06 8/+/,'3D (*' %8@#36/+6 6*%+, 6# +#6' *'3' %0 6*' 3'`E'06 %0 +#6 0-+)*3#+#E0 73#8 6*' )#4' @'30@')6%<'D o#E 0)*'4E&' / )/&& /+4 'F')E6' /+4 6*'+ %8@&'8'+6 /+ #+.E))'00 /+4 #+I33#3 8'6*#4 6# )/@6E3' 6*' 3'0@#+0' 73#8 .15 /+4 =/6'2/-D (*'0' 8'6*#40 #3 &%06'+'3 )&/00 )/+ $' 0'@/3/6' 6# 6*' #+' 2' */<' E0'4D 9&& )/&&0 /3' /0-+)*3#+#E0 73#8 / )#4%+, @'30@')6%<' 3'&'/0%+, 6*' 9+43#%4 /@@&%)/6%#+ 6# @'37#38 #6*'3 /)6%<%6%'0D J<'3 6*' 2%3' %6 %0 06%&& / 0-+)*3#+#E0 )/&&D (*' +'F6 0')6%#+ 'F@&/%+0 6*%0 %+ 4'6/%&D
8.3.1 Call the Service Document ;*'+ -#E )3'/6' /+ 9+43#%4 /@@&%)/6%#+ 7#3 E0' 2%6* .15 h =/6'2/- -#E +''4 6# 4'6'38%+' 2*/6 )&/00 %0 ,#%+, 6# */+4&' 6*' 4/6/ )/&&0D (*%0 %0 -#E3 4')%0%#+ /0 6*'3' %0 +#6*%+, 06#@@%+, -#E 73#8 @E66%+, %6 %+ / 06/+4/34 ^/ )&/00H 6*' /@@&%)/6%#+ )&/00 #3 /+ /)6%<%6- )&/00D I%6*'3 2/- 6*' @3#)'00 %0 6*' 0/8'D
8.3.1.1 Calling K+ 6*' )&/00 -#E */<' )*#0'+ -#E 0%8@&- E0' 6*' .M"?#++')6%<%6- &%$3/3- 6# $E%&4 / 3'`E'06 /+4 0'+4 6# 6*' U'`E'06 "/+/,'3D (*' 0)3''+0 0*#6 $' 0*#20 /+ 'F/8@&'D ;*'+ 2' %+%6%/&%O'4 6*' /@@&%)/6%#+ 2' )3'/6' 6*' #$^')6 3'`E'068/+/,'3 0# 2' #+&- */<' 6# )3'/6' / 3'`E'06 #$^')6 /+4 7%&& %6 2%6* 6*' 1U[H Y((5 R'3$ /+4 @/-/4 %7 /+-D (*'+ 2' 0%8@&- /44 %6 6# 6*' 3'`E'06 $E+4&' /+4 7%3' 6*' 3'`E'06 8/+/,'3 6# 8/G' 6*' )/&&D :#6' / $E+4&' %0 / 0'3%'0 #7 )/&&0 2*%)* 2%&& $' 'F')E6' 0'`E'+6%/&&-D K6 %0 E@ 6# -#E %7 -#E 2/+6 6# E0' $E+4&'0 #3 +#6D
K+ 6*%0 )#4' 0+%@@'6 -#E )/+ 0'' K )/&& / *'&@'3 8'6*#4 )/&& $E%&4U'`E'06D Kf<' )3'/6'4 6*%0 6# /44 Y((5 *'/4'30 /+4 @/-/40 4'@'+4%+, #+ 8- ?U1M #@'3/6%#+D (*' 8'6*#4 )/+ $' 0''+ $' /+4 %0 ^E06 /+ 'F/8@&' #7 /$063/)6%#+D (*' G'- @#%+6 *'3' %0 2' 0'6 / &%06'+'3 6# a6*%0bH 8'/+%+, 6*' )&/00 2%&& 3')'%<' 6*' 3'0@#+0'0 '&0'2*'3' %+ /+#6*'3 8'6*#4D K6 %0 +#6 6*' $'06 @3#,3/88%+, /+4 %0 ^E06 /+ 'F/8@&'v
9@3%& ABCA
SS
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
8.3.1.2 Receiving J+)' 6*' )/&& */0 $''+ 0'+6H 6*' )#4' )#+6%+E'0 %+4'@'+4'+6 #7 6*' 3'`E'06 8/+/,'3 'F')E6%+, 6*' )/&&D .# -#E +''4 6# 8/+/,' -#E3 )#4' /@@3#@3%/6'&-D K+ 8- 'F/8@&' K )*#0' 6# E0' / L##&'/+ 3%/$&' 6# 2/%6 7#3 / 06/6' )*/+,' /+4 6*'+ )#+6%+E'D o#E )/+ 0'' 6*%0 %+ 6*' )#4' 0+%@@'6 $' 73#8 6*' 0/8' 0',8'+6 #7 )#4' /0 6*' %+%6%/& 3'`E'06D (*%0 %0 ^E06 /+ 'F/8@&' /+4 %4'/&&- -#E 2#E&4 +#6 *#&4 6*' 1K %+ 0E)* / 06/6'D Kf<' 4#+' 6*%0 6# @E0* / 4%/,E' $#F 6# 6*' 1K 7#3 4'8#+063/6%#+ @E3@#0'0D
I<'+ 6*#E,* 2' /3' 2/%6%+, 7#3 6*' 3'0@#+0' *'3'H 6*' /)6E/& 3'0@#+0' %0 )/@6E3'4 '&0'2*'3' %+ -#E )&/00D (# 4# 6*%0 -#E /&2/-0 */<' 6# %8@&'8'+6 6*' K.M":'6[%06'+'3 %+6'37/)' 7#3 6*' )&/00 4#%+, 6*' 2#3GD (*' 'F/8@&' $' 0*#20 / )&/00 )/&&'4 8#4'&D Y'3' Kf<' 4')&/3'4 %6 6# %8@&'8'+6 K.M":'6[%06'+'3D
9@3%& ABCA
ST
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
J+)' 2' */<' 4#+' 6*%0 2' */<' 6# %8@&'8'+6 62# 8'6*#40 #+.E))'00 /+4 #+I33#3D (*'0' 8'6*#40 /3' E0'4 6# )/@6E3' 6*' 3'0@#+0'0 6# /+- J4/6/ )/&&0 2' 8/G' 6# =/6'2/- <%/ .15D .'' $' 7#3 6*' 0%,+/6E3' #7 '/)* 8'6*#4D o#E 8E06 %8@&'8'+6 6*'8v X#3 6*' #+.E))'00 8'6*#4 -#E +''4 6# %+6'33#,/6' 6*' %+)#8%+, 3'0@#+0' a/U'0@#+0'b /+4 )*')G 7#3 /44%6%#+/& Y((5 .6/6E0 )#4'0D L- #G%+, /6 6*' 3'`E'06 1U[ /&0# -#E )/+ 4'6'38%+' 2*'6*'3 6*' 3'0@#+0' 2/0 / .'3<%)' M#)E8'+6H "'6/4/6/H .E$0)3%@6%#+H :#6%7%)/6%#+ #3 ?#&&')6%#+ )/&&D
8.3.1.3 Parsing 90 8'+6%#+'4 /$#<' %+ 6*' #+.E))'00 8'6*#4 -#E +''4 6# @E6 0#8' ,%) 6# 4'6'38%+' 2*/6 6*' 3'0@#+0' %0 /)6E/&&- %+ 3'0@#+0' 6#D J+)' -#E */<' 4#+' 6*%0 -#E +''4 6# @/30' 6*' @/-/4 %+6# /+ 'F%06%+, I+6%62*%)* %0 4'7%+'4 73#8 -#E3 0'3<%)'D :#2 -#E 0'' 2*- 2' */<' 6# )/&& 6*' .'3<%)' M#)E8'+6 /+4 8'6/4/6/ 4#)E8'+60 %+ / @/36%)E&/3 #34'3D Y/<' / #G /6 6*' )#4' 0+%@@'6 $' /+4 0'' *#2 2' )/&& 6*' @/30'3 7#3 %+ 6*%0 )/0' 6*' .'3<%)' M#)E8'+6D o#E 2%&& 4# 6*%0 2%6* '<'3- )/&& 'F)'@6 -#E 2%&& )/06 %6 6# / 4%77'3'+6 '+6%6-D
9@3%& ABCA
SN
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
8.3.1.4 Caching .# +#2 6*/6 2' */<' )/@6E3'4 /+4 @/30'4 / )/&& )#8%+, %+ 73#8 =/6'2/- /+4 .15 2' 6*'+ +''4 6# @E6 %6 %+6# 6*' )/)*' 0# 2' )/+ &'<'3/,' %6 '/0%&- &/6'3 %+ #E3 /@@&%)/6%#+D (*%0 %0 3'/&&- '/0- /+4 %0 #+' &%+' #7 )#4'D o#E )/+ 0'' %6 73#8 6*' )#4' 0+%@@'6 $'D J+)' 6*%0 %0 4#+' -#E +#2 */<' 6*' /@@3#/)* 7#3 /&& 0E$0'`E'+6 )/&&0 E0%+, 6*%0 8'6*#4#,-D 9&& 6*/6 )*/+,'0 %0 6*' Y((5 8'6*#4H @/-/40 /+4 %+6'33#,/6%#+ #+ 6*' 3'0@#+0' )#8%+, $/)G %+D
:#6' l .'' *#2 K E0'4 6*' L##&'/+ 06/6'8'+6 /6 6*' '+4 6# 0%,+/& 6*' #6*'3 8'6*#4 4/6/ %0 /%&/$&'r o#E )/+ %8@&'8'+6 6*%0 *#2'<'3 -#E 2/+6D K6 %0 ^E06 /+ 'F/8@&'D
9@3%& ABCA
SV
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
8.3.2 Call the Metadata Document .# 6*' 0/8' @3#)'00 /@@&%'0 6# 6*' 8'6/4/6/ 4#)E8'+6 'F)'@6 2' 2%&& E0' / 4%77'3'+6 1U[ /+4 3')'%<' / 4%77'3'+)' '+6%6-D K 2%&& +#6 4'0)3%$' 6*' @3#)'00 /,/%+ 3/6*'3 0*#2 6*' 4%77'3'+)'0 %+ <%/ )#4' 0+%@@'60D
8.3.3 Calling
8.3.4Receiving & Parsing & Caching
9@3%& ABCA
Sj
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
8.3.5 Call the Data Collection (Flight) J+)' /,/%+ 2' 'F')E6' %+ 6*' 0/8' 8/++'3 2%6* 0#8' 0&%,*6 3%/6%#+0D K 2/+6 6# )/&& 6*' X&%,*6 ?#&&')6%#+ 0# K )/+ 4%0@&/- / @/36%)E&/3 7&%,*6 #+ 6*' E0'3 %+6'37/)' $'7#3' 2' /)6E/&&- 0E$0)3%$'D o#E )/+ %8@&'8'+6 2*/6'<'3 )/&& -#E 2/+6 *'3'D Kf<' )*#0' 6# E0' 6*' t7%&6'3 +#6/6%#+ /0 /+ 'F/8@&' %+06'/4 #7 /+ 'F@&%)%6 3'/4 #7 / E+%`E' 7&%,*6D (*%0 2/0 4%3')6 4')%0%#+ /0 K 2/0 +#6 0E3' #7 2*/6 4/6/ 2#E&4 $' /%&/$&' )3#00 0-06'8D K 2%&& +#6 4'0)3%$' 6*' @3#)'00 /,/%+ 3/6*'3 0*#2 6*' 4%77'3'+)'0 %+ <%/ )#4' 0+%@@'60D
8.3.6Calling
8.3.7 Receiving & Parsing & Caching
9@3%& ABCA
Si
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
8.4 Creating & Deleting Subscriptions J+)' 2' */<' /+ /@@&%)/6%#+ 3E++%+, /+4 6*' )#3' =/6'2/- 0'3<%)'0 %+ )/)*' 2' )/+ 4%0@&/- 6*' 4/6/ /@@3#@3%/6'&-D (*%0 4#)E8'+6 4#'0 +#6 4'0)3%$' *#2 6# 3'+4'3 6*' 4/6/H /0 %6 %0 3'/&&- )#3' 9+43#%4 @3#,3/88%+,D (*' 0/8@&' )#4' 4'8#+063/6'0 /+ 'F/8@&' #7 *#2 -#E )#E&4 0'@/3/6' /+4 9+43#%4 9)6%<%62%6* / 8#4'& )&/00 $E6 %0 #+&- 7#3 4'8#+063/6%#+ @E3@#0'0D "#3' #+ 6*/6 &/6'3v
8.4.1 Create Subscription (*' @3#)'00 #7 )3'/6' / 0E$0)3%@6%#+ %0 +# 4%77'3'+6 6# %+6'3/)6%+, 2%6* /+- #6*'3 =/6'2/- ?#&&')6%#+ 'F)'@6 2' ^E06 */<' / 0@')%7%) @/-/4 6# /4*'3' 6#D ;*/6 %0 3'/&&- +%)' /$#E6 6*' J4/6/ .Mg %0 6*' )&/00'0 2%&& *'&@ -#E $E%&4 6*' 0E$0)3%@6%#+ @/-/4 <'3- '/0%&-D U'8'8$'3 /&& 2' +''4 6# 4# %0 )/&& 6*' .E$0)3%@6%#+?#&&')6%#+ 2%6* / Y((5 5J.( c?3'/6'dH 0#8' Y((5 Y'/4'30 c.5AQ.@S 0@')%7%)d /+4 /66/)*'4 6*' @/-/4D ['6f0 6/G' / #G /6 *#2 2' 4# 6*%0 %+ 6*' )#4'D
8.4.1.1 Calling
9@3%& ABCA
SP
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
;*/6 4#'0 6*/6 /)6E/&&- $E%&4r (*' Z"[ 5/-/4 )/+ $' 0''+ $'D
xmlns:atom="http://www.w3.org/2005/Atom">
Subscription http://SUPHOST:8000/GWC/SUPNotification FlightCollection * false
(*' 7#&%+, 6/$&' 4'0)3%$'0 6*' 8#06 %8@#36/+6 Z"[ '&'8'+60 /+4 6*'%3 8'/+%+, %+ 3'&/6%#+ 6# #E3 0)'+/3%#D K+ #E3 0/8@&' /@@&%)/6%#+ 2' /3' +#6 0E$0)3%$%+, 6# / @/36%)E&/3 7&%,*6 E0%+, 6*' 7%&6'3 '&'8'+6D K /8 ^E06 )#++')6%+, 6*' '+4_6#_'+4 0)'+/3%# 7#3 / 4'8#+063/6%#+D
32&%&'(
!&,#+-.(-"'
6%6&'
(*%0 )/+ $' /+- 6'F6
4'&%<'3-9443'00
.@')%7%'0 6*' )/6%#+ #7 0E$0'`E'+6 +#6%7%)/6%#+0 7#3 LE0%+'00 J$^')6 '<'+60D ;' 2%&& @E6 / 63/)' #+ 6*%0 )/6%#+ 6# 4'8#+063/6' 2*/6 %0 @#06'4 %+ 2*'+ / L/)G'+4 LE0%+'00 J$^')6 '<'+6 %0 )3'/6'4D 96 3E+6%8' 6*%0 1U[ /+4 @#36 %0 )#8@/3'4 6# 6*' Y((5 4'06%+/6%#+0 4'7%+'4 %+ ."NPD K7 6*'3' /3' 62# #3 8#3' ."NP 4'06%+/6%#+ %6 2%&& 3'63%'<' 6*' 7%306 '+63- #+&-D X#3 8#$%&' 0)'+/3%#0 2%6* .15 6*%0 1U[ )/+ $' 3'63%'<'4 4-+/8%)/&&73#8 .15 /@@&%)/6%#+ )#++')6%#+ @3#@'36%'0 0'6 $- /+ /48%+%063/6#3D
?#&&')6%#+
(*' =/6'2/- LE0%+'00 J$^')6 ?#&&')6%#+ )3'/6'4 %+ 6*' @3'_3'`E%0%6' 0)'+/3%#D K7 -#E /3' E+0E3' #7 6*%0 +/8' -#E )/+ /&2/-0 0'/3)* 7#3 %6 %+ 6*' 8'6/4/6/ 4#)E8'+6 /%&/$&' $@'37#38%+, / Y((5 ='6 #+ *66@nQQx=/6'2/- *#06+/8'wnx=/6'2/- *#06 *66@ @#36w Q0/@Q#@EQ04/6/Q0/@Qx-#E3 0'3<%)' 4#)E8'+6wQt8'6/4/6/
7%&6'3
9 7%&6'3 '+/$&'0 6*' E0'3 6# '%6*'3 0E$0)3%$' 6# /&& $E0%+'00 #$^')6 %+06/+)'0 #3 #+&- / 0@')%7%) '+6%6- %+06/+)'D (*%0 )#8@&%'0 6# 6*' +#38/& J4/6/ t7%&6'3 +#6/6%#+ /+4 0E@@#360 #+&- 9:M #@'3/6#30D ID, K7 6*' 7%&6'3 %0 &'76 '8@6- 2' 2%&& 0E$0)3%$' 6# /&& 8/6'3%/& )3'/6%#+ '<'+60D ;' )/+ @E6 0#8'6*%+, &%G' 6*' 7#&%+, 6# 0E$0)3%$' #+&- 6# / 0@')%7%) 8/6'3%/&D (*' 7#&%+, %0 /+ 'F/8@&' #7 ./&'0 J34'3D ID=D x4n7%&6'3w&E' '` zBBBBBBTBBSz /+4 0)*'8'q%4 '` z.9[I.qJUMIUz /+4 0)*'8'q/,'+)-q%4 '` zmNgqBBTzxQ4n7%&6'3w
9@3%& ABCA
TB
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
0'&')6
I%6*'3 { #3 $&/+GD K6 %0 @#00%$&' 6# 3'63%'<' 6*' #$^')6 )#+6'+6 %+06'/4 #7 ^E06 6*' '<'+6 %+7#38/6%#+D (*%0 %0 6*' 3'0@#+0%$%&%6- #7 6*' /@@&%)/6%#+ %+ 6*' $/)G'+4 6# @#@E&/6' 6*' '+6%3' @/-/4 #3 $E0%+'00 #$^')6 )#+6'+60D 5&'/0' )#+0E&6 6*' $/)G'+4 /@@&%)/6%#+ 4#)E8'+6/6%#+ 6# E+4'306/+4 %7 6*%0 %0 0E@@#36'4D
@'30%06:#6%7%)/6%#+0
(*%0 '&'8'+6 4'6'38%+'0 %7 +#6%7%)/6%#+0 /3' 0'+6 c@E0*'4d 6# .15 /+4 @'30%06'4 #3 2*'6*'3 6*'- /3' 06#3'4 %+ =/6'2/- 7#3 &/6'3 3'63%'& <%/ / @E&&D (# 3'63%'<' +#6%7%)/6%#+0 <%/ @E&& -#E +''4 6# )/&& / 4%77'3'+6 0'3<%)' /&& 6#,'6*'3D IF/8@&' n *66@nQQx*#06+/8'wnx@#36wQ0/@Q#@EQ04/6/Q%27+4Q:J(KXK?9(KJ:.(JUIQ:#6%7%)/6%#+?#&&')6 %#+rt7#38/6sF8&0/@_)&%'+6sx)&%'+6+E8$'3 w :#6' l (*%0 %0 #+&- 0E@@#36'4 2*'+ %8@&'8'+6%+, 0E$0)3%@6%#+ /+4 +#6%7%)/6%#+ 2*'+ E0%+, 6*' JM/6/ )*/++'&D
8.4.1.2 Receiving & Parsing & Caching (*' 0/8' @3#)'00 /@@&%'0 7#3 )3'/6%+, 6*' 0E$0)3%@6%#+D o#E 0%8@&- )*')G 6*' 3'`E'06Q3'0@#+0' %+7#38/6%#+ %+ 6*' #+.E))'00 /+4 6*'+ @/30' /+4 )/)*' /))#34%+,&-D :#6' -#E 2%&& +''4 6# )*')G 6*' Y((5 3'0@#+0' )#4'0 /0 6*'- 2%&& $3%+, $/)G ABC /+4 @#00%$&- ABT 7#3 / 0E))'007E& )3'/6'D U'8'8$'3 -#E +''4 6# 0/<' 6*' 0E$0)3%@6%#+ =1KM 6*/6 )#8'0 $/)G 73#8 6*' =/6'2/- .'3<'3D (*%0 E+%`E'&- %4'+6%7%'0 6*' 0E$0)3%@6%#+ 0# -#E )/+ E+0E$0)3%$' &/6'3D
9@3%& ABCA
TC
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
8.4.2Delete Subscription M'&'6%+, / 0E$0)3%@6%#+ %0 <'3- '/0- /+4 7#& 6*' +#38/& )#+<'+6%#+ #7 4'&'6%+, /+ '+6%6- %+ / UI.(7E& @/3/4%,8D 9&& 2' +''4 6# 4# %0 $E%&4 / 1U[ 2%6* / 0E77%F #7 .E$0)3%@6%#+?#&&')6%#+ /+4 6*' E+%`E' KM 2' 2/+6 6# 4'&'6'D ;' )#8$%+' 6*%0 2%6* 0#8' Y((5 *'/4'30 /+4 6*' Y((5 <'3$ MI[I(ID ;' 4#+z6 +''4 6# @/30' #3 )/)*' 6*' 3'0@#+0'H /0 %6 2%&& $' '8@6-D o#E 8/- ^E06 2/+6 6# 4'&'6' /+- )/)*' %6'80 6# $' )#+0%06'+6D 90 +, /0 %6 %0 0E))'007E&v
8.4.2.1 Calling
8.4.2.2 Receiving
9@3%& ABCA
TA
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
8.5 Receiving Notifications ;*'+ / 63%,,'3 #))E30 =/6'2/- #3 / L/)G'+4 6*' +#6%7%)/6%#+ )#8'0 %+6# .15 /+4 %+6# 6*' 4'<%)' <%/ #E3 +, @#&& 8')*/+%08 4'0)3%$'4 '/3&%'3D 9&& 2' +''4 6# 4# %0 E0' 6*' 0/8' #+.E))'00 8'6*#4 6# )*')G 6*' %+$#E+4 8'00/,' /+4 0'' %7 %6 %0 / +#6%7%)/6%#+D .# 2' 4#+z6 */<' 6# 4# 6*' )/&& *'3' %0 ^E06 / )/0' #7 3')'%<'H @/30' /+4 )/)*'D
8.5.1 Receive & Parse & Cache (*' )#4' $' 0*#20 6*' 0/8' @3#)'00 %0 7#&'4 %+ 6*' #+.E))'00 8'6*#4D (*' 4%77'3'+)' *'3' %0 %+ 8/@@&%)/6%#+ Kf<' 0'@/3/6'4 6*' 9)6%<%6- )&/00 c1Kd 2%6* 6*' 8#4'& c)/&&0Q'6)d )&/00D
=%<'+ %+ *'3' K )/++#6 3/%0' 1K '<'+60 #3 %+6'3/)6 6*' +#6%7%)/6%#+ )'+6'3 K E0' / #$0'3<'3Q#$0'3$&' @/66'3+ 6# +#6%7- 6*' 9)6%<%6- )&/00D (*%0 %0 4#+' 2%6* 6*' 0'6?*/+,'4 /+4 +#6%7-J$0'3<'3 8'6*#40D (*%0 %0 3'/&E60%4' 6*' 0)#@' #7 6*%0 4#)E8'+6 /0 %60 E@ 6# -#E 6# 4'6'38%+' *#2 6# 4'0%,+ -#E3 9+43#%4 /@@&%)/6%#+D (*' )#4' 0+%@@'3 $' )#8'0 73#8 8- 9)6%<%6- )&/00 cMKXXIUI:(d /+4 0*#20 *#2 K 3')'%<' 6*' 06/6' )*/+,' /+4 6*'+ 3'63%'<' 6*' +#6%7%)/6%#+0 73#8 6*' 8#4'& E0%+, / ,'6 8'6*#4D (*%0 3'63%'<'0 %6 73#8 6*' )/)*'D
9@3%& ABCA
TS
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
(*' 06'@ %+ 6*' 9)6%<%6- )&/00 %0 ^E06 6# @/00 %6 6# 6*' +#6%7%)/6%#+ )'+6'3 #7 6*' #@'3/6%+, 0-06'8D o#E )/+ 0'' 6*/6 $'D K6 %0 ^E06 /+ 'F/8@&'D
9@3%& ABCA
TT
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
9. Running the Sample Application 9.1 Application Structure (*' 0/8@&' /@@&%)/6%#+ 8'+6%#+'4 %+ 6*%0 4#)E8'+6 %0 3'/&&- 0%8@&' /+4 4#'0 +#6 3'7&')6 / )#8@&'6' /@@3#/)* 6# 9+43#%4 /@@&%)/6%#+ 4'0%,+D /M& ,5%.2& 5..2-#5(-"' -, 5((5#M&=c @2&5,& $,& P="W& *-&F&+ (" N-&F (M& 5((5#M%&'(,8 d"$ F-22 '"( ,&& (M-, -> 0"$ $,& P..2& @+&N-&F8 K6 %0 ^E06 / )#++')6%<%6- 'F/8@&'H 2*%)* '+/$&'0 6*' $/0%)0D 5&'/0' E0' -#E3 #2+ ^/ )&/00 @/66'3+ )#8$%+/6%#+ 6*/6 0E%6'4 -#E3 3'`E%3'8'+60 /+4 %0 @3#4E)6%#+ 2#36*-D (*%0 %0 +#6 @3#4E)6%#+ 2#36*- /0 %6 %0 ^E06 /+ 'F/8@&'v (*'3' /3' #+&- 62# )&/00'0 /+4 6*3'' #6*'3 7%&'0 3'`E%3%+, )*/+,' %+ 6*%0 @3#^')6n •
•
•
•
9)6%<%6- l c=/6'2/-X&%,*65E0*9)6%<%6-D^/
9@3%& ABCA
TN
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
9.2 Preparing the Application 9.2.1 Copy the files (# 8/G' -#E /@@&%)/6%#+ 3E++/$&' -#E +''4 6# )#@- /+4 @/06' 6*' 7%&'0 &%06'4 /$#<' 2*%)* /3' /66/)*'4 6# 6*%0 5MX 4#)E8'+6 %+6# 6*' 4%3')6#3- 063E)6E3'0 8'+6%#+'4 /$#<'D K+ 0#8' )/0'0 -#E 2%&& +''4 6# #<'323%6' /+4 'F%06%+, 7%&'D
9.2.2 Change Model.java L'7#3' 2' )/+ 3E+ 6*' /@@&%)/6%#+ -#E +''4 6# 8/G' )*/+,'0 6# 6*' 8#4'& )&/00 3'@&/)%+, 6*' E0'3 ,#+ %+7#38/6%#+ 0@')%7%) 6# -#E3 &/+40)/@'D K+ / @3#4E)6%<' '+<%3#+8'+6 -#E 2#E&4 &'<'3/,' 6*'
CD AD SD
!"#$%&!' 1 234535356627 "" #89 #$,/$, :+)% !"#$#&(' 1 2644327 "" #89 9+,% !"#$)&*#+,-./ 1 2427 "" ;<,= >? !"#$"!0(,+*0 1 2@'A027 "" #89 8)$, B<=$ !"#$+)')&/0 1 2
?*/+,' 6*' =;q59..;JUM /+4 =;q1.IU:9"I 6# '`E/& -#E3 %+6'+4'4 .95 :'6;'/<'3 =/6'2/)3'4'+6%/&0D ?*/+,' 6*' .15qYJ.( /+4 .15q5JU( 6# 3'7&')6 -#E3 .15 0@')%7%) %+7#38/6%#+D o#E 0*#E&4 +#6 +''4 6# )*/+,' 6*' .15 E0'3+/8'H /)6%6%#+ )#4' /+4 /@@&%)/6%#+ %7 -#E 7#&'4 6*' %+063E)6%#+0 )#33')6&- %+ 6*' @3'<%#E0 )*/@6'30D
9@3%& ABCA
TV
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
9.3 Running the application UE+ 6*' /@@&%)/6%#+ /0 @'3 / +#38/& 9+43#%4 /@@&%)/6%#+ /+4 <%'2 6*' .15 ,0 6# 0'' 6*' %+6'3/)6%#+D K *%,*&- 3')#88'+4 -#E 4'$E, 6*%0 /@@&%)/6%#+ 7%306 /0 -#E 2%&& 0'' 8'/+%+,7E& 4'$E,,%+, %+7#38/6%#+ %+ 6*' ,)/6 <%'2 2%6*%+ 6*' ')&%@0' '+<%3#+8'+6D o#E 0*#E&4 0'' 6*' 7#&%+, 0)3''+0 %7 6*' 0'3<%)'0 /3' )/&&'4 )#33')6&-D CD
(*' /@@&%)/6%#+ /40 /+4 06'@0 6*3#E,* 6*' .15 #+$#/34%+, /+4 ,/6'2/- 0'3<%)' )/&& @3#)'00D o#E )/+ )*')G %+ .15 .?? 6# 0'' 6*' /@@&%)/6%#+ )#++')6%#+ 0*#20 6*' 4'<%)' #3 0%8E&/6#3 %0 3',%06'3'4v
AD
(*' /@@&%)/6%#+ 1K 0*#20 6*' 06'@0 /3' $'%+, @'37#38'4D o#E )/+ 0'' 6*'0' $'D 9)6%6%#+QU',%063/6%#+D
9@3%& ABCA
Tj
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
SD
o#E 0*#E&4 0'' 6*' =/6'2/- .'3<%)'0 $'%+, )/&&'4 .'3<%)' M#)E8'+6H "'6/4/6/ M#)E8'+6 /+4 7%+/&&- 6*' M/6/ ?#&&')6%#+D X#3 E0 6*' X&%,*6?#&&')6%#+D
9@3%& ABCA
Ti
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
TD
(# @'37#38 / 0E$0)3%@6%#+ )&%)G 6*' 0E$0)3%$' $E66#+ /+4 2/%6 7#3 6*' 0E$0)3%@6%#+ )3'/6' )/&& 6# $' 'F')E6'4D o#E 0*#E&4 0'' 6*' 0E$0)3%@6%#+ 06/6E0 E@4/6'4 /@@3#@3%/6'&-D
ND
J+)' 6*%0 %0 4#+'D [#, %+6# 6*' ,/6'2/- %+06/+)' /+4 3E+ 6*' 0/8@&' 3'@#36 6*/6 2%&& 63%,,'3 / +#6%7%)/6%#+ 7#3 6*' 7&%,*6 0)'+/3%#D (*' 3'@#36 %0 aQ6e93@JRfYEef@I1\f/31/bD K+ 6*' /@@&%)/6%#+ -#E 0*#E&4 0'' 6*' '<'+6 +#6%7%)/6%#+ /33%<' /+4 4%0@&/-'4 /@@3#@3%/6'&-D U'8'8$'3 6*%0 %0 ^E06 /+ 'F/8@&' #7 6*' '+4_6#_'+4 )#++')6%<%6-D 9&0# #G /6 6*' .15 ,0 6# 0'' *#2 6*' +#6%7%)/6%#+ %0 3#E6'4 6# 6*' 4'<%)'D X#3 8#3' %+7# @&'/0' 0'' 6*' +'F6 )*/@6'3 '"(->-#5(-"' +"$(-'< &4.25-'&=D
VD
9@3%& ABCA
TP
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
10. Notification Routing Explained .# 6*' $%, `E'06%#+D Y#2 %0 0E$0)3%@6%#+ /+4 +#6%7%)/6%#+ $#E+4 /+4 2*/6 %+7#38/6%#+ %0 3'`E%3'4 6# 3'<'30' 3#E6' $/)G 6# 6*' 4'<%)'r (*' 6/$&' $' 0*#20 6*' G'- %+7#38/6%#+ /+4 3#E6%+, @3#)'00D
1(&. 78 R&<-,(+5(-"'
]&0 6'>"
345%.2&
5E0* :#6%7%)/6%#+ I+4@#%+6 1U[ 8/%+6/%+'4 %+ 6*'
*[email protected].(niBBBQ=;?Q.15:#6%7%)/6%#+
/@@&%)/6%#+ )#++')6%#+ @3#@'36%'0D :8 P#(-N5(-"'
(*' )&%'+6 3'63%'<'0 6*' 1U[ /+4 0/<'0D
P..2-#5(-"' G"''(-"' 6= g 1-%$25("+?Q?B::?5h
K+ 6*' /@@&%)/6%#+ )#++')6%#+ .?? 0)3''+ 6*'
>?H>hC=5Lh5CL#hDL?5#W7BH&H#ff
&E'0 /3' /00%,+'4 /0 0''+ 6# 6*' 3%,*6D (*%0 %0
E5(&F50f^2-
6*' gIov
P..2-#5(-"' 6= g E5(&F50f^2-5$2(
?8 G+&5(& 1$W,#+-.(-"'
(*' )&%'+6 E0'0 6*' 1U[ /+4 0E77%F'0 2%6* /@@&%)/6%#+ )#++')6%#+ %4H E0'3H /@@&%)/6%#+ /+4 4#8/%+ /+4 %+)&E4'0 %+ 0E$0)3%@6%#+ )3'/6' @/-/4 '&'8'+6 4'&%<'3-9443'00D :J(KXK?9(KJ: 5IU.K.(IM K: =9(I;9o
XJU"9( s *[email protected].(n@#36Q=;?Q.15:#6%7%)/6%#+Q9@@&%)/ 6%#+?#++')6%#+K4Q10'3Q9@@&%)/6%#+QM#8/%+ *66@nQQ1I@\K1/iOBBBJEeGJ1I@S"(->-#5(-"'J1-%$2 5("+?Q?B::?5h>?H>hC=5Lh5CL#hDL?5#W7BH&H#ff E5(&F50f^2--#5(-"'J=&>5$2(
C8 /+-<<&+ S"(->-#5(-"'
J+)' 6*' +#6%7%)/6%#+ %0 %+ =/6'2/- 6*' ."NP 4'06%+/6%#+ 2%6* / )#+06/+6 *#06H @#36 /+4 $/0%) 1U[ @3'7%F %0 8/6)*'4 6# @3'<%#E0 06'@ @'30%06'4 %+ / 6/$&' /6 0E$0)3%@6%#+ )3'/6%#+ 6%8'D :J(KXK?9(KJ: .I:( (J .15 K7 +#6%7%)/6%#+ @'30%06'4 s 63E' 6*'+ +#6%7%)/6%#+0 06#3'4 %+ ,/6'2/- 7#3 &/6'3 51[[ /+4 +#6 0'+6 6# .15D :J(KXK?9(KJ:. .(JUIM K: =9(I;9o .15 #G0 /6 /@@&%)/6%#+ )#++')6%#+ 6/$&' /+4 )#8@/3'0 2%6* 6*' 7E&& 1U[ E0'4D
."NP M'06%+/6%#+ (/3,'6 Y#06n 7B87878DD .'3<%)' :#n OBBB 5/6* 53'7%Fn JEeGJ1I@S"(->-#5(-"'
MIRK?I h 1.IU XJ1:M .15 )*')G0 %7 E0'3Q/@@&%)/6%#+ %0 #+&%+' #3 #77&%+'D .15 )*')G0 %7 #77&%+' )#++')6%<%6- 0'66%+,0 'F%06D 95:. '6)D :J(KXK?9(KJ: .I:( (J MIRK?I 9@@&%)/6%#+ /4'4 %+ 7#3',3#E+4D J:[K:I :J(KXK?9(KJ:. UI(UKIRIM XUJ" .15 D8 R&-N& S"(->-#5(-"'
?&%'+6 /))'@60 3'0@#+0' %+ 0@')%7%) 8'6*#4 %7 #+&%+'D ?&%'+6 /))'@60 3'0@#+0' 73#8 @3#@3%'6/38'00/,%+, 0'3<%)'D 95:. '6)D ?&%'+6 8/- )/&& +#6%7%)/6%#+ 0'3<%)' %7 51[[ 0)'+/3%# )*#0'+ :J(KXK?9(KJ: 9??I5(IM
9@3%& ABCA
NB
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
11.Communication Architectures (Device Specific) (*' )#88E+%)/6%#+0 $'62''+ .15 /+4 4'<%)' %+ #+&%+' 8#4' E6%&%O' Y((5Q0 *#2'<'3 2*/6 2' */<' +#6 4%0)E00'4 6*E0 7/3 %0 6*' E0' #7 S34 @/36- 4'<%)' 0@')%7%) 8'00/,%+, 0'3<%)'0 0E)* 95:. #3 LI.D (*' 7#&%+, 4%/,3/8 %&&E063/6'0 6*' 3'&/6%#+0*%@ $'62''+ .15 /+4 6*' 4'<%)' 0@')%7%) /3)*%6')6E3'0D (*' 7%306 06'@ %+ 6*' @3#)'00 7 4%)6/6'0 6*/6 6*'0' 0'66%+,0 8E06 $' 8/%+6/%+'4 /,/%+06 6*' /@@&%)/6%#+ )#++')6%#+ @3#@'36%'0D X#3 8#3' 4'6/%&'4 )#+7%,E3/6%#+ 06'@0 @&'/0' 0'' 6*' 3'&'+6 Y#2_(# ,E%4' 7#3 '/)* 4'<%)'D 9@@&' /+4 L&/)G$'33- +#6%7%)/6%#+ 0'3<%)'0 /3' 0E@@#36'4 *#2'<'3 /6 6*%0 @#%+6 %+ 6%8' c=/6'2/- .5S h .15 ADCDCd 9+43#%4 ?AM" %0 +#6 0E@@#36'4D 9&0# 6*' %+6'+6%#+ 7#3 E0%+, 95:. /+4 :J? %0 6# +#6 )*/++'& 6*' @/-/4 6*3#E,* 6*%0 8')*/+%08 $E6 3/6*'3 63%,,'3 6*' /@@&%)/6%#+ 6# /4 %+ 7#3',3#E+4 /+4 @'37#38 /+ #+&%+' +#6%7%)/6%#+ /,/%+06 6*' @'+4%+, 4'<%)' 0@')%7%) `E'E'0D
9@3%& ABCA
NC
Y#2_(#k.E$0)3%@6%#+ h :#6%7%)/6%#+ 2%6* .95 :'6;'/<'3 =/6'2/- _ 9+43#%4
12. Appendix – Subscription Collection (*' 0E$0)3%@6%#+ )#&&')6%#+ $#E+4 6# -#E '+/$&'4 =/6'2/- 0'3<%)' 7#& 6*' 0/8' @3%+)%@/& /0 /+=/6'2/- 0'3<%)'D (*%0 8'/+0 6*/6 / E0'3 #3 /@@&%)/6%#+ )/+ mE'3-H ?3'/6'H U'/4H 1@4/6' /+4 M'&'6' 0E$0)3%@6%#+0 0%8@&- $- E0%+, 6*' )#8$%+/6%#+ #7 1U[H Y((5 <'3$ /+4 @/-/4D
P#(-"'
\//@ *&+W
R&A$&,( @502"5=
15%.2& IRZ
mE'3-
=I(
I8@6-
kQ.E$0)3%@6%#+?#&&')6%#+
U'/4
=I(
I8@6-
kQ.E$0)3%@6%#+?#&&')6%#+c|KMsCSASBPi9.M9.fd
?3'/6'
5J.(
.E$0)3%@6%#+ I+6%6-
kQ.E$0)3%@6%#+?#&&')6%#+c|KMsCSASBPi9.M9.fd
M'&'6'
MI[I(I
I8@6-
kQ.E$0)3%@6%#+?#&&')6%#+c|KMsCSASBPi9.M9.fd
1@4/6'
51(
.E$0)3%@6%#+ I+6%6-
kQ.E$0)3%@6%#+?#&&')6%#+c|KMsCSASBPi9.M9.fd
9@3%& ABCA
NA