GWT 1.6 Developer Guide

download GWT 1.6 Developer Guide

of 116

Transcript of GWT 1.6 Developer Guide

  • 8/14/2019 GWT 1.6 Developer Guide

    1/116

    GWT

    Google Web Toolkit 1.6

    Developer GuideThe next generation of Web Apps

    Write rich web applications without the tedious of coding Html, Javascript or Ajax, andthe most important: cross browser ready.

    Prepared by:Ignacio Gutirrez Torrero

    SAIT Software Administrativowww.sait.com.mx

    Monterrey Nuevo LenSan Luis Ro Colorado SonoraSan Francisco California

    May 2009

    GOOGLE is a trademark of Google Inc.SAIT is not endorsed or affiliated with Google Inc

  • 8/14/2019 GWT 1.6 Developer Guide

    2/116

    Hi

    My name is Ignacio Gutierrez.

    Im a Computer Engineer from Monterrey Mxico.

    I work in SAIT, the company that owns Mexicos Best ERP, and actually is moving from desktop to webapplications.

    Im programming in GWT since 2007 like a hobby because like to hunt new technologies. Now is 2009 andGWT 1.6 is a serious player in Web Development.

    I prepare this document (that is the original developer guide from GWT 1.6), but in one single document, soyou can print it and read it at home, as many times you like with out to turn on your PC; I now is a greenera, but I prefer read in my bed, anyway I save electricity.

    You can found the source of this document in: http://code.google.com/webtoolkit/doc/1.6/DevGuide.html

    My passion for GWT takes me to visit Google last year.

  • 8/14/2019 GWT 1.6 Developer Guide

    3/116

    *RRJOH :HE 7RRONLW +RPH 'RFV %ORJ *URXS 7HUPV

    *:7 LQFOXGHV GLUHFWVXSSRUW IRU ZHE DUFKLYH ZDU RXWSXW IDVWHU FRPSLODWLRQ QHZ ZLGJHWV QHZ DQG LPKDQGOLQJ DQG PXFK PRUH ,Q DGGLWLRQ *:7 UHVROYHV GR]HQV RI EXJV IURP WKH *:7 LVVXH WUDFNHU ,I \RX UH FXUUHXVLQJ *:7 IROORZ WKH VWHS E\ VWHS LQVWUXFWLRQV IRU XSJUDGLQJ H[LVWLQJ SURMHFWV WR *:7

    1HZ )HDWXUHV

    %XJ )L[HV

    +RZ WR 8SJUDGH

    1HZ 3URMHFW 6WUXFWXUH

    2QH RI WKH ELJJHVW FKDQJHV WR *:7 LV D QHZ SURMHFW VWUXFWXUH 7KH ROG RXWSXW IRUPDW KDV EHHQ UHSODFVWDQGDUG -DYD ZHE DSS H[SDQGHG ZDU IRUPDW DQG WKH DFWXDO GLUHFWRU\ QDPH GRHV GHIDXOW WR ZDU 1RWHGLUHFWRU\ LV QRW RQO\ IRU FRPSLOHU RXWSXW LWLV DOVR LQWHQGHG WR FRQWDLQ KDQGZULWWHQ VWDWLF UHVRLQFOXGHG LQ \RXU ZHEDSS DORQJVLGH *:7 PRGXOHV WKDW LV WKLQJV \RX G ZDQW WR YHUVLRQ FRQWURO 3OHDVH D*:76KHOO DQG *:7&RPSLOHU WRROV ZLOO PDLQWDLQ WKHLU OHJDF\ EHKDYLRU EXW WKH\ KDYH EHHQ GHSUHFDWHG+RVWHG0RGH DQG &RPSLOHU WRROV ZKLFK XVH WKH QHZ ZDU RXWSXW :KHQ LV RIILFLDOO\ UHOHDVHG ZH ZLOO EHH[LVWLQJ SURMHFWV WR XSGDWH WR WKH QHZ GLUHFWRU\ IRUPDW DQG WR XVH WKH QHZ WRROV WR WDNH DGYDQWFRPSDWLELOLW\ ZLWK IXWXUH *:7 UHOHDVHV

    7KH VDPSOH SURMHFWV SURYLGHG LQ WKH *:7 GLVWULEXWLRQ SURYLGH DQ H[DPSOH RI FRUUHFW QHZ SURMHFW FRQIGHWDLOV RQ WKH VSHFLILFV RIWKH QHZ SURMHFW IRUPDW SOHDVH VHHWKH GHVLJQ GRFXPHQW

    $ FRXSOH RI LPSRUWDQW FKDQJHV WR KLJKOLJKW KHUH3URMHFWV ZLWK VHUYHU VLGH FRGH *:7 53& PXVWFRQILJXUH DZHE [PO ILOH DWZDU :(% ,1) ZHE [PO 7KLVZHE [PO ILOH PXVW GHILQH DQG SXEOLVK DQ\ VHUYOHWV DVVRFLDWHG ZLWK WKH ZHE DSSOLFDWLRQ 6HH WKH'\QD7DEOH VDPSOH $GGLWLRQDOO\ VHUYHU VLGH OLEUDU\ GHSHQGHQFLHV PXVW EH FRSLHG LQWRZDU :(% ,1) OLE )RU H[DPSOH DQ\ *:7 53& VHUYOHWV PXVW KDYH D FRS\ RI JZW VHUYOHW MDU LQ WKLV IROGHU

    +70/ KRVW SDJHV ZLOO QR ORQJHU W\SLFDOO\ EH ORFDWHG LQ D *:7 PRGXOH V SXEOLFSDWK ,QVWHDG ZH OO EH UWKDW SHRSOH WDNH DGYDQWDJH RI WKH QDWXUDO ZHE DSS EHKDYLRU IRU VHUYLQJ VWDWLF ILOHV E\ SODFLQLQ WKH ZDU VWUXFWXUH WKDW PDNHV VHQVH )RU H[DPSOH \RX PLJKW ZDQW WR ORDG D *:7 PRGXOH IURP D -63 SDLQ WKH URRW RI \RXU ZHE DSS 7R NHHS VXFK KDQGZULWWHQ VWDWLF ILOHV VHSDUDWH IURPWKRVH SURGXFHGFRPSLOHU WKH ODWWHU ZLOO EH SODFHG LQWR PRGXOH VSHFLILF VXEGLUHFWRULHV $Q\ SDJH WKDW ZLVKHV WPRGXOH FDQ GR VR YLD D VFULSW WDJ E\ UHIHUHQFLQJ WKH *:7 SURGXFHGPRGXOH! QRFDFKH MV VFULSW ZLWKLQ WKDWPRGXOH V VXEGLUHFWRU\ $V RI ZH OO EH UHFRPPHQGLQJ WKDW RQO\ PRGXOH VSHFLILF UHVRXUFHV XVHG GLUH

    FRGH VXFK DV LPDJH ILOHV QHHGHG E\ ZLGJHWV VKRXOG UHPDLQ RQ WKH SXEOLF SDWK 6HH WKH LQFOXGHG 6KIRU VRPH H[DPSOHV RI WKLV GLVWLQFWLRQ

    :KHQ \RX GR QHHG WR ORDG UHVRXUFHV IURP D PRGXOH V SXEOLF SDWK DOZD\V FRQVWUXFW DQ DEVROXWH 85/*:7 JHW0RGXOH%DVH85/ )RU H[DPSOH *:7 JHW0RGXOH%DVH85/ GLU ILOH H[W 7KLV DGYLFHKDV QRW FKDQJHG EXW LQ WKH SDVW LW ZDV HDV\WR EH VORSS\ ZLWK WKLV EHFDXVH WKH KRVW SDJH DQG *:7W\SLFDOO\ OLYHG LQ WKH VDPH GLUHFWRU\ VR XVLQJ D UHODWLYH 85/ ZRXOG XVXDOO\ GR WKH ULJKW WKLQJ 1PRGXOHV OLYH LQ D VXEGLUHFWRU\ \RX PXVW UHIHUHQFH SXEOLF UHVRXUFHV WKURXJK*:7 JHW0RGXOH%DVH85/

    +RVWHG 0RGH (QKDQFHPHQWV

    $OWKRXJK WKH OHJDF\ *:76KHOO VWLOO XVHV DQ HPEHGGHG 7RPFDW VHUYHU WKH QHZ +RVWHG0RGH UXQV -HWW\ LQDOVR D QHZ 5HVWDUW 6HUYHU EXWWRQ RQ WKH PDLQ KRVWHG PRGH ZLQGRZ &OLFNLQJ WKLV EXWWRQ UHVWDUWV

    :KDW V 1HZ LQ *:7 "

    1HZ )HDWXUHV

    WKH FRQWHQW RI WKLV SDJH LV OLFHQVHG XQGHU WKH&UHDWLYH &RPPRQV $WWULEXWLRQ /LFHQVH

    *RRJOH &RGH +RPH 7HUPV RI 6HUYLFH3ULYDF\ 3ROLF\6LWH 'LUHFWRU\

    *RRJOH &RGH RIIHUHG LQ(QJ OLVK(VSDxRO 3RUWXJXrV3

    :KDW V 1HZ LQ *:7 " *RRJOH :HE 7RRONLW *RRJOH &RGH

    S FRGH JRRJOH FRP ZHEWRRONLW GRF 5HOHDVH1RWHVB B KWPO

  • 8/14/2019 GWT 1.6 Developer Guide

    4/116

  • 8/14/2019 GWT 1.6 Developer Guide

    5/116

  • 8/14/2019 GWT 1.6 Developer Guide

    6/116

  • 8/14/2019 GWT 1.6 Developer Guide

    7/116

  • 8/14/2019 GWT 1.6 Developer Guide

    8/116

    ,I \RX GHYHORS \RXU RZQ ZLGJHWV DQG KDYH RYHUULGGHQ:LGJHW RQ%URZVHU(YHQW PDNH VXUH WKDW \RXU RYHUULGH FDOOVVXSHU RQ%URZVHU(YHQW 7KH :LGJHW RQ%URZVHU(YHQW PHWKRG FRQWDLQV FRGH WR DXWRPDWLFDOO\ ILUH QDWLYHYHQWV WR WKHLU DVVRFLDWHG(YHQW+DQGOHUV VR LI \RX RYHUULGH WKH FRGH DQG GR QRW FDOO WKH VXSHU PHWKRG \RXU (YHQW+DQGOHUVZLOO QRW ILUH

    )RU H[DPSOH WKLV ZLOOQRWDXWRPDWLFDOO\ FDOO&OLFN+DQGOHUVDGGHG XVLQJ WKH:LGJHW DGG'RP+DQGOHU PHWKRG

    SXEOLF FODVV 0\:LGJHW H[WHQGV :LGJHW ^

    #2YHUULGHSXEOLF YRLG RQ%URZVHU(YHQW (YHQW HYHQW ^LI '20 HYHQW*HW7\SH HYHQW (YHQW 21&/,&. ^

    'R VRPHWKLQJ ZLWK FOLFN`

    ``

    EXW WKLV FRGH ZLOO

    SXEOLF FODVV 0\:LGJHW H[WHQGV :LGJHW ^#2YHUULGHSXEOLF YRLG RQ%URZVHU(YHQW (YHQW HYHQW ^

    VXSHU RQ%URZVHU(YHQW HYHQWLI '20 HYHQW*HW7\SH HYHQW (YHQW 21&/,&. ^

    'R VRPHWKLQJ ZLWK FOLFN`

    ``

    $Q HYHQ EHWWHU DOWHUQDWLYH LV WR XVH DQ DQRQ\PRXV LQQHU FODVV WR KDQGOH WKH&OLFN(YHQW DV IROORZV QRWLFH KRZ ZH QRORQJHU QHHG WR RYHUULGHRQ%URZVHU(YHQW

    SXEOLF FODVV 0\:LGJHW H[WHQGV :LGJHW ^SXEOLF 0\:LGJHW ^

    DGG'RP+DQGOHU QHZ &OLFN+DQGOHU ^SXEOLF YRLG RQ&OLFN &OLFN(YHQW HYHQW ^

    'R VRPHWKLQJ ZLWK FOLFN`

    ` &OLFN(YHQW JHW7\SH`

    `

    $Q\ SUREOHPV ZKLOH XSJUDGLQJ" $V DOZD\V OHW XV NQRZ RQ WKH*:7 'HYHORSHU )RUXP DQG RXU JUHDW FRPPXQLW\ RU *:7WHDP PHPEHUV ZLOO JHWEDFN WR \RX WR PDNH VXUH WKH XSJUDGH SURFHVV GHWDLOHG LQ WKLV JXLGH LV DFFXUDWH DXVHUV

    :KDW V 1HZ LQ *:7 " *RRJOH :HE 7RRONLW *RRJOH &RGH

    S FRGH JRRJOH FRP ZHEWRRONLW GRF 5HOHDVH1RWHVB B KWPO

  • 8/14/2019 GWT 1.6 Developer Guide

    9/116

    *RRJOH :HE 7RRONLW +RPH 'RFV %ORJ *URXS 7HUPV

    :HOFRPH WR WKH *RRJOH :HE 7RRONLW 'HYHORSHU V *XLGH 7KLV JXLGH LQWURGXFHV WKH NH\ FRQFHSWV WRROV DQHQFRXQWHU ZKHQ EXLOGLQJ ZHE DSSOLFDWLRQV ZLWK *:7 7KH WRSLFV LQ WKLV JXLGH VSDQ SURMHFWRUJDQL]DWLRGHEXJJLQJ WHVWLQJ RSWLPL]LQJ DQG SXEOLVKLQJ \RXU ZHE DSSOLFDWLRQ

    ,I \RX UH QHZ WR *:7 DQG HDJHU WR VWDUW SOD\LQJ LPPHGLDWHO\ \RX PLJKW ZDQW WR WU\ WKH4XLFN 6WDUW2U LI \RX UH ORRNLQJ IRU YHU\ VSHFLILF LQIRUPDWLRQ DERXW *:7 $3,V RU WRROV VHH WKH5HIHUHQFH *XLGHIRU GHWDLOV

    2UJDQL]LQJ 3URMHFWV

    &RGLQJ %DVLFV

    &RPSLOLQJ 'HEXJJLQJ

    %XLOGLQJ 8VHU ,QWHUIDFHV

    ,QWHUQDWLRQDOL]DWLRQ $FFHVVLELOLW\

    &RPPXQLFDWLQJ ZLWK D 6HUYHU

    7HVWLQJ

    'HYHORSHU V *XLGH

    WKH FRQWHQW RI WKLV SDJH LV OLFHQVHG XQGHU WKH&UHDWLYH &RPPRQV $WWULEXWLRQ /LFHQVH

    *RRJOH &RGH +RPH 7HUPV RI 6HUYLFH3ULYDF\ 3ROLF\6LWH 'LUHFWRU\

    *RRJOH &RGH RIIHUHG LQ(QJ OLVK(VSDxRO 3RUWXJXrV3

    'HYHORSHU V *XLGH *RRJOH :HE 7RRONLW *RRJOH &RGH

    WS FRGH JRRJOH FRP ZHEWRRONLW GRF 'HY*XLGH KWPO

  • 8/14/2019 GWT 1.6 Developer Guide

    10/116

    *RRJOH :HE 7RRONLW +RPH 'RFV %ORJ *URXS 7HUPV

    *:7 SUR MHFWV FDQ EH RUJDQL]HG LQ D YDULHW\ RI ZD\V +RZHYHU SDUWLFXODU FRQYHQWLRQV DUH HQFRXUDJHG WR PDNHLGHQWLI\ ZKLFK FRGH LV LQWHQGHG WR UXQ RQ WKH FOLHQW EURZVHU WKH VHUYHU RU ERWK

    7KLV VHFWLRQ GHVFULEHV WKH IXQGDPHQWDOV RI SURMHFW RUJDQL]DWLRQ ZLWK *:7 DV ZHOO DV WKH UHFRPPHQGHG FRQY

    +70/ +RVW 3DJHV

    6WDQGDUG 'LUHFWRU\ DQG 3DFNDJH /D\RXW

    0RGXOHV 8QLWV RI FRQILJXUDWLRQ

    0RGXOH ;0/ ILOHV

    +RZ GR , NQRZ ZKLFK *:7 PRGXOHV , QHHG WR LQKHULW"

    $XWRPDWLF 5HVRXUFH ,QFOXVLRQ

    )LOWHULQJ 3XEOLF DQG 6RXUFH 3DFNDJHV

    7KH %RRWVWUDS 6HTXHQFH

    *:7 PRGXOHV DUH VWRUHG RQ D ZHE VHUYHU DV D VHW RI -DYD6FULSW DQG UHODWHG ILOHV ,Q RUGHU UXQ WKH PRGXOH LWORDGHG IURP D ZHE SDJH RI VRPH VRUW $Q\ +70/ SDJH FDQ LQFOXGH D *:7 DSSOLFDWLRQ YLD D6&5,37 WDJ 7KLV +70/SDJH LV UHIHUUHG WR DV DKRVW SDJHIURP WKH *:7 DSSOLFDWLRQ V SRLQW RI YLHZ $ W\SLFDO +70/ KRVW SDJH IRU DQ DSSOLFDWLRQZULWWHQ ZLWK *:7 IURP VFUDWFK PLJKW QRW LQFOXGH DQ\ YLVLEOH +70/ ERG\ FRQWHQW DW DOO 7KH H[DPSOH EHORZ VKRZVHPEHG D *:7 DSSOLFDWLRQ WKDW ZLOO XVH WKH HQWLUH EURZVHU ZLQGRZ

    KWPO!KHDG!

    3URSHUWLHV FDQ EH VSHFLILHG WR LQIOXHQFH GHIHUUHG ELQGLQJ !PHWD QDPH JZW SURSHUW\ FRQWHQWORFDOH HQB8. !

    6W\OHVKHHWV DUH RSWLRQDO EXW XVHIXO !OLQN UHO VW\OHVKHHW KUHI &DOHQGDU FVV !

    7LWOHV DUH RSWLRQDO EXW XVHIXO !WLWOH! &DOHQGDU $SS WLWOH!

    KHDG!ERG\ !

    7KLV VFULSW WDJ LV ZKDW DFWXDOO\ ORDGV WKH *:7 PRGXOH 7KH !QRFDFKH MV ILOH DOVR FDOOHG D VHOHFWLRQ VFULSW LV !SURGXFHG E\ WKH *:7 FRPSLOHU LQ WKH PRGXOH RXWSXW GLUHFWRU\ !RU JHQHUDWHG DXWRPDWLFDOO\ LQ KRVWHG PRGH !

    VFULSW ODQJXDJH MDYDVFULSW VUF FDOHQGDU FDOHQGDU QRFDFKH MV ! VFULSW!

    ,QFOXGH D KLVWRU\ LIUDPH WR HQDEOH IXOO *:7 KLVWRU\ VXSSRUW !WKH LG PXVW EH H[DFWO\ DV VKRZQ !

    LIUDPH VUF MDYDVFULSW LG BBJZWBKLVWRU\)UDPH VW\OH ZLGWK KHLJKWERUGHU ! LIUDPH !

    ERG\ !KWPO!

    2UJDQL]LQJ 3URMHFWV

    +70/ +RVW 3DJHV

    WKH FRQWHQW RI WKLV SDJH LV OLFHQVHG XQGHU WKH&UHDWLYH &RPPRQV $WWULEXWLRQ /LFHQVH

    *RRJOH &RGH +RPH 7HUPV RI 6HUYLFH3ULYDF\ 3ROLF\6LWH 'LUHFWRU\

    *RRJOH &RGH RIIHUHG LQ(QJ OLVK(VSDxRO 3RUWXJXrV3

    2UJDQL]LQJ3URMHFWV *RRJOH :HE 7RRONLW *RRJOH &RGH

    S FRGH JRRJOH FRP ZHEWRRONLW GRF 'HY*XLGH2UJDQL]LQJ3URMHFWV KWPO

  • 8/14/2019 GWT 1.6 Developer Guide

    11/116

    1RWH WKDW WKH ERG\ RI WKH SDJH FRQWDLQV RQO\ D6&5,37 WDJ DQG DQ,)5$0( WDJ ,W LV OHIW WR WKH *:7 DSSOLFDWLRQ WR WKHQ ILOOLQ DOO WKH YLVXDO FRQWHQW

    %XW *:7 ZDV GHVLJQHG WR PDNH LW HDV\ WR DGG *:7 IXQFWLRQDOLW\ WR H[LVWLQJ ZHE DSSOLFDWLRQV ZLWK RQO\ PLQRU FKDQLV SRVVLEOH WR DOORZ WKH *:7 PRGXOH WR VHOHFWLYHO\ LQVHUW ZLGJHWV LQWR VSHFLILF SODFHV LQ DQ +70/ SDJH 7R DFFRPSWKLV XVH WKHLG DWWULEXWH LQ \RXU +70/ WDJV WR VSHFLI\ D XQLTXH LGHQWLILHU WKDW \RXU *:7 FRGH ZLOO XVH WR DWWDFK ZLWKDW +70/ HOHPHQW )RU H[DPSOH

    ERG\ !

    RWKHU VDPSOH +70/ RPLWWHG !WDEOHDOLJQ FHQWHU!

    WU!WG LG VORW ! WG!WG LG VORW ! WG!

    WU!WDEOH!

    ERG\ !

    1RWLFH WKDW WKHWGWDJV LQFOXGH DQLG DWWULEXWH DVVRFLDWHG ZLWK WKHP 7KLV DWWULEXWH LV DFFHVVLEOH WKURXJK WKH'20 FODVV

  • 8/14/2019 GWT 1.6 Developer Guide

    12/116

    * XLGHOLQHV

    ,I \RX DUH QRW XVLQJ WKH &RPPDQG OLQH WRROV WR JHQHUDWH \RXU SURMHFW ILOHV DQG GLUHFWRULHV KHUH DUH VRPH JXLNHHS LQ PLQG ZKHQ RUJDQL]LQJ \RXU FRGH DQG FUHDWLQJ -DYD SDFNDJHV

    8QGHU WKH PDLQ SURMHFW GLUHFWRU\ FUHDWH WKH IROORZLQJ GLUHFWRULHV

    VUF IROGHU FRQWDLQV SURGXFWLRQ -DYD VRXUFH

    ZDU IROGHU \RXU ZHE DSS FRQWDLQV VWDWLF UHVRXUFHV DV ZHOO DV FRPSLOHG RXWSXW

    WHVW IROGHU RSWLRQDO -8QLW WHVW FRGH ZRXOG JR KHUH

    :LWKLQ WKH VUF SDFNDJH FUHDWH D SURMHFW URRW SDFNDJH DQG D FOLHQW SDFNDJH

    ,I \RX KDYH VHUYHU VLGH FRGH DOVR FUHDWH D VHUYHU SDFNDJH WR GLIIHUHQWLDWH EHWZHHQ WKH FOLHQW VLGH FRGWUDQVODWHG LQWR -DYD6FULSW IURP WKH VHUYHU VLGH FRGH ZKLFK LV QRW

    :LWKLQ WKH SURMHFW URRW SDFNDJH SODFH RQH RU PRUH PRGXOH GHILQLWLRQV

    ,Q WKH ZDU GLUHFWRU\ SODFH DQ\ VWDWLF UHVRXUFHV VXFK DV WKH KRVW SDJH VW\OH VKHHWV RU LPDJHV

    :LWKLQ WKH FOLHQW DQG VHUYHU SDFNDJHV \RX DUH IUHH WR RUJDQL]H \RXU FRGH LQWR DQ\ VXESDFNDJHV \RX UHTXLUH

    ([DPSOH *:7 VWDQGDUG SDFNDJH OD\RXW

    )RU H[DPSOH DOO WKH ILOHV IRU WKH '\QD7DEOH VDPSOH DUH RUJDQL]HG LQ D PDLQ SURMHFW GLUHFWRU\ DOVR FDOOHG '\QD7D

    -DYD VRXUFH ILOHV DUH LQ WKH GLUHFWRU\'\QD7DEOH VUF FRP JRRJOH JZW VDPSOH G\QDWDEOH

    7KH PRGXOH LV GHILQHG LQ WKH ;0/ ILOH'\QD7DEOH VUF FRP JRRJOH JZW VDPSOH G\QDWDEOH'\QD7DEOH JZW [PO

    7KH SURMHFW URRW SDFNDJH LVFRP JRRJOH JZW VDPSOH G\QDWDEOH

    7KH ORJLFDO PRGXOH QDPH LVFRP JRRJOH JZW VDPSOH G\QDWDEOH '\QD7DEOH

    7KH VUF GLUHFWRU\ FRQWDLQV DQ DSSOLFDWLRQ V -DYD VRXUFH ILOHV WKH PRGXOH GHILQLWLRQ DQG H[WHUQDO UHVRXUFH

    3DFNDJH )LOH 3XUSRVH

    FRP JRRJOH JZW VDPSOH G\QDWDEOH 7KH SURMHFW URRW SDFNDJH F

    7KH VUF GLUHFWRU\

    2UJDQL]LQJ3URMHFWV *RRJOH :HE 7RRONLW *RRJOH &RGH

    S FRGH JRRJOH FRP ZHEWRRONLW GRF 'HY*XLGH2UJDQL]LQJ3URMHFWV KWPO

  • 8/14/2019 GWT 1.6 Developer Guide

    13/116

  • 8/14/2019 GWT 1.6 Developer Guide

    14/116

    ' \QD7DEOH ZDU :(% ,1) OLE JZW VHUYOHW MDU ,I \RX KDYH DQ\ VHUYOHWV XVLQJ *:7 53& \RX ZLOO QHHWR SODFH D FRS\ RIJZW VHUYOHW MDUKHUH

    7KH WHVW GLUHFWRU\ FRQWDLQV WKH VRXUFH ILOHV IRU DQ\ -8QLW WHVWV

    3DFNDJH )LOH 3XUSRVH

    FRP JRRJOH JZW VDPSOH G\QDWDEOH FOLHQW &OLHQW VLGHWHVW ILOHV DQGVXESDFNDJHV

    FRP JRRJOH JZW VDPSOH G\QDWDEOH FOLHQW '\QD7DEOH7HVW MDYD 7HVW FDVHVIRU WKHHQWU\ SRLQWFODVV

    FRP JRRJOH JZW VDPSOH G\QDWDEOH VHUYHU 6HUYHU VLGHWHVW ILOHV DQGVXESDFNDJHV

    FRP JRRJOH JZW VDPSOH G\QDWDEOH VHUYHU 6FKRRO&DOHQGDU6HUYLFH,PSO7HVW MDYD 7HVW FDVHVIRU VHUYHU

    FODVVHV

    ,QGLYLGXDO XQLWV RI *:7 FRQILJXUDWLRQ DUH FDOOHGPRGXOHV$ PRGXOH EXQGOHV WRJHWKHU DOO WKH FRQILJXUDWLRQ VHWWLQJV WKD\RXU *:7 SURMHFW QHHGV

    LQKHULWHG PRGXOHV

    DQ HQWU\ SRLQW DSSOLFDWLRQ FODVV QDPH WKHVH DUH RSWLRQDO DOWKRXJK DQ\ PRGXOH UHIHUUHG WR LQ +70/ PXVWOHDVW RQH HQWU\ SRLQW FODVV VSHFLILHG

    VRXUFH SDWK HQWULHV

    SXEOLF SDWK HQWULHV

    GHIHUUHG ELQGLQJ UXOHV LQFOXGLQJ SURSHUW\ SURYLGHUV DQG FODVV JHQHUDWRUV

    0RGXOHV DUHGHILQHG LQ ;0/DQG SODFHG LQWR \RXUSURMHFW V SDFNDJH KLHUDUFK\0RGXOHV PD\ DSSHDU LQ DQ\ SDFNDJH LQ\RXU FODVVSDWK DOWKRXJK LW LV VWURQJO\ UHFRPPHQGHG WKDW WKH\ DSSHDU LQ WKH URRW SDFNDJH RI DVWDQGDUG SURMHFW OD\RXW

    (QWU\ 3RLQW &ODVVHV

    $ PRGXOH HQWU\ SRLQW LV DQ\ FODVV WKDW LV DVVLJQDEOH WR(QWU\3RLQWDQG WKDW FDQ EH FRQVWUXFWHG ZLWKRXW SDUDPHWHUV :KHQ DPRGXOH LV ORDGHG HYHU\ HQWU\ SRLQW FODVV LV LQVWDQWLDWHG DQG LWV(QWU\3RLQW RQ0RGXOH/RDGPHWKRG JHWV FDOOHG

    6RXUFH 3DWK

    0RGXOHV FDQ VSHFLI\ ZKLFK VXESDFNDJHV FRQWDLQ WUDQVODWDEOHVRXUFHFDXVLQJ WKH QDPHG SDFNDJH DQG LWV VXESDFNDJHV WREH DGGHG WR WKHVRXUFH SDWK2QO\ ILOHV IRXQG RQ WKH VRXUFH SDWK DUH FDQGLGDWHV WR EH WUDQVODWHG LQWR -DYD6FULSWSRVVLEOH WR PL[FOLHQW VLGHDQGVHUYHU VLGHFRGH WRJHWKHU LQ WKH VDPH FODVVSDWK ZLWKRXW FRQIOLFW :KHQ PRGXOH LQKHULWPRGXOHV WKHLU VRXUFH SDWKV DUH FRPELQHG VR WKDW HDFK PRGXOH ZLOO KDYH DFFHVV WR WKH WUDQVODWDEOH VRXUF

    7KH GHIDXOW VRXUFH SDWK LV WKHFOLHQW VXESDFNDJH XQGHUQHDWK ZKHUH WKH0RGXOH ;0/ )LOH LV VWRUHG

    3XEOLF 3DWK

    0RGXOHV FDQ VSHFLI\ ZKLFK VXESDFNDJHV DUH SXEOLF FDXVLQJ WKH QDPHG SDFNDJH DQG LWV VXESDFNDJHV WR EH DGGHG WR WKH SXEOLF SDWK7KH SXEOLF SDWK LV WKH SODFH LQ \RXU SURMHFW ZKHUH VWDWLF UHVRXUFHV UHIHUHQFHG E\ \RXU *:7 PRGXOH VX&66 RU LPDJHV DUH VWRUHG :KHQ \RX FRPSLOH \RXU DSSOLFDWLRQ LQWR -DYD6FULSW DOO WKH ILOHV WKDW FDQ EH IRXQG RQSXEOLF SDWK DUH FRSLHG WR WKH PRGXOH V RXWSXW GLUHFWRU\ :KHQ UHIHUHQFLQJ SXEOLF UHVRXUFHV LQ FOLHQW FRGH IRVHWWLQJ WKH 85/ RI DQ,PDJH ZLGJHW \RX VKRXOG FRQVWUXFW WKH 85/ OLNH WKLV*:7 JHW0RGXOH%DVH85/UHVRXUFH1DPH SQJ :KHQ UHIHUHQFLQJ SXEOLF UHVRXUFHV IURP D0RGXOH ;0/ )LOH MXVW XVH WKH UHODWLYH SDWK ZLWKLQ WKH

    7KH WHVW GLUHFWRU\

    0RGXOHV 8QLWV RI FRQILJXUDWLRQ

    2UJDQL]LQJ3URMHFWV *RRJOH :HE 7RRONLW *RRJOH &RGH

    S FRGH JRRJOH FRP ZHEWRRONLW GRF 'HY*XLGH2UJDQL]LQJ3URMHFWV KWPO

  • 8/14/2019 GWT 1.6 Developer Guide

    15/116

    SXEOLF IROGHU WKH PRGXOH V EDVH 85/ ZLOO EH SUHSHQGHG DXWRPDWLFDOO\ :KHQ DPRGXOH LQKHULWV RWKHU PRGXOHV WKSDWKV DUH FRPELQHG VR WKDW HDFK PRGXOH ZLOO KDYH DFFHVV WR WKH VWDWLF UHVRXUFHV LW H[SHFWV

    7KH GHIDXOW SXEOLF SDWK LV WKH SXEOLF VXEGLUHFWRU\ XQGHUQHDWK ZKHUH WKH0RGXOH ;0/ )LOH LV VWRUHG

    0RGXOHV DUH GHILQHG LQ ;0/ ILOHV ZLWK D ILOH H[WHQVLRQ RIJZW [PO 0RGXOH ;0/ ILOHV VKRXOG UHVLGH LQ \RXU SURMHFW V URRWSDFNDJH

    ,I \RX DUH XVLQJ WKHVWDQGDUG SURMHFW VWUXFWXUH\RXU PRGXOH ;0/ FDQ EH DV VLPSOH DV WKH IROORZLQJ H[DPSOH

    PRGXOH UHQDPH WR G\QDWDEOH !LQKHULWVQDPH FRP JRRJOH JZW XVHU 8VHU !HQWU\ SRLQW FODVV FRP JRRJOH JZW VDPSOH G\QDWDEOH FOLHQW '\QD7DEOH !

    PRGXOH!

    /RDGLQJ PRGXOHV

    0RGXOH ;0/ ILOHV DUH IRXQG RQ WKH -DYD FODVVSDWK 0RGXOHV DUH DOZD\V UHIHUUHG WR E\ WKHLU ORJLFDO QDPHV 7KH ORJLQDPH RI D PRGXOH LV RI WKH IRUP SNJ SNJ 0RGXOH1DPH DOWKRXJK DQ\ QXPEHU RI SDFNDJHV PD\ EH SUHVHQW 7KH ORJLFDOQDPH LQFOXGHV QHLWKHU WKH DFWXDO ILOH V\VWHP SDWK QRU WKH ILOH H[WHQVLRQ

    )RU H[DPSOH LI WKH PRGXOH ;0/ ILOH KDV D ILOH QDPH RI

    a VUF FRP H[DPSOH FDO &DOHQGDU JZW [PO

    WKHQ WKH ORJLFDO QDPH RI WKH PRGXOH LV

    FRP H[DPSOH FDO &DOHQGDU

    5HQDPLQJ PRGXOHV

    7KH PRGXOH! HOHPHQW VXSSRUWV DQ RSWLRQDO DWWULEXWHUHQDPH WRWKDW FDXVHV WKH FRPSLOHU WR EHKDYH DV WKRXJK WKHPRGXOH KDG D GLIIHUHQW QDPH WKDQ WKH ORQJ IXOO\ TXDOLILHG QDPH 5HQDPLQJ D PRGXOH KDV WZR SULPDU\ XVH FDVHV

    WR KDYH D VKRUWHU PRGXOH QDPH WKDW GRHVQ W UHIOHFW WKH DFWXDO SDFNDJH VWUXFWXUH WKLV LV WKH PRVW WUHFRPPHQGHG XVH FDVH

    WR FUHDWH D ZRUNLQJ PRGXOH WR VSHHG XS GHYHORSPHQW WLPH E\ UHVWULFWLQJ WKH QXPEHU RI SHUPXWDWLRQV

    FRP IRR :RUNLQJ0RGXOH JZW [PO

    PRGXOH UHQDPH WR FRP IRR 0\0RGXOH !LQKHULWVQDPH FRP IRR 0\0RGXOH !VHW SURSHUW\ QDPH XVHU DJHQW YDOXH LH !VHW SURSHUW\ QDPH ORFDOH YDOXH GHIDXOW !

    PRGXOH!

    :KHQ :RUNLQJ0RGXOH JZW [PO LV FRPSLOHG WKH FRPSLOHU ZLOO SURGXFH RQO\ DQLH YDULDQW XVLQJ WKH GHIDXOW ORFDOH WKLVZLOO VSHHG XS GHYHORSPHQW FRPSLODWLRQV 7KH RXWSXW IURP WKH:RUNLQJ0RGXOH JZW [PO ZLOO EH D GURS LQ UHSODFHPHQWIRU0\0RGXOH JZW [PO EHFDXVH WKH FRPSLOHU ZLOO JHQHUDWH WKH RXWSXW XVLQJ WKH DOWHUQDWH QDPH 2I FRXUVH LI FRP IRR 0\0RGXOH ZDV LWVHOI UHQDPHG \RX ZRXOG MXVW FRS\ LWV UHQDPH WR DWWULEXWH

    'LYLGLQJ FRGH LQWR PXOWLSOH PRGXOHV

    &UHDWLQJ D VHFRQG PRGXOH GRHVQ W QHFHVVDULO\ PHDQ WKDW WKDW PRGXOH PXVW GHILQH DQ HQWU\ SRLQW 7\SLFDOO\ \RQHZ PRGXOH ZKHQ \RX ZDQW WR SDFNDJH XS D OLEUDU\ RI *:7 FRGH WKDW \RX ZDQW WR UHXVH LQ RWKHU *:7 SURMHFWV $QH[DPSOH RI WKLV LV WKH *RRJOH $3, /LEUDU\ IRU *RRJOH :HE 7RRONLW*$/*:7 VSHFLILFDOO\ WKH *HDUV IRU *:7 $3, ELQGLQJ,I \RX GRZQORDG WKH OLEUDU\ DQG WDNH D ORRN DW WKHJZW JRRJOH DSLV FRP JRRJOH JZW JHDUV \RX OO ILQG WKH

    'HILQLQJ D PRGXOH IRUPDW RI PRGXOH ;0/ ILOHV

    2UJDQL]LQJ3URMHFWV *RRJOH :HE 7RRONLW *RRJOH &RGH

    S FRGH JRRJOH FRP ZHEWRRONLW GRF 'HY*XLGH2UJDQL]LQJ3URMHFWV KWPO

  • 8/14/2019 GWT 1.6 Developer Guide

    16/116

  • 8/14/2019 GWT 1.6 Developer Guide

    17/116

    7 KH VXSHU VRXUFH! WDJ LQVWUXFWV WKH FRPSLOHU WR UH URRW D VRXUFH SDWK 7KLV LV XVHIXO IRU FDVHV ZKHUH \RX ZDUH XVH DQ H[LVWLQJ -DYD $3, IRU D *:7 SURMHFW EXW WKH RULJLQDO VRXUFH LV QRW DYDLODEOH RU QRW WUDQVODWDEOH $ FUHDVRQ IRU WKLV LV WR HPXODWH SDUW RI WKH -5( QRW LPSOHPHQWHG E\ *:7

    )RU H[DPSOH VXSSRVH \RX ZDQW LPSOHPHQW WKH 88,' FODVV SURYLGHG E\ WKH -5( XQGHUMDYD XWLO$VVXPH \RXU SURMHFW VPRGXOH ILOH LVFRP H[DPSOH P\SURMHFW 0\3URMHFW JZW [PO 3ODFH WKH VRXUFH IRU WKH 88,' FODVV LQWRFRP H[DPSOH P\SURMHFW MUH MDYD XWLO 88,' MDYD 7KHQ DGG D OLQH WR0\3URMHFW JZW [PO

    VXSHU VRXUFH SDWK MUH !

    7KLV WHOOV WKH FRPSLOHU WR DGG DOO VXEIROGHUV RIFRP H[DPSOH P\SURMHFW MUH WR WKHVRXUFH SDWKEXW WR VWULS RII WKHSDWK SUHIL[ XS WR DQG LQFOXGLQJMUH$V D UHVXOWFRP JRRJOH P\SURMHFW JZW MUH MDYD XWLO 88,' MDYD ZLOO EHYLVLEOH WR WKH FRPSLOHU DVMDYD XWLO 88,' MDYD ZKLFK LV WKH LQWHQGHG UHVXOW

    7KH *:7 SURMHFW XVHV WKLV WHFKQLTXH LQWHUQDOO\ IRU WKH -5( HPXODWLRQ FODVVHV SURYLGHG ZLWK *:7 2QH FDYHDW VSHRYHUULGLQJ -5( FODVVHV LQ WKLV ZD\ LV WKDW WKH\ ZLOO QHYHU DFWXDOO\ EH XVHG LQ KRVWHG PRGH ,Q KRVWHG PRGH WKHFODVVHV DOZD\V VXSHUVHGH FODVVHV FRPSLOHG IURP VRXUFH

    7KH VXSHU VRXUFH! HOHPHQW VXSSRUWVSDWWHUQ EDVHG ILOWHULQJWR DOORZ ILQH JUDLQHG FRQWURO RYHU ZKLFK UHVRXUFHV JHWFRSLHG LQWR WKH RXWSXW GLUHFWRU\ GXULQJ D *:7 FRPSLOH

    ;0/ (OHPHQW 5HIHUHQFH

    7KLV VHFWLRQ GRFXPHQWV WKH PRVW FRPPRQO\ XVHG HOHPHQWV LQ WKH PRGXOH ;0/ ILOH

    LQKHULWV QDPHORJLFDO PRGXOH QDPH! ,QKHULWV DOO WKH VHWWLQJV IURP WKH VSHFLILHG PRGXOH DV LI WKH FRQWHQWWKH LQKHULWHG PRGXOH V ;0/ ZHUH FRSLHG YHUEDWLP $Q\ QXPEHU RI PRGXOHV FDQ EH LQKHULWHG LQ WKLV PDQQHU 6HHWKLV DGYLFH DERXW GHFLGLQJ ZKLFK PRGXOHV WR LQKHULW

    HQWU\ SRLQW FODVVFODVVQDPH! 6SHFLILHV DQHQWU\ SRLQWFODVV $Q\ QXPEHU RI HQWU\ SRLQW FODVVHV FDQ EH DGGHGLQFOXGLQJ WKRVH IURP LQKHULWHG PRGXOHV (QWU\ SRLQWV DUH DOO FRPSLOHG LQWR D VLQJOH FRGHEDVH 7KH\ DUH FDVHTXHQWLDOO\ LQ WKH RUGHU LQ ZKLFK WKH\ DSSHDU LQ WKH PRGXOH ILOH 6R ZKHQ WKHRQ0RGXOH/RDG RI \RXU ILUVW HQWU\SRLQW ILQLVKHV WKH QH[W HQWU\ SRLQW LV FDOOHG LPPHGLDWHO\

    VRXUFH SDWK SDWK! (DFK RFFXUUHQFH RI WKHVRXUFH! WDJ DGGV D SDFNDJH WR WKHVRXUFH SDWKE\ FRPELQLQJWKH SDFNDJH LQ ZKLFK WKH PRGXOH ;0/ LV IRXQG ZLWK WKH VSHFLILHG SDWK WR D VXESDFNDJH $Q\ -DYD VRXUFH ILOHDSSHDULQJ LQ WKLV VXESDFNDJH RU DQ\ RI LWV VXESDFNDJHV LV DVVXPHG WR EH WUDQVODWDEOH 7KHVRXUFH! HOHPHQWVXSSRUWVSDWWHUQ EDVHG ILOWHULQJWR DOORZ ILQH JUDLQHG FRQWURO RYHU ZKLFK UHVRXUFHV JHW FRSLHG LQWR WKH RXWSXW

    GLUHFWRU\ GXULQJ D *:7 FRPSLOH

    ,I QR VRXUFH! HOHPHQW LV GHILQHG LQ D PRGXOH ;0/ ILOH WKHFOLHQW VXESDFNDJH LVLPSOLFLWO\ DGGHG WR WKH VRXUFH SDWK DV LIVRXUFH SDWK FOLHQW ! KDG EHHQIRXQG LQ WKH ;0/ 7KLV GHIDXOW KHOSV NHHS PRGXOH ;0/ FRPSDFW IRU VWDQGDUG SURMHFWOD\RXWV

    SXEOLF SDWK SDWK! (DFK RFFXUUHQFH RI WKHSXEOLF! WDJ DGGV D SDFNDJH WR WKHSXEOLF SDWKE\ FRPELQLQJ WKHSDFNDJH LQ ZKLFK WKH PRGXOH ;0/ LV IRXQG ZLWK WKH VSHFLILHG SDWK WR LGHQWLI\ WKH URRW RI D SXEOLF SDWK HQWUDSSHDULQJ LQ WKLV SDFNDJH RU DQ\ RI LWV VXESDFNDJHV ZLOO EH WUHDWHG DV D SXEOLFO\ DFFHVVLEOH UHVRXUFH 7KHSXEOLF! HOHPHQW VXSSRUWVSDWWHUQ EDVHG ILOWHULQJWR DOORZ ILQH JUDLQHG FRQWURO RYHU ZKLFK UHVRXUFHV JHW FRSLHGLQWR WKH RXWSXW GLUHFWRU\ GXULQJ D *:7 FRPSLOH

    ,I QR SXEOLF! HOHPHQW LV GHILQHG LQ D PRGXOH ;0/ ILOH WKH SXEOLF VXESDFNDJH LVLPSOLFLWO\ DGGHG WR WKH SXEOLF SDWK DV LISXEOLF SDWK SXEOLF ! KDG EHHQ

    IRXQG LQ WKH ;0/ 7KLV GHIDXOW KHOSV NHHS PRGXOH ;0/ FRPSDFW IRU VWDQGDUG SURMHFWOD\RXWV

    VHUYOHW SDWKXUO SDWKFODVV FODVVQDPH! )RU 53& WKLV HOHPHQW ORDGV D VHUYOHW FODVV PRXQWHG DW WKHVSHFLILHG 85/ SDWK 7KH 85/ SDWK VKRXOG EH DEVROXWH DQG KDYH WKH IRUP RI D GLUHFWRU\ IRU H[DPSOHFDOHQGDU

  • 8/14/2019 GWT 1.6 Developer Guide

    18/116

    VFULSW VUF M V XUO ! $XWRPDWLFDOO\ LQMHFWV WKH H[WHUQDO -DYD6FULSW ILOH ORFDWHG DW WKH ORFDWLRQ VSHFLILVUF 6HHDXWRPDWLF UHVRXUFH LQFOXVLRQIRU GHWDLOV ,I WKH VSHFLILHG 85/ LV QRW DEVROXWH WKH UHVRXUFH ZLOO EH ORDGHG IURP WPRGXOH V EDVH 85/ LQ RWKHU ZRUGV LW ZRXOG PRVW OLNHO\ EH D SXEOLF UHVRXUFH

    VW\OHVKHHW VUFFVV XUO ! $XWRPDWLFDOO\ LQMHFWV WKH H[WHUQDO &66 ILOH ORFDWHG DW WKH ORFDWLRQ VSHFLILHGVUF 6HHDXWRPDWLF UHVRXUFH LQFOXVLRQIRU GHWDLOV ,I WKH VSHFLILHG 85/ LV QRW DEVROXWH WKH UHVRXUFH ZLOO EH ORDGHG IURP WPRGXOH V EDVH 85/ LQ RWKHU ZRUGV LW ZRXOG PRVW OLNHO\ EH D SXEOLF UHVRXUFH

    H[WHQG SURSHUW\ QDPHFOLHQW SURSHUW\ QDPHYDOXHVFRPPD VHSDUDWHG YDOXHV! ([WHQGV WKH VHW RI YDOXHV IRU DQ H[LVWLQJ FOLHQW SURSHUW\ $Q\ QXPEHU RI YDOXHV PD\ EH DGGHG LQ WKLV PDQQHU DQG FOLHQW SURSHUW\ YDOXHVDFFXPXODWH WKURXJK LQKHULWHG PRGXOHV

  • 8/14/2019 GWT 1.6 Developer Guide

    19/116

    UHSODFH ZLWK FODVV FRP JRRJOH JZW XVHU FOLHQW XL LPSO )RFXV,PSO2OG !ZKHQ W\SH LV FODVV FRP JRRJOH JZW XVHU FOLHQW XL LPSO )RFXV,PSO !

    DQ\ !ZKHQ SURSHUW\ LV QDPH XVHU DJHQW YDOXH JHFNR !ZKHQ SURSHUW\ LV QDPH XVHU DJHQW YDOXH RSHUD !

    DQ\ !UHSODFH ZLWK!

    6DIDUL QHHGV D GLIIHUHQW KLGGHQ LQSXW !UHSODFH ZLWK FODVV FRP JRRJOH JZW XVHU FOLHQW XL LPSO )RFXV,PSO6DIDUL !

    ZKHQ W\SH LV FODVV FRP JRRJOH JZW XVHU FOLHQW XL LPSO )RFXV,PSO !ZKHQ SURSHUW\ LV QDPH XVHU DJHQW YDOXH VDIDUL !

    UHSODFH ZLWK!

    ,( V LPSOHPHQWDWLRQ WUDSV H[FHSWLRQV RQ LQYDOLG VHW)RFXV !UHSODFH ZLWK FODVV FRP JRRJOH JZW XVHU FOLHQW XL LPSO )RFXV,PSO,( !ZKHQ W\SH LV FODVV FRP JRRJOH JZW XVHU FOLHQW XL LPSO )RFXV,PSO !

    DQ\ !ZKHQ SURSHUW\ LV QDPH XVHU DJHQW YDOXH LH !

    DQ\ !UHSODFH ZLWK!

    PRGXOH!

    *:7 O LEUDULHV DUH RUJDQL]HG LQWR PRGXOHV 7KH VWDQGDUG PRGXOHV FRQWDLQ ELJ SLHFHV RI IXQFWLRQDOLW\ GHVLJQHGLQGHSHQGHQWO\ RI HDFK RWKHU %\ VHOHFWLQJ RQO\ WKH PRGXOHV \RX QHHG IRU \RXU SURMHFW IRU H[DPSOH WKH -621 PRGXOUDWKHU WKDQ WKH ;0/ PRGXOH \RX PLQLPL]H FRPSOH[LW\ DQG UHGXFH FRPSLODWLRQ WLPH

    *HQHUDOO\ \RX ZDQW WR LQKHULW DW OHDVW WKH 8VHU PRGXOH 7KH 8VHU PRGXOH FRQWDLQV DOO WKH FRUH *:7 IXQFWLRQDLQFOXGLQJ WKH (QWU\3RLQW FODVV 7KH 8VHU PRGXOH DOVR FRQWDLQV UHXVDEOH 8, FRPSRQHQWV ZLGJHWV DQG SDQHOV DQIRU WKH +LVWRU\ IHDWXUH ,QWHUQDWLRQDOL]DWLRQ '20 SURJUDPPLQJ DQG PRUH

    6WDQGDUG 0RGXOHV *:7

    0RGXOH /RJLFDO 1DPH 0RGXOH 'HILQLWLRQ &RQWH QWV

    8VHU FRP JRRJOH JZW XVHU 8VHU 8VHU JZW [PO &RUH *:7 IXQFWLRQDOLW\

    +773 FRP JRRJOH JZW KWWS +773 +773 JZW [PO /RZ OHYHO +773 FRPPXQLFDWLRQV OLEUDU\

    -621 FRP JRRJOH JZW MVRQ -621 -621 JZW [PO -621 FUHDWLRQ DQG SDUVLQJ

    -8QLW FRP JRRJOH JZW MXQLW -8QLW -8QLW JZW [PO -8QLW WHVWLQJ IUDPHZRUN LQWHJUDWLRQ

    ;0/ FRP JRRJOH JZW [PO ;0/ ;0/ JZW [PO ;0/ GRFXPHQW FUHDWLRQ DQG SDUVLQJ

    *:7 DOVR SURYLGHV VHYHUDOWKHPHPRGXOHV ZKLFK FRQWDLQ GHIDXOW VW\OHV IRU ZLGJHWV DQG SDQHOV

  • 8/14/2019 GWT 1.6 Developer Guide

    20/116

  • 8/14/2019 GWT 1.6 Developer Guide

    21/116

    7 KHPRGXOH ;0/ IRUPDW VSXEOLF! VRXUFH! DQG VXSHU VRXUFH! HOHPHQWV VXSSRUWV FHUWDLQ DWWULEXWHV DQG QHVWHOHPHQWV WR DOORZ SDWWHUQ EDVHG LQFOXVLRQ DQG H[FOXVLRQ LQ WKHSXEOLF SDWK7KHVH HOHPHQWV IROORZ WKH VDPH UXOHV DV$QWV)LOH6HW HOHPHQW 3OHDVH VHH WKHGRFXPHQWDWLRQIRU)LOH6HW IRU D JHQHUDO RYHUYLHZ 7KHVH HOHPHQWV GR QRW VXSSRUWWKH IXOO)LOH6HWVHPDQWLFV 2QO\ WKH IROORZLQJ DWWULEXWHV DQG QHVWHG HOHPHQWV DUH FXUUHQWO\ VXSSRUWHG

    7KH LQFOXGHVDWWULEXWH

    7KH H[FOXGHV DWWULEXWH7KH GHIDXOWH[FOXGHVDWWULEXWH

    7KH FDVHVHQVLWLYHDWWULEXWH

    1HVWHGLQFOXGHWDJV

    1HVWHGH[FOXGH WDJV

    2WKHU DWWULEXWHV DQG QHVWHG HOHPHQWV DUH QRW VXSSRUWHG

    7KH GHIDXOW YDOXH RIGHIDXOWH[FOXGHVLVWUXH%\ GHIDXOW WKH SDWWHUQV OLVWHGKHUHDUH H[FOXGHG

    &RQVLGHU WKH IROORZLQJ +70/ SDJH WKDW ORDGV D *:7 PRGXOH

    '2&7

  • 8/14/2019 GWT 1.6 Developer Guide

    22/116

    KDVKQDPH! FDFKH KWPO FRPSOHWHVRQ0RGXOH/RDG LV QRW FDOOHG \HW DV ZH UH VWLOO ZDLWLQJ RQH[WHUQDO6FULSW2QH MVWR FRPSOHWH EHIRUH WKH GRFXPHQW LV FRQVLGHUHG UHDG\

    H[WHUQDO6FULSW2QH MVFRPSOHWHV 7KH GRFXPHQW LV UHDG\ VR RQ0RGXOH/RDG ILUHV

    UHDOO\%LJ,PDJH7ZR MSJ FRPSOHWHV

    ERG\ RQORDG ILUHV LQ WKLV FDVH VKRZLQJ DQ DOHUW ER[

    7KLV LV D ELW FRPSOH[ EXW WKH SRLQW LV WR VKRZ H[DFWO\ ZKHQ YDULRXV UHVRXUFHV DUH IHWFKHG DQG ZKHQRQ0RGXOH/RDGZLOO EH FDOOHG 7KH PRVW LPSRUWDQW WKLQJV WR UHPHPEHU DUH WKDW

  • 8/14/2019 GWT 1.6 Developer Guide

    23/116

    *RRJOH :HE 7RRONLW +RPH 'RFV %ORJ *URXS 7HUPV

    &OLHQW VLGH FRGH&RPSDWLELOLW\ ZLWK WKH -DYD /DQJXDJH DQG /LEUDULHV

    +LVWRU\

    1XPEHU DQG 'DWH )RUPDWWLQJ

    3URJUDPPLQJ 'HOD\HG /RJLF

    :RUNLQJ ZLWK -621

    :RUNLQJ ZLWK ;0/

    -DYD6FULSW 1DWLYH ,QWHUIDFH -61,

    -DYD6FULSW 2YHUOD\ 7\SHV

    'HIHUUHG %LQGLQJ

  • 8/14/2019 GWT 1.6 Developer Guide

    24/116

    7KH H[DPSOH DERYH ORJV D PHVVDJH WR WKH +RVWHG%URZVHU FRQVROH ,I \RX WU\WR UXQ WKLV H[DPSOHDSSOLFDWLRQ LQ ZHE PR\RX ZRQ W VHHDQ\WKLQJ EHFDXVH WKH *:7 ORJ PHWKRG LV FRPSLOHG DZD\ ZKHQ WKH FOLHQW VLGH FRGH LV WUDQVODWHG LQWR-DYD6FULSW

    +HOOR :RUOG ([DPSOH

    ,QFOXGHG ZLWK WKH *:7 GLVWULEXWLRQLV D VDPSOH +HOOR :RUOG SURJUDP WKDW ORRNVOLNH WKLV ZKHQUXQ LQ KRVWHG PRGH

    SDFNDJH FRP JRRJOH JZW VDPSOH KHOOR FOLHQW

    LPSRUWFRP JRRJOH JZW FRUH FOLHQW(QWU\3RLQWLPSRUWFRP JRRJOH JZW HYHQWGRP FOLHQW&OLFN(YHQWLPSRUWFRP JRRJOH JZW HYHQWGRP FOLHQW&OLFN+DQGOHULPSRUWFRP JRRJOH JZW XVHU FOLHQW:LQGRZLPSRUWFRP JRRJOH JZW XVHU FOLHQWXL %XWWRQLPSRUWFRP JRRJOH JZW XVHU FOLHQWXL 5RRW3DQHOLPSRUWFRP JRRJOH JZW XVHU FOLHQWXL :LGJHW

    +HOOR :RUOG DSSOLFDWLRQ

    SXEOLF FODVV +HOOR LPSOHPHQWV(QWU\3RLQW ^

    SXEOLF YRLGRQ0RGXOH/RDG ^%XWWRQE QHZ %XWWRQ&OLFN PH QHZ &OLFN+DQGOHU ^

    SXEOLF YRLGRQ&OLFN &OLFN(YHQWHYHQW ^:LQGRZ DOHUW +HOOR $-$;

    ``

    5RRW3DQHO JHW DGG E`

    `

    ,Q WKH HQWU\ SRLQW PHWKRG IRU WKH +HOOR :RUOG DSSOLFDWLRQ WKH IROORZLQJ DFWLRQVZHUH WDNHQ

    D QHZ %XWWRQ ZLGJHW ZDV FUHDWHGZLWK WKH WH[W &OLFN PH

    D KDQGOHU ZDV FUHDWHG WR UHVSRQG WR WKH XVHU FOLFNLQJ WKH EXWWRQ

    &RGLQJ %DVLFV *RRJOH :HE 7RRONLW *RRJOH &RGH

    S FRGH JRRJOH FRP ZHEWRRONLW GRF 'HY*XLGH&RGLQJ%DVLFV KWPO

  • 8/14/2019 GWT 1.6 Developer Guide

    25/116

  • 8/14/2019 GWT 1.6 Developer Guide

    26/116

    WKHVH OLEUDULHVDUH TXLWH ODUJH DQG UHO\ RQ IXQFWLRQDOLW\WKDW LV XQDYDLODEOH ZLWKLQ ZHE EURZVHUV 7R ILQG RXWFODVVHV DQG PHWKRGV DUH VXSSRUWHG IRU FRUH -DYD UXQWLPH SDFNDJHV VHH WKH *:7-5( (PXODWLRQ 5HIHUHQFH

    7LS

  • 8/14/2019 GWT 1.6 Developer Guide

    27/116

    )RU H[DPSOH DKLVWRU\ WRNHQ QDPHG SDJH ZRXOG EH DGGHG WR D 85/DV IROORZV

    KWWS ZZZ H[DPSOH FRP FRP H[DPSOH JZW +LVWRU\([DPSOH +LVWRU\([DPSOH KWPO SDJH

    :KHQ WKH DSSOLFDWLRQ ZDQWV WR SXVK D SODFHKROGHU RQWR WKH EURZVHU V KLVWRU\ VWDFN LW VLPSO\ LQYRNHV+LVWRU\ QHZ,WHP WRNHQ:KHQ WKH XVHU XVHV WKH EDFN EXWWRQ D FDOOZLOO EH PDGH WR DQ\ REMHFW WKDW ZDV DGGHG DV DKDQGOHU ZLWK+LVWRU\ DGG9DOXH&KDQJH+DQGOHU,W LV XS WR WKH DSSOLFDWLRQ WR UHVWRUH WKH VWDWH DFFRUGLQJ WR WKH YDOXHQHZ WRNHQ

    ([ DPSOH

    7R XVH *:7 +LVWRU\ VXSSRUW \RX PXVW ILUVW HPEHG DQ LIUDPH LQWR \RXUKRVW +70/ SDJH

    LIUDPH VUF MDYDVFULSWLG BBJZWBKLVWRU\)UDPHVW\OH ZLGWK KHLJKW ERUGHU ! LIUDPH!

    7KHQ LQ \RXU *:7 DSSOLFDWLRQ SHUIRUP WKH IROORZLQJ VWHSV

    $GG DKLVWRU\ WRNHQ WR WKH KLVWRU\ VWDFN ZKHQ \RX ZDQW WR HQDEOH DKLVWRU\ HYHQW

    &UHDWH DQ REMHFW WKDW LPSOHPHQWV WKH9DOXH&KDQJH+DQGOHU LQWHUIDFH SDUVHV WKH QHZ WRNHQ DYDLODEOH E\ FDOOLQJ9DOXH&KDQJH(YHQW JHW9DOXHDQG FKDQJHV WKH DSSOLFDWLRQ VWDWH WR PDWFK

    7KH IROORZLQJ VKRUW H[DPSOH VKRZV KRZ WR DGG DKLVWRU\ HYHQW HDFK WLPH WKH XVHU VHOHFWV D QHZ WDE LQ D7DE3DQHO

    LPSRUWFRP JRRJOH JZW FRUH FOLHQW(QWU\3RLQWLPSRUWFRP JRRJOH JZW HYHQWORJLFDO VKDUHG6HOHFWLRQ(YHQWLPSRUWFRP JRRJOH JZW HYHQWORJLFDO VKDUHG6HOHFWLRQ+DQGOHULPSRUWFRP JRRJOH JZW HYHQWORJLFDO VKDUHG9DOXH&KDQJH(YHQWLPSRUWFRP JRRJOH JZW HYHQWORJLFDO VKDUHG9DOXH&KDQJH+DQGOHULPSRUWFRP JRRJOH JZW XVHU FOLHQW+LVWRU\LPSRUWFRP JRRJOH JZW XVHU FOLHQWXL +70/LPSRUWFRP JRRJOH JZW XVHU FOLHQWXL 5RRW3DQHOLPSRUWFRP JRRJOH JZW XVHU FOLHQWXL 7DE3DQHO

    (QWU\ SRLQW FODVVHV GHILQH FRGH!RQ0RGXOH/RDG FRGH!

    SXEOLF FODVV %URZVHU+LVWRU\([DPSOH LPSOHPHQWV(QWU\3RLQW ^

    7DE3DQHOWDE3DQHO

    7KLV LV WKH HQWU\ SRLQW PHWKRG

    SXEOLF YRLGRQ0RGXOH/RDG ^WDE3DQHO QHZ 7DE3DQHO

    WDE3DQHO DGG QHZ+70/ K !3DJH &RQWHQW /ODPDV K ! 3DJHWDE3DQHO DGG QHZ+70/ K !3DJH &RQWHQW $OSDFDV K ! 3DJHWDE3DQHO DGG QHZ+70/ K !3DJH &RQWHQW &DPHOV K ! 3DJH

    WDE3DQHO DGG6HOHFWLRQ+DQGOHUQHZ 6HOHFWLRQ+DQGOHU,QWHJHU! ^SXEOLF YRLGRQ6HOHFWLRQ 6HOHFWLRQ(YHQW,QWHJHU! HYHQW ^72'2 $XWR JHQHUDWHG PHWKRG VWXE

    +LVWRU\ QHZ,WHP SDJH HYHQWJHW6HOHFWHG,WHP``

    +LVWRU\ DGG9DOXH&KDQJH+DQGOHUQHZ 9DOXH&KDQJH+DQGOHU6WULQJ! ^SXEOLF YRLGRQ9DOXH&KDQJH 9DOXH&KDQJH(YHQW6WULQJ! HYHQW ^

    6WULQJKLVWRU\7RNHQ HYHQWJHW9DOXH

    3DUVH WKH KLVWRU\ WRNHQWU\ ^

    LI KLVWRU\7RNHQ VXEVWULQJ HTXDOV SDJH ^

    &RGLQJ %DVLFV *RRJOH :HE 7RRONLW *RRJOH &RGH

    S FRGH JRRJOH FRP ZHEWRRONLW GRF 'HY*XLGH&RGLQJ%DVLFV KWPO

  • 8/14/2019 GWT 1.6 Developer Guide

    28/116

    6WULQJWDE,QGH[7RNHQ KLVWRU\7RNHQ VXEVWULQJLQWWDE,QGH[ ,QWHJHU SDUVH,QW WDE,QGH[7RNHQ

    6HOHFW WKH VSHFLILHG WDE SDQHOWDE3DQHO VHOHFW7DEWDE,QGH[

    ` HOVH ^WDE3DQHO VHOHFW7DE

    `

    ` FDWFK ,QGH[2XW2I%RXQGV([FHSWLRQ H ^WDE3DQHO VHOHFW7DE

    ``

    `

    WDE3DQHO VHOHFW7DE5RRW3DQHO JHW DGG WDE3DQHO

    ``

    +\SHUOLQN :LGJHWV

    +\SHUOLQNV DUH FRQYHQLHQW WR XVHWR LQFRUSRUDWH KLVWRU\ VXSSRUW LQWR DQ DSSOLFDWLRQ +\SHUOLQN ZLGJHWV DUH*:7WKDW ORRN OLNH UHJXODU +70/ DQFKRUV

  • 8/14/2019 GWT 1.6 Developer Guide

    29/116

  • 8/14/2019 GWT 1.6 Developer Guide

    30/116

    6\PERO 0HDQLQJ

    'LJLW ]HUR IRUFHG

    'LJLW ]HUR VKRZV DV DEVHQW

    'HFLPDO VHSDUDWRU RU PRQHWDU\ GHFLPDO VHSDUDWRU

    0LQXV VLJQ

    *URXSLQJ VHSDUDWRU

    6SHFLI\LQJ DQ LQYDOLG SDWWHUQ ZLOO FDXVH WKH1XPEHU)RUPDW JHW)RUPDW PHWKRG WR WKURZ DQMDYD ODQJ ,OOHJDO$UJXPHQW([FHSWLRQ 7KH SDWWHUQVSHFLILFDWLRQ LV YHU\ ULFK 5HIHU WR WKHFODVV GRFXPHQWDWLRQIRU WKH IXOO VHW RI IHDWXUHV

    ,I \RX ZLOO EH XVLQJ WKH VDPH QXPEHU IRUPDW SDWWHUQ PRUH WKDQ RQFH LW LV PRVW HIILFLHQW WR FDFKH WKH IRUPDW KDQGOHIURP1XPEHU)RUPDW JHW)RUPDW SDWWHUQ

    8VLQJ 'DWH7LPH)RUPDW

    *:7 SURYLGHV WKH'DWH7LPH)RUPDWFODVV WR UHSODFH WKH IXQFWLRQDOLW\ RI WKH'DWH)RUPDWDQG7LPH)RUPDW FODVVHV IURPWKH -5(

    )RU WKH'DWH7LPH)RUPDWFODVV WKHUH DUHD ODUJH QXPEHU RI GHIDXOW IRUPDWV GHILQHG

    'DWH WRGD\ QHZ 'DWH

    SULQWV 7XH 'HF *07 LQ WKH GHIDXOW ORFDOH*:7 ORJ WRGD\ WR6WULQJ QXOO

    SULQWV LQ WKH GHIDXOW ORFDOH*:7 ORJ 'DWH7LPH)RUPDW JHW6KRUW'DWH)RUPDW IRUPDW WRGD\ QXOO

    SULQWV 'HFHPEHU LQ WKH GHIDXOW ORFDOH*:7 ORJ 'DWH7LPH)RUPDW JHW/RQJ'DWH)RUPDW IRUPDW WRGD\ QXOO

    SULQWV 30 LQ WKH GHIDXOW ORFDOH*:7 ORJ 'DWH7LPH)RUPDW JHW6KRUW7LPH)RUPDW IRUPDW WRGD\ QXOO

    SULQWV 30 *07 LQ WKH GHIDXOW ORFDOH*:7 ORJ 'DWH7LPH)RUPDW JHW/RQJ7LPH)RUPDW IRUPDW WRGD\ QXOO

    SULQWV 'HF 30 LQ WKH GHIDXOW ORFDOH*:7 ORJ 'DWH7LPH)RUPDW JHW0HGLXP'DWH7LPH)RUPDW IRUPDW WRGD\ QXOO

    /LNH WKH1XPEHU)RUPDWFODVV \RX FDQDOVR XVH WKLV FODVV WR SDUVH D GDWH IURPD6WULQJLQWR D'DWH UHSUHVHQWDWLRQ

  • 8/14/2019 GWT 1.6 Developer Guide

    31/116

    *:7 SURYLGHV WKUHH FODVVHV WKDW \RX FDQ XVHWR GHIHU UXQQLQJ FRGH XQWLO D ODWHU SRLQW LQWLPH 7LPHU 'HIHUUHG&RPDQG ,QFUHPHQWDO&RPPDQG

    6FKHGXOLQJ ZRUN WKH 7LPHU FODVV

    8VH WKH7LPHU FODVV WR VFKHGXOH ZRUN WR EH GRQH LQ WKH IXWXUH

    7R FUHDWH D WLPHU FUHDWH D QHZ LQVWDQFH RI WKH 7LPHU FODVV DQG WKHQ RYHUULGH WKH UXQ PHWKRG HQWU\ SRLQW

    7LPHU WLPHU QHZ 7LPHU ^SXEOLF YRLGUXQ ^

    :LQGRZ DOHUW 7LPHU H[SLUHG`

    `

    ([HFXWH WKH WLPHU WR H[SLUH VHFRQGV LQ WKH IXWXUHWLPHU VFKHGXOH

    1RWLFH WKDW WKH WLPHU ZLOO QRW KDYH D FKDQFH WR H[HFXWH WKH UXQ PHWKRG XQWLO DIWHU FRQWURO UHWXUQV WR WKHORRS

    2QH W\SLFDO XVHIRU D WLPHULV WR WLPHRXW D ORQJ UXQQLQJ FRPPDQG 7KHUH DUH D IHZ UXOHVRI WKXPE WR UHPHPEHU LQ WKLVVLWXDWLRQ

    6WRUH WKH WLPHU LQ DQ LQVWDQFHYDULDEOH

    $OZD\V FKHFN WR VHH WKDW WKH WLPHU LV QRW FXUUHQWO\UXQQLQJ EHIRUH VWDUWLQJ D QHZ RQH &KHFN WKH LQVWDQFHWR VHH WKDW LW LV QXOO

    5HPHPEHU WR FDQFHO WKH WLPHU ZKHQ WKH FRPPDQG FRPSOHWHV VXFFHVVIXOO\

    $OZD\V VHW WKH LQVWDQFH YDULDEOH WR QXOO ZKHQ WKH FRPPDQG FRPSOHWHV RU WKH WLPHU H[SLUHV

    %HORZ LV D DQ H[DPSOH RI XVLQJ D WLPHRXW ZLWK D5HPRWH 3URFHGXUH &DOO53&

    LPSRUWFRP JRRJOH JZW XVHU FOLHQW7LPHULPSRUWFRP JRRJOH JZW XVHU FOLHQW:LQGRZLPSRUWFRP JRRJOH JZW XVHU FOLHQWUSF $V\QF&DOOEDFN

    SXEOLF FODVV )RR ^

    $ NHHSHU RI WKH WLPHU LQVWDQFH LQ FDVH ZH QHHG WR FDQFHO LWSULYDWH 7LPHU WLPHRXW7LPHU QXOO

    $Q LQGLFDWRU ZKHQ WKH FRPSXWDWLRQ VKRXOG TXLWSULYDWH ERROHDQDERUW)ODJ IDOVH

    VWDWLFILQDO LQW7,0(287 VHFRQG WLPHRXW

    YRLGVWDUW:RUN ^

    &KHFN WR PDNH VXUH WKH WLPHU LVQ W DOUHDG\ UXQQLQJLI WLPHRXW7LPHU QXOO ^

    :LQGRZ DOHUW &RPPDQG LV DOUHDG\ UXQQLQJUHWXUQ

    `

    &UHDWH D WLPHU WR DERUW LI WKH 53& WDNHV WRR ORQJWLPHRXW7LPHU QHZ 7LPHU ^

    SXEOLF YRLGUXQ ^:LQGRZ DOHUW 7LPHRXW H[SLUHG

    WLPHRXW7LPHU QXOODERUW)ODJ WUXH

    ``

    &UHDWLQJ 7LPHRXW /RJLF

    &RGLQJ %DVLFV *RRJOH :HE 7RRONLW *RRJOH &RGH

    S FRGH JRRJOH FRP ZHEWRRONLW GRF 'HY*XLGH&RGLQJ%DVLFV KWPO

  • 8/14/2019 GWT 1.6 Developer Guide

    32/116

    UH ,QLWLDOL]H WKH DERUW IODJ DQG VWDUW WKH WLPHUDERUW)ODJ IDOVHWLPHRXW7LPHU VFKHGXOH7,0(287 WLPHRXW LV LQ PLOOLVHFRQGV

    .LFN RII DQ 53&P\6HUYLFH P\5SF0HWKRG DUJ QHZ $V\QF&DOOEDFN ^

    SXEOLF YRLGRQ)DLOXUH 7KURZDEOHFDXJKW ^:LQGRZ DOHUW 53& )DLOHG FDXJKW

    FDQFHO7LPHU`

    SXEOLF YRLGRQ6XFFHVV 2EMHFWUHVXOW ^FDQFHO7LPHU

    LI DERUW)ODJ ^7LPHRXW DOUHDG\ RFFXUUHG GLVFDUG UHVXOW

    UHWXUQ`:LQGRZ DOHUW 53& UHWXUQHG 6WULQJ UHVXOW

    ``

    `

    6WRS WKH WLPHRXW WLPHU LI LW LV UXQQLQJSULYDWH YRLGFDQFHO7LPHU ^

    LI WLPHRXW7LPHU QXOO ^WLPHRXW7LPHU FDQFHOWLPHRXW7LPHU QXOO

    ``

    `

    ,Q RUGHUWR NHHS D XVHU LQWHUIDFH XS WR GDWH \RX VRPHWLPHVZDQW WR SHUIRUPDQ XSGDWH SHULRGLFDOO\

  • 8/14/2019 GWT 1.6 Developer Guide

    33/116

    SULYDWH YRLGVKRZ(ODSVHG ^GRXEOHHODSVHG7LPH 6\VWHP FXUUHQW7LPH0LOOLV VWDUW7LPH1XPEHU)RUPDWQ 1XPEHU)RUPDW JHW)RUPDW

    HODSVHG/DEHO VHW7H[W (ODSVHG Q IRUPDW HODSVHG7LPH`

    `

    'HIH UULQJ VRPH ORJLF LQWR WKH LPPHGLDWH IXWXUH WKH 'HIHUUHG&RPPDQG FODVV

    6RPHWLPHV \RX ZDQW WR EUHDN XS \RXU ORJLF ORRS VR WKDW WKH -DYD6FULSW HYHQW ORRS JHWV D FKDQFH WR UXQ EHWZHHQ WSLHFHV RI FRGH 7KH'HIHUUHG&RPPDQGFODVV ZLOO DOORZ \RX WR GR WKDW 7KH ORJLF WKDW \RX SDVV WR 'HIHUUHG&RPPDQG ZLOOUXQ DW VRPH SRLQW LQ WKH IXWXUH DIWHU FRQWURO KDV EHHQ UHWXUQHG WR WKH -DYD6FULSW HYHQW ORRS 7KLV OLWWOH GHLQWHUIDFH D FKDQFHWR SURFHVV VRPH XVHU HYHQWV RULQLWLDOL]H RWKHU FRGH 7R XVH WKH 'HIHUUHG&RPPDQG FODVV LQ LWIRUP \RX FUHDWH D VXEFODVV RI WKH&RPPDQG FODVV RYHUULGLQJ WKH H[HFXWH PHWKRG DQG SDVV LW WR'HIHUUHG&RPPDQG DGG&RPPDQG

    7H[W%R[ GDWD(QWU\

    6HW WKH IRFXV RQ WKH ZLGJHW DIWHU VHWXS FRPSOHWHV'HIHUUHG&RPPDQG DGG&RPPDQGQHZ &RPPDQG ^

    SXEOLF YRLGH[HFXWH ^GDWD(QWU\ VHW)RFXV

    ``

    GDWD(QWU\ QHZ 7H[W%R[

    $YRLGLQJ 6ORZ 6FULSW :DUQLQJV WKH ,QFUHPHQWDO&RPPDQG FODVV

    $-$; GHYHORSHUV QHHG WR EH DZDUH RI NHHSLQJ WKH EURZVHU UHVSRQVLYH WR WKH XVHU :KHQ -DYD6FULSW FRGH LV UXQQLQJ XVLQWHUIDFH FRPSRQHQWV OLNH EXWWRQV DQG WH[W DUHDV ZLOO QRW UHVSRQG WR XVHU LQSXW ,I WKH EURZVHUZHUH WR DOORZFRQWLQXH WKH XVHU PLJKW WKLQN WKH EURZVHU LV KXQJ DQG EH WHPSWHG WR UHVWDUW LW %XW EURZVHUV KDYHD EXLOW LPHFKDQLVP WKHXQUHVSRQVLYH VFULSW ZDUQLQJ

    $Q\ VFULSW WKDW UXQV ZLWKRXW UHWXUQLQJ FRQWURO WR WKH -DYD6FULSW PDLQ HYHQW ORRS IRU PRUH WKDQ VHFRQGV RUVRULVN RI KDYLQJ WKHEURZVHU SRSXS WKLV GLDORJ WR WKH XVHU 7KH GLDORJ LV WKHUH EHFDXVH D SRRUO\ ZULWWHQ VFULSW PLJKLQILQLWH ORRS RU VRPH RWKHU EXJ WKDW LV NHHSLQJ WKH EURZVHU IURPUHVSRQGLQJ %XW LQ $-$; DSSOLFDWLRQV WKH VFULSW PGRLQJ OHJLWLPDWH ZRUN

    *:7 SURYLGHV DQ,QFUHPHQWDO&RPPDQGFODVV WKDW KHOSVSHUIRUPORQJ UXQQLQJ FDOFXODWLRQV ,W ZRUNV E\ UHSHDWHGO\ FDOOLDQ H[HFXWH HQWU\ SRLQW XQWLO WKH FRPSXWDWLRQ LV FRPSOHWH

    7KH IROORZLQJ H[DPSOH LV DQ RXWOLQH RI KRZWR XVH WKH ,QFUHPHQWDO&RPPDQG FODVV WR GR VRPH FRPSXWDWLRQ LQ D ZD\ WKDOORZV WKH EURZVHU V XVHU LQWHUIDFH WR EH UHVSRQVLYH

    SXEOLF FODVV ,QFUHPHQWDO&RPPDQG7HVWLPSOHPHQWV(QWU\3RLQW ^

    1XPEHU RI WLPHV GR:RUN LV FDOOHGVWDWLFILQDO LQW0$;B/2236

    7LJKW LQQHU ORRS LQ GR:RUNVWDWLFILQDO LQW:25.B/223B&2817

    &RGLQJ %DVLFV *RRJOH :HE 7RRONLW *RRJOH &RGH

    S FRGH JRRJOH FRP ZHEWRRONLW GRF 'HY*XLGH&RGLQJ%DVLFV KWPO

  • 8/14/2019 GWT 1.6 Developer Guide

    34/116

    1XPEHU RI WLPHV GR:RUN LV FDOOHG LQ ,QFUHPHQWDO&RPPDQG EHIRUHUHWXUQLQJ FRQWURO WR WKH HYHQW ORRS

    VWDWLFILQDO LQW:25.B&+81.

    $ EXWWRQ WR NLFN RII WKH FRPSXWDWLRQ%XWWRQEXWWRQ

    SXEOLF YRLGRQ0RGXOH/RDG ^EXWWRQ QHZ %XWWRQ6WDUW &RPSXWDWLRQ

    EXWWRQ DGG&OLFN+DQGOHUQHZ &OLFN+DQGOHU ^SXEOLF YRLGRQ&OLFN &OLFN(YHQWHYHQW ^

    GR:RUN,QFUHPHQWDO`

    ``

    &UHDWH D ,QFUHPHQWDO&RPPDQG LQVWDQFH WKDW JHWV FDOOHG EDFN HYHU\ VR RIWHQXQWLO DOO WKH ZRUN LW KDV WR GR LV FRPSOHWH

    SULYDWH YRLGGR:RUN,QFUHPHQWDO ^

    7XUQ RII WKH EXWWRQ VR LW ZRQ W VWDUW SURFHVVLQJ DJDLQEXWWRQ VHW(QDEOHGIDOVH

    ,QFUHPHQWDO&RPPDQGLF QHZ ,QFUHPHQWDO&RPPDQGLQWFRXQWHU

    SXEOLF ERROHDQH[HFXWH ^IRU LQWL L :25.B&+81. L ^

    FRXQWHU

    UHVXOW GR:RUN

    ,I ZH KDYH GRQH DOO WKH ZRUN H[LW ZLWK D IDOVHUHWXUQ YDOXH WR WHUPLQDWH IXUWKHU H[HFXWLRQ

    LI FRXQWHU 0$;B/2236 ^

    5H HQDEOH EXWWRQEXWWRQ VHW(QDEOHGWUXH

    RWKHU HQG RI FRPSXWDWLRQ SURFHVVLQJ

    UHWXUQIDOVH`

    `&DOO WKH H[HFXWH IXQFWLRQ DJDLQ

    UHWXUQWUXH`

    `

    6FKHGXOH WKH ,QFUHPHQWDO&RPPDQG LQVWDQFH WR UXQ ZKHQFRQWURO UHWXUQV WR WKH HYHQW ORRS E\ UHWXUQLQJ WUXH

    'HIHUUHG&RPPDQG DGG&RPPDQGLF

    `

    5RXWLQH WKDW NHHSV WKH &38 EXV\ IRU D ZKLOH#UHWXUQ DQ LQWHJHU UHVXOW RI WKH FDOFXODWLRQ

    SULYDWH LQWGR:RUN ^LQWUHVXOW

    FRPSXWDWLRQ

    UHWXUQUHVXOW`

    &RGLQJ %DVLFV *RRJOH :HE 7RRONLW *RRJOH &RGH

    S FRGH JRRJOH FRP ZHEWRRONLW GRF 'HY*XLGH&RGLQJ%DVLFV KWPO

  • 8/14/2019 GWT 1.6 Developer Guide

    35/116

    0DQ\ $-$; DSSOLFDWLRQ GHYHORSHUV KDYH DGRSWHG-621 DV WKH GDWD IRUPDW RI FKRLFH IRU VHUYHU FRPPXQLFDWLRQ ,W LVDUHODWLYHO\ VLPSOH IRUPDW EDVHG RQ WKH REMHFW OLWHUDO QRWDWLRQ RI -DYD6FULSW ,I \RX FKRRVH WR XVH -621 HQFRGHG GDW\RXU DSSOLFDWLRQ *:7 FRQWDLQV FODVVHV \RX FDQ XVH WR SDUVH DQG PDQLSXODWH -621 REMHFWV

    -621 HQFRGLQJ

    7KH -621 IRUPDW LV EDVHG RQ WKH V\QWD[ DQG GDWDW\SHV RI WKH -DYD6FULSW ODQJXDJH ,W VXSSRUWV VWULQJV QXPEHUVERROHDQV DQG QXOOYDOXHV

    ^ PLQ4W\ SULFH `^ PLQ4W\ SULFH `^ PLQ4W\ SULFH `

    @`

    `

    6HH MVRQ RUJ H[DPSOH KWPOIRU PRUH -621 H[DPSOHV

    3DUVLQJ -621

    *:7 V -621 W\SHV DUH FRQWDLQHG LQ D VHSDUDWH PRGXOH VR \RX OOQHHG WR DGG WKH QHFHVVDU\LQKHULWV! WDJ WR \RXU PRGXOH ;0/ ILOH

    LQKHULWVQDPH FRP JRRJOH JZW MVRQ -621 !

    7\SLFDOO\ \RX ZLOOUHFHLYH -621 GDWD DV WKH UHVSRQVH WH[W RI DQ+773 UHTXHVW7KXV \RX OO ILUVW KDYH WR FRQYHUW WKDW6WULQJLQWR D GDWD VWUXFWXUH \RX FDQ QDYLJDWH DQG PDQLSXODWH *:7 LQFOXGHV WKH-6213DUVHU FODVV WR KDQGOH WKDWWUDQVIRUPDWLRQ ,WV ORQH VWDWLF PHWKRGSDUVH 6WULQJZLOO DFFHSW WKH -621 WH[W DQG SDUVHV LV LQWR D VHW RI-6219DOXHGHULYHG REMHFWV

    -6219DOXH LV WKH VXSHUFODVVRI DOO -621 W\SHV (DFK RI WKH EDVLF-621 W\SHV LVUHSUHVHQWHG E\ D FODVV LQ WKHFRP JRRJOH JZW MVRQ FOLHQWSDFNDJH -6219DOXH FRQWDLQV D VHULHVRI PHWKRGV\RX FDQ XVH WR GHWHUPLQH ZKLFK VSHFLILFVXEW\SH WKH YDOXH UHSUHVHQWV DQG LI SRVVLEOH SHUIRUPWKH FRQYHUVLRQ )RU H[DPSOH WKHLV%RROHDQPHWKRG ZLOO UHWXUQ D-621%RROHDQLI WKH -6219DOXH LV UHDOO\ D -621%RROHDQ RUQXOOLI LW LV QRW

    &RPSRVLWH -621 W\SHV FRQWDLQ VSHFLDOL]HG PHWKRGV IRU DFFHVVLQJ WKHLU PHPEHUV-6212EMHFW KDVJHW 6WULQJDQGSXW 6WULQJ -6219DOXHPHWKRGVIRU JHWWLQJ DQG VHWWLQJ WKH REMHFW V SURSHUWLHV-621$UUD\ KDV FRUUHVSRQGLQJ PHWKRGVQDPHGJHW LQWDQGVHW LQW -6219DOXH

    )RU D FRPSOHWH H[DPSOH RI SDUVLQJ -621 VHH WKH-621 VHFWLRQLQ WKH *:7 WXWRULDOV

    0DVKXSV ZLWK -621 DQG -61,

    ,I \RXUH ORDGLQJ -621HQFRGHG GDWD IURP\RXU RZQ VHUYHU \RX OO W\SLFDOO\ XVH WKH5HTXHVW%XLOGHU DQG UHODWHG FODVVHV WRPDNH +773 UHTXHVWV+RZHYHU \RX FDQ DOVR UHWULHYH -621 IURPUHPRWHVHUYHUV LQ WUXH PDVKXS IDVKLRQ XVLQJ *:7 V-DYD6FULSW 1DWLYH ,QWHUIDFH -61,IXQFWLRQDOLW\ 7KH WHFKQLTXHVIRU FURVV VLWH-621 LV H[SODLQHG PRUH IXOO\ LQ WKH JHWWLQJVWDUWHG WXWRULDO 7R VHH D ZRUNLQJ H[DPSOH FKHFN RXW WKH&URVV VLWH &OLHQW 6HUYHU &RPPXQLFDWLRQ VHFWLRQRI WKH*HWWLQJ6WDUWHG JXLGH

    :RUNLQJ ZLWK -621

    :RUNLQJ ZLWK ;0/

    &RGLQJ %DVLFV *RRJOH :HE 7RRONLW *RRJOH &RGH

    S FRGH JRRJOH FRP ZHEWRRONLW GRF 'HY*XLGH&RGLQJ%DVLFV KWPO

  • 8/14/2019 GWT 1.6 Developer Guide

    36/116

    ([WHQVLEOH 0DUNXS /DQJXDJH ;0/ LV D GDWD IRUPDW FRPPRQO\ XVHG LQ PRGHUQ ZHE DSSOLFDWLRQV ;0/ XVHV FXVWRP WDJVWR GHVFULEH GDWD DQGLV HQFRGHG DV SODLQWH[W PDNLQJ LW ERWK IOH[LEOH DQG HDV\ WR ZRUN ZLWK 7KH *:7 FODVV OLEUDU\FRQWDLQV D VHW RI W\SHV GHVLJQHG IRU SURFHVVLQJ ;0/ GDWD

    ;0/ W\SHV

    7KH ;0/ W\SHV SURYLGHG E\ *:7 FDQ EH IRXQG LQ WKHFRP JRRJOH JZW [PO FOLHQWSDFNDJH ,Q RUGHU WR XVH WKHVH LQ \RXU DSSOLFDWLRQ \RX OO QHHG WR DGG WKH IROORZLQJLQKHULWV! WDJ WR \RXUPRGXOH ;0/ ILOH

    LQKHULWVQDPH FRP JRRJOH JZW [PO ;0/ !

    3DUVLQJ ;0/

    7R GHPRQVWUDWH KRZWR SDUVH ;0/ ZLWK *:7 ZH OOXVH WKH IROORZLQJ ;0/ GRFXPHQW WKDW FRQWDLQV DQ HPDLO PHVVDJH

    " [PO YHUVLRQ "!PHVVDJH!

    KHDGHU!WR GLVSOD\1DPH 5LFKDUG DGGUHVV ULFN#VFKRRO HGX !IURP GLVSOD\1DPH -R\FH DGGUHVV MR\FH#ZHEVLWH FRP !VHQW! 7 = VHQW!VXEMHFW! 5H )OLJKW LQIR VXEMHFW!

    KHDGHU!ERG\ ! , OO SLFN \RX XS DW WKH DLUSRUW DW 6HH \RX WKHQ ERG\ !

    PHVVDJH!

    6XSSRVH WKDW \RXUH ZULWLQJ DQHPDLO DSSOLFDWLRQ DQG QHHG WR H[WUDFW WKH QDPH RI WKH VHQGHU WKH VXEMHFW OLQHPHVVDJH ERG\ IURPWKH ;0/ +HUH LV VDPSOH FRGH WKDW ZLOOGR MXVW WKDW ZHOO H[SODLQ WKH FRGH LQ MXVW D ELW

    SULYDWHYRLGSDUVH0HVVDJH 6WULQJPHVVDJH;PO ^WU\ ^

    SDUVH WKH ;0/ GRFXPHQW LQWR D '20'RFXPHQW PHVVDJH'RP ;0/3DUVHU SDUVH PHVVDJH;PO

    ILQG WKH VHQGHU V GLVSOD\ QDPH LQ DQ DWWULEXWH RI WKH IURP! WDJ

    1RGHIURP1RGH PHVVDJH'RP JHW(OHPHQWV%\7DJ1DPH IURP LWHP6WULQJ IURP (OHPHQW IURP1RGH JHW$WWULEXWHGLVSOD\1DPH

    IURP/DEHO VHW7H[WIURP

    JHW WKH VXEMHFW XVLQJ 1RGH V JHW1RGH9DOXH IXQFWLRQ6WULQJVXEMHFW

    PHVVDJH'RP JHW(OHPHQWV%\7DJ1DPH VXEMHFW LWHP JHW)LUVW&KLOG JHW1RGH9DOXHVXEMHFW/DEHO VHW7H[WVXEMHFW

    JHW WKH PHVVDJH ERG\ E\ H[SOLFLWO\ FDVWLQJ WR D 7H[W QRGH7H[W ERG\1RGH

    7H[W PHVVDJH'RP JHW(OHPHQWV%\7DJ1DPH ERG\ LWHP JHW)LUVW&KLOG6WULQJERG\ ERG\1RGH JHW'DWD

    ERG\/DEHO VHW7H[WERG\

    ` FDWFK '20([FHSWLRQ H ^:LQGRZ DOHUW &RXOG QRW SDUVH ;0/ GRFXPHQW

    ``

    7KH ILUVW VWHS LV WR SDUVH WKH UDZ ;0/ WH[W LQWR DQ;0/ '20 VWUXFWXUH ZH FDQ XVH WR QDYLJDWH WKH GDWD *:7 V ;0/SDUVHU LV FRQWDLQHG LQ WKH;0/3DUVHU FODVV &DOO LWVSDUVH 6WULQJVWDWLF PHWKRG WR SDUVH WKH ;0/ DQG UHWXUQ D'RFXPHQWREMHFW ,I DQ HUURU RFFXUVGXULQJ SDUVLQJ IRU H[DPSOH LI WKH;0/ LV QRWZHOO IRUPHGWKH ;0/3DUVHU ZLOO WKURZ D'20([FHSWLRQ

    ,I SDUVLQJ VXFFHHGV WKH 'RFXPHQW REMHFW ZH UHFHLYH UHSUHVHQWV WKH ;0/ GRFXPHQW LQ PHPRU\ ,W LV D WUHH FRPSRVHG RI JHQHULF1RGH REMHFWV $QRGH LQ WKH ;0/ '20 LV WKH EDVLF XQLW RI GDWD LQ DQ ;0/ GRFXPHQW *:7 FRQWDLQV VHYHUDOVXELQWHUIDFHV RI 1RGH ZKLFK SURYLGH VSHFLDOL]HG PHWKRGV IRUSURFHVVLQJ WKH YDULRXV W\SHV RI QRGHV

    &RGLQJ %DVLFV *RRJOH :HE 7RRONLW *RRJOH &RGH

    S FRGH JRRJOH FRP ZHEWRRONLW GRF 'HY*XLGH&RGLQJ%DVLFV KWPO

  • 8/14/2019 GWT 1.6 Developer Guide

    37/116

    (OHPHQWUHSUHVHQWV '20 HOHPHQWV ZKLFK DUH VSHFLILHG E\ WDJV LQ ;0/VRPH(OHPHQW! VRPH(OHPHQW!

    7H[W UHSUHVHQWV WKH WH[W EHWZHHQ WKH RSHQLQJ DQG FORVLQJ WDJ RI DQ HOHPHQWVRPH(OHPHQW!+HUH LV VRPHWH[W VRPH(OHPHQW!

    &RPPHQW UHSUHVHQWV DQ ;0/ FRPPHQW QRWHV DERXW WKLV GDWD !

    $WWU UHSUHVHQWV DQ DWWULEXWH RI DQ HOHPHQWVRPH(OHPHQW P\$WWULEXWH !

    5HIHU WR WKH GRFXPHQWDWLRQ IRU WKH1RGH LQWHUIDFH IRU D FRPSOHWH OLVW RI W\SHV WKDW GHULYH IURP1RGH

    7R JHW WR WKH '20 QRGHV IURPWKH 'RFXPHQW REMHFW ZH FDQ XVH RQH RI WKUHH PHWKRGV 7KHJHW'RFXPHQW(OHPHQW

    PHWKRG UHWULHYHV WKHGRFXPHQW HOHPHQW WKH WRS HOHPHQW DW WKH URRW RI WKH '20 WUHH DV DQ(OHPHQW:H FDQ WKHQ XVH WKHQDYLJDWLRQ PHWKRGV RI WKH1RGH FODVV IURP ZKLFK (OHPHQW GHULYHV H JJHW&KLOG1RGHVJHW1H[W6LEOLQJJHW3DUHQW1RGHHWF WR GULOO GRZQ DQG UHWULHYH WKH GDWD ZH QHHG

    :H FDQ DOVR JR GLUHFWO\ WR D SDUWLFXODU QRGH RU OLVW RI QRGHV XVLQJ WKHJHW(OHPHQW%\,G 6WULQJDQGJHW(OHPHQWV%\7DJ1DPH 6WULQJPHWKRGV 7KH JHW(OHPHQW%\,G 6WULQJ PHWKRG ZLOO UHWULHYH WKH (OHPHQW ZLWK WKH VSHFLIL,' ,I \RX ZDQW WR XVH ,' V LQ \RXU;0/ \RX OO QHHG WR VXSSO\ WKH QDPH RI WKH DWWULEXWH WR XVHDV WKH ,' LQ WKH'7' RI WKH;0/ GRFXPHQW MXVW VHWWLQJ DQ DWWULEXWH QDPHGLG ZLOO QRW ZRUN 7KH JHW(OHPHQWV%\7DJ1DPH 6WULQJ PHWKRG LV XVHIXO LI \RX ZDQW WR UHWULHYH RQH RU PRUH HOHPHQWV ZLWK D SDUWLFXODU WDJ QDPH 7KH OLVW RI HOHPHQWV ZLOO EH UHWXUQHG LQ1RGH/LVWREMHFW ZKLFK FDQ EH LWHUDWHG RYHU WR JHW WKH LQGLYLGXDO 1RGHV LW FRQWDLQV

    ,Q WKH H[DPSOH FRGH ZH XVH WKH JHW(OHPHQWV%\7DJ1DPH 6WULQJ PHWKRG WR UHWULHYH WKH QHFHVVDU\ HOHPHQWV IURP WKH;0/ FRQWDLQLQJ WKH HPDLO PHVVDJH 7KH VHQGHU V QDPH LV VWRUHG DV DQ DWWULEXWH RI WKHIURP! WDJ VR ZH XVHJHW$WWULEXWH 6WULQJ7KH VXEMHFW OLQH LV VWRUHG DV WH[W LQVLGH WKHVXEMHFW! WDJ VR ZH ILUVW ILQG WKH VXEMHFW HOHPHQW DQGWKHQ UHWULHYH LWV ILUVW DQG RQO\ FKLOG QRGH DQG FDOOJHW1RGH9DOXHRQ LW WR JHW WKH WH[W )LQDOO\ WKH PHVVDJH ERG\ LV VWRUHG

    LQ WKH VDPH ZD\ WH[W ZLWKLQ WKHERG\! WDJ EXW WKLV WLPH ZH H[SOLFLWO\ FDVW WKH1RGH WR D7H[WREMHFW DQG H[WUDFW WKH WH[WXVLQJJHW'DWD

    %XLOGLQJ DQ ;0/ GRFXPHQW

    ,Q DGGLWLRQ WR SDUVLQJ H[LVWLQJ GRFXPHQWV WKH *:7 ;0/ W\SHV FDQ DOVR EH XVHGWR FUHDWH DQG PRGLI\ ;0/ 7R FUHDWH DQHZ ;0/ GRFXPHQW FDOO WKH VWDWLFFUHDWH'RFXPHQWPHWKRG RI WKH;0/3DUVHU FODVV

  • 8/14/2019 GWT 1.6 Developer Guide

    38/116

    7KH -61, V\QWD[LV D GLUHFWLYHWR WKH -DYD WR -DYD6FULSW &RPSLOHU WR DFFHSW DQ\WH[W EHWZHHQ WKH FRPPHQW VWDWHPHYDOLG -6 FRGH DQGLQMHFW LW LQOLQH LQ WKH JHQHUDWHG *:7 ILOHV $W FRPSLOH WLPH WKH *:7 FRPSLOHU SHUIRUPV VRPH V\QWD[FKHFNV RQ WKH -DYD6FULSW LQVLGH WKHPHWKRG WKHQJHQHUDWHV LQWHUIDFH FRGH IRU FRQYHUWLQJ PHWKRG DUJXPHQWV DQYDOXHV SURSHUO\

    $V RI WKH *:7 UHOHDVH WKH -DYD YDUDUJV FRQVWUXFW LV VXSSRUWHG 7KH *:7 FRPSLOHU ZLOO WUDQVODWH YDUDUJV FDOOVEHWZHHQ SLHFHVRI -DYD FRGH +RZHYHU FDOOLQJ D YDUDUJV -DYD6FULSW PHWKRG IURP -DYDZLOO UHVXOW LQ WKH FDOOHH UHFWKH DUJXPHQWV LQ DQ DUUD\

    ([ DPSOHV+HUH LV D VLPSOH H[DPSOH RI KRZWR FRGH D -61,PHWKRG WKDW SXWV XS D -DYD6FULSW DOHUW GLDORJ

    SXEOLF VWDWLFQDWLYHYRLGDOHUW 6WULQJPVJ ^ZQG DOHUW PVJ

    `

    1RWH WKDW WKH FRGH GLG QRW UHIHUHQFH WKH -DYD6FULSWZLQGRZREMHFW GLUHFWO\LQVLGH WKH PHWKRG :KHQ DFFHVVLQJ WKHEURZVHU V ZLQGRZ DQG GRFXPHQW REMHFWV IURP -61, \RX PXVW UHIHUHQFH WKHP DVZQG DQG GRF UHVSHFWLYHO\

  • 8/14/2019 GWT 1.6 Developer Guide

    39/116

    HUURUV LQ WKH -DYD6FULSW ERG\ RI WKH PHWKRG ZLOO QRW EH VHHQ XQWLO UXQ WLPH

    $FFHVVLQJ -DYD 0HWKRGV DQG )LHOGV IURP -DYD6FULSW

    ,W FDQ EH YHU\ XVHIXO WR PDQLSXODWH -DYD REMHFWV IURP ZLWKLQ WKH -DYD6FULSW LPSOHPHQWDWLRQ RI D -61, PHWKRG +RZHYHUVLQFH -DYD6FULSW XVHV G\QDPLF W\SLQJ DQG -DYD XVHV VWDWLF W\SLQJ \RX PXVW XVH D VSHFLDO V\QWD[

    :KHQ ZULWLQJ -61, FRGH LW LV KHOSIXO WR RFFDVLRQDOO\ UXQ LQZHE PRGH 7KH-DYD6FULSW FRPSLOHU FKHFNV \RXU -61, FRGH DQG FDQ IODJ HUURUV DW FRPSLOH WLPH WKDW \RX ZRXOG QRW FDWFK XQWLO UXQWLPH LQKRVWHG PRGH

    &DOOLQJ -DYD PHWKRGV IURP -DYD6FULSW LV VRPHZKDW VLPLODU WR FDOOLQJ -DYD PHWKRGV IURP & FRGH LQ-1, ,Q SDUWLFXODU -61,ERUURZV WKH -1, PDQJOHG PHWKRG VLJQDWXUH DSSURDFK WR GLVWLQJXLVKDPRQJ RYHUORDGHG PHWKRGV -DYD6FULSW FDOOV LQPHWKRGV DUH RI WKH IROORZLQJ IRUP

    >LQVWDQFH H[SU @#FODVV QDPH PHWKRG QDPH SDUDP VLJQDWXUH DUJXPHQWV

    LQVWDQFH H[SUPXVW EH SUHVHQW ZKHQ FDOOLQJ DQ LQVWDQFH PHWKRG DQG PXVW EH DEVHQW ZKHQ FDOOLQJ D VWDWLFPHWKRGFODVV QDPHLV WKH IXOO\ TXDOLILHG QDPHRI WKH FODVV LQ ZKLFK WKH PHWKRG LV GHFODUHG RU D VXEFODVV WKHUHRI

    SDUDP VLJQDWXUHLV WKH LQWHUQDO -DYD PHWKRG VLJQDWXUH DV VSHFLILHGKHUHEXW ZLWKRXW WKH WUDLOLQJ VLJQDWXUH RI WKHPHWKRGUHWXUQ W\SH VLQFHLW LV QRW QHHGHG WR FKRRVH WKH RYHUORDG

    DUJXPHQWVLV WKH DFWXDO DUJXPHQW OLVW WR SDVV WR WKH FDOOHG PHWKRG

    &DOOLQJ -DYD FRQVWUXFWRUV IURP-DYD6FULSW LVLGHQWLFDO WR WKH DERYH XVH FDVH H[FHSW WKDW WKH PHWKRG QDPHLV DQHZ

    *LYHQ WKH IROORZLQJ -DYD FODVVHV

    SDFNDJH SNJFODVV 7RS/HYHO ^

    SXEOLF 7RS/HYHO ^ `SXEOLF 7RS/HYHO LQWL ^ `

    VWDWLFFODVV 6WDWLF,QQHU ^SXEOLF 6WDWLF,QQHU ^ `

    `

    FODVV ,QVWDQFH,QQHU ^SXEOLF ,QVWDQFH,QQHU LQWL ^ `

    ``

    :H FRPSDUH WKH -DYD H[SUHVVLRQ YHUVXV WKH -61, H[SUHVVLRQ

    QHZ 7RS/HYHO EHFRPHV#SNJ 7RS/HYHO QHZ

    QHZ 6WDWLF,QQHU EHFRPHV#SNJ 7RS/HYHO 6WDWLF,QQHU QHZ

    VRPH7RS/HYHO,QVWDQFH QHZ ,QVWDQFH,QQHU EHFRPHV#SNJ 7RS/HYHO ,QVWDQFH,QQHU QHZ /SNJ 7RS/HYHO , VRPH7RS/HYHO,QVWDQFH

    7KH HQFORVLQJ LQVWDQFH RI D QRQ VWDWLF FODVVLV LPSOLFLWO\ GHILQHG DV WKHILUVW SDUDPHWHU IRU FRQVWUXFWQRQ VWDWLF FODVV 5HJDUGOHVV RI KRZ GHHSO\ QHVWHG D QRQ VWDWLF FODVVLV LW RQO\ QHHGV DUHIHUHQFH WR DQLQVWDQFH RI LWV LPPHGLDWHO\ HQFORVLQJ W\SH

    6WDWLF DQG LQVWDQFHILHOGV FDQ EH DFFHVVHG IURPKDQGZULWWHQ -DYD6FULSW )LHOG UHIHUHQFHV DUH RI WKH IRUP

    >LQVWDQFH H[SU @#FODVV QDPH ILHOG QDPH

    ([DPSOH

    ,QYRNLQJ -DYD PHWKRGV IURP -DYD6FULSW

    ,QYRNLQJ -DYD FRQVWUXFWRUV IURP -DYD6FULSW

    $FFHVVLQJ -DYD ILHOGV IURP -DYD6FULSW

    &RGLQJ %DVLFV *RRJOH :HE 7RRONLW *RRJOH &RGH

    S FRGH JRRJOH FRP ZHEWRRONLW GRF 'HY*XLGH&RGLQJ%DVLFV KWPO

  • 8/14/2019 GWT 1.6 Developer Guide

    40/116

    SXEOLF FODVV -61,([DPSOH ^

    6WULQJP\,QVWDQFH)LHOGVWDWLFLQWP\6WDWLF)LHOG

    YRLGLQVWDQFH)RR 6WULQJV ^XVH V

    `

    VWDWLFYRLGVWDWLF)RR 6WULQJV ^XVH V`

    SXEOLF QDWLYHYRLGEDU -61,([DPSOH [ 6WULQJV ^&DOO LQVWDQFH PHWKRG LQVWDQFH)RR RQ WKLV

    WKLV #FRP JRRJOH JZW H[DPSOHV -61,([DPSOH LQVWDQFH)RR /MDYD ODQJ 6WULQJ V

    &DOO LQVWDQFH PHWKRG LQVWDQFH)RR RQ [[ #FRP JRRJOH JZW H[DPSOHV -61,([DPSOH LQVWDQFH)RR /MDYD ODQJ 6WULQJ V

    &DOO VWDWLF PHWKRG VWDWLF)RR#FRP JRRJOH JZW H[DPSOHV -61,([DPSOH VWDWLF)RR /MDYD ODQJ 6WULQJ V

    5HDG LQVWDQFH ILHOG RQ WKLV

    YDU YDO WKLV #FRP JRRJOH JZW H[DPSOHV -61,([DPSOH P\,QVWDQFH)LHOG

    :ULWH LQVWDQFH ILHOG RQ [[ #FRP JRRJOH JZW H[DPSOHV -61,([DPSOH P\,QVWDQFH)LHOG YDO DQG VWXII

    5HDG VWDWLF ILHOG QR TXDOLILHU#FRP JRRJOH JZW H[DPSOHV -61,([DPSOH P\6WDWLF)LHOG YDO DQG VWXII

    `

    `

    7LS $V RI WKH *:7 UHOHDVH WKH -DYD YDUDUJV FRQVWUXFW LV VXSSRUWHG 7KH *:7 FRPSLOHU ZLOO WUDQVODWH YDUDUJV FDOOV EHWZHHQ WZR SLHFHV RI -DYD FRGH KRZHYHUFDOOLQJ D YDUDUJV -DYD PHWKRG IURP -61, ZLOO UHTXLUH WKH -DYD6FULSW FDOOHU WR SDVV

    DQ DUUD\ RI WKH DSSURSULDWH W\SH

    &DOOLQJ D -DYD 0HWKRG IURP +DQGZULWWHQ -DYD6FULSW

    6RPHWLPHV \RX QHHG WR DFFHVVD PHWKRGRU FRQVWUXFWRU GHILQHG LQ *:7 IURP RXWVLGH -DYD6FULSW FRGH 7KLV FRGH PLJKW EKDQG ZULWWHQ DQG LQFOXGHG LQ DQRWKHUMDYD VFULSW ILOH RULW FRXOG EH D SDUW RI DWKLUG SDUW\ OLEUDU\ ,Q WKLVFDVFRPSLOHU ZLOO QRW JHW D FKDQFH WR EXLOG DQ LQWHUIDFH EHWZHHQ \RXU -DYD6FULSW FRGH DQG WKH *:7 JHQHUDWHG -DYD6FULGLUHFWO\

    $ ZD\WR PDNH WKLV NLQG RI UHODWLRQVKLS ZRUN LV WR DVVLJQ WKH PHWKRG YLD -61,WR DQ H[WHUQDO JOREDOO\ YLVLEOH -DYD6QDPH WKDW FDQ EH UHIHUHQFHG E\ \RXU KDQG FUDIWHG-DYD6FULSW FRGH

    SDFNDJH P\SDFNDJH

    SXEOLF 0\8WLOLW\&ODVV^

    SXEOLF VWDWLFLQWFRPSXWH/RDQ,QWHUHVWLQWDPW IORDWLQWHUHVW5DWHLQWWHUP ^ `

    SXEOLF VWDWLFQDWLYHYRLGH[SRUW6WDWLF0HWKRG ^ZQG FRPSXWH/RDQ,QWHUHVW#P\SDFNDJH 0\8WLOLW\&ODVV FRPSXWH/RDQ,QWHUHVW ,),

    ``

    2Q DSSOLFDWLRQ LQLWLDOL]DWLRQ FDOO0\8WLOLW\&ODVV H[SRUW6WDWLF0HWKRG H J IURP \RXU *:7 (QWU\ 3RLQW 7KLVZLOO DVVLJQ WKH IXQFWLRQ WR D YDULDEOH LQ WKH ZLQGRZ REMHFW FDOOHGFRPSXWH/RDQ,QWHUHVW

    &RGLQJ %DVLFV *RRJOH :HE 7RRONLW *RRJOH &RGH

    S FRGH JRRJOH FRP ZHEWRRONLW GRF 'HY*XLGH&RGLQJ%DVLFV KWPO

  • 8/14/2019 GWT 1.6 Developer Guide

    41/116

    6KDULQJ REMHFWV EHWZHHQ -DYD VRXUFH DQG -DYD6FULSW

    3DUDPHWHUV DQG UHWXUQ W\SHV LQ -61,PHWKRGV DUH GHFODUHG DV -DYD W\SHV 7KHUH DUH YHU\ VSHFLILF UXOHV IRU KRZ YDOXSDVVLQJ LQ DQG RXW RI -DYD6FULSW FRGH PXVW EH WUHDWHG 7KHVH UXOHV PXVW EH IROORZHG ZKHWKHU WKH YDOXHV HQWHU DWKURXJK QRUPDO -DYD PHWKRG FDOO VHPDQWLFV RU WKURXJK WKH VSHFLDO V\QWD[E\ ZKLFK -DYD PHWKRGVDUH LQYRNHG IURP-6FRGH

    3DVVLQJ -DYD YDOXHV LQWR -DYD6FULSW

    ,QFRPLQJ -DYD W\SH +RZ LW DSSHDUV WR -DYD6FULSW FRGH

    6WULQJ -DYD6FULSW VWULQJ DV LQYDU V P\ VWULQJ

    ERROHDQ -DYD6FULSW ERROHDQ YDOXH DV LQYDU E WUXH

    ORQJ GLVDOORZHG VHH QRWHV

    RWKHU QXPHULF SULPLWLYHV -DYD6FULSW QXPHULF YDOXH DV LQYDU [

    -DYD6FULSW2EMHFW -DYD6FULSW2EMHFWWKDW PXVW KDYH RULJLQDWHG IURP-DYD6FULSW FRGHW\SLFDOO\ DV WKH UHWXUQ YDOXH RI VRPH RWKHU -61,PHWKRG VHH QRWHV

    -DYD DUUD\ RSDTXH YDOXH WKDW FDQ RQO\ EH SDVVHG EDFN LQWR -DYD FRGH

    DQ\ RWKHU -DYD2EMHFW RSDTXH YDOXH DFFHVVLEOH WKURXJK VSHFLDO V\QWD[

    3DVVLQJ -DYD6FULSW YDOXHV LQWR -DYD FRGH

    2XWJRLQJ -DYD W\SH :KDW PXVW EH SDVVHG

    6WULQJ -DYD6FULSW VWULQJ DV LQUHWXUQ ERR

    ERROHDQ -DYD6FULSW ERROHDQ YDOXH DV LQUHWXUQ IDOVH

    ORQJ GLVDOORZHG VHH QRWHV

    -DYD QXPHULF SULPLWLYH -DYD6FULSW QXPHULF YDOXH DV LQUHWXUQ

    -DYD6FULSW2EMHFW QDWLYH -DYD6FULSW REMHFW DV LQUHWXUQGRFXPHQW FUHDWH(OHPHQW GLY VHH QRWHV

    DQ\ RWKHU -DYD2EMHFWLQFOXGLQJ DUUD\V

    -DYD2EMHFWRI WKH FRUUHFW W\SH WKDW PXVW KDYH RULJLQDWHG LQ -DYD FRGH -DYDREMHFWV FDQQRW EH FRQVWUXFWHG IURP WKLQ DLU LQ -DYD6FULSW

    ,PSRUWDQW 1RWHV7KH -DYDORQJ W\SH FDQQRW EH UHSUHVHQWHG LQ -DYD6FULSW DV D QXPHULF W\SH VR *:7 HPXODWHV LW XVLQJ DQRSDTXHGDWD VWUXFWXUH 7KLV PHDQV WKDW -61,PHWKRGV FDQQRW SURFHVV DORQJ DV D QXPHULF W\SH 7KH FRPSLOHU WKHUHIRUHGLVDOORZV E\ GHIDXOW GLUHFWO\ DFFHVVLQJ DORQJ IURP -61, -61, PHWKRGV FDQQRW KDYHORQJ DV D SDUDPHWHU W\SH RU D UHWXUQ W\SH DQG WKH\ FDQQRW DFFHVV DORQJ XVLQJ D-61, UHIHUHQFH,I \RX ILQG \RXUVHOI ZDQWLQJ WR SDVV DORQJLQWR RU RXW RI D -61, PHWKRG KHUH DUH VRPH RSWLRQV

    )RU QXPEHUV WKDW ILW LQWR W\SHGRXEOH

    XVH W\SHGRXEOH

    LQVWHDG RI W\SHORQJ

    )RU FRPSXWDWLRQV WKDW UHTXLUH WKH IXOOORQJ VHPDQWLFV UHDUUDQJH WKHFRGH VR WKDW WKH FRPSXWDWLRQV KDSSHQ LQ-DYD LQVWHDG RI LQ -DYD6FULSW 7KDW ZD\ WKH\ ZLOO XVH WKHORQJ HPXODWLRQ

    )RU YDOXHV PHDQW WR EH SDVVHG WKURXJK XQFKDQJHG WR -DYD FRGH ZUDS WKH YDOXH LQD/RQJ 7KHUH DUH QRUHVWULFWLRQV RQ W\SH/RQJ ZLWK -61, PHWKRGV

    ,I \RX DUHVXUH \RX NQRZ ZKDW \RX DUH GRLQJ \RX FDQ DGG WKH DQQRWDWLRQFRP JRRJOH JZW FRUH FOLHQW 8QVDIH1DWLYH/RQJ WR WKH PHWKRG 7KH FRPSLOHU ZLOO WKHQ DOORZ\RX WRSDVV DORQJ LQWR DQG RXW RI -DYD6FULSW ,W ZLOO VWLOO EH DQRSDTXH GDWD W\SH KRZHYHU VR WKH RQO\ WKLQJ \RXEH DEOH WR GR ZLWK LW ZLOO EH WR SDVV LW EDFN WR -DYD

    9LRODWLQJ DQ\ RI WKHVH PDUVKDOLQJ UXOHV LQKRVWHG PRGHZLOO JHQHUDWH DFRP JRRJOH JZW GHY VKHOO 'HY*XLGH+RVWHG0RGH([FHSWLRQ GHWDLOLQJ WKH SUREOHP 7KLV H[FHSWLRQ LV QRWWUDQVODWDEOHDQG QHYHU WKURZQ LQZHE PRGH

    &RGLQJ %DVLFV *RRJOH :HE 7RRONLW *RRJOH &RGH

    S FRGH JRRJOH FRP ZHEWRRONLW GRF 'HY*XLGH&RGLQJ%DVLFV KWPO

  • 8/14/2019 GWT 1.6 Developer Guide

    42/116

    -DYD6FULSW2EMHFWJHWV VSHFLDO WUHDWPHQW IURP WKH *:7 FRPSLOHU DQG KRVWHG EURZVHU ,WV SXUSRVH LV WR SURYLGH DQRSDTXH UHSUHVHQWDWLRQ RI QDWLYH -DYD6FULSW REMHFWV WR -DYDFRGH

    $OWKRXJK -DYD DUUD\V DUH QRW GLUHFWO\ XVDEOH LQ -DYD6FULSW WKHUH DUH VRPH KHOSHU FODVVHV WKDW HIILFLHQWOVLPLODU HIIHFW-V$UUD\ -V$UUD\%RROHDQ-V$UUD\,QWHJHU -V$UUD\1XPEHU DQG-V$UUD\6WULQJ7KHVH FODVVHV DUHZUDSSHUV DURXQG D QDWLYH -DYD6FULSW DUUD\

    -DYDQXOODQG -DYD6FULSWQXOODUH LGHQWLFDO DQG DOZD\V OHJDO YDOXHV IRU DQ\ QRQ SULPLWLYH -DYD W\SH -DYD6FULSWXQGHILQHGLV DOVR FRQVLGHUHG HTXDO WRQXOOZKHQ SDVVHG LQWR -DYD FRGH WKH UXOHV RI -DYD6FULSW GLFWDWH WKDW LQ-DYD6FULSW FRGHQXOO XQGHILQHG LVWUXHEXWQXOO XQGHILQHG LVIDOVH ,Q SUHYLRXV YHUVLRQV RI *:7 XQGHILQHGZDV QRW D OHJDO YDOXH WR SDVV LQWR -DYD

    ([FH SWLRQV DQG -61,

    $Q H[FHSWLRQ FDQ EH WKURZQ GXULQJ WKH H[HFXWLRQ RI HLWKHU QRUPDO -DYD FRGH RU WKH -DYD6FULSW FRGH ZLWKLQD -61, PHW:KHQ DQ H[FHSWLRQ JHQHUDWHG ZLWKLQ D -61,PHWKRG SURSDJDWHV XS WKH FDOO VWDFN DQG LV FDXJKW E\D -DYD FDWFK EORFN WWKURZQ -DYD6FULSW H[FHSWLRQ LV ZUDSSHG DV D-DYD6FULSW([FHSWLRQREMHFW DW WKH WLPH LW LV FDXJKW 7KLV ZUDSSHU REMHFWFRQWDLQV RQO\ WKHFODVV QDPH DQG GHVFULSWLRQ RI WKH -DYD6FULSW H[FHSWLRQ WKDW RFFXUUHG 7KH UHFRPPHQGHG SUDFWLKDQGOH -DYD6FULSW H[FHSWLRQV LQ -DYD6FULSW FRGH DQG -DYD H[FHSWLRQV LQ -DYDFRGH

    $ -DYDH[FHSWLRQ FDQ VDIHO\ UHWDLQLGHQWLW\ ZKLOH SURSDJDWLQJ WKURXJK D -61, PHWKRG

    )RU H[DPSOH

    -DYD PHWKRGGR)RR FDOOV -61, PHWKRGQDWLYH)RR

    QDWLYH)RRLQWHUQDOO\ FDOOV -DYD PHWKRG

    IRR,PSOIRR,PSO WKURZV DQ H[FHSWLRQ

    7KH H[FHSWLRQ WKURZQ IURPIRR,PSO ZLOO SURSDJDWH WKURXJKQDWLYH)RR DQG FDQ EH FDXJKW LQGR)RR 7KHH[FHSWLRQ ZLOO UHWDLQ LWV W\SH DQG LGHQWLW\

    6XSSRVH \RXUH KDSSLO\ XVLQJ -61, WR FDOO ELWV RI KDQGZULWWHQ -DYD6FULSW IURP ZLWKLQ \RXU *:7 PRGXOH ,W ZRUNV ZHOO EXW-61, RQO\ ZRUNV DW WKH OHYHO RI LQGLYLGXDO PHWKRGV 6RPH LQWHJUDWLRQ VFHQDULRV UHTXLUH \RX WR PRUH GHHSO\LQWHUW-DYD6FULSW DQG -DYD REMHFWV '20 DQG -621SURJUDPPLQJ DUHWZR JRRG H[DPSOHV DQG VR ZKDW ZH UHDOO\ ZDQW LV DZD\ WR LQWHUDFW GLUHFWO\ ZLWK-DYD6FULSW REMHFWV IURP RXU -DYD VRXUFH FRGH ,Q RWKHU ZRUGV ZH ZDQW -DYD6FULSW REMORRN OLNH-DYD REMHFWV ZKHQ ZH UH FRGLQJ

    *:7 LQWURGXFHV -DYD6FULSW RYHUOD\ W\SHVWR PDNH LW HDV\ WR LQWHJUDWH HQWLUH IDPLOLHV RI -DYD6FULSW REMHFWV LQWR \*:7 SURMHFW 7KHUH DUH PDQ\ EHQHILWV RI WKLVWHFKQLTXH LQFOXGLQJ WKH DELOLW\ WR XVH\RXU -DYD ,'( V FRGH FRPSOHWLRQ DUHIDFWRULQJ FDSDELOLWLHV HYHQ DV\RX UH ZRUNLQJ ZLWK XQW\SHG -DYD6FULSW REMHFWV

    ([DPSOH (DV\ HIILFLHQW -621

    2YHUOD\ W\SHV DUH HDVLHVW WR XQGHUVWDQG ZLWK H[DPSOHV 6XSSRVH ZH ZDQW WR DFFHVV DQ DUUD\RI -621 REMHFWVUHSUHVHQWLQJ D VHW RI FXVWRPHU HQWLWLHV 7KH -DYD6FULSW VWUXFWXUH PLJKW ORRN OLNH WKLV

    YDUMVRQ'DWD >^ )LUVW1DPH -LPP\ /DVW1DPH :HEEHU `^ )LUVW1DPH $ODQ /DVW1DPH 'D\DO `^ )LUVW1DPH .HDQX /DVW1DPH 6SRRQ `^ )LUVW1DPH (PLO\ /DVW1DPH 5XGQLFN `

    @

    7R VXSHULPSRVHD -DYD W\SH RQWR WKH DERYHVWUXFWXUH \RX VWDUW E\ VXEFODVVLQJ-DYD6FULSW2EMHFWD PDUNHU W\SH WKDW*:7 XVHV WR GHQRWH -DYD6FULSW REMHFWV /HW VJR DKHDG DQG DGG VRPH JHWWHUV WRR

    $Q RYHUOD\ W\SHFODVV &XVWRPHUH[WHQGV-DYD6FULSW2EMHFW^

    2YHUOD\ W\SHV DOZD\V KDYH SURWHFWHG ]HUR DUJ FWRUVSURWHFWHG&XVWRPHU ^ `

    -DYD6FULSW 2YHUOD\ 7\SHV

    &RGLQJ %DVLFV *RRJOH :HE 7RRONLW *RRJOH &RGH

    S FRGH JRRJOH FRP ZHEWRRONLW GRF 'HY*XLGH&RGLQJ%DVLFV KWPO

  • 8/14/2019 GWT 1.6 Developer Guide

    43/116

    7\SLFDOO\ PHWKRGV RQ RYHUOD\ W\SHV DUH -61,SXEOLF ILQDO QDWLYH6WULQJJHW)LUVW1DPH ^ UHWXUQ WKLV )LUVW1DPH `SXEOLF ILQDO QDWLYH6WULQJJHW/DVW1DPH ^ UHWXUQ WKLV /DVW1DPH `

    1RWH WKRXJK WKDW PHWKRGV DUHQ W UHTXLUHG WR EH -61,SXEOLF ILQDO 6WULQJJHW)XOO1DPH ^

    UHWXUQJHW)LUVW1DPH JHW/DVW1DPH`

    `

    *:7 ZLOO QRZ XQGHUVWDQG WKDW DQ\ LQVWDQFH RI&XVWRPHULV DFWXDOO\ D WUXH -DYD6FULSW REMHFW WKDW FRPHV IURP RXWVLGH \RXU*:7 PRGXOH 7KLV KDV XVHIXOLPSOLFDWLRQV )RU H[DPSOH QRWLFH WKHWKLVUHIHUHQFH LQVLGHJHW)LUVW1DPH DQGJHW/DVW1DPH 7KDWWKLVLV WUXO\ WKH LGHQWLW\ RI WKH -DYD6FULSW REMHFW VR \RX LQWHUDFW ZLWK LW H[DFWO\ DV LW H[LV-DYD6FULSW ,Q WKLV H[DPSOH ZH FDQ GLUHFWO\ DFFHVV WKH -621 ILHOGV ZH NQRZ H[LVWWKLV )LUVW1DPHDQGWKLV /DVW1DPH

    6R KRZ GR \RXDFWXDOO\ JHW D -DYD6FULSW REMHFW RQ ZKLFK WR RYHUOD\ D -DYD W\SH"

  • 8/14/2019 GWT 1.6 Developer Guide

    44/116

  • 8/14/2019 GWT 1.6 Developer Guide

    45/116

    *:7 DQG &OLHQW 6HUYHU &RPPXQLFDWLRQ$OVR IURP *RRJOH , 2 0LJXHO 0HQGH] H[SODLQV YDULRXV ZD\V LQ ZKLFK \RXFDQ DFFHVV GDWD IURP WKH EURZVHU LQFOXGLQJ KRZ WR FRPELQH5HTXHVW%XLOGHUDQG RYHUOD\ W\SHV IRU UHDOO\FRQYHQLHQW -621 DFFHVV

    'HVLJQ 2YHUOD\ 7\SHV 5HDG DW \RXURZQ ULVN 7KHVH DUHWKH H[FUXFLDWLQJ WHFKQLFDOGHWDLOV ,W V IDLUO\ LQWHUHVEXW QRW QHFHVVDULO\ LQVWUXFWLYH

    'HIHUUHG ELQGLQJ LV D IHDWXUH RI WKH *:7 FRPSLOHU WKDW ZRUNV E\ JHQHUDWLQJ PDQ\ YHUVLRQV RI FRGH DW FRPSLOH WLPH RQO

    RQH RI ZKLFK QHHGVWR EH ORDGHG E\ D SDUWLFXODU FOLHQW GXULQJ ERRWVWUDSSLQJ DW UXQWLPH (DFKYHUVLRQ LV JHQHUDWEURZVHU EDVLV DORQJ ZLWK DQ\RWKHU D[LV WKDW \RXU DSSOLFDWLRQ GHILQHV RU XVHV )RU H[DPSOH LI \RX ZHUH WR LQWHUQDW\RXU DSSOLFDWLRQ XVLQJ*:7 V ,QWHUQDWLRQDOL]DWLRQ PRGXOHWKH *:7 FRPSLOHU ZRXOG JHQHUDWH YDULRXV YHUVLRQV RI \RXU DSSOLFDWLRQ SHU EURZVHU HQYLURQPHQW VXFK DV )LUHIR[ LQ (QJOLVK )LUHIR[ LQ )UHQFK ,QWHUQHW ([SORUHU LQ (QJOLVK HWF$V D UHVXOW WKH GHSOR\HG -DYD6FULSW FRGH LVFRPSDFW DQG TXLFNHU WR GRZQORDG WKDQ KDQG FRGHG -DYD6FULSW FRQWDLRQO\ WKH FRGH DQG UHVRXUFHV LW QHHGV IRU D SDUWLFXODU EURZVHU HQYLURQPHQW

    'HIHUUHG %LQGLQJ LV D WHFKQLTXH XVHG E\ WKH *:7 FRPSLOHU WR FUHDWH DQG VHOHFW D VSHFLILF LPSOHPHQWDWLRQ RI D FODVVRQ D VHW RI SDUDPHWHUV ,Q HVVHQFH GHIHUUHG ELQGLQJ LV WKH *RRJOH :HE 7RRONLW DQVZHU WR -DYD UHIOHFWLRQ ,W DOORZV*:7 GHYHORSHU WR SURGXFH VHYHUDO YDULDWLRQV RI WKHLU DSSOLFDWLRQV FXVWRPWR HDFK EURZVHUHQYLURQPHQW DQG KDYRI WKHP DFWXDOO\ GRZQORDGHG DQG H[HFXWHG LQ WKH EURZVHU

    'HIHUUHG ELQGLQJ KDV VHYHUDO EHQHILWV5HGXFHV WKH VL]H RI WKH JHQHUDWHG -DYD6FULSW FRGH WKDW D FOLHQW ZLOO QHHG WR GRZQORDG E\ RQO\ LQFOXGLQJ WKHQHHGHG WR UXQ D SDUWLFXODU EURZVHU ORFDOH LQVWDQFH XVHG E\ WKH,QWHUQDWLRQDOL]DWLRQ PRGXOH

    6DYHV GHYHORSPHQW WLPH E\ DXWRPDWLFDOO\ JHQHUDWLQJ FRGH WR LPSOHPHQW DQ LQWHUIDFH RU FUHDWH D SUR[\ FODVVE\ WKH*:7 53& PRGXOH6LQFH WKH LPSOHPHQWDWLRQV DUH SUH ERXQGDW FRPSLOH WLPH WKHUH LV QR UXQ WLPH SHQDOW\ WR ORRN XS DQ LPSOHPHLQ D GDWD VWUXFWXUH DV ZLWK G\QDPLF ELQGLQJ RU XVLQJ YLUWXDO IXQFWLRQV

    6RPH SDUWV RI WKH WRRONLW PDNH LPSOLFLW XVH RI GHIHUUHG ELQGLQJ WKDW LV WKH\ XVH WKH WHFKQLTXH DV D SDUW RI WKHLPSOHPHQWDWLRQ EXW LW LV QRW YLVLEOH WR WKH XVHU RI WKH $3, )RU H[DPSOH PDQ\ZLGJHWV DQG SDQHOVDV ZHOO DV WKH'20 FODVVXVH WKLV WHFKQLTXH WR LPSOHPHQW EURZVHU VSHFLILF ORJLF 2WKHU*:7 IHDWXUHV UHTXLUH WKH $3, XVHUWR H[SOLFLW\ LQYRNGHIHUUHG ELQGLQJ E\ GHVLJQLQJ FODVVHV WKDW IROORZ VSHFLILF UXOHV DQG LQVWDQWLDWLQJ LQVWDQFHV RI WKH FODVVHV ZL*:7 FUHDWH &ODVVLQFOXGLQJ*:7 53& DQG, 1

    $V D XVHU RI WKH *RRJOH :HE 7RRONLW \RX PD\ QHYHU QHHG WR FUHDWH D QHZLQWHUIDFH WKDW XVHV GHIHUUHG ELQGLQJ ,I \RXIROORZ WKH LQVWUXFWLRQV LQ WKH JXLGHIRU FUHDWLQJ LQWHUQDWLRQDOL]HG DSSOLFDWLRQV RU*:7 53& FDOOV \RX ZLOO EH XVELQGLQJ EXW \RX ZLOO QRW KDYH WR DFWXDOO\ ZULWH DQ\ EURZVHU GHSHQGHQW RU ORFDOH GHSHQGHQW FRGH

    7KH UHVW RI WKH GHIHUUHG ELQGLQJ VHFWLRQ GHVFULEHV KRZ WR FUHDWH QHZUXOHV DQG FODVVHV XVLQJ GHIHUUHGELQGLQJQHZ WR WKH WRRONLW RURQO\ LQWHQG WR XVH SUH SDFNDJHG ZLGJHWV \RX ZLOO SUREDEO\ ZDQW WR VNLS RQ WR WKH QH[W WRSLQWHUHVWHG LQ SURJUDPPLQJ HQWLUHO\ QHZZLGJHWV IURPWKH JURXQG XS RU RWKHU IXQFWLRQDOLW\ WKDW UHTXLUHV FURVVEGHSHQGHQW FRGH WKH QH[W VHFWLRQV VKRXOGEH RI LQWHUHVW

    'HIL QLQJ 'HIHUUHG %LQGLQJ 5XOHV

    7KHUH DUH WZR ZD\V LQ ZKLFK W\SHV FDQ EH UHSODFHG YLD GHIHUUHG ELQGLQJ

    5HSODFHPHQW $ W\SHLV UHSODFHG ZLWKDQRWKHU GHSHQGLQJ RQ D VHW RI FRQILJXUDEOH UXOHV

    &RGH JHQHUDWLRQ $ W\SH LV VXEVWLWXWHG E\ WKH UHVXOW RI LQYRNLQJ D FRGH JHQUHDWRU DW FRPSLOH WLPH

    'LUHFWLYHV LQ 0RGXOH ;0/ ILOHV

    7KH GHIHUUHG ELQGLQJ PHFKDQLVPLV FRPSOHWHO\ FRQILJXUDEOH DQG GRHV QRW UHTXLUHHGLWLQJ WKH *:7 GLVWULEXWHG VRXUFRGH 'HIHUUHG ELQGLQJ LV FRQILJXUHG WKURXJK WKHUHSODFH ZLWK! DQG JHQHUDWH ZLWK! HOHPHQWV LQ WKHPRGXOH;0/ ILOHV 7KH GHIHUUHG ELQGLQJ UXOHV DUH SXOOHG LQWR WKHPRGXOH EXLOG WKURXJKLQKHULWV! HOHPHQWV

    )RU H[DPSOH WKHIROORZLQJ FRQILJXUDWLRQ LQYRNHVGHIHUUHG ELQGLQJ IRU WKH3RSXS3DQHOZLGJHW

    7RS OHYHO

    PRGXOH!

    JZW [PO LQKHULWVFRP JRRJOH JZW XVHU 8VHU

    'HIHUUHG %LQGLQJ

    'HIHUUHG %LQGLQJ %HQHILWV

    &RGLQJ %DVLFV *RRJOH :HE 7RRONLW *RRJOH &RGH

    S FRGH JRRJOH FRP ZHEWRRONLW GRF 'HY*XLGH&RGLQJ%DVLFV KWPO

  • 8/14/2019 GWT 1.6 Developer Guide

    46/116

  • 8/14/2019 GWT 1.6 Developer Guide

    47/116

    ,I WKH 3RSXS,PSO FUHDWHV DQ LIUDPH VKLP LW V DOVR QHFHVVDU\ WR KLGH LWDV ZHOO

    LPSO VHW9LVLEOHJHW(OHPHQW YLVLEOH`

    7KH GHIDXOW LPSOHPHQWDWLRQ RI3RSXS,PSO VHW9LVLEOH LV HPSW\ EXW3RSXS,PSO,( KDV VRPH VSHFLDO ORJLFLPSOHPHQWHG DV D-61, PHWKRG

    SXEOLF QDWLYHYRLGVHW9LVLEOH (OHPHQWSRSXS ERROHDQYLVLEOH ^LI SRSXS BBIUDPH ^SRSXS BBIUDPH VW\OH YLVLELOLW\ YLVLEOH " YLVLEOH KLGGHQ

    `` ^

    $IWHU WKH *:7 FRPSLOHU UXQV LW SUXQHV RXW DQ\XQXVHG FRGH ,I \RXU DSSOLFDWLRQUHIHUHQFHV WKH3RSXS3DQHOFODVV WKHFRPSLOHU ZLOO FUHDWH D VHSDUDWH -DYD6FULSW RXWSXW ILOH IRU HDFK EURZVHU HDFKFRQWDLQLQJ RQO\ RQH RI WKH LPSOHPHQ3RSXS,PSO 3RSXS,PSO,( RU3RSXS,PSO0R]LOOD 7KLV PHDQV WKDW HDFK EURZVHU RQO\GRZQORDGV WKHLPSOHPHQWDWLRQ LW QHHGV WKXVUHGXFLQJ WKH VL]H RI WKH RXWSXW -DYD6FULSW FRGH DQG PLQLPL]LQJ WKH WLPHQHHGHG W\RXU DSSOLFDWLRQ IURP WKH VHUYHU

    'HIH UUHG %LQGLQJ XVLQJ *HQHUDWRUV

    7KH VHFRQG WHFKQLTXH IRU GHIHUUHG ELQGLQJ FRQVLVWV RI XVLQJJHQHUDWRUV*HQHUDWRUV DUH FODVVHV WKDW DUH LQYRNHG E\ WKH*:7 FRPSLOHU WR JHQHUDWH D -DYD LPSOHPHQWDWLRQ RI D FODVV GXULQJ FRPSLODWLRQ :KHQ FRPSLOLQJ WR ZHE PRGH WKLVJHQHUDWHG LPSOHPHQWDWLRQ LV GLUHFWO\WUDQVODWHG WR RQH RI WKH YHUVLRQV RI \RXU DSSOLFDWLRQ LQ -DYD6FULSW FRGHZLOO GRZQORDG EDVHG RQ LWV EURZVHU HQYLURQPHQW

    7KH IROORZLQJ LV DQ H[DPSOH RI KRZ D GHIHUUHG ELQGLQJ JHQHUDWRU LV VSHFLILHG WR WKH FRPSLOHU LQ WKHPRGXOH ;0/ ILOHKLHUDUFK\ IRU WKH5HPRWH6HUYLFHFODVV XVHG IRU *:7 53&

    7RS OHYHO

    PRGXOH!

    JZW [PO LQKHULWVFRP JRRJOH JZW XVHU 8VHU

    FRP JRRJOH JZW XVHU 8VHU JZW [POLQKHULWVFRP JRRJO JZW XVHU 5HPRWH6HUYLFH

    FRP JRRJOH JZW XVHU 5HPRWH6HUYLFH JZW [POFRQWDLQV

    JHQHUDWHV ZLWK! HOHPHQWV WR GHILQH GHIHUUHG ELQGLQJUXOHV IRU WKH5HPRWH6HUYLFHFODVV

    *HQHUDWRU &RQILJXUDWLRQ LQ 0RGXOH ;0/

    7KH ;0/ HOHPHQW JHQHUDWH ZLWK! WHOOV WKH FRPSLOHU WR XVH D*HQHUDWRUFODVV +HUH DUH WKH FRQWHQWV RI WKH5HPRWH6HUYLFH JZW [PO ILOH UHOHYDQW WR GHIHUUHG ELQGLQJ

    PRGXOH!

    RWKHU FRQILJXUDWLRQ RPLWWHG !

    'HIDXOW ZDUQLQJ IRU QRQ VWDWLF ILQDO ILHOGV HQDEOHG !VHW SURSHUW\ QDPH JZW VXSSUHVV1RQ6WDWLF)LQDO)LHOG:DUQLQJV YDOXH IDOVH !

    JHQHUDWH ZLWKFODVV FRP JRRJOH JZW XVHU UHELQG USF 6HUYLFH,QWHUIDFH3UR[\*HQHUDWRU !

    ZKHQ W\SH DVVLJQDEOH FODVV FRP JRRJOH JZW XVHU FOLHQW USF 5HPRWH6HUYLFH !JHQHUDWH ZLWK!

    PRGXOH!

    7KHVH GLUHFWLYHV LQVWUXFW WKH *:7 FRPSLOHU WR LQYRNH PHWKRGV LQ D*HQHUDWRU VXEFODVV6HUYLFH,QWHUIDFH3UR[\*HQHUDWRULQ RUGHU WR JHQHUDWH VSHFLDO FRGH ZKHQ WKH GHIHUUHG ELQGLQJ PHFKDQLVP

    *:7 FUHDWH LV HQFRXQWHUHG ZKLOH FRPSLOLQJ ,Q WKLV FDVH LI WKH*:7 FUHDWH FDOO UHIHUHQFHV DQ LQVWDQFH RI 5HPRWH6HUYLFHRU RQH RI LWV VXEFODVVHV WKH6HUYLFH,QWHUIDFH3UR[\*HQHUDWRUV JHQHUDWH C PHWKRG ZLOO EHLQYRNHG

    &RGLQJ %DVLFV *RRJOH :HE 7RRONLW *RRJOH &RGH

    S FRGH JRRJOH FRP ZHEWRRONLW GRF 'HY*XLGH&RGLQJ%DVLFV KWPO

  • 8/14/2019 GWT 1.6 Developer Guide

    48/116

    *H QHUDWRU ,PSOHPHQWDWLRQ

    'HILQLQJ D VXEFODVV RI WKH*HQHUDWRUFODVV LV PXFK OLNH GHILQLQJ D SOXJ LQ WR WKH *:7 FRPSLOHU 7KH*HQHUDWRUJHWVFDOOHG WR JHQHUDWH D-DYD FODVV GHILQLWLRQ EHIRUH WKH -DYD WR -DYD6FULSW FRQYHUVLRQ RFFXUV 7KH LPSOHPHQWDWLRQRQH PHWKRG WKDW PXVW RXWSXW -DYD FRGH WR D ILOH DQG UHWXUQ WKH QDPH RI WKH JHQHUDWHG FODVV DV D VWULQJ

    7KH IROORZLQJ FRGH VKRZV WKH*HQHUDWRUWKDW LV UHVSRQVLEOH IRU GHIHUUHG ELQGLQJ RI D5HPRWH6HUYLFHLQWHUIDFH

    *HQHUDWRU IRU SURGXFLQJ WKH DV\QFKURQRXV YHUVLRQ RI D^#OLQN FRP JRRJOH JZW XVHU FOLHQW USF 5HPRWH6HUYLFH 5HPRWH6HUYLFH` LQWHUIDFH

    SXEOLF FODVV 6HUYLFH,QWHUIDFH3UR[\*HQHUDWRU H[WHQGV*HQHUDWRU

    *HQHUDWH D GHIDXOW FRQVWUXFWLEOH VXEFODVV RI WKH UHTXHVWHG W\SH 7KHJHQHUDWRU WKURZV FRGH!8QDEOH7R&RPSOHWH([FHSWLRQ FRGH! LI IRU DQ\ UHDVRQLW FDQQRW SURYLGH D VXEVWLWXWH FODVV

    #UHWXUQ WKH QDPH RI D VXEFODVV WR VXEVWLWXWH IRU WKH UHTXHVWHG FODVV RUUHWXUQ FRGH!QXOO FRGH! WR FDXVH WKH UHTXHVWHG W\SH LWVHOI WR EHXVHG

    SXEOLF 6WULQJJHQHUDWH 7UHH/RJJHU ORJJHU *HQHUDWRU&RQWH[WFW[6WULQJUHTXHVWHG&ODVV WKURZV8QDEOH7R&RPSOHWH([FHSWLRQ^

    7\SH2UDFOH W\SH2UDFOH FW[ JHW7\SH2UDFOHDVVHUW W\SH2UDFOH QXOO

    -&ODVV7\SH UHPRWH6HUYLFH W\SH2UDFOH ILQG7\SH UHTXHVWHG&ODVVLI UHPRWH6HUYLFH QXOO ^

    ORJJHU ORJ 7UHH/RJJHU (5525 8QDEOH WR ILQG PHWDGDWD IRU W\SHUHTXHVWHG&ODVV QXOO

    WKURZQHZ 8QDEOH7R&RPSOHWH([FHSWLRQ`

    LI UHPRWH6HUYLFHLV,QWHUIDFH QXOO ^

    ORJJHU ORJ 7UHH/RJJHU (5525 UHPRWH6HUYLFH JHW4XDOLILHG6RXUFH1DPHLV QRW DQ LQWHUIDFH QXOOWKURZQHZ 8QDEOH7R&RPSOHWH([FHSWLRQ

    `

    3UR[\&UHDWRUSUR[\&UHDWRU QHZ 3UR[\&UHDWRU UHPRWH6HUYLFH

    7UHH/RJJHU SUR[\/RJJHU ORJJHU EUDQFK 7UHH/RJJHU '(%8**HQHUDWLQJ FOLHQW SUR[\ IRU UHPRWH VHUYLFH LQWHUIDFH

    UHPRWH6HUYLFH JHW4XDOLILHG6RXUFH1DPH QXOO

    UHWXUQSUR[\&UHDWRU FUHDWHSUR[\/RJJHU FW[`

    `

    7KH W\SH2UDFOHLV DQ REMHFW WKDW FRQWDLQV LQIRUPDWLRQ DERXW WKH -DYD FRGH WKDW KDV DOUHDG\ EHHQ SDUVHG WKDWJHQHUDWRU PD\ QHHG WR FRQVXOW ,Q WKLV FDVH WKHJHQHUDWH PHWKRG FKHFNV LW DUJXPHQWV DQG WKH SDVVHV RII WKH EXON RI WKH ZRUN WR DQRWKHU FODVV3UR[\&UHDWRU

    &RGLQJ %DVLFV *RRJOH :HE 7RRONLW *RRJOH &RGH

    S FRGH JRRJOH FRP ZHEWRRONLW GRF 'HY*XLGH&RGLQJ%DVLFV KWPO

  • 8/14/2019 GWT 1.6 Developer Guide

    49/116

  • 8/14/2019 GWT 1.6 Developer Guide

    50/116

    7 KH ILUVW PHVVDJH LQ WKH ORJ ZLQGRZ LV DERXWVWDUWLQJ DQ +773 VHVVLRQ %\ GHIDXOW KRVWHG PRGH UXQV DQ LQLQVWDQFH WR VHUYH \RXU ZHE DSSOLFDWLRQ 7KLV HPEHGGHG -HWW\ LQVWDQFH VHUYHV GLUHFWO\ RXW RI \RXU SURMH

  • 8/14/2019 GWT 1.6 Developer Guide

    51/116

  • 8/14/2019 GWT 1.6 Developer Guide

    52/116

    LI ODEHO JHW7H[W HTXDOVODEHO VHW7H[W +HOOR :RUOG

    HOVHODEHO VHW7H[W

    ``

    &DOOV WR *:7 ORJ DUH LQWHQGHG MXVW IRU XVH ZKLOH GHEXJJLQJ \RXU DSSOLFDWLRQ 7KH\ DUH RSWLPL]HG RXW LQ ZHH[DPSOH FRQVLGHU WKH IROORZLQJ FKDQJH WR WKH RQ&OLFN PHWKRG LQWHQGHG WR LQWHQWLRQDOO\ WULJJHU DQ H

    SXEOLF YRLG RQ&OLFN :LGJHW VHQGHU ^*:7 ORJ 8VHU SUHVVHG D EXWWRQ QXOO

    2EMHFW QXOO2EMHFW QXOOQXOO2EMHFW WR6WULQJ 6KRXOG FDXVH 1XOO3RLQWHU([FHSWLRQ

    :KHQ WKH KRVWHG DSSOLFDWLRQ HQFRXQWHUV DQ H[FHSWLRQ D PHVVDJH LV SULQWHG RQ WKH ORJ ZLQGRZ 7KH H[FHSWKLJKOLJKWHG ZLWK D UHG LFRQ ,Q WKLV H[DPSOH ZKHQ \RX FOLFN RQ WKH EXWWRQ LQ WKH EURZVHU ZLQGRZ D 1XOO3RWULJJHUHG DQG WKH EDFN WUDFH IRU WKH H[FHSWLRQ GLVSOD\V LQ WKH VWDWXV DUHD EHORZ WKH ORJ DUHD &OLFNLPHVVDJH RU LFRQ GLVSOD\V WKH IXOO WH[W RI WKH H[FHSWLRQ LQ WKH PHVVDJH DUHD EHORZ

    &RPSLOLQJ 'HEXJJLQJ *RRJOH :HE 7RRONLW *RRJOH &RGH

    S FRGH JRRJOH FRP ZHEWRRONLW GRF 'HY*XLGH&RPSLOLQJ$QG'HEX

  • 8/14/2019 GWT 1.6 Developer Guide

    53/116

    ( QDEOLQJ LQWHUQDO *:7 GHEXJ PHVVDJHV

    7 KH ORJ ZLQGRZ FDQ GLVSOD\ PRUH YHUERVH GHEXJJLQJ LI \RX LQYRNH LWE\ VSHFLI\LQJ WKHORJ/HYHO FRPPDQG OLQHDUJXPHQW 6SHFLI\LQJ WKH OHYHO RI63$0 WXUQV RQ PDQ\ PHVVDJHV LQVLGH RI WKH *:7 HQJLQH 7KHVH PHVVDJHV DUHGLVSOD\HG LQ D KLHUDUFKLFDO WUHH ZKLFK FDQ EH PDQLSXODWHG E\ FOLFNLQJ RQ LQGLYLGXDO OLQHV RU E\ XVLQJ WK&ROODSVH $OO LFRQV LQ WKH WRROEDU

    &RPSLOLQJ 'HEXJJLQJ *RRJOH :HE 7RRONLW *RRJOH &RGH

    S FRGH JRRJOH FRP ZHEWRRONLW GRF 'HY*XLGH&RPSLOLQJ$QG'HEX

  • 8/14/2019 GWT 1.6 Developer Guide

    54/116

    8VLQJ DQ ,'( ZLWK +RVWHG 0RGH

    :KHQ XVLQJ DQ ,'( VXFK DV (FOLSVH -%XLOGHU RU ,QWHOOL- LW LVHDV\ WR XVH WKH ,'( V EXLOW LQ -DYD GHEXJJHU WR GHPRGXOH 6LPSO\ VHW D EUHDNSRLQW VRPHZKHUH LQVLGH \RXU FRGH VXFK DV WKHRQ0RGXOH/RDG HQWU\ SRLQW ZKHUH \RXZDQW WKH GHEXJJHU WR VWRS DQG OHW \RX LQVSHFW WKH VWDWH RI \RXU SURJUDP )RU DQ H[DPSOH RI GHEXJJLQJ LQ KRVXVLQJ WKH (FOLSVH ,'( VHH WKH *HWWLQJ 6WDUWHG WXWRULDO'HEXJJLQJ D *:7 $SSOLFDWLRQ

    $Q ([DPSOH /DXQFK

    /HW V ORRN EHKLQG WKH VFHQHV ZKHQ \RX ODXQFK \RXU *:7 DSSOLFDWLRQ LQ KRVWHG PRGH 7R UXQ KRVWHG PRGH \RX V-DYD 90 XVLQJ WKH PDLQ FODVVFRP JRRJOH FRP JZW GHY +RVWHG0RGH ,I \RX ORRN LQVLGH D JHQHUDWHG DQWEXLOG [PO \RX OO ILQG VRPHWKLQJ OLNH WKLV

    WDUJHW QDPH KRVWHG GHSHQGV MDYDF GHVFULSWLRQ 5XQ KRVWHG PRGH !MDYD IDLORQHUURU WUXH IRUN WUXH FODVVQDPH FRP JRRJOH JZW GHY +RVWHG0RGH !

    FODVVSDWK!SDWKHOHPHQW ORFDWLRQ VUF !SDWK UHILG SURMHFW FODVV SDWK !

    FODVVSDWK!MYPDUJ YDOXH ;P[ 0 !DUJ YDOXH VWDUWXS8UO !DUJ YDOXH +HOOR KWPO !

    $GGLWLRQDO DUJXPHQWV OLNH VW\OH 35(77< RU ORJ/HYHO '(%8* !DUJ YDOXH FRP JRRJOH JZW VDPSOH KHOOR +HOOR !

    &RPSLOLQJ 'HEXJJLQJ *RRJOH :HE 7RRONLW *RRJOH &RGH

    S FRGH JRRJOH FRP ZHEWRRONLW GRF 'HY*XLGH&RPSLOLQJ$QG'HEX

  • 8/14/2019 GWT 1.6 Developer Guide

    55/116

    MDYD!WDUJHW!

    7 KLV LV VLPLODU WR UXQQLQJ WKH IROORZLQJ FRPPDQG RQ WKH FRPPDQG OLQH

    MDYD ;P[ 0 FS VUF ZDU :(% ,1) FODVVHV ?JZW ZLQGRZV ?JZW XVHU MDU?JZW ZLQGRZV ?JZW GHY ZLQGRZV MDUFRP JRRJOH JZW GHY +RVWHG0RGH VWDUWXS8UO +HOOR KWPO

    FRP JRRJOH JZW VDPSOH KHOOR +HOOR

    7KH VWDUWXS8UO SDUDPHWHU WHOOV +RVWHG 0RGH ZKLFK 85/ V WR ODXQFK LQ WKH KRVWHG PRGH EURZVHU ZKHQ LWVWKH YDOXH H[FOXGHV WKH GRPDLQ WKH GRPDLQ LV DVVXPHG WR EHORFDOKRVW 7KH SRUW LV DVVXPHG WR EH WKH SRUW UXQQLQJ WHPEHGGHG VHUYHU ,Q WKH H[DPSOH DERYH WKLV DGGUHVV LVKWWS ORFDOKRVW +HOOR KWPO

    7KH ILQDO SDUDPHWHU WKH RQH DW WKH HQG ZLWK QR IODJ SUHFHGLQJ LW LV WKH PRGXOH RU VHW RI PRGXOHV ZH FDUYDOXH LV UHTXLUHG LQ RUGHU WR FRUUHFWO\LQLWLDOL]H WKH ZDU GLUHFWRU\ ZLWK ERRWVWUDS VFULSWV IRU DQ\ *WR UXQ

    $IWHU \RX KDYH \RXU DSSOLFDWLRQ ZRUNLQJ ZHOO LQKRVW HG PRGH \RX ZLOO ZDQWWR WU\ RXW \RXU DSSOLFDWLRQ LQ \RXU WDUJHWEURZVHUV WKDW LV \RX ZDQW WR UXQ LW LQZHE PRGH 7KLV LV DV HDV\ DV FOLFNLQJ WKH&RPSLOH %URZVHEXWWRQ LQ WKH WRROEDU RI WKH +RVWHG 0RGH EURZVHU

    $IWHU \RX FOLFN WKH&RPSLOH %URZVHEXWWRQ +RVWHG 0RGH SDXVHV ZKLOH WKH *:7 FRPSLOHU WUDQVODWHV \RXU -DYD VRXFRGH SOXV WKH VRXUFH FRGH RI WKH *:7 OLEUDU\ DQG DQ\ WKLUG SDUW\ OLEUDULHV LQWR RSWLPL]HG -DYD6FULSW ,I WUXQV LQWR HUURUV WKH\ ZLOO EH GLVSOD\HG LQ WKH ORJ ZLQGRZ $IWHU WKH FRPSLODWLRQ FRPSOHWHV VXFFHVVIXOOZLQGRZ RSHQV GLVSOD\LQJ \RXU +70/ KRVW SDJH DQG \RXU DSSOLFDWLRQ 2U DQ H[LVWLQJ EURZVHU VHVVLRQ PLJKW GLVDSSOLFDWLRQ LQ D QHZ WDE

    5XQQLQJ \RXU DSSOLFDWLRQ LQ ZHE PRGH DOORZV \RX WR WHVW \RXU DSSOLFDWLRQ DV LW LV GHSOR\HG ,I \RX KDYH D VHFRPSRQHQW VSHFLILHG LQ \RXUZHE [PO ILOH \RXU *:7 53& FDOOV ZLOO DOVR EH VHUYHG WR WKH EURZVHU

  • 8/14/2019 GWT 1.6 Developer Guide

    56/116

  • 8/14/2019 GWT 1.6 Developer Guide

    57/116

    $IWHU UXQQLQJ WKH *:7 FRPSLOHU \RXU ZDU GLUHFWRU\ VKRXOG ORRN VRPHWKLQJ OLNH WKLV

    & ?JZW ZLQGRZV ?VDPSOHV?+HOOR!?ELQ?ILQG ZDUZDUZDU?KHOORZDU?KHOOR? ((& '$ &% ) & ( $( )&( FDFKH KWPOZDU?KHOOR? % '& & ($ ''() (( FDFKH KWPOZDU?KHOOR? '$ '&() ) %( ( &' $ FDFKH KWPOZDU?KHOOR?$ )& )) ' ) % & & $) % ) FDFKH KWPOZDU?KHOOR?( & $%% ( $ $ '% ) $ FDFKH KWPOZDU?KHOOR? $ &' ( % $ & % % ' ') & FDFKH SQJZDU?KHOOR? &') ' )( ) &$ ' )% ) FDFKH SQJZDU?KHOOR? '$ & &)) ) ' ) FDFKH SQJZDU?KHOOR?$ &' ) ( $ '(' ) $' ' %$ $ $ FDFKH SQJZDU?KHOOR?% ( & ( $$ $% & ' FDFKH SQJZDU?KHOOR?FOHDU FDFKH JLIZDU?KHOOR?KHOOR QRFDFKH MVZDU?KHOOR?KRVWHG KWPOZDU?+HOOR KWPO

    ,Q WKH DERYH H[DPSOHZDU KHOOR KHOOR QRFDFKH MV LV WKH VFULSW\RX ZRXOG LQFOXGH LQ D KRVW +70/ SDJH WR ORDG

    +HOOR DSSOLFDWLRQ ,Q WKLV FDVH WKH KRVW +70/ SDJH LV ORFDWHG DVZDU +HOOR KWPO DQG ORDGV WKH *:7 VWDUWXS VFULSWWKURXJK WKH UHODWLYH 85/KHOOR KHOOR QRFDFKH MV

    &RPSLOLQJ 'HEXJJLQJ *RRJOH :HE 7RRONLW *RRJOH &RGH

    S FRGH JRRJOH FRP ZHEWRRONLW GRF 'HY*XLGH&RPSLOLQJ$QG'HEX

  • 8/14/2019 GWT 1.6 Developer Guide

    58/116

    *RRJOH :HE 7RRONLW +RPH 'RFV %ORJ *URXS 7HUPV

    * :7 XVHU LQWHUIDFH FODVVHV DUH VLPLODU WR WKRVH LQ H[LVWLQJ 8, IUDPHZRUNV VXFK DV6ZLQJ DQG6:7 H[FHSW WKDW WKH ZLGJHWVDUH UHQGHUHG XVLQJ G\QDPLFDOO\ FUHDWHG+70/ UDWKHU WKDQ SL[HO RULHQWHG JUDSKLFV

    ,Q WUDGLWLRQDO -DYD6FULSW SURJUDPPLQJ G\QDPLF XVHU LQWHUIDFH FUHDWLRQ LV GRQH E\ PDQLSXODWLQJ WKH EURZVHUV '*:7 SURYLGHV DFFHVV WR WKH EURZVHU V '20 GLUHFWO\XVLQJ WKH'20 FODVV LW LV IDU HDVLHU WR XVH FODVVHV IURP WKH:LGJHWKLHUDUFK\ 7KH :LGJHW FODVVHV PDNH LW HDVLHU WR TXLFNO\ EXLOG LQWHUIDFHV WKDW ZLOOZRUN FRUUHFWO\RQ DOO EURZ

    &URVVE URZVHU 6XSSRUW

    8QGHUVWDQGLQJ /D\RXW

    :LGJHWV DQG 3DQHOV

    &UHDWLQJ &XVWRP :LGJHWV

    $FFHVVLQJ WKH %URZVHU V '20

    (YHQWV DQG +DQGOHUV

    $SSO\LQJ 6W\OH

    ,PDJH %XQGOHV

    *:7 VKLHOGV \RX IURP ZRUU\LQJ WRR PXFK DERXW FURVV EURZVHU LQFRPSDWLELOLWLHV ,I \RX VWLFN WR EXLOW LQZLGJHWVDQGFRPSRVLWHV\RXU DSSOLFDWLRQV ZLOO ZRUN VLPLODUO\ RQ WKH PRVW UHFHQW YHUVLRQV RI ,QWHUQHW ([SORUHU )LUHIR[ DQG 62SHUD WRR PRVW RI WKH WLPH '+70/ XVHU LQWHUIDFHV DUH UHPDUNDEO\ TXLUN\ WKRXJK VR PDNH VXUHWR WHVW \RXU DSSOLFDWLRQV WKRURXJKO\ RQ HYHU\ EURZVHU

    :KHQHYHU SRVVLEOH *:7 GHIHUV WR EURZVHUV QDWLYH XVHULQWHUIDFH HOHPHQWV )RU H[DPSOH *:7 V%XWWRQZLGJHW LV D WUXH+70/ EXWWRQ!UDWKHU WKDQ D V\QWKHWLF EXWWRQ OLNH ZLGJHW EXLOW VD\ IURP DGLY! 7KDW PHDQV WKDW *:7 EXWWRQVUHQGHU DSSURSULDWHO\ LQ GLIIHUHQW EURZVHUV DQGRQ GLIIHUHQW FOLHQW RSHUDWLQJ V\VWHPV :H OLNH WKH QDWLYH EUEHFDXVH WKH\ UH IDVW DFFHVVLEOH DQG PRVW IDPLOLDU WR XVHUV

    :KHQ LW FRPHV WR VW\OLQJ ZHE DSSOLFDWLRQV&66 LV LGHDO 6R LQVWHDG RI DWWHPSWLQJ WR HQFDSVXODWH 8,VW\OLQJ EHKLQG D ZDRI OHDVW FRPPRQ GHQRPLQDWRU $3,V *:7 SURYLGHV YHU\ IHZ PHWKRGV GLUHFWO\ UHODWHG WR VW\OH 5DWKHU GHYHORSHUV DHQFRXUDJHG WR GHILQH VW\OHV LQ VW\OHVKHHWV WKDW DUH OLQNHG WR DSSOLFDWLRQ FRGH XVLQJVW\OH QDPHV,Q DGGLWLRQ WR FOHDQO\VHSDUDWLQJ VW\OH IURPDSSOLFDWLRQ ORJLF WKLV GLYLVLRQ RI ODERU KHOSV DSSOLFDWLRQV ORDG DQG UHQGHU PRUH TXLFNPHPRU\ DQG HYHQ PDNHV WKHP HDVLHU WR WZHDN GXULQJ HGLW GHEXJ F\FOHV VLQFH WKHUHV QR QHHG WR UHFRPSLOH IRU VWWZHDNV

    7LS ,I \RX ILQGD QHHG WR LPSOHPHQW D EURZVHU VSHFLILF GHSHQGHQF\ \RX FDQ XVH D-61, PHWKRG WR UHWULHYH WKHEURZVHU 8VHU$JHQW VWULQJ

    SXEOLF VWDWLFQDWLYH6WULQJJHW8VHU$JHQW ^UHWXUQ QDYLJDWRU XVHU$JHQW WR/RZHU&DVH

    `

    3DQHOV LQ *:7 DUH PXFK OLNH WKHLU OD\RXW FRXQWHUSDUWV LQ RWKHU XVHU LQWHUIDFH OLEUDULHV 7KH PDLQ GLIIHUHQFHWKDW *:7 SDQHOV XVH +70/ HOHPHQWV VXFK DV',9DQG 7$%/( WR OD\RXW WKHLUFKLOG ZLGJHWV

    5RRW3DQHO

    7KH ILUVW SDQHO \RX UH OLNHO\ WR HQFRXQWHU LV WKH5RRW3DQHO7KLV SDQHO LV DOZD\V DW WKH WRS RI WKH FRQWDLQPHQW KLHUDUFK\7KH GHIDXOW 5RRW3DQHO ZUDSV WKH +70/ GRFXPHQW V ERG\ DQG LV REWDLQHG E\ FDOOLQJ5RRW3DQHO JHW,I \RX QHHG WR JHW D

    %XLOGLQJ 8VHU ,QWHUIDFHV

    &URVV EURZVHU 6XSSRUW

    8QGHUVWDQGLQJ /D\RXW

    WKH FRQWHQW RI WKLV SDJH LV OLFHQVHG XQGHU WKH&UHDWLYH &RPPRQV $WWULEXWLRQ /LFHQVH

    *RRJOH &RGH +RPH 7HUPV RI 6HUYLFH3ULYDF\ 3ROLF\6LWH 'LUHFWRU\

    *RRJOH &RGH RIIHUHG LQ(QJ OLVK(VSDxRO 3RUWXJXrV3

    %XLOGLQJ8VHU ,QWHUIDFHV *RRJOH :HE 7RRONLW *RRJOH &RGH

    S FRGH JRRJOH FRP ZHEWRRONLW GRF 'HY*XLGH8VHU,QWHUIDFH KWPO

  • 8/14/2019 GWT 1.6 Developer Guide

    59/116

  • 8/14/2019 GWT 1.6 Developer Guide

    60/116

    2WKHUZLVH \RX PLJKW KDYH WR PDNH LW UHDOO\ UHDOO\ VPDOO LQ RUGHUWR VHH WKH QLIW\ VFUROO EDUV

    6FUROO3DQHOVFUROOHU QHZ 6FUROO3DQHO FRQWHQWVVFUROOHU VHW6L]H S[ S[GRFN DGG VFUROOHU 'RFN3DQHO &(17(5

    $V \RX FDQ VHH LQ WKH VFUHHQVKRW EHORZ WKH RUGHU RI DGGLQJ FRPSRQHQWV WR WKH'RF3DQHO LV LPSRUWDQW LI \RX DGG PRUHWKDQ RQH FRPSRQHQW WR WKH VDPH GLUHFWLRQ 7KH ILUVW FRPSRQHQW DGGHG ZLOO EH FORVHVW WR WKH HGJH 7KH QH[W FRPSRDGGHG ZLOO QHVW WRZDUG WKH LQVLGH RI WKH SDQHO

    7DE 3DQHO

    7KH 7DE3DQHOGLVSOD\V D URZ RI FOLFNDEOH WDEV (DFK WDE LV DVVRFLDWHG ZLWK D SDQHO ZKLFKFDQ FRQWDLQ D VXE SDQHO RUDUELWUDU\ +70/ ZKLFK LV H[SRVHG LQ D PDLQ YLHZLQJ DUHD ZKHQ WKH WDE LV VHOHFWHG 7KH PDLQ YLHZLQJ DUHD LV LPSOHPHQWZLWK D'HFN3DQHO$Q H[DPSOH RI XVLQJ D 7DE 3DQHO IROORZV

    &UHDWH D WDE SDQHO7DE3DQHOWDE3DQHO QHZ 7DE3DQHO

    6HW WKH ZLGWK WR SL[HOVWDE3DQHO VHW:LGWK S[

    $GG D KRPH WDE

    +70/ KRPH7H[W QHZ+70/ &OLFN RQH WKH WDEV WR VHH PRUH FRQWHQWWDE3DQHO DGG KRPH7H[W +RPH

    $GG D WDE ZLWK DQ LPDJH9HUWLFDO3DQHOY3DQHO QHZ 9HUWLFDO3DQHO

    Y3DQHO DGG 6KRZFDVH LPDJHV JZW/RJR FUHDWH,PDJHWDE3DQHO DGG Y3DQHO *:7 /RJR

    $GG D WKLUG WDE+70/ PRUH,QIR QHZ+70/ 7DEV DUH KLJKO\ FXVWRPL]DEOH XVLQJ &66WDE3DQHO DGG PRUH,QIR 0RUH ,QIR

    0DNH WKH ILUVW WDE VHOHFWHG DQG WKH WDE V FRQWHQW YLVLEOHWDE3DQHO VHOHFW7DE

    7KH VFUHHQVKRW EHORZ VKRZV WKH7DE3DQHOIRFXVHG RQ WKH ILUVW WDE $V \RX FDQ VHH IURPWKH FRGH H[DPSOH \RX FDQDGG+70/ RU RWKHU SDQHOV WR EH GLVSOD\HG DV WKH FRQWHQW RI WKH WDE

  • 8/14/2019 GWT 1.6 Developer Guide

    61/116

    +RUL]RQWDO DQG 9HUWLFDO 6SOLW SDQHOV

    7 KH+RUL]RQWDO6SOLW3DQHODQG9HUWLFDO6SOLW3DQHODUUDQJH WZR ZLGJHWV LQ D VLQJOH URZ RU FROXPQ DQG DOORZ WKH XVHU WRLQWHUDFWLYHO\ FKDQJH WKH SURSRUWLRQ RI WKH ZLGWK GHGLFDWHG WR HDFK RI WKH WZR ZLGJHWV :LGJHWV FRQWDLQHG ZLWSDQHOV ZLOO EH DXWRPDWLFDOO\ GHFRUDWHG ZLWKVFUROOEDUV ZKHQ QHFHVVDU\

    &UHDWH D 9HUWLFDO 6SOLW 3DQHO9HUWLFDO6SOLW3DQHOY6SOLW QHZ 9HUWLFDO6SOLW3DQHO

    6HW WKH ERXQGLQJ ER[ LQ SL[HOVY6SOLW VHW6L]H S[ S[

    6HW WKH SRVLWLRQ RI WKH KDQGOH IURP WKH WRS RI WKH

    SDQHO

    Y6SOLW VHW6SOLW3RVLWLRQ

    $GG VRPH FRQWHQW6WULQJUDQGRP7H[W 7KLV LV VRPH WH[W WR VKRZ KRZ WKH FRQWHQWV RQ HLWKHU

    VLGH RI WKH VSOLWWHU IORZ7KLV LV VRPH WH[W WR VKRZ KRZ WKH FRQWHQWV RQ HLWKHUVLGH RI WKH VSOLWWHU IORZ7KLV LV VRPH WH[W WR VKRZ KRZ WKH FRQWHQWV RQ HLWKHUVLGH RI WKH VSOLWWHU IORZ

    Y6SOLW VHW7RS:LGJHW QHZ+70/ UDQGRP7H[WY6SOLW VHW%RWWRP:LGJHWQHZ+70/ UDQGRP7H[W

    %\ PDQLSXODWLQJ WKH KDQGOH LQ WKH PLGGOH RI WKH SDQHO WKH XVHU FDQ H[SRVH PRUHRI WKH XSSHU RU ORZHU SRUWLRQ RI WDV VKRZQ LQ WKH VFUHHQVKRW EHORZ

    %XLOGLQJ8VHU ,QWHUIDFHV *RRJOH :HE 7RRONLW *RRJOH &RGH

    S FRGH JRRJOH FRP ZHEWRRONLW GRF 'HY*XLGH8VHU,QWHUIDFH KWPO

  • 8/14/2019 GWT 1.6 Developer Guide

    62/116

  • 8/14/2019 GWT 1.6 Developer Guide

    63/116

    )OH[7DEOH $ IOH[LEOH WDEOH WKDW FUHDWHV FHOOV RQ GHPDQG ,W FDQ EH MDJJHG WKDW LV HDFK URZ FDQ FRQWDLQ D GLIIQXPEHU RI FHOOV DQG LQGLYLGXDO FHOOV FDQ EH VHW WR VSDQ PXOWLSOH URZV RU FROXPQV

    $EVROXWH3DQHO$Q DEVROXWHSDQHO SRVLWLRQV DOO RI LWV FKLOGUHQ DEVROXWHO\ DOORZLQJ WKHP WR RYHUODS

    6HH WKH :LGJHW *DOOHU\ IRU VFUHHQVKRWV RU GLDJUDPV IRU WKHVH SDQHOV

    6L]HV DQG 0HDVXUHV

    ,W LV SRVVLEOH WR VHW WKH VL]H RI D ZLGJHW H[SOLFLWO\ XVLQJVHW:LGWKVHW+HLJKWDQGVHW6L]H7KH DUJXPHQWV WR WKHVHPHWKRGV DUH VWULQJV UDWKHU WKDQ LQWHJHUV EHFDXVH WKH\ DFFHSW DQ\ YDOLG &66 PHDVXUHPHQWV VXFK DV SL[HOV S[FHQWLPHWHUV FP DQGSHUFHQWDJH

  • 8/14/2019 GWT 1.6 Developer Guide

    64/116

  • 8/14/2019 GWT 1.6 Developer Guide

    65/116

    &UHDWH D ZLGJHW WKDW ZUDSV -DYD6FULSW XVLQJ-61, PHWKRGV

    7KHUH DUH QXPHURXV WKLUG SDUW\ OLEUDULHV WKDW SURYLGH ZLGJHWV \RX FDQ LQWHJUDWH LQWR \RXU *:7 PRGXOH WKDW ZHUXVLQJ WKH VWUDWHJLHV OLVWHG DERYH

    %XLOGLQJ &RPSRVLWHV

    7KH PRVW HIIHFWLYH ZD\ WR FUHDWH QHZ ZLGJHWV LV WR H[WHQG WKH&RPSRVLWHFODVV $FRPSRVLWH LV D VSHFLDOL]HG ZLGJHW WKDWFDQ FRQWDLQ DQRWKHU FRPSRQHQW W\SLFDOO\ DSDQHOEXW EHKDYHV DV LI LW ZHUHLWV FRQWDLQHG ZLGJHW

  • 8/14/2019 GWT 1.6 Developer Guide

    66/116

    LI VHQGHU FKHFN%R[ ^:KHQ WKH FKHFN ER[ LV FOLFNHG XSGDWH WKH WH[W ER[ V HQDEOHG VWDWH

    WH[W%R[ VHW(QDEOHGFKHFN%R[ LV&KHFNHG`

    `

    6HWV WKH FDSWLRQ DVVRFLDWHG ZLWK WKH FKHFN ER[

    #SDUDP FDSWLRQ WKH FKHFN ER[ V FDSWLRQ

    SXEOLF YRLGVHW&DSWLRQ6WULQJFDSWLRQ ^1RWH KRZ ZH XVH WKH XVH FRPSRVLWLRQ RI WKH FRQWDLQHG ZLGJHWV WR SURYLGHRQO\ WKH PHWKRGV WKDW ZH ZDQW WR

    FKHFN%R[ VHW7H[W FDSWLRQ`

    *HWV WKH FDSWLRQ DVVRFLDWHG ZLWK WKH FKHFN ER[

    #UHWXUQ WKH FKHFN ER[ V FDSWLRQ

    SXEOLF 6WULQJJHW&DSWLRQ ^UHWXUQFKHFN%R[ JHW7H[W

    ``

    SXEOLF YRLGRQ0RGXOH/RDG ^&UHDWH DQ RSWLRQDO WH[W ER[ DQG DGG LW WR WKH URRW SDQHO

    2SWLRQDO7H[W%R[RWE QHZ 2SWLRQDO7H[W%R[ &KHFN WKLV WR HQDEOH PH5RRW3DQHO JHW DGG RWE

    ``

    )URP 6FUDWFK LQ -DYD &RGH

    ,W LV DOVR SRVVLEOH WR FUHDWH D ZLGJHW IURP VFUDWFK DOWKRXJK LW LV WULFNLHU VLQFH \RX KDYH WR ZULWH FRGHDW D ORRI WKH EDVLF ZLGJHWV DUH ZULWWHQ WKLV ZD\ VXFK DV%XWWRQDQG7H[W%R[3OHDVH UHIHU WR WKH LPSOHPHQWDWLRQV RI WKHVHZLGJHWV WR XQGHUVWDQG KRZ WR FUHDWH \RXU RZQ

    7R XQGHUVWDQG KRZ WR FUHDWH \RXU RZQ UHIHUWR WKH LPSOHPHQWDWLRQV RI WKHVH ZLGJHWV LQWKH FRP JRRJOH JZW XVHUSDFNDJH 7KH VRXUFH FRGH LV LQ JZW XVHU MDU

    8VLQJ -DYD6FULSW

    :KHQ LPSOHPHQWLQJ D FXVWRPZLGJHW WKDW GHULYHV GLUHFWO\ IURP WKH:LGJHWEDVH FODVV \RX PD\ DOVR ZULWH VRPH RI WKHZLGJHW V PHWKRGV XVLQJ -DYD6FULSW 7KLV VKRXOG JHQHUDOO\ RQO\ EH GRQH DV D ODVW UHVRUW DV LW EHFRPHV QHFHVVDU\ WFRQVLGHU WKH FURVV EURZVHU LPSOLFDWLRQV RI WKH QDWLYH PHWKRGV WKDW \RX ZULWH DQG DOVR EHFRPHV PRUH GLIILFXOW)RU DQ H[DPSOH RI WKLV SDWWHUQ LQ SUDFWLFH VHH WKH7H[W%R[ZLGJHW DQG WKH XQGHUO\LQJ -DYD6FULSW LPSOHPHQWDWLRQ RI VRPHRI LWV PHWKRGV LQ WKH 7H[W%R[,PSO FODVV

  • 8/14/2019 GWT 1.6 Developer Guide

    67/116

  • 8/14/2019 GWT 1.6 Developer Guide

    68/116

  • 8/14/2019 GWT 1.6 Developer Guide

    69/116

  • 8/14/2019 GWT 1.6 Developer Guid