LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58...

38
’HSOR\LQJ2UDFOH*UDSKLFVLQ 2UDFOHL$69)RUPV6HUYLFHV %HVWSUDFWLFHVIRULQWHJUDWLQJ2UDFOH *UDSKLFVLQ)RUPVRQWKH:HE $Q2UDFOH:KLWH3DSHU )HEUXDU\

Transcript of LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58...

Page 1: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

'HSOR\LQJ�2UDFOH�*UDSKLFV�LQ�2UDFOH�L$6�9��)RUPV�6HUYLFHV���%HVW�SUDFWLFHV�IRU�LQWHJUDWLQJ�2UDFOH�*UDSKLFV�LQ�)RUPV�RQ�WKH�:HE� $Q�2UDFOH�:KLWH�3DSHU�)HEUXDU\��������

Page 2: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

([HFXWLYH�2YHUYLHZ ������������������������������������������������������������������������������������������� ,QWURGXFWLRQ���������������������������������������������������������������������������������������������������������

2UDFOH�*UDSKLFV��L��WKH�)LQDO�5HOHDVH�RI�2UDFOH�*UDSKLFV ���������������������� 0LJUDWLQJ�&KDUWV�WR�WKH�:HE ������������������������������������������������������������������������ &KDUWLQJ�LQ�1HZ�)RUPV��L�$SSOLFDWLRQV ����������������������������������������������������� ,QWHQGHG�$XGLHQFH ����������������������������������������������������������������������������������������� 6XSSOHPHQWDU\�6DPSOH�0RGXOHV ������������������������������������������������������������������

,QWHJUDWLQJ�)RUPV��L�ZLWK�2UDFOH�*UDSKLFV��L������������������������������������������������ &DOOLQJ�WKH�2UDFOH�*UDSKLFV��L�([HFXWDEOHV ����������������������������������������������� 8SJUDGLQJ�2*�3// ��������������������������������������������������������������������������������������� 8SJUDGLQJ�WR�2UDFOH�'HYHORSHU��L�3DWFK�� ������������������������������������������������

&DOOLQJ�2UDFOH�*UDSKLFV�'LVSOD\V�IURP�2UDFOH�)RUPV ��������������������������������� 'LVSOD\LQJ�2*'V�YLD�5HSRUWV�6HUYLFHV ������������������������������������������������������ 'LVSOD\LQJ�2*'V�LQ�D�)RUPV�,PDJH�,WHP������������������������������������������������� 'LVSOD\LQJ�2*'V�LQ�D�)RUPV�&KDUW�,WHP��������������������������������������������������

&KDUWV�FUHDWHG�ZLWK�WKH�&KDUW�:L]DUG ���������������������������������������������������� 'LVSOD\LQJ�DQ�2*'�ZLWK�WKH�2*�3DFNDJH ������������������������������������������� 'LVSOD\LQJ�DQ�2*'�ZLWK�5XQB3URGXFW�������������������������������������������������

,PSURYLQJ�&KDUWV�'LVSOD\HG�LQ�D�)RUPV�&KDUW�,WHP�RQ�WKH�:HE�������������� 0DNLQJ�&KDUW�7H[W�+RUL]RQWDO �������������������������������������������������������������������� $GGLQJ�D�6XUURXQGLQJ�5HFWDQJOH�WR�WKH�2*'����������������������������������������� 5HSODFLQJ�WKH�$[HV�/DEHOV�DQG�&KDUW�7LWOH������������������������������������������������

5HSODFLQJ�WKH�$[HV�/DEHOV�DQG�&KDUW�7LWOH�ZLWK�*UDSKLFV�7H[W�������� 6LPXODWLQJ�WKH�$[HV�/DEHOV�DQG�&KDUW�7LWOH�RQ�WKH�)RUPV�&DQYDV���

0LVVLQJ�/HJHQGV �������������������������������������������������������������������������������������������� 5HWDLQLQJ�WKH�'HVLJQ�7LPH�&KDUW�/HJHQG �������������������������������������������� 6LPXODWLQJ�WKH�&KDUW�/HJHQG�LQ�)RUPV��������������������������������������������������

5HVHWWLQJ�%DU��/LQH��RU�)LOO�&RORU ���������������������������������������������������������������� 6HW�WKH�&RORUV�LQ�WKH�/D\RXW�(GLWRU ������������������������������������������������������� 6HW�WKH�&RORUV�3URJUDPPDWLFDOO\�LQ�2UDFOH�*UDSKLFV�������������������������� 6HW�WKH�&RORUV�LQ�D�)RUP�ZLWK�D�6LPXODWHG�/HJHQG �����������������������������

)RQWV�DQG�)RUPDW�7ULJJHUV �������������������������������������������������������������������������� 6XPPDU\�������������������������������������������������������������������������������������������������������������� $SSHQGL[ �������������������������������������������������������������������������������������������������������������

&RGH�IURP�$GG/HJHQG�RJG ������������������������������������������������������������������������� 3URFHGXUH�2SHQ7ULJJHU�IURP�DGGOHJHQG�RJG�������������������������������������������

&RGH�IURP�$GG/HJHQG�IPE ������������������������������������������������������������������������ 3URFHGXUH�&UHDWH&KDUW$QG/HJHQG�IURP�DGGOHJHQG�IPE �����������������������

&RGH�IURP�6HW&RORUV�RJG����������������������������������������������������������������������������� 3URFHGXUH�2SHQ7ULJJHU�IURP�VHWFRORUV�RJG��������������������������������������������� 3URFHGXUH�6HW'DWD*URXS&RORU�IURP�VHWFRORUV�RJG �������������������������������� 3URFHGXUH�*HW/HJHQG&RORUV�IURP�VHWFRORUV�RJG �������������������������������������

)XUWKHU�5HDGLQJ�DQG�5HIHUHQFHV ��������������������������������������������������������������������� �

Page 3: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�2

'HSOR\LQJ�2UDFOH�*UDSKLFV�LQ�2UDFOH�L$6�)RUPV�6HUYLFHV��(;(&87,9(�29(59,(:�

2UDFOH�*UDSKLFV�LV�D�WRRO�XVHG�SULPDULO\�WR�FKDUW�GDWD�IURP�DQ�2UDFOH�GDWDEDVH��7KHVH�FKDUWV�DUH�RIWHQ�GLVSOD\HG�IURP�ZLWKLQ�2UDFOH�IRUPV��7KLV�ZKLWH�SDSHU�FRQWDLQV�D�QXPEHU�RI�UHFRPPHQGDWLRQV�WR�VPRRWK�WKH�PLJUDWLRQ�RI�VXFK�IRUPV�ZLWK�HPEHGGHG�2UDFOH�*UDSKLFV�GLVSOD\V�IURP�D�FOLHQW�VHUYHU�HQYLURQPHQW�WR�WKH�:HE��0DQ\�GHYHORSHUV�DUH�QRZ�FRQVLGHULQJ�WKLV�PLJUDWLRQ��SDUWLFXODUO\�EHFDXVH�WKH�:HE�LV�WKH�RQO\�PHDQV�RI�GHSOR\PHQW�ZLWKLQ�)RUPV�6HUYLFHV�LQ�5HOHDVH���RI�2UDFOH�L$6�²�KHQFHIRUWK�UHIHUUHG�WR�DV�2UDFOH�L$6�9���7KH�SURGXFW�LQIRUPDWLRQ�LQ�WKLV�SDSHU�UHIHUV�RQO\�WR�WKLV�UHOHDVH��2UDFOH�L$6�9���WKRXJK�WKH�VDPSOH�FRGH�FDQ�DOVR�EH�XVHG�ZLWK�)RUPV��L��

,1752'8&7,21�

2UDFOH�*UDSKLFV��L��WKH�)LQDO�5HOHDVH�RI�2UDFOH�*UDSKLFV�

7KH�ILQDO�UHOHDVH�RI�2UDFOH�*UDSKLFV�LV�LQ�2UDFOH�'HYHORSHU��L��$OWKRXJK�WKHUH�LV�QR�UHOHDVH��L�RI�*UDSKLFV�LQ�2UDFOH�L�'HYHORSHU�6XLWH��2UDFOH�L'6��9��RU�LQ�2UDFOH�L�$SSOLFDWLRQ�6HUYHU��2UDFOH�L$6��9���2UDFOH�L$6�)RUPV�DQG�5HSRUWV�FDQ�VWLOO�GLVSOD\�HPEHGGHG�2UDFOH�*UDSKLFV�'LVSOD\V��2*'V��E\�FDOOLQJ�WKH��L�2UDFOH�*UDSKLFV�H[HFXWDEOHV�LQVWDOOHG�LQ�WKHLU�RZQ�HQWLUHO\�VHSDUDWH��L�2UDFOH�KRPH��7KLV�GHSOR\PHQW�LV�:HE�RQO\��DV�LW�LV�RQO\�RQ�WKH�:HE�WKDW�2UDFOH�L$6�DQG�2UDFOH�L'6�)RUPV�DQG�5HSRUWV�FDQ�EH�UXQ��WKHUH�LV�QR�ORQJHU�D�FOLHQW�VLGH�UXQWLPH�HQJLQH�WR�UXQ�)RUPV�DQG�5HSRUWV�DSSOLFDWLRQV�LQ�FOLHQW�VHUYHU�PRGH��0DQ\�DSSOLFDWLRQV�GHYHORSHG�ZLWK�HDUOLHU�YHUVLRQV�RI�2UDFOH�)RUPV�DQG�2UDFOH�5HSRUWV�DUH�QRZ�EHLQJ�PLJUDWHG�IURP�FOLHQW�VHUYHU�WR�:HE�GHSOR\PHQW��LQFOXGLQJ�VRPH�ZLWK�HPEHGGHG�2*'V��,Q�PDQ\�FDVHV�WKH�PLJUDWLRQ�ZLOO�EH�FRPELQHG�ZLWK�XSJUDGLQJ�WR�2UDFOH�L$6�9���+HQFH�WKLV�ZKLWH�SDSHU�DGGUHVVHV�ERWK�WKH�VXEMHFW�RI�PLJUDWLRQ�WR�WKH�:HE�RI�IRUPV�ZLWK�HPEHGGHG�2*'V�DQG�WKH�UHODWHG�VXEMHFW�RI�FDOOLQJ�2UDFOH�*UDSKLFV��L�H[HFXWDEOHV�IURP�2UDFOH�L$6�9���

0LJUDWLQJ�&KDUWV�WR�WKH�:HE�

6LQFH�2UDFOH�*UDSKLFV�ZDV�QRW�RULJLQDOO\�FRQFHLYHG�IRU�:HE�GHSOR\PHQW��LVVXHV�PD\�DULVH�ZKHQ�IRUPV�ZLWK�HPEHGGHG�FKDUWV�DUH�UH�GHSOR\HG�IURP�D�FOLHQW�VHUYHU�HQYLURQPHQW�WR�WKH�:HE��SDUWLFXODUO\�PRUH�FRPSOH[�FKDUWV�ZLWK�PRUH�FRPSOH[�FKDUDFWHU�VHWV��,Q�VRPH�FDVHV��WH[W�GLPHQVLRQV�PD\�DOWHU��FDXVLQJ�WH[W�LWHPV�WR�RYHUODS�RU�WR�H[WHQG�RYHU�WKH�HGJH�RI�D�GLVSOD\��7KHVH�LVVXHV��SDUWLFXODUO\�FRQFHUQLQJ�VFDOLQJ��DUH�DNLQ�WR�WKH�VLGH�HIIHFWV�WKDW�FDQ�RFFXU�ZKHQ�SRUWLQJ�DSSOLFDWLRQV�IURP�RQH�SODWIRUP�WR�DQRWKHU��7KLV�ZKLWH�SDSHU�RIIHUV�D�QXPEHU�RI�´EHVW�SUDFWLFHµ�UHFRPPHQGDWLRQV�WR�FRXQWHU�LVVXHV�VXFK�DV�WKHVH�WKDW�FDQ�DULVH�ZKHQ�PLJUDWLQJ�WR�)RUPV�6HUYLFHV�:HE�GHSOR\PHQW���

&KDUWLQJ�LQ�1HZ�)RUPV��L�$SSOLFDWLRQV�

)RU�QHZ�)RUPV��L�DSSOLFDWLRQV��D�:HE�VSHFLILF�FKDUWLQJ�WRRO�LV�SUREDEO\�SUHIHUDEOH��D�WRRO�VXFK�DV�WKH�&KDUW�8VHU�,QWHUIDFH�&RPSRQHQW�LQ�2UDFOH�L'6�-'HYHORSHU��IRU�LQVWDQFH��ZKLFK�FDQ�EH�LQWHJUDWHG�DV�D�-DYD%HDQ�LQ�)RUPV��1RWH�WKDW�WKH�DELOLW\�RI�2UDFOH�)RUPV�WR�LQFOXGH�2UDFOH�*UDSKLFV�GLVSOD\V�ZLOO�QRW�EH�VXSSRUWHG�LQGHILQLWHO\��,W�PD\�EH�UHPRYHG�IURP�D�IXWXUH�)RUPV�UHOHDVH��ZLWK�GXH�QRWLFH��)RU�WKLV�UHDVRQ��2UDFOH�UHFRPPHQGV�XVLQJ�2UDFOH�*UDSKLFV�RQ�WKH�:HE�RQO\�LQ�H[LVWLQJ��QRW�QHZ��)RUPV�DSSOLFDWLRQV��

Page 4: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�3

,QWHQGHG�$XGLHQFH�

7KLV�ZKLWH�SDSHU�LV�LQWHQGHG�IRU�H[SHULHQFHG�2UDFOH�)RUPV�GHYHORSHUV�ZKR�DOVR�KDYH��RU�DUH�SUHSDUHG�WR�JDLQ��VRPH�IDPLOLDULW\�ZLWK�2UDFOH�*UDSKLFV�DQG�2UDFOH�5HSRUWV��

6XSSOHPHQWDU\�6DPSOH�0RGXOHV�

7KHUH�DUH�D�QXPEHU�RI�VDPSOH�PRGXOHV�WKDW�VXSSOHPHQW�WKLV�ZKLWH�SDSHU��LOOXVWUDWLQJ�VRPH�RI�LWV�UHFRPPHQGDWLRQV��7KHVH�PRGXOHV�FDQ�EH�GRZQORDGHG�IURP�WKH�2UDFOH�7HFKQRORJ\�1HWZRUN�ZHEVLWH��KWWS���RWQ�RUDFOH�FRP�SURGXFWV�IRUPV�WHFKOLVWLQJ�L�KWPO��IURP�D�OLQN�ORFDWHG�QH[W�WR�WKLV�GRFXPHQW���%RWK��L�DQG��L�YHUVLRQV�RI�WKH�IRUPV�PRGXOHV�DUH�DYDLODEOH��

,17(*5$7,1*�)2506��L�:,7+�25$&/(�*5$3+,&6��L�

&DOOLQJ�WKH�2UDFOH�*UDSKLFV��L�([HFXWDEOHV�

)RU�)RUPV��L�6HUYLFHV�WR�GLVSOD\�2*'V��LW�QHHGV�WR�FDOO�WKH�2UDFOH�*UDSKLFV��L�H[HFXWDEOHV��2UDFOH�*UDSKLFV��L�PXVW�EH�LQVWDOOHG�DV�SDUW�RI�DQ�2UDFOH�'HYHORSHU��L�LQVWDOODWLRQ�RQ�WKH�VDPH�PDFKLQH��EXW�LQ�D�FRPSOHWHO\�VHSDUDWH�2UDFOH�KRPH�IURP�WKH�2UDFOH�L�'HYHORSHU�6XLWH�RU�$SSOLFDWLRQ�6HUYHU��)RUPV��L�LV�PDGH�DZDUH�RI�WKH�2UDFOH�*UDSKLFV��L�E\�DQ�HQYLURQPHQW�YDULDEOH��25$&/(B*5$3+,&6�,B+20(��ZKLFK�PXVW�EH�SUHVHQW�LQ�WKH�HQYLURQPHQW�LQ�ZKLFK�WKH�)RUPV��L�6HUYLFHV�DUH�VWDUWHG��25$&/(B*5$3+,&6�,B+20(�VKRXOG�EH�VHW�WR�WKH�GLUHFWRU\�ORFDWLRQ�RI�WKH�2UDFOH�KRPH�RI�WKH�'HYHORSHU��L�LQVWDOODWLRQ���

2Q�:LQGRZV��D�GHGLFDWHG�*UDSKLFV��L�EDWFK�HQJLQH�VWDUWV�XS�RQ�WKH�PLGGOH�WLHU�IRU�HDFK�)RUPV��L�VHVVLRQ�WKDW�LQYRNHV�DQ�2*'��%\�GHIDXOW��WKLV�SURFHVV�LV�WHUPLQDWHG�DIWHU�ILYH�PLQXWHV�RI�LQDFWLYLW\��<RX�FDQ�RYHUULGH�WKLV�GHIDXOW��KRZHYHU��E\�VHWWLQJ�WKH�UHJLVWU\�YDULDEOH�11B7,0(287�LQ�WKH�2UDFOH�'HYHORSHU��L�2UDFOH�KRPH�WR�D�GLIIHUHQW�QXPEHU�RI�PLQXWHV��2Q�8QL[��D�VKHOO�VFULSW�QDPHG�J��UXQP�VK�LV�FDOOHG�ZKHQ�DQ�2*'�LV�ILUVW�UHIHUHQFHG�LQ�D�)RUPV��L�VHVVLRQ��,W�XVHV�25$&/(B*5$3+,&6�,B+20(�WR�VHW�WKH�NH\�HQYLURQPHQW�YDULDEOHV�RI�WKH�'HYHORSHU��L�2UDFOH�KRPH�DQG�WKHQ�FDOOV�WKH�J��UXQP�H[HFXWDEOH�LQ�WKDW�2UDFOH�KRPH��J��UXQP�H[LWV�ZKHQ�WKH�)RUPV�VHVVLRQ�WHUPLQDWHV��

2Q�:LQGRZV��LQ�WKH�HQYLURQPHQW�LQ�ZKLFK�WKH�)RUPV��L�6HUYLFHV�DUH�VWDUWHG��\RX�PXVW�VHW�3$7+�WR�LQFOXGH�WKH��25$&/(B*5$3+,&6�,B+20(�?ELQ�DQG�WKLV�ORFDWLRQ�PXVW�EH�SODFHG�DIWHU�WKH�ELQ�GLUHFWRU\�IRU�WKH�)RUPV��L�H[HFXWDEOHV��7KLV�LV�QRW�DQ�LVVXH�RQ�8QL[��ZKHUH�WKH�J��UXQP�VK�VFULSW�VHWV�XS�WKH�HQYLURQPHQW�IRU�FDOOLQJ�2UDFOH�*UDSKLFV��

2Q�ERWK�:LQGRZV�DQG�8QL[��WKH�*UDSKLFV�H[HFXWDEOH�ZLOO�VHDUFK�*5$3+,&6��B3$7+�IRU�2*'V��MXVW�DV�LW�GLG�ZLWK�)RUPV�DQG�5HSRUWV��L��6HW�*5$3+,&6��B3$7+�LQ�WKH�'HYHORSHU��L�2UDFOH�KRPH��

8SJUDGLQJ�2*�3//�

7KH�OLEUDU\�2*�3//�LV�UHTXLUHG�WR�LQYRNH�2UDFOH�*UDSKLFV�XVLQJ�WKH�2*�SDFNDJH��7KLV�PRGXOH�FRPHV�ZLWK�WKH�)RUPV��L�GHPRV��EXW�LW�VKRXOG�EH�UHFRPSLOHG�DQG�VDYHG�LQ�)RUPV��L�'HYHORSHU��$��L�YHUVLRQ�LV�LQFOXGHG�ZLWK�WKH�VXSSOHPHQWDU\�VDPSOH�PRGXOHV��/LNH�DQ\�RWKHU�)RUPV��L�3//��WKLV�2*�3//�ZLOO�QHHG�WR�EH�LQ�WKH�)2506��B3$7+��

8SJUDGLQJ�WR�2UDFOH�'HYHORSHU��L�3DWFK���

)RU�)RUPV��L�*UDSKLFV��L�WR�IXQFWLRQ�FRUUHFWO\��LW�LV�HVVHQWLDO�WKDW�WKH�2UDFOH�*UDSKLFV��L�2UDFOH�KRPH�EH�SDWFKHG�WR�DW�OHDVW�SDWFK�VHW���RI�2UDFOH�'HYHORSHU��L��:LWK�HDUOLHU�SDWFK�VHWV�\RX�DUH�OLNHO\�WR�HQFRXQWHU�

Page 5: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�4

SUREOHPV�ZLWK�IRQWV�DQG�RU�WKH�GLVDSSHDUDQFH�RI�WLFN�ODEHOV��

&$//,1*�25$&/(�*5$3+,&6�',63/$<6�)520�25$&/(�)2506�

2UDFOH�)RUPV�FDQ�SUHVHQW�2UDFOH�*UDSKLFV�GLVSOD\V�LQ�RQH�RI�WKUHH�FRQWDLQHU�REMHFWV��

• $�UHSRUW�FDOOHG�E\�D�IRUP�

• $�)RUPV�LPDJH�LWHP�

• $�)RUPV�FKDUW�LWHP�

,Q�WKH�FOLHQW�VHUYHU�HQYLURQPHQW��GLVSOD\�ZLWKLQ�D�FKDUW�LWHP�LV�E\�IDU�WKH�PRVW�FRPPRQ�RSWLRQ��+HUH��WKH�2*�SDFNDJH�DOORZV�FKDUWV�WR�EH�VFDOHG��UHIUHVKHG�DQG�PDGH�LQWHUDFWLYH��,Q�WKH�:HE�HQYLURQPHQW��KRZHYHU��WKH�WZR�RWKHU�GLVSOD\�PHWKRGV�KDYH�PRUH�WR�RIIHU��:KHQ�PLJUDWLQJ�WR�WKH�:HE��VHULRXV�FRQVLGHUDWLRQ�VKRXOG�EH�JLYHQ�WR�VZLWFKLQJ�DZD\�IURP�)RUPV�FKDUW�LWHPV��,Q�PDQ\�FDVHV��GLVSOD\�YLD�5HSRUW�6HUYLFHV�PD\�EH�SUHIHUDEOH��

'LVSOD\LQJ�2*'V�YLD�5HSRUWV�6HUYLFHV�

6LQFH�2*'V�FDQ�EH�HPEHGGHG�LQ�ERWK�2UDFOH�)RUPV�DQG�2UDFOH�5HSRUWV��DQG�2UDFOH�)RUPV�FDQ�FDOO�2UDFOH�5HSRUWV��LW�LV�SHUIHFWO\�SRVVLEOH�IRU�D�IRUP�WR�GLVSOD\�D�FKDUW�LQGLUHFWO\�YLD�D�UHSRUW�LQ�ZKLFK�WKH�FKDUW�LV�HPEHGGHG��,Q�WKH�FOLHQW�VHUYHU�HQYLURQPHQW��FKDUWV�GLVSOD\HG�LQ�WKLV�ZD\�VXIIHU�IURP�WZR�UHVWULFWLRQV��WKH\�PXVW�DSSHDU�LQ�D�VHSDUDWH�ZLQGRZ�IURP�)RUPV�DQG�WKH\�DUH�HQWLUHO\�VWDWLF��2QO\�WKH�ILUVW�RI�WKHVH�UHVWULFWLRQV�UHPDLQV�RQ�WKH�:HE��$�UHSRUW�GHSOR\HG�RYHU�WKH�:HE�FDQ�FRQWDLQ�G\QDPLF��LQWHUDFWLYH�FKDUWV��FOLFNLQJ�RQ�DQ�LQWHUDFWLYH�FKDUW�DUHD�FRPSOHWHO\�UHGUDZV�WKH�ZKROH�UHSRUW��:LWK�2UDFOH�5HSRUWV�RQ�WKH�:HE��D�UHSRUW�DQG�LWV�HPEHGGHG�FKDUW�DUH�UHQGHUHG�RQ�WKH�PLGGOH�WLHU��ZKHUHDV�ZLWK�2UDFOH�)RUPV�RQ�WKH�:HE��D�IRUP�DQG�LWV�HPEHGGHG�FKDUW�DUH�UHQGHUHG�RQ�WKH�JHQHULF�-DYD�FOLHQW��,W�LV�WKLV�UHQGHULQJ�E\�WKH�JHQHULF�-DYD�FOLHQW�WKDW�LV�UHVSRQVLEOH�IRU�PRVW�RI�WKH�LVVXHV�WKDW�FDQ�DULVH�ZKHQ�PRYLQJ�IRUPV�ZLWK�HPEHGGHG�2*'V�WR�WKH�:HE��0XFK�RI�WKH�UHVW�RI�WKLV�SDSHU�H[SODLQV�KRZ�WR�ZRUN�DURXQG�WKHVH�LVVXHV��EXW�PRYLQJ�WKH�2*'�LQWR�D�UHSRUW�GLVSOD\HG�YLD�5HSRUWV�6HUYLFHV�VLPSO\�DYRLGV�WKHP�DOWRJHWKHU���

,I�SODFLQJ�DQ�2*'�LQ�D�VHSDUDWH�ZLQGRZ�LV�QRW�D�SUREOHP��WKHQ�GLVSOD\LQJ�LW�LQGLUHFWO\�YLD�5HSRUWV�6HUYLFHV�LV�SUREDEO\�WKH�EHVW�RSWLRQ��%H�DZDUH�WKDW�RQ�WKH�:HE�UHFRUG�JURXSV�FDQQRW�EH�SDVVHG�IURP�D�IRUP�WR�D�UHSRUW��DV�WKH\�FDQ�LQ�WKH�FOLHQW�VHUYHU�HQYLURQPHQW��WKH�UHSRUW�PXVW�TXHU\�WKH�GDWDEDVH�GLUHFWO\��7R�JDLQ�SHUIRUPDQFH��WKH�5HSRUWV�6HUYLFHV�SDUDPHWHU�7ROHUDQFH�FDQ�EH�XVHG�WR�VKDUH�UHSRUW�RXWSXW�DPRQJ�XVHUV�ZLWKLQ�D�SUHGHILQHG�WLPH�IUDPH�DV�ORQJ�DV�D�UHSRUW·V�TXHU\�SDUDPHWHUV�UHPDLQ�WKH�VDPH��7KH�7ROHUDQFH�SDUDPHWHU��ZKLFK�WDNHV�LWV�YDOXH�LQ�VHFRQGV��LV�XVHG�E\�5HSRUWV�6HUYLFHV�WR�GHWHUPLQH�ZKHWKHU�D�UHSRUW�QHHGV�WR�EH�UHJHQHUDWHG�RU�ZKHWKHU�DQ�H[LVWLQJ�FRS\�FDQ�EH�XVHG��

)RU�PRUH�LQIRUPDWLRQ�RQ�FDOOLQJ�5HSRUWV�IURP�)RUPV�RQ�WKH�:HE��VHH�WKH�ZKLWH�SDSHU�,QWHJUDWLQJ�2UDFOH�L$6�5HSRUWV�LQ�2UDFOH�L$6�)RUPV��)RU�PRUH�LQIRUPDWLRQ�RQ�HPEHGGLQJ�FKDUWV�LQ�UHSRUWV�GHSOR\HG�RYHU�WKH�:HE��VHH�WKH�ZKLWH�SDSHU�'HSOR\LQJ�,QWHUDFWLYH�&KDUWV�RQ�WKH�:HE��0LJUDWLQJ�IURP�WKH�*UDSKLFV�&DUWULGJH��7KH�LQIRUPDWLRQ�LQ�WKLV�ODWWHU�SDSHU�LV�VXSSOHPHQWHG�KHUH�E\�JXLGHOLQHV�RQ�KRZ�WR�PRYH�D�FKDUW�FUHDWHG�XVLQJ�WKH�)RUPV�FKDUW�ZL]DUG�LQWR�D�UHSRUW��VHH�SDJH�����

Page 6: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�5

'LVSOD\LQJ�2*'V�LQ�D�)RUPV�,PDJH�,WHP�

,I�LW�LV�HVVHQWLDO�WKDW�WKH�2*'�DSSHDU�ZLWKLQ�D�)RUPV�ZLQGRZ�DQG�LI�QR�LQWHUDFWLYLW\�LV�UHTXLUHG��\RX�VKRXOG�FRQVLGHU�WKH�VHFRQG�GLVSOD\�PHWKRG��YLD�D�)RUPV�LPDJH�LWHP��QR�LQWHUDFWLYLW\�LV�SRVVLEOH�EHFDXVH�)RUPV�LPDJH�LWHPV�DUH�HQWLUHO\�VWDWLF���

8VLQJ�D�)RUPV�LPDJH�LWHP�FDQ�JLYH�\RX�EHWWHU�FRQWURO�RYHU�VFDOH�DQG�IRQWV�WKDQ�D�)RUPV�FKDUW�LWHP��,W�DOVR�SUHYHQWV�LVVXHV�WKDW�PD\�DULVH�ZLWK�2UDFOH�*UDSKLFV�LPDJH�LWHPV�GLVSOD\HG�YLD�)RUPV�FKDUW�LWHPV�RQ�WKH�:HE��7KHVH�FRQFHUQ�LPDJHV�HPEHGGHG�LQ�WKH�2*'�LWVHOI��QRW�LPDJHV�UHDG�LQWR�D�)RUPV�LPDJH�LWHP��EXW�LPDJHV�GLVSOD\HG�LQ�DQ�2UDFOH�*UDSKLFV�LPDJH�LWHP��SRSXODWHG�LQ�2UDFOH�*UDSKLFV�E\�WKH�EXLOW�LQ�2JB,PSRUWB,PDJH��WKH�*UDSKLFV�HTXLYDOHQW�RI�WKH�)RUPV�EXLOW�LQ�5HDGB,PDJHB)LOH���2UDFOH�*UDSKLFV�LPDJH�LWHPV�GR�QRW�DOZD\V�DSSHDU�ZKHQ�WKH�2*'�LV�GLVSOD\HG�RYHU�WKH�:HE�LQ�D�)RUPV�FKDUW�LWHP���

'LVSOD\LQJ�DQ�2*'�LQ�D�)RUPV�LPDJH�LWHP�PDNHV�XVH�RI�WKH�2UDFOH�*UDSKLFV�UXQWLPH�SDUDPHWHU�([SRUWLPDJH�DQG�WKH�)RUPV�EXLOW�LQ�5HDGB,PDJHB)LOH��:KHQ�WKH�FKDUW�LV�WR�EH�GLVSOD\HG��LVVXH�D�+267�FRPPDQG�WKDW�H[SRUWV�DQ�LPDJH�RI�WKH�GLVSOD\��DQG�WKHQ�UHDG�WKLV�LPDJH�LQWR�D�)RUPV�LPDJH�LWHP��7KH�IROORZLQJ�SURJUDP�XQLW�LOOXVWUDWHV�WKLV�WHFKQLTXH��

DECLARE

vConnectString VARCHAR2(50);

vImageFilename VARCHAR2(40);

vOGFilename VARCHAR2(40):= ’emp.ogd’;

BEGIN

vConnectString := GET_APPLICATION_PROPERTY(USERNAME)|| ’/’ ||

GET_APPLICATION_PROPERTY(PASSWORD)|| ’@’ ||

GET_APPLICATION_PROPERTY(CONNECT_STRING);

vImageFilename :=

GET_APPLICATION_PROPERTY(USERNAME)||’OGImageFile.gif’;

HOST(’gorun60 openfile=’||vOGFilename||

’ userid=’||vConnectString ||

’ exportimage=’||vImageFilename||’ quit=yes’);

READ_IMAGE_FILE(vImageFilename, ’GIF’,’Block3.Image4’);

HOST(’del ’||vImageFilename);

END;

%HVLGHV�WKH�UHVWULFWLRQ�RQ�LQWHUDFWLYLW\��WKHUH�DUH�D�QXPEHU�RI�RWKHUV�OLPLWDWLRQV�WR�GLVSOD\LQJ�2*'V�LQ�)RUPV�LPDJH�LWHPV��

���� ,W�LV�QRW�SRVVLEOH�WR�SDVV�GDWD�SDUDPHWHUV�GLUHFWO\�WR�WKH�2*'��

���� (DFK�WLPH�WKH�FKDUW�LV�LQYRNHG��WKH�*UDSKLFV�VRIWZDUH�KDV�WR�EH�ORDGHG��7KH�SHUIRUPDQFH�RYHUKHDG�LV�FRPSDUDEOH�WR�UHVWDUWLQJ�WKH�*UDSKLFV�EDWFK�HQJLQH�HDFK�WLPH�D�FDOO�LV�PDGH�WR�WKH�2*�SDFNDJH��

���� ,W�ZLOO�EH�QHFHVVDU\�WR�PDQDJH�WKH�2*�LPDJH�ILOHV�VR�WKDW�ILOH�QDPHV�DUH�XQLTXH��86(51$0(�LV�XVHG�LQ�WKH�DERYH�H[DPSOH���

,I�WKH�+267�FRPPDQG�LV�LVVXHG�IURP�2UDFOH�L�)RUPV�6HUYLFHV��WKH�2UDFOH�*UDSKLFV�H[HFXWDEOH�ZLOO�QHHG�WR�EH�FDOOHG�LQ�WKH��L�HQYLURQPHQW��,W�PD\�EH�EHVW�WR�GR�WKLV�LQ�D�VKHOO�VFULSW�RU�EDWFK�ILOH��&DOO�WKH�ILOH�XVLQJ�

Page 7: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�6

WKH�+267�FRPPDQG��,Q�WKH�ILOH��VHW�WKH��L�HQYLURQPHQW�DQG�LVVXH�WKH�FRPPDQG�WR�JHQHUDWH�WKH�FKDUW�LPDJH��2Q�8QL[��\RX�PD\�ZDQW�WR�EDVH�VXFK�D�VKHOO�VFULSW�RQ�J��UXQP�VK��WKH�VKHOO�VFULSW�WKDW�2UDFOH�L�)RUPV�6HUYLFHV�XVHV�WR�FDOO�J��UXQP��

6RPHWLPHV�LW�LV�SRVVLEOH�WR�DQWLFLSDWH�DKHDG�RI�WLPH�H[DFWO\�ZKLFK�FKDUW�DQG�GDWD�ZLOO�EH�UHTXLUHG��DV��IRU�LQVWDQFH��ZLWK�D�FKDUW�WKDW�VXPPDUL]HV�DQ�RYHUQLJKW�EDWFK�SURFHVV�DQG�LV�FKHFNHG�HDFK�PRUQLQJ��6XFK�FKDUW�LPDJHV�FDQ�EH�FUHDWHG�LQ�DGYDQFH��VR�WKDW�JHQHUDWLQJ�WKH�LPDJH�WKHQ�EHFRPHV�WKH�ILQDO�VWHS�LQ�WKH�EDWFK�SURFHVV�DQG��DV�WKH�FKDUW�QRZ�H[LVWV�EHIRUH�WKH�DSSOLFDWLRQ�WR�GLVSOD\�LW�LV�UXQ��SHUIRUPDQFH�LV�HQKDQFHG��

'LVSOD\LQJ�2*'V�LQ�D�)RUPV�&KDUW�,WHP�

7KH�WKLUG�PHWKRG�IRU�GLVSOD\LQJ�DQ�2*'��GLVSOD\LQJ�LW�LQ�D�)RUPV�FKDUW�LWHP��LV�WKH�PRVW�FRPPRQ�PHWKRG�XVHG�LQ�WKH�FOLHQW�VHUYHU�HQYLURQPHQW��2Q�WKH�:HE��WKH�SURFHVV�RI�UHQGHULQJ�E\�WKH�JHQHULF�-DYD�FOLHQW�PD\�FDXVH�LPSHUIHFWLRQV�LQ�WKH�FKDUW��/DWHU�VHFWLRQV�LQ�WKLV�SDSHU�ZLOO�H[SODLQ�KRZ�WKHVH�FDQ�EH�FRUUHFWHG��

7KHUH�DUH�WKUHH�ZD\V�LQ�ZKLFK�DQ�2*'�FDQ�SRSXODWH�D�)RUPV�FKDUW�LWHP��

• :LWK�WKH�&KDUW�:L]DUG�

• :LWK�WKH�2*�SDFNDJH�

• :LWK�WKH�5XQB3URGXFW�FRPPDQG�

&KDUW�:L]DUG�2*'V�ZLOO�KDYH�EHHQ�FUHDWHG�XVLQJ�WKH�)RUPV�'HYHORSHU�&KDUW�:L]DUG��2*'V�GLVSOD\HG�XVLQJ�WKH�2*�SDFNDJH�RU�5XQB3URGXFW�ZLOO�KDYH�EHHQ�FUHDWHG�LQ�2UDFOH�*UDSKLFV�%XLOGHU��

&KDUWV�FUHDWHG�ZLWK�WKH�&KDUW�:L]DUG�

7KH�&KDUW�:L]DUG�LQ�2UDFOH�)RUPV��L�'HYHORSHU�DQG�2UDFOH�5HSRUWV��L�'HYHORSHU�LV�D�TXLFN�ZD\�RI�FUHDWLQJ�D�VLPSOH�FKDUW�EDVHG�RQ�WKH�GDWD�LQ�D�)RUPV�EORFN�RU�5HSRUWV�TXHU\��-XVW�DV�WKHUH�LV�QR��L�YHUVLRQ�RI�2UDFOH�*UDSKLFV��WKHUH�LV�QR�&KDUW�:L]DUG�LQ�)RUPV��L�'HYHORSHU�RU�5HSRUWV��L�'HYHORSHU��2UDFOH�)RUPV��L�DQG�2UDFOH�5HSRUWV��L�DUH�WKH�ODVW�UHOHDVH�LQ�ZKLFK�LW�ZDV�LQFOXGHG���

7KH�GHILQLWLRQ�RI�D�ZL]DUG�JHQHUDWHG�FKDUW�LV�VDYHG�LQ�DQ�2*'�ILOH��ZKLFK�LV�VHSDUDWH�IURP�DQ\�)0%�RU�5')�ILOH��EXW�FDQQRW�EH�UXQ�PHDQLQJIXOO\�DV�DQ�LQGHSHQGHQW�2UDFOH�*UDSKLFV�PRGXOH��VLQFH�LW�UHOLHV�RQ�)RUPV�RU�5HSRUWV�WR�VXSSO\�LWV�GDWD��7KLV�ZL]DUG�JHQHUDWHG�2*'�FDQ�EH�HGLWHG�LQ�2UDFOH�*UDSKLFV�%XLOGHU��(GLWLQJ�WKH�2*'�LQ�*UDSKLFV�%XLOGHU�LV�RIWHQ�GHVLUDEOH�EHFDXVH�LW�DOORZV�PRGLILFDWLRQ�RI�PDQ\�RI�WKH�FKDUW�IHDWXUHV��IRQWV��D[HV�ODEHOV��OHJHQGV��DQG�WKH�OLNH��WKDW�FDQQRW�EH�PRGLILHG�WKURXJK�WKH�ZL]DUG��:KHWKHU�D�ZL]DUG�JHQHUDWHG�FKDUW�LV�WR�EH�GLVSOD\HG�LQ�D�FOLHQW�VHUYHU�HQYLURQPHQW�RU�RYHU�WKH�:HE��LWV�DSSHDUDQFH�FDQ�RIWHQ�EH�JUHDWO\�LPSURYHG�LQ�*UDSKLFV�%XLOGHU���

,Q�WKH�FKDUWLQJ�ZRUOG��LPSURYHPHQW�RIWHQ�HTXDWHV�WR�VLPSOLILFDWLRQ��UHPRYLQJ�XQQHFHVVDU\�LWHPV�WKDW�LQ�QR�ZD\�FRQWULEXWH�WR�DQ�XQGHUVWDQGLQJ�RI�WKH�GDWD�UHSUHVHQWHG�E\�WKH�FKDUW��6XFK�LWHPV�DUH�YHU\�OLNHO\�LQ�WKH�UHODWLYHO\�VLPSOH�FKDUWV�JHQHUDWHG�ZLWK�WKH�&KDUW�:L]DUG��LQ�ZKLFK�LW�LV�RIWHQ�REYLRXV�ZKDW�LV�EHLQJ�FKDUWHG�DQG�ZKDW�HDFK�D[LV�UHSUHVHQWV��,Q�*UDSKLFV�%XLOGHU��WKH�OHJHQG�DQG�HYHQ�D[HV�ODEHOV�FDQ�EH�UHPRYHG�IURP�D�ZL]DUG�JHQHUDWHG�2*'���

Page 8: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�7

1HZ�FKDUWV�DUH�FUHDWHG�LQ�*UDSKLFV�%XLOGHU�DURXQG�D�PHDQLQJIXO�VDPSOH�GDWD�VHW��7KLV�LV�QRW�WKH�FDVH�LQ�)RUPV�RU�5HSRUWV�'HYHORSHU�ZLWK�FKDUWV�FUHDWHG�XVLQJ�WKH�ZL]DUG��DQG�LQ�VXFK�FKDUWV�ZKHQ�JHQXLQH�GDWD�LV�GLVSOD\HG�DW�UXQWLPH��D[HV�DQG�WLFN�ODEHOV�PD\�RYHUODS��,W�LV�RIWHQ�QHFHVVDU\�WR�XVH�*UDSKLFV�%XLOGHU�WR�FRUUHFW�WKHVH�RYHUODSV�E\�UHPRYLQJ�RU�UHVFDOLQJ�LWHPV��6XFK�FRUUHFWLRQV��ZKLFK�ZHUH�RIWHQ�QHFHVVDU\�WR�PDNH�D�ZL]DUG�JHQHUDWHG�FKDUW�DFFHSWDEOH�LQ�D�FOLHQW�VHUYHU�HQYLURQPHQW��PD\�KDYH�WR�EH�UHGRQH�ZKHQ�PLJUDWLQJ�FKDUWV�WR�:HE�GHSOR\PHQW��7H[W�RYHUODSV�PD\�UHDSSHDU��,W�PD\�EH�WLPH�WR�UHFRQVLGHU�ZKHWKHU�WKH�FKDUW�FRXOG�EH�IXUWKHU�VLPSOLILHG��,W�PD\�HYHQ�EH�WLPH�WR�FRQVLGHU�ZKHWKHU�LW�ZRXOG�EH�EHWWHU�WR�XVH�D�QHZ�2*'�FUHDWHG�ZLWKLQ�2UDFOH�*UDSKLFV�%XLOGHU��ZKHUH�WKH�GHYHORSHU�KDV�ILQHU�FRQWURO�RYHU�WKH�FKDUW�IURP�LWV�LQFHSWLRQ���

'LVSOD\LQJ�LQ�5HSRUWV�DQ�2*'�FUHDWHG�ZLWK�WKH�)RUPV�&KDUW�:L]DUG�

$QRWKHU�RSWLRQ�ZKHQ�PRYLQJ�WR�WKH�:HE�LV�WR�NHHS�WKH�ZL]DUG�JHQHUDWHG�2*'�EXW�GLVSOD\�LW�YLD�5HSRUWV�6HUYLFHV�DV�IROORZV��

��� ,Q�5HSRUWV��L�'HYHORSHU��FUHDWH�D�UHSRUW�XVLQJ�WKH�5HSRUW�:L]DUG�ZLWK�GDWD�FROXPQV�RI�WKH�VDPH�QDPHV�DV�WKRVH�SDVVHG�WR�WKH�FKDUW�E\�WKH�IRUP��DQG�D�TXHU\�WKDW�ZLOO�UHWULHYH�WKH�VDPH�GDWD��6HW�WKH�ILHOG�ODEHOV�WR�EODQN�DQG�WKH�WHPSODWH�WR�1R�WHPSODWH��

��� 0RGLI\�WKH�)RUPDW�WULJJHU�RI�WKH�UHSRUW·V�UHSHDWLQJ�JURXS�WR�DOZD\V�UHWXUQ�)$/6(��VR�WKDW�QR�DFWXDO�UHSRUW�GDWD�ZLOO�EH�GLVSOD\HG��

��� ,Q�WKH�UHSRUW·V�OD\RXW�PRGHO��GUDZ�RXW�D�FKDUW�LWHP�DQG�EULQJ�XS�LWV�SURSHUW\�SDOHWWH��

��� 6HW�&KDUW�)LOHQDPH�WR�WKH�FKDUW�JHQHUDWHG�E\�WKH�)RUPV�&KDUW�:L]DUG��

��� 6HOHFW�3DUDPHWHUV�DQG�&ROXPQV�DQG�WKHQ�JR�WR�WKH�&ROXPQ�WDE��VHH�)LJXUH������

��� 6HW�&KDUW�4XHU\�WR�JHQLHBTXHU\��DOO�ORZHUFDVH���

��� 6HW�5HSRUW�*URXS�WR�WKH�UHSRUW·V�UHSHDWLQJ�JURXS��

��� 6FUROO�GRZQ�WR�WKH�ORZHU�KDOI�RI�WKH�&ROXPQV�WDE��KLJKOLJKW�HDFK�UHSRUW�FROXPQ�WKDW�DSSHDUV�LQ�WKH�TXHU\��DQG�HQWHU�WKH�VDPH�QDPH�DORQJVLGH�LW�XQGHU�&KDUW�&ROXPQ��

��� 5XQ�WKH�UHSRUW��,W�VKRXOG�GLVSOD\�QRWKLQJ�EXW�WKH�FKDUW��

���� ,I�\RX�DUH�DFWXDOO\�GHSOR\LQJ�XVLQJ��L$6��XSJUDGH�WKH�UHSRUW�WR��L���

���� 1RZ�FDOO�WKH�UHSRUW�IURP�WKH�IRUP��

Page 9: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�8

(KIWTG����/CRRKPI�TGRQTV�CPF�EJCTV�EQNWOPU�

Page 10: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�9

'LVSOD\LQJ�DQ�2*'�ZLWK�WKH�2*�3DFNDJH�

&KDUWV�FUHDWHG�LQ�2UDFOH�*UDSKLFV�%XLOGHU�DUH�XVXDOO\�GLVSOD\HG�LQ�D�)RUPV�FKDUW�LWHP�E\�VXESURJUDPV�IURP�WKH�2*�SDFNDJH��2*�2SHQ�RSHQV�D�GLVSOD\��2WKHU�2*�SURFHGXUHV�DQG�IXQFWLRQV�FDQ�PDNH�WKH�FKDUWV�LQWHUDFWLYH�DQG�G\QDPLF��PRXVH�FOLFNV�FDQ�EH�SDVVHG�RQ�WR�EXWWRQ�SURFHGXUHV�LQ�WKH�2*'��SDUDPHWHUV�FDQ�EH�SDVVHG�EDFN�DQG�IRUWK�EHWZHHQ�)RUPV�DQG�*UDSKLFV��*UDSKLFV�EXLOW�LQV�DQG�SURJUDP�XQLWV�FDQ�EH�FDOOHG�IURP�)RUPV��

$Q�LPSRUWDQW�SDUDPHWHU�WR�2*�2SHQ�LV�WKH�%RROHDQ�&OLS��ZKLFK�GHWHUPLQHV�ZKHWKHU�WKH�FKDUW�VKRXOG�EH�VFDOHG�WR�ILW�WKH�GLPHQVLRQV�RI�WKH�IRUP·V�FKDUW�LWHP��RU�ZKHWKHU�LW�VKRXOG�EH�GLVSOD\HG�XVLQJ�LWV�GHIDXOW�VL]H�DQG��LI�QHFHVVDU\��FOLSSHG�WR�ILW�WKH�FKDUW�LWHP��(YHQ�IRU�IRUPV�UXQQLQJ�LQ�D�FOLHQW�VHUYHU�HQYLURQPHQW��VHWWLQJ�&OLS�WR�)$/6(��L�H��VFDOLQJ�WKH�FKDUW��GRHV�QRW�DOZD\V�ZRUN��)RQWV�PD\�QRW�VFDOH�DV�QHDWO\�DV�WKH�UHVW�RI�WKH�FKDUW��FDXVLQJ�WH[W�WR�RYHUODS��,Q�VXFK�FLUFXPVWDQFHV�LW�LV�RIWHQ�EHWWHU�WR�UHVL]H�WKH�IRUP·V�FKDUW�LWHP�LQ�)RUPV�'HYHORSHU�DQG�WR�UHVL]H�WKH�FKDUW�LWVHOI�LQ�2UDFOH�*UDSKLFV�%XLOGHU�VR�WKDW�WKHUH�LV�VXIILFLHQW�VSDFH�RQ�WKH�IRUP�WR�GLVSOD\�WKH�ZKROH�FKDUW�HYHQ�ZLWK�&OLS�VHW�WR�LWV�GHIDXOW�RI�758(��$V�D�JHQHUDO�UHFRPPHQGDWLRQ�IRU�FKDUWV�GHSOR\HG�XVLQJ�2*�23(1�RYHU�WKH�:HE��VHW�&OLS�WR�758(�DQG�VFDOH�WKH�IRUP·V�FKDUW�LWHP�DQG�WKH�FKDUW�DSSURSULDWHO\���

'LVSOD\LQJ�DQ�2*'�ZLWK�5XQB3URGXFW�

<RX�FDQ�DOVR�LQYRNH�2*'V�IURP�)RUPV�ZLWK�WKH�5XQB3URGXFW�EXLOW�LQ��ZLWK�WKH�SDUDPHWHU�3URGXFW�VHW�WR�*5$3+,&6��)RU�IRUPV�UXQQLQJ�LQ�D�FOLHQW�VHUYHU�FRQILJXUDWLRQ��WKH�SDUDPHWHU�'LVSOD\�FDQ�EH�VHW�WR�D�FKDUW�LWHP�RQ�WKH�IRUP��ZKLFK�WKHQ�FRQWDLQV�WKH�FKDUW��RU�LW�FDQ�EH�OHIW�EODQN��LQ�ZKLFK�FDVH�WKH�FKDUW�DSSHDUV�LQ�D�VHSDUDWH�2UDFOH�*UDSKLFV�UXQWLPH�ZLQGRZ��)RU�)RUPV�UXQQLQJ�RQ�WKH�:HE��LI�WKH�'LVSOD\�SDUDPHWHU�LV�OHIW�EODQN��QR�FKDUW�ZLOO�DSSHDU��DV�WKHUH�LV�QR�2UDFOH�*UDSKLFV�UXQWLPH�IRU�WKH�:HE��7R�GLUHFW�2*'V�WR�D�VHSDUDWH�ZLQGRZ�IURP�)RUPV�RQ�WKH�:HE��FDOO�WKHP�YLD�5HSRUWV�6HUYLFHV���

&DOOLQJ�*UDSKLFV�XVLQJ�5XQB3URGXFW�ZLWK�'LVSOD\�VHW�WR�D�FKDUW�LWHP�LV�PXFK�WKH�VDPH�DV�FDOOLQJ�*UDSKLFV�XVLQJ�WKH�2*�2SHQ�IXQFWLRQ�ZLWK�LWV�SDUDPHWHU�&OLS�VHW�WR�)$/6(��)RUPV�ZLOO�GR�LWV�EHVW�WR�VFDOH�WKH�FKDUW�LPDJH�VR�WKDW�LW�ILWV�LQWR�WKH�FKDUW�LWHP��EXW�WKLV�GRHV�QRW�DOZD\V�VXFFHHG��SDUWLFXODUO\�RYHU�WKH�:HE��$V�ZLWK�OG.Open(..,Clip=>FALSE,..)��WKH�UHFRPPHQGDWLRQ�IRU�)RUPV�RQ�WKH�:HE�LV�WR�UHSODFH�FDOOV�WR�5XQB3URGXFW�WR�GLVSOD\�2*'V�LQ�D�FKDUW�LWHP�ZLWK�2*�2SHQ�ZLWK�&OLS�VHW�WR�758(��

Page 11: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�10

,03529,1*�&+$576�',63/$<('�,1�$�)2506�&+$57�,7(0�21�7+(�:(%�

$�)RUPV�FKDUW�LWHP�LV�WKH�PRVW�FRPPRQ�PHWKRG�RI�GLVSOD\LQJ�DQ�2*'�LQ�)RUPV�DSSOLFDWLRQV�LQ�WKH�FOLHQW�VHUYHU�HQYLURQPHQW��,Q�PDQ\�FDVHV��LW�ZLOO�VWLOO�EH�WKH�PHWKRG�\RX�SUHIHU�IRU�)RUPV�DSSOLFDWLRQV�RQ�WKH�:HE��7KHUH�DUH�D�QXPEHU�RI�IODZV��KRZHYHU��WKDW�FDQ�DSSHDU�LQ�2*'V�GLVSOD\HG�LQ�FKDUW�LWHPV�ZKHQ�WKH\�DUH�PLJUDWHG�WR�WKH�:HE��7KH�UHPDLQGHU�RI�WKLV�ZKLWH�SDSHU�DGGUHVVHV�WKHVH�LVVXHV�DQG�VXJJHVWV�ZD\V�LQ�ZKLFK�WKH\�FDQ�EH�FRUUHFWHG��

0DNLQJ�&KDUW�7H[W�+RUL]RQWDO�

2QH�PRGLILFDWLRQ�WKDW�\RX�FDQ�PDNH�WR�2*'V�WR�LPSURYH�ERWK�WKHLU�SHUIRUPDQFH�DQG�WKHLU�DSSHDUDQFH�RYHU�WKH�:HE�LQ�D�)RUPV�FKDUW�LWHP�LV�WR�PDNH�DV�PXFK�WH[W�DV�SRVVLEOH�KRUL]RQWDO��0RVW�QRQKRUL]RQWDO�WH[W�LQ�FKDUWV�LV�DOLJQHG�YHUWLFDOO\�XQGHU�WKH�;�D[LV��EHFDXVH�RWKHUZLVH�LWHP�QDPHV�ZRXOG�RYHUODS��EXW�LI�WKH�D[HV�DUH�UHYHUVHG�LW�LV�RIWHQ�SRVVLEOH�WR�KDYH�KRUL]RQWDO�WH[W�RQO\��DV�ODEHOV�DORQJ�WKH�<�D[LV�W\SLFDOO\�DUH��RU�FDQ�EH��PRUH�ZLGHO\�VSDFHG��,Q�SUDFWLFH��WKLV�D[HV�UHYHUVDO�ZLOO�RIWHQ�LQYROYH�QR�PRUH�WKDQ�HGLWLQJ�&KDUW�3URSHUWLHV�DQG�FKDQJLQJ�&KDUW�7\SH�IURP�&ROXPQ��WKH�*UDSKLFV�%XLOGHU�GHIDXOW�ZLWK�YHUWLFDOO\�DVFHQGLQJ�EORFNV�DQG�YHUWLFDOO\�GHVFHQGLQJ�ODEHOV��WR�%DU��ZLWK�KRUL]RQWDOO\�H[WHQGLQJ�EORFNV�DQG�KRUL]RQWDO�WH[W�IRU�ERWK�D[HV��+RZHYHU��\RX�PD\�QHHG�WR�EULQJ�XS�WKH�$[HV�3URSHUWLHV�WDE�DQG�H[SOLFLWO\�VHW�7LFN�/DEHO�5RWDWLRQ�WR�KRUL]RQWDO�RQ�WKH�KRUL]RQWDO�D[LV��,I�WKH�WLFN�ODEHOV�WKHQ�EHFRPH�WRR�FORVHO\�VSDFHG��LQFUHDVH�WKHLU�6WHS�VL]H��)LJXUH���LOOXVWUDWHV�WKLV�WUDQVIRUPDWLRQ�IURP�D�FROXPQ�WR�D�EDU�FKDUW��

(KIWTG����6TCPUHQTOKPI�C�EJCTV�HTQO�%QNWOP�VQ�$CT�

Page 12: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�11

$GGLQJ�D�6XUURXQGLQJ�5HFWDQJOH�WR�WKH�2*'�

,W�VRPHWLPHV�KDSSHQV�WKDW�ZKHQ�D�FKDUW�HPEHGGHG�LQ�D�IRUP�LV�PRYHG�WR�WKH�:HE��LWV�SHULPHWHU�LV�FURSSHG��LQGHHG�VXFK�FURSSLQJ�FDQ�DOVR�RFFXU�ZKHQ�IRUPV�DUH�GHSOR\HG�LQ�D�FOLHQW�VHUYHU�HQYLURQPHQW�LI�WKH�UXQWLPH�GDWD�LV�VXIILFLHQWO\�GLIIHUHQW�IURP�WKH�FKDUW�GDWD�DW�GHVLJQ�WLPH���<RX�FDQ�HDVLO\�FRUUHFW�D�FURSSHG�SHULPHWHU�E\�DGGLQJ�D�EDFNJURXQG�UHFWDQJOH�LQ�*UDSKLFV�%XLOGHU��)LJXUH���LOOXVWUDWHV�WKLV�IDXOW�DQG�LWV�FRUUHFWLRQ�DW�UXQWLPH�RQ�WKH�:HE��

(KIWTG����%QTTGEVKPI�C�ETQRRGF�RGTKOGVGT�YKVJ�C�UWTTQWPFKPI�TGEVCPING�

Page 13: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�12

)LJXUH���VKRZV�WKH�FRUUHFWHG�FKDUW�LQ�*UDSKLFV�%XLOGHU��$�ZKLWH�UHFWDQJOH�ZLWK�D�ZKLWH�ERUGHU�KDV�EHHQ�DGGHG�DURXQG��DQG�EHKLQG��WKH�FKDUW��,W�PD\�DOVR�EH�QHFHVVDU\�WR�UHGXFH�WKH�VL]H�RI�WKH�FKDUW�LQ�*UDSKLFV�%XLOGHU��SDUWLFXODUO\��DV�LQ�WKLV�FDVH��ZKHQ�WKH�FKDUW�KDV�EHHQ�FUHDWHG�LQ�)RUPV�ZLWK�WKH�&KDUW�:L]DUG���)LJXUHV���DQG���ZHUH�FUHDWHG�XVLQJ�WKH�VXSSOHPHQWDU\�VDPSOH�PRGXOHV�SLHVXUURXQG�IPE��SLHQRVXUURXQG�RJG�DQG�SLHVXUURXQG�RJG����

(KIWTG����#FFKPI�C�UWTTQWPFKPI�TGEVCPING�KP�)TCRJKEU�$WKNFGT�

Page 14: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�13

5HSODFLQJ�WKH�$[HV�/DEHOV�DQG�&KDUW�7LWOH�

%\�GHIDXOW�2*'V�DUH�FUHDWHG�ZLWK�WLFN�ODEHOV��LQGLYLGXDO�LWHPV�DORQJ�DQ�D[LV��DQG�D[HV�ODEHOV��WKH�ODEHO�IRU�WKH�HDFK�D[LV�DV�D�ZKROH���8QOHVV�RQH�LV�VSHFLILHG��WKH�FKDUW�WLWOH�UHPDLQV�EODQN��,Q�IRUPV�UXQ�RQ�WKH�:HE��WKHUH�DUH�WLPHV�ZKHQ�WKH�WLFN�ODEHOV�RYHUODS�ZLWK�RWKHU�FKDUW�WH[W��SDUWLFXODUO\�D[HV�ODEHOV��VHH�ILJXUH������

(KIWTG����/KURNCEGF�NCDGNU�

6RPHWLPHV�WKLV�RYHUODS�FDQ�EH�FRUUHFWHG�E\�UHVL]LQJ�WKH�FKDUW�LQ�*UDSKLFV�%XLOGHU��6RPHWLPHV�LW�LV�EHWWHU�LI�WKH�WLWOH�RU�D[HV�ODEHOV�DUH�UHPRYHG��2IWHQ�WKH�LQIRUPDWLRQ�FRQYH\HG�E\�WKH�D[HV�ODEHOV�LV�REYLRXV�IURP�WKH�WLFN�ODEHOV��RU�FRXOG�EH�PDGH�SODLQ�LQ�D�FHQWUDOO\�SRVLWLRQHG�3URPSW�DERYH�WKH�)RUPV�FKDUW�LWHP��)LJXUH���LOOXVWUDWHV�WKLV�VXJJHVWLRQ��,W�VKRZV�WKH�YDOXHV�RI�WKH�SURPSW�UHODWHG�SURSHUWLHV�RI�WKH�)RUPV�FKDUW�LWHP��DQG�WKH�UHVXOWLQJ�FKDUW��$�FKDUW�WLWOH�FDQ�DOVR�EH�UHPRYHG�IURP�WKH�FKDUW�LWVHOI�DQG�UHSODFHG�E\�D�3URPSW�DERYH�RU�EHORZ�WKH�FKDUW�LWHP��

Page 15: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�14

Page 16: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�15

,I��KRZHYHU��WKH�UHPRYDO�RI�D[HV�ODEHOV�DQG�RU�WLWOH�SURYHV�WR�EH�QHFHVVDU\��EXW�\RX�FDQQRW�GR�ZLWKRXW�SUHVHQWLQJ�WKH�LQIRUPDWLRQ�WKH\�FRQYH\�ZLWKLQ�WKH�ERXQGDU\�RI�WKH�FKDUW�LWVHOI��WZR�RSWLRQV�DUH�RSHQ��

• 5HSODFLQJ�WKH�ODEHOV�DQG�WLWOH�ZLWK�2UDFOH�*UDSKLFV�WH[W�

• 6LPXODWLQJ�WKH�ODEHO�DQG�WLWOH�RQ�WKH�)RUPV�FDQYDV�LWVHOI�

7KH�ILUVW�RSWLRQ�LV�SUREDEO\�SUHIHUDEOH��XQOHVV�\RX�ILQG�\RX�QHHG�WR�VLPXODWH�WKH�FKDUW�OHJHQG�LQ�D�IRUP�DV�ZHOO��VHH�RQ��´6LPXODWLQJ�WKH�&KDUW�/HJHQG�LQ�)RUPVµ���

5HSODFLQJ�WKH�$[HV�/DEHOV�DQG�&KDUW�7LWOH�ZLWK�*UDSKLFV�7H[W�

7KH�ILUVW�RSWLRQ��UHSODFHPHQW�E\�2UDFOH�*UDSKLFV�WH[W��LQFRUSRUDWHV�WKH�VXUURXQGLQJ�UHFWDQJOH�WHFKQLTXH��VHH�WKH�HDUOLHU�VHFWLRQ�´$GGLQJ�D�6XUURXQGLQJ�5HFWDQJOH�WR�WKH�2*'µ��DV�IROORZV��

,Q�)RUPV�'HYHORSHU��

• 6HOHFW�WKH�FKDUW�LWHP�DQG�VHW�WKH�ILOO�FRORU�WR�ZKLWH��

,Q�2UDFOH�*UDSKLFV�%XLOGHU��

��� 'UDZ�RXW�D�ZKLWH�UHFWDQJOH�DURXQG�WKH�FKDUW�DQG�VHW�LWV�OLQH�FRORU�WR�ZKLWH��

��� 0RYH�WKH�UHFWDQJOH�EHKLQG�WKH�FKDUW��XVLQJ�6HQG�WR�%DFN�IURP�WKH�$UUDQJH�PHQX���

��� 8QFKHFN�WKH�6KRZ�$[LV�/DEHO�SURSHUW\�IRU�HDFK�RI�WKH�D[HV��

��� %ODQN�RXW�7LWOH�RQ�WKH�ILUVW�WDE�RI�&KDUW�3URSHUWLHV��

��� $GG�VXLWDEO\�SRVLWLRQHG�7H[W�REMHFWV��QRW�WR�EH�FRQIXVHG�ZLWK�7H[W�ILHOG�REMHFWV��ZLWK�WKH�D[HV�QDPHV�DQG�FKDUW�WLWOH��([SDQG�WKH�ZKLWH�UHFWDQJOH�WR�DFFRPPRGDWH�WKH�WH[W�LWHPV�LI�QHFHVVDU\��

$�FRUUHFWHG�YHUVLRQ�RI�WKH�FKDUW�LQ�ILJXUH���LV�VKRZQ�LQ�ILJXUH����ZLWK�WKH�D[HV�ODEHOV�DQG�FKDUW�WLWOH�UHSODFHG�E\�2UDFOH�*UDSKLFV�WH[W��)LJXUH���LV�EDVHG�RQ�WKH�VXSSOHPHQWDU\�PRGXOHV�RJODEHOV�IPE�DQG�RJODEHOV�RJG��

Page 17: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�16

(KIWTG����.CDGNU�CPF�VKVNG�TGRNCEGF�D[�1TCENG�)TCRJKEU�VGZV�

Page 18: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�17

6LPXODWLQJ�WKH�$[HV�/DEHOV�DQG�&KDUW�7LWOH�RQ�WKH�)RUPV�&DQYDV�

7KH�VHFRQG�RSWLRQ�LV�WR�VLPXODWH�WKH�D[HV�ODEHOV�DQG�WLWOH�RQ�WKH�IRUP·V�FDQYDV�LWVHOI��7KLV�LV�D�IDLUO\�VLPSOH�H[HUFLVH��UHSODFLQJ�WKH�ODEHOV�DQG�WLWOH�RI�WKH�FKDUW�ZLWK�VXLWDEO\�SRVLWLRQHG�)RUPV�GLVSOD\�LWHPV��7KH�ERXQGDU\�WR�WKH�FKDUW�LWHP�PXVW�EH�KLGGHQ�DQG�D�QHZ�IUDPH�IRU�WKH�FKDUW�QHHGV�WR�EH�FUHDWHG�ZKLFK�LQFOXGHV�WKH�GLVSOD\�LWHPV�DV�IROORZV��

,Q�)RUPV�'HYHORSHU��VHH�ILJXUH�����

���� 6HW�WKH�EHYHO�RI�WKH�FKDUW�LWHP�WR�1RQH��

���� &UHDWH�DQG�SRVLWLRQ�GLVSOD\�LWHPV�IRU�WKH�ODEHOV�DQG�FKDUW�WLWOH��

���� 6L]H�WKH�GLVSOD\�LWHPV�DSSURSULDWHO\�DQG�HQVXUH�WKH\�KDYH�QR�EHYHO��

���� 6HW�WKH�YDOXHV�RI�WKH�GLVSOD\�LWHPV�HLWKHU�LQ�WKHLU�,QLWLDO�9DOXH�RU�SURJUDPPDWLFDOO\�ZKHQ�WKH�FKDUW�LV�RSHQHG��

���� 'UDZ�D�EHYHOHG�UHFWDQJOH�WKDW�HQFRPSDVVHV�WKH�GLVSOD\�LWHPV�DQG�FKDUW�LWHP���

���� 6HW�WKH�ILOO�FRORU�RI�WKH�GLVSOD\�LWHPV��FKDUW�LWHP�DQG�UHFWDQJOH�WR�WKH�VDPH�FRORU�²�SUREDEO\�ZKLWH��

(KIWTG����#ZGU�NCDGNU�CPF�VKVNG�CU�FKURNC[�KVGOU�KP�(QTOU�&GXGNQRGT�

Page 19: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�18

,Q�*UDSKLFV�%XLOGHU��

���� 5HPRYH�WKH�FKDUW�WLWOH��

���� 8SGDWH�WKH�D[HV�SURSHUWLHV��XQFKHFNLQJ�6KRZ�$[LV�/DEHO�IRU�HDFK�D[LV��

���� 0RYH�WKH�FKDUW�WR�WKH�WRS�OHIW�KDQG�FRUQHU�RI�WKH�/D\RXW�(GLWRU��

)LJXUH���VKRZV�KRZ�WKH�IRUP�LQ�ILJXUH���PLJKW�ORRN�DW�UXQWLPH��7KH�WZR�ILJXUHV�DUH�EDVHG�RQ�WKH�VXSSOHPHQWDU\�PRGXOHV�IRUPODEHOV�IPE�DQG�IRUPODEHOV�RJG��ZKLFK�GHPRQVWUDWH�WKH�UHPRYDO�RI�WKH�D[HV�ODEHOV�DQG�WLWOH�LQWR�)RUPV��

(KIWTG����%JCTV�YKVJ�CZGU�NCDGNU�CPF�VKVNG�KP�VJG�HQTO�

,QVWHDG�RI�)RUPV�GLVSOD\�LWHPV��ERLOHUSODWH�WH[W�FRXOG�EH�XVHG�IRU�WKH�ODEHOV�DQG�WLWOH��%RLOHUSODWH�WH[W�FDQQRW�EH�VHW�SURJUDPPDWLFDOO\��EXW�LW�FDQ�EH�URWDWHG�YHUWLFDOO\��ZKLFK�PD\�EH�GHVLUDEOH�LI�WKHUH�LV�D�OHQJWK\�ODEHO�IRU�WKH�YHUWLFDO�D[LV��

Page 20: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�19

0LVVLQJ�/HJHQGV�

2FFDVLRQDOO\��WKH�FKDUW�OHJHQG�GRHV�QRW�DSSHDU�LQ�DQ�2*'�GLVSOD\HG�RYHU�WKH�:HE�LQ�D�)RUPV�FKDUW�LWHP��+RZ�\RX�RXJKW�EHVW�WR�FRUUHFW�WKLV�RPLVVLRQ�GHSHQGV�RQ�ZKHWKHU�WKH�FRPSRQHQWV�RI�WKH�OHJHQG�FDQ�EH�GHWHUPLQHG�DW�GHVLJQ�WLPH�RU�ZKHWKHU�WKH\�DUH�GHWHUPLQHG�RQO\�DW�UXQWLPH��7KH�OHJHQGV�RI�FKDUWV�ZLWKRXW�VXEFDWHJRULHV��DUH�IL[HG�DW�GHVLJQ�WLPH��7KH�OHJHQGV�RI�FKDUWV�ZLWK�VXEFDWHJRULHV�PD\�FKDQJH�DW�UXQWLPH��GHSHQGLQJ�RQ�WKH�FRQVWDQF\�RI�WKH�VXEFDWHJRU\�GDWD��&RQVLGHU�D�OHJHQG�VKRZLQJ�FRORU�FRGHV�IRU�D�VXEFDWHJRU\�RI�'HSDUWPHQW�1XPEHU��WKH�UDQJH�RI�GHSDUWPHQWV�PD\�ZHOO�FKDQJH�RYHU�WLPH��&RPSDUH�WKLV�WR�D�OHJHQG�VKRZLQJ�FRORU�FRGHV�IRU�D�VXEFDWHJRU\�RI�0DOH�RU�)HPDOH��\RX�FRXOG�EH�PRUH�FRQILGHQW�WKDW�WKLV�ZRXOG�UHPDLQ�XQFKDQJHG��,Q�WKH�ILUVW�FDVH��WKH�UDQJH�RI�DWWULEXWHV�IRU�WKH�VXEFDWHJRU\�PD\�DOWHU��WKXV�PRGLI\LQJ�WKH�OHJHQG��LQ�WKH�VHFRQG�FDVH��WKH\�GR�QRW��

5HWDLQLQJ�WKH�'HVLJQ�7LPH�&KDUW�/HJHQG�

,I�WKH�GDWD�LQ�WKH�PLVVLQJ�OHJHQG�ZLOO�QHYHU�FKDQJH��LW�LV�D�UHODWLYHO\�VLPSOH�PDWWHU�WR�VWRS�LW�IURP�GLVDSSHDULQJ��$GG�WKH�IROORZLQJ�FRGH�WR�WKH�RSHQ�WULJJHU�RI�WKH�2*'��7KLV�SURFHGXUH�UHWDLQV�WKH�OHJHQG�DV�LW�DSSHDUV�DW�GHVLJQ�WLPH��EXW�UHGUDZV�WKH�UHVW�RI�WKH�FKDUW�WR�GLVSOD\�WKH�UXQWLPH�GDWD��

PROCEDURE OpenTrigger IS

vChart OG_OBJECT := OG_GET_OBJECT(’mychart’);

vQuery OG_QUERY := OG_GET_QUERY(vChart);

BEGIN

/*

** Control query execution and chart update from the

** open trigger.

*/

OG_SET_EXECOPEN(vQuery, FALSE);

OG_SET_AUTOUPDATE(vChart, FALSE);

OG_EXECUTE_QUERY(vQuery);

OG_UPDATE_CHART(vChart, OG_ALL_CHUPDA - OG_LEGEND_CHUPDA);

END;

6HH�WKH�VXSSOHPHQWDU\�PRGXOH�UHWDLQOHJHQG�RJG��ZKLFK�XVHV�WKLV�SURFHGXUH��

6LPXODWLQJ�WKH�&KDUW�/HJHQG�LQ�)RUPV�

,I�WKHUH�LV�QR�JXDUDQWHH�WKDW�WKH�OHJHQG�GDWD�ZLOO�UHPDLQ�XQFKDQJHG�DIWHU�GHVLJQ�WLPH��WKHQ�FRQVLGHU�VLPXODWLQJ�D�PLVVLQJ�OHJHQG�LQ�)RUPV��7KLV�VWUDWHJ\�XVHV�VRPH�RI�WKH�WHFKQLTXHV�IURP�´6LPXODWLQJ�WKH�$[HV�/DEHOV�DQG�&KDUW�7LWOH�LQ�)RUPVµ��7KH�VWHSV�LQYROYHG�FDQ�EH�JURXSHG�LQWR�VWDJHV�DV�IROORZV��

,Q�)RUPV�'HYHORSHU��

���� +LGH�WKH�ERXQGDU\�RI�WKH�FKDUW�LWHP��

���� &UHDWH�D�SVHXGR�OHJHQG�VWDFNHG�FDQYDV�ZLWK�D�PXOWL�UHFRUG�EORFN�WR�VLPXODWH�WKH�OLQHV�RI�WKH�OHJHQG���

,Q�*UDSKLFV�%XLOGHU��

1 To check whether a chart includes a subcategory column mapping, see the bottom right-hand corner of the Chart Properties, Categories tab, in Oracle Graphics Builder.

Page 21: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�20

���� $GG�DQ�DGGLWLRQDO�TXHU\�WR�KROG�WKH�OHJHQG�FRORU�FRGHV��

���� $GG�D�IRUPDW�WULJJHU�WR�FRORU�WKH�GDWD�LWHPV�DFFRUGLQJ�WR�WKH�OHJHQG�FRGHV���

���� &UHDWH�RU�PRGLI\�WKH�RSHQ�WULJJHU�WR�DWWDFK�WKH�IRUPDW�WULJJHU�WR�WKH�UHOHYDQW�LWHPV���

%DFN�LQ�)RUPV�'HYHORSHU���

���� :ULWH�D�SURFHGXUH�WKDW�FUHDWHV�WKH�FKDUW�TXHU\�GDWD�DQG�OHJHQG�FRORU�FRGHV�DQG�SDVVHV�WKLV�LQIRUPDWLRQ�WR�*UDSKLFV��DV�ZHOO�DV�SRSXODWLQJ�WKH�PXOWL�UHFRUG�OHJHQG�EORFN��

(DFK�VWDJH�ZLOO�QRZ�EH�H[SODLQHG�LQ�GHWDLO��7KHVH�VWDJHV�DUH�LOOXVWUDWHG�LQ�WKH�VXSSOHPHQWDU\�PRGXOHV�DGGOHJHQG�IPE�DQG�DGGOHJHQG�RJG��ZKLFK�FDQ�DOVR�EH�XVHG�DV�D�WHPSODWH�IRU�VLPXODWLQJ�D�OHJHQG�LQ�IRUPV��7KHVH�PRGXOHV�DUH�EDVHG�RQ�WKH�VWDQGDUG�2UDFOH�GHPRQVWUDWLRQ�WDEOH�HPS��FUHDWHG�E\�GHPREOG�VTO��ZKLFK�LV�LQFOXGHG�ZLWK�WKH�VDPSOH�PRGXOHV��

+LGH�WKH�%RXQGDU\�RI�WKH�&KDUW�,WHP�

7KH�ILUVW�VWDJH��KLGLQJ�WKH�ERXQGDU\�RI�WKH�FKDUW�LWHP��LV�WKH�VDPH�DV�WKDW�RI�´6LPXODWLQJ�WKH�$[HV�/DEHOV�DQG�&KDUW�7LWOH�LQ�)RUPVµ��,QGHHG��LI�WKH�OHJHQG�LV�WR�EH�PRYHG�LQWR�)RUPV��LW�SUREDEO\�PDNHV�VHQVH�WR�PRYH�WKH�ODEHOV�DQG�WLWOH�DV�ZHOO��-XVW�DOORZ�VXIILFLHQW�VSDFH�LQ�WKH�HQFRPSDVVLQJ�EHYHOHG�UHFWDQJOH�WR�LQFOXGH�D�OHJHQG�WR�EH�SODFHG�WR�WKH�ULJKW�RI�WKH�FKDUW��

&UHDWH�D�3VHXGR�/HJHQG�6WDFNHG�&DQYDV�

7KH�QH[W�VWDJH��VWLOO�LQ�)RUPV�'HYHORSHU��LV�WR�FUHDWH�WKH�SVHXGR�OHJHQG��7KLV�ZLOO�FRPSULVH�D�VXLWDEO\�SRVLWLRQHG�DQG�VL]HG�VWDFNHG�FDQYDV�FRQWDLQLQJ�D�PXOWL�UHFRUG�EORFN��ZLWK�D�URZ�IRU�HDFK�OLQH�RI�WKH�OHJHQG�RI�WZR�GLVSOD\�LWHPV��RQH�IRU�WKH�FRORU�FRGH��RQH�IRU�WKH�OHJHQG�GHVFULSWLRQ��

���� &UHDWH�WKH�VWDFNHG�FDQYDV�DQG�VHW�WKH�IROORZLQJ�SURSHUWLHV�WR�SRVLWLRQ�LW��

9LHZSRUW�;�3RVLWLRQ�

9LHZSRUW�<�3RVLWLRQ�

9LHZSRUW�:LGWK�

9LHZSRUW�+HLJKW�

3K\VLFDO�:LGWK�

3K\VLFDO�+HLJKW�

���� &UHDWH��PDQXDOO\��UDWKHU�WKDQ�ZLWK�WKH�'DWD�%ORFN�:L]DUG��D�QRQGDWDEDVH�PXOWL�UHFRUG�EORFN��ZLWK�1XPEHU�RI�5HFRUGV�'LVSOD\�VHW�WR�����WKLV�YDOXH�ZLOO�EH�FKDQJHG�DW�UXQWLPH���

���� ,Q�WKH�EORFN�DQG�RQ�WKH�VWDFNHG�FDQYDV��DGG�WKH�IROORZLQJ�GLVSOD\�LWHPV��

/HJHQGB7LWOH�

/HJHQGB,WHPB1DPH�

/HJHQGB,WHPB&RORU�

���� ,Q�WKH�SURSHUW\�SDOHWWH�IRU�/HJHQGB7LWOH�VHW�5HFRUGV�1XPEHU�RI�,WHPV�'LVSOD\HG�WR����

Page 22: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�21

���� 6HW�D�ILOO�FRORU�IRU�/HJHQGB,WHPB&RORU��DQ\�ZLOO�GR��DV�LW�ZLOO�EH�RYHUULGGHQ�DW�UXQWLPH���DQG�VL]H�LW�VR�WKDW�LW�DSSHDUV�HLWKHU�YHU\�QDUURZ��OLNH�D�OLQH��RU�DV�D�VKRUW�EDU��GHSHQGLQJ�RQ�ZKHWKHU�LW�LV�WR�EH�WKH�OHJHQG�IRU�D�OLQH�RU�EDU�FKDUW��

���� 5HPRYH�DQ\�EHYHO�IRU�/HJHQGB7LWOH�DQG�/HJHQGB,WHPB1DPH��

)LJXUH����LOOXVWUDWHV�WKH�UHVXOW�DV�LW�DSSHDUV�LQ�)RUPV�'HYHORSHU��

(KIWTG�����#�NGIGPF�ETGCVGF�HTQO�C�UVCEMGF�ECPXCU�

Page 23: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�22

�$GG�D�/HJHQG�&RORU�&RGHV�4XHU\�LQ�2UDFOH�*UDSKLFV�%XLOGHU�

(YHQWXDOO\�DW�UXQWLPH��WKH�OHJHQG�FRORU�FRGHV�ZLOO�EH�VHW�LQ�D�)RUPV�UHFRUG�JURXS�DQG�SDVVHG�WR�D�*UDSKLFV�TXHU\�DV�D�GDWD�SDUDPHWHU��+RZHYHU��\RX�ILUVW�QHHG�WR�DGG�WKLV�TXHU\�WR�WKH�2*'��DQG�JLYH�LW�VRPH�LQLWLDO�YDOXHV��6R�IRU�WKLV�QH[W�VWDJH��HGLW�WKH�2*'�LQ�2UDFOH�*UDSKLFV�%XLOGHU�DQG�FUHDWH�D�QHZ�TXHU\�EDVHG�RQ�WKH�IROORZLQJ��

SELECT ’ALegendValue’ legenditem, ’magenta’ color FROM dual

EXW�FKDQJH�¶$OHJHQG9DOXH·�WR�D�VXEFDWJRU\�YDOXH�WKDW�\RX�NQRZ�ZLOO�DSSHDU�LQ�*UDSKLFV�%XLOGHU�LQ�WKH�VDPSOH�GDWD�IRU�WKH�FKDUW��7KLV�ZLOO�DOORZ�\RX�WR�WHVW�WKH�FRORU�UHWULHYLQJ�IXQFWLRQ��*HW&RORU��IURP�*UDSKLFV�%XLOGHU��)RU�H[DPSOH��LQ�WKH�DFFRPSDQ\LQJ�PRGXOH�DGGOHJHQG�RJG��WKH�GDWD�LV�JURXSHG�LQWR�VXEFDWHJRULHV�EDVHG�RQ�GHSWQR��VR�WKH�OHJHQG�VKRZV�WKH�FRORU�FRGH�IRU�HDFK�GHSDUWPHQW��$V����DQG����DUH�VRPH�RI�WKH�GHSDUWPHQW�QXPEHUV��WKH�FRORUV�TXHU\�LQ�WKH�2*'�LV��

SELECT ’10’ legenditem, ’green’ color FROM dual

UNION

SELECT ’20’ legenditem, ’red’ color FROM dual

5HSODFH�¶��·�DQG�¶��·�ZLWK�YDOXHV�WKDW�\RX�NQRZ�ZLOO�DSSHDU�LQ�\RXU�VXEFDWHJRU\�FROXPQ��EXW�GRQ·W�FKDQJH�WKH�FROXPQ�QDPH�DOLDVHV��OHJHQGLWHP�DQG�FRORU��WKH\�PXVW�FRUUHVSRQG�WR�WKH�FROXPQV�RI�WKH�UHFRUG�JURXS�WR�EH�FUHDWHG�LQ�)RUPV��

$GG�)RUPDW�7ULJJHU�&RGH�WR�&RORU�WKH�'DWD�,WHPV�$FFRUGLQJ�WR�WKH�/HJHQG�&RGHV��

6WLOO�LQ�2UDFOH�*UDSKLFV�%XLOGHU��FRS\�WKH�SURJUDP�XQLWV�*HW&RORU�DQG�6HW&RORU�IURP�DGGOHJHQG�RJG��6HW&RORU�LV�WKH�IRUPDW�WULJJHU�WKDW�ZLOO�EH�VHW�RQ�WKH�UHOHYDQW�GDWD�OLQHV�RU�EDUV��,W�FDOOV�*HW&RORU�WR�UHWULHYH�WKH�DSSURSULDWH�FRORU�FRGH��*HW&RORU�ORRSV�WKURXJK�WKH�FRORUV�TXHU\�WR�ORRN�XS�WKH�FRORU��1R�PRGLILFDWLRQV�QHHG�WR�EH�PDGH�WR�*HW&RORU��-XVW�RQH�FXVWRPL]DWLRQ�LV�UHTXLUHG�LQ�6HW&RORU��LQLWLDOL]H�Y6XE&DWHJRU\&ROXPQ�WR�WKH�QDPH�RI�WKH�FKDUW·V�VXEFDWHJRU\�FROXPQ��VHH�WKH�ERWWRP�ULJKW�KDQG�VLGH�RI�WKH�&DWHJRULHV�WDE�RI�&KDUW�3URSHUWLHV����

&UHDWH�RU�0RGLI\�WKH�2SHQ�7ULJJHU�WR�$WWDFK�WKH�)RUPDW�7ULJJHU�WR�WKH�5HOHYDQW�,WHPV�

1H[W��LQ�WKH�2*'·V�RSHQ�WULJJHU��DWWDFK�6HW&RORU�WR�WKH�GDWD�EDUV�RU�OLQHV��<RX�FDQ�PDNH�XVH�RI�WKH�RSHQ�WULJJHU�IURP�DGGOHJHQG�RJG��TXRWHG�LQ�WKH�DSSHQGL[���:KDW�WKLV�RSHQ�WULJJHU�GRHV�ILUVW�LV�WR�XSGDWH�WKH�FKDUW�VR�WKDW�DQ\�QHZ�VXEFDWHJRU\�GDWD�JURXSV�FDQ�EH�FUHDWHG��LW�WKHQ�VHWV�WKH�IRUPDW�WULJJHU�RQ�DOO�VXE�FDWHJRU\�JURXSV��DQG�ILQDOO\�LW�XSGDWHV�WKH�FKDUW�D�VHFRQG�WLPH�WR�HQVXUH�ERWK�WKDW�WKH�IRUPDW�WULJJHU�LV�ILUHG�DQG�WKDW�LW�WDNHV�HIIHFW��7KH�VXEFDWHJRU\�GDWD�JURXSV�DUH�LGHQWLILHG�E\�WKH�QDPLQJ�FRQYHQWLRQ�^6XE&DWHJRU\�FROXPQ�YDOXH`B^6XE&DWHJRU\�FROXPQ�QDPH`B^OLQHV�RU�EDUV���6R�GDWD�EDUV�VKRZLQJ�WKH�VDODULHV��6$/��IRU�WKH�VXEFDWHJRU\�GHSDUWPHQW��'(3712�����ZLOO�DOO�EH�LQ�WKH�JURXS�QDPHG���B6$/BEDUV��([SDQG�WKH�FKDUW�REMHFW�LQ�WKH�REMHFW�QDYLJDWRU�WR�VHH�WKH�QDPHV�RI�WKH�VXEFDWHJRU\�GDWD�JURXSV��$SSO\LQJ�WKH�IRUPDW�WULJJHU�WR�D�JURXS�REMHFW�HQVXUHV�WKDW�WKH�WULJJHU�LV�VHW�IRU�DOO�WKH�FKLOG�PHPEHUV�RI�WKH�JURXS��7KH�VXEFDWHJRU\�FROXPQ�YDOXHV�ZLOO�EH�WKH�/HJHQG,WHPV�OLVWHG�LQ�WKH�FRORUV�TXHU\�ZKHQ�WKH�TXHU\�GDWD�LV�SDVVHG�IURP�)RUPV��VR�WKH�RSHQ�WULJJHU�ORRSV�WKURXJK�WKH�FRORUV�TXHU\�WR�EXLOG�XS�WKH�/HJHQG,WHP�QDPHV��

Page 24: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�23

,I�WKH�2*'�GRHV�QRW�DOUHDG\�KDYH�DQ�RSHQ�WULJJHU��WKHUH�DUH�RQO\�WZR�PRGLILFDWLRQV�\RX�ZLOO�QHHG�WR�PDNH���

��� ,QLWLDOL]H�Y&KDUW1DPH�WR�WKH�QDPH�RI�\RXU�FKDUW��,I�WKH�FKDUW�KDV�QR�QDPH��EULQJ�XS�&KDUW�3URSHUWLHV�DQG�VHW�RQH��9&KDUW1DPH�LV�FDVH�VHQVLWLYH��VR�HQVXUH�WKDW�LW�LV�VHW�LQ�WKH�VDPH�FDVH�DV�WKH�FKDUW�QDPH�WKDW�DSSHDUV�LQ�WKH�REMHFW�QDYLJDWRU��P\FKDUW�LV�QRW�WKH�VDPH�DV�0\&KDUW��

��� ,QLWLDOL]H�Y6XE&DWHJRU\6XIIL[�WR�WKH�VXIIL[�RI�WKH�QDPHV�IRU�DOO�WKH�GDWD�EDUV��OLQHV��RU�FROXPQV�DV�WKH\�DSSHDU�LQ�WKH�REMHFW�QDYLJDWRU��7KH�VXIIL[�ZLOO�EH�RI�WKH�IRUPDW�B^FROXPQBQDPH`BOLQHV�RU�B^FROXPQBQDPH`BEDUV��,Q�DGGOHJHQG�RJG�WKH�GDWD�OLQHV�DUH�QDPHG���B6$/BOLQHV����B6$/BOLQHV�HWF��KHQFH�WKH�VXIIL[�LV�B6$/BOLQHV��$V�ZLWK�Y&KDUW1DPH��WKH�FDVH�PXVW�EH�H[DFWO\�DV�LW�DSSHDUV�LQ�WKH�REMHFW�QDYLJDWRU��

,I�WKHUH�LV�DOUHDG\�DQ�RSHQ�WULJJHU�WR�WKH�FKDUW��LW�LV�OLNHO\�WKDW�WKH�H[LVWLQJ�OLQHV�RI�H[HFXWDEOH�FRGH�VKRXOG�IROORZ�WKH�ILUVW�2*B83'$7(B&+$57��7KH�H[DFW�SODFHPHQW�RI�WKLV�H[LVWLQJ�FRGH��KRZHYHU��ZLOO�YDU\�IURP�FKDUW�WR�FKDUW��GHSHQGLQJ�XSRQ�LWV�SXUSRVH��

$�3URFHGXUH�WR�3RSXODWH�WKH�&KDUW�,WHP�DQG�/HJHQG�IURP�)RUPV�

:KLOH�WKH�SURJUDP�XQLWV�DGGHG�WR�WKH�2*'�QHHGHG�YHU\�OLWWOH�PRGLILFDWLRQ��WKH�LQLWLDWLQJ�SURFHGXUH�LQ�)RUPV�ZLOO�UHTXLUH�PRUH�H[WHQVLYH�FXVWRPL]DWLRQ��&RS\�WKH�SURFHGXUH�&UHDWH&KDUW$QG/HJHQG�IURP�DGGOHJHQG�IPE��DOVR�TXRWHG�LQ�WKH�DSSHQGL[��DQG�FXVWRPL]H�LW�LQ�DFFRUGDQFH�ZLWK�WKH�FRPPHQWV��,W�SDVVHV�WZR�UHFRUG�JURXSV�WR�WKH�2*'��WKH�TXHU\�RQ�ZKLFK�WKH�FKDUW�LV�EDVHG�DQG�D�TXHU\�OLVWLQJ�WKH�OHJHQG�LWHPV�DQG�WKHLU�FRORU�FRGHV��5*&KDUW4XHU\7H[W�DQG�5*/HJHQG4XHU\7H[W�ZLOO�ERWK�QHHG�WR�EH�FKDQJHG��<RX�FDQ�FRS\�5*&KDUW4XHU\7H[W�GLUHFWO\�IURP�WKH�2*'��,W�LV�HVVHQWLDO�WKDW�WKH�FROXPQ�DOLDVHV�LQ�5*/HJHQG4XHU\7H[W�EH�¶OHJHQGLWHP·�DQG�¶FRORU·�MXVW�DV�WKH\�DUH�LQ�WKH�2*'��5HWULHYH�WKH�DFWXDO�OHJHQG�LWHP�GDWD�YDOXHV�E\�LVVXLQJ�D�6(/(&7�',67,1&7�RQ�WKH�VXEFDWHJRU\�FROXPQ�QDPH��GHSWQR�LQ�WKLV�H[DPSOH��DQG�DSSHQGLQJ�WKH�:+(5(�FODXVH�IURP�WKH�FKDUW�TXHU\���&UHDWH&KDUW$QG/HJHQG�LQFOXGHV�D�3/�64/�7DEOH�RI�FRORUV��&UHDWH�YLVXDO�DWWULEXWHV�WR�FRUUHVSRQG�WR�HDFK�RI�WKHVH�FRORUV��VR�WKDW�YLVXDO�DWWULEXWH�GDUN\HOORZ�LV�D�YLVXDO�DWWULEXWH�ZLWK�%DFNJURXQG�&RORU�VHW�WR�GDUN�\HOORZ��YLVXDO�DWWULEXWH�UHG�LV�D�YLVXDO�DWWULEXWH�ZLWK�%DFNJURXQG�&RORU�VHW�WR�UHG��DQG�VR�RQ��&UHDWH&KDUW$QG/HJHQG�ORRSV�WKURXJK�WKH�OHJHQGTXHU\�UHFRUG�JURXS��DVVLJQLQJ�VXFFHVVLYH�FRORUV�IURP�WKH�FRORUV�WDEOH��FUHDWLQJ�DSSURSULDWHO\�FRORUHG�DQG�QDPHG�OHJHQG�LWHPV��DQG�XSGDWLQJ�WKH�FRORU�FROXPQ�RI�WKH�UHFRUG�JURXS��<RX�WKHQ�SDVV�ERWK�UHFRUG�JURXSV�WR�2UDFOH�*UDSKLFV�DV�GDWD�SDUDPHWHUV�WR�WKH�2*�23(1�FRPPDQG���

)LJXUH����VKRZV�D�IRUP�WKDW�DGRSWV�WKLV�WHFKQLTXH�WR�VLPXODWH�D�OHJHQG��

��

Page 25: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�24

(KIWTG�����%JCTV�YKVJ�C�NGIGPF�UKOWNCVGF�KP�(QTOU�

Page 26: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�25

5HVHWWLQJ�%DU��/LQH��RU�)LOO�&RORU�

$QRWKHU�LVVXH�WKDW�FDQ�DULVH�ZKHQ�GLVSOD\LQJ�2*'V�RQ�WKH�:HE�LQ�)RUPV�FKDUW�LWHPV�FRQFHUQV�WKH�FRORULQJ�RI�GDWD�LWHP�JURXSV��,Q�ILJXUH�����WKH�FKDUW�GLVSOD\V�WZR�YDOXHV�SHU�SHUVRQ��6$/�DQG�&200��7KH�OHJHQG�FRUUHFWO\�VKRZV�WKH�GLVWLQFW�FRORUV�IRU�6$/�DQG�&200��EXW�WKH�FKDUWLQJ�RI�WKH�GDWD�LWHP�JURXSV�²�EDUV�LQ�WKLV�FDVH�²�DUH�ERWK�WKH�FRORU�RI�6$/���)LJXUH����VKRZV�WKH�FRUUHFW�YHUVLRQ�RI�WKH�FKDUW���

(KIWTG�����+PEQTTGEV�DCT�EQNQTKPI�

7KHUH�DUH�VHYHUDO�ZD\V�WR�FRUUHFW�WKH�FRORULQJ�RI�GDWD�LWHP�JURXSV��

• 6HW�WKH�FRORUV�LQ�WKH�OD\RXW�HGLWRU��

• 6HW�WKH�FRORUV�SURJUDPPDWLFDOO\�LQ�2UDFOH�*UDSKLFV��

• 6HW�WKH�FRORUV�LQ�D�IRUP�ZLWK�D�VLPXODWHG�OHJHQG��

Page 27: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�26

6HW�WKH�&RORUV�LQ�WKH�/D\RXW�(GLWRU�

7KHUH�LV�D�TXLFN�VROXWLRQ�WR�WKH�SUREOHP�IRU�D�FKDUW�ZKHUH�WKH�EDUV��FROXPQV��OLQHV��RU�ILOO�DUH�MXVW�RQH�RI�D�FRXSOH�RI�FRORUV��DQG�ZKHUH�WKH�FRORUV�DQG�WKXV�DOVR�WKH�FRQVWLWXHQWV�RI�WKH�OHJHQG�DUH�GHWHUPLQHG�DW�GHVLJQ�WLPH���)RU�D�GLVFXVVLRQ�RI�WKH�GLIIHUHQFH�EHWZHHQ�OHJHQGV�GHILQHG�DW�GHVLJQ�WLPH�DQG�WKRVH�GHWHUPLQHG�RQO\�DW�UXQWLPH��VHH�WKH�HDUOLHU�VHFWLRQ�´0LVVLQJ�/HJHQGVµ���$OO�\RX�QHHG�WR�GR�LV�H[SOLFLWO\�VHW�WKH�FRORU�RI�WKH�ZURQJO\�FRORUHG�JURXS�RI�LWHPV�LQ�*UDSKLFV�%XLOGHU��DV�LOOXVWUDWHG�LQ�)LJXUH������

(KIWTG�����'ZRNKEKVN[�UGVVKPI�DCT�EQNQT�KP�)TCRJKEU�$WKNFGT�

([SDQG�WKH�FKDUW�LWHP�LQ�WKH�REMHFW�QDYLJDWRU��VR�LW�LV�SRVVLEOH�WR�VHH�WKH�QDPHV�RI�WKH�GDWD�LWHP�JURXSV��6$/BEDUV�DQG�&200BEDUV�LQ�WKLV�FDVH��6HOHFW�WKH�GDWD�LWHP�JURXS�WKDW�LV�QRW�SLFNLQJ�XS�LWV�FRORU�FRUUHFWO\�DQG�DVVLJQ�D�QHZ�FRORU�LQ�WKH�/D\RXW�(GLWRU��,Q�ILJXUH�����WKH�&200BEDUV�JURXS�KDV�EHHQ�VHOHFWHG�YLD�WKH�REMHFW�QDYLJDWRU�DQG�D�QHZ�ILOO�FRORU�FKRVHQ�IURP�WKH�ILOO�FRORU�SDOHWWH��6HWWLQJ�WKLV�QHZ�ILOO�FRORU�DXWRPDWLFDOO\�XSGDWHV�ERWK�WKH�FRORU�RI�WKH�EDUV�DQG�WKH�UHOHYDQW�FRORU�VDPSOH�LQ�WKH�OHJHQG��)LJXUH����VKRZV�WKH�FRUUHFWHG�FKDUW�DV�LW�QRZ�DSSHDUV�DW�UXQWLPH��

Page 28: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�27

(KIWTG�����%QTTGEVGF�DCT�EQNQTKPI�

6HW�WKH�&RORUV�3URJUDPPDWLFDOO\�LQ�2UDFOH�*UDSKLFV�

:KHQ�WKHUH�DUH�D�ODUJHU�QXPEHU�RI�JURXSV�RI�GDWD�LWHPV��DQG�WKXV�PRUH�WKDQ�D�FRXSOH�RI�LWHPV�RQ�WKH�OHJHQG��H[SOLFLWO\�VHWWLQJ�D�FRORU�LQ�WKH�/D\RXW�(GLWRU�GRHV�QRW�DOZD\V�ZRUN��+RZHYHU��VR�ORQJ�DV�WKH�OHJHQG��DQG�WKXV�WKH�QXPEHU�RI�GDWD�LWHP�JURXSV��LV�GHWHUPLQHG�DW�GHVLJQ�WLPH��D�SURJUDPPDWLF�VROXWLRQ�FDQ�EH�DSSOLHG��,W�WDNHV�WKH�RSHQ�WULJJHU�IURP�WKH�HDUOLHU�VHFWLRQ�´5HWDLQLQJ�WKH�'HVLJQ�7LPH�&KDUW�/HJHQGµ�DQG�DGGV�D�FDOO�WR�WKH�SURFHGXUH�*HW/HJHQG&RORUV��ZKLFK�LQ�WXUQ�FDOOV�6HW'DWD*URXS&RORU��7KHVH�WZR�SURFHGXUHV�DSSHDU�LQ�WKH�VXSSOHPHQWDU\�PRGXOH�VHWFRORUV�RJG��DQG�DUH�DOVR�ERWK�TXRWHG�LQ�WKH�DSSHQGL[��1HLWKHU�SURFHGXUH�VKRXOG�QRUPDOO\�UHTXLUH�DQ\�FXVWRPL]DWLRQ��*HW/HJHQG&RORUV�ORRSV�WKRXJK�WKH�LWHPV�RQ�WKH�OHJHQG��DQG�IRU�HDFK�SDLU�RI�FRORU�VDPSOH�DQG�WH[W�ODEHO�LW�JHWV�WKH�FRORU�DQG�XVHV�WKH�WH[W�ODEHO�WR�EXLOG�XS�WKH�QDPH�RI�WKH�FRUUHVSRQGLQJ�JURXS�RI�GDWD�LWHPV��7KLV�QDPH�ZLOO�VLPSO\�EH�WKH�WH[W�ODEHO�ZLWK�BEDUV��BOLQHV��RU�BILOOV�FRQFDWHQDWHG�RQ�WKH�HQG��DV�VKRZQ�LQ�ILJXUH�����ZKHUH�WKH�OHJHQG�ODEHO�6$/�FRUUHVSRQGV�WR�WKH�GDWD�JURXS�6$/BEDUV��DQG�&200�FRUUHVSRQGV�WR�&200BEDUV����

6HW�WKH�&RORUV�LQ�D�)RUP�ZLWK�D�6LPXODWHG�/HJHQG�

7KH�VROXWLRQ�RI�VHWWLQJ�WKH�FRORUV�SURJUDPPDWLFDOO\�LQ�2UDFOH�*UDSKLFV�LV�QRW�DSSOLFDEOH�LI�WKH�FRQVWLWXHQWV�RI�WKH�OHJHQG�DUH�RQO\�GHWHUPLQHG�DW�UXQWLPH��,Q�WKLV�FDVH��XVH�WKH�PHWKRG�H[SODLQHG�LQ�´6LPXODWLQJ�WKH�&KDUW�/HJHQG�LQ�)RUPVµ��DV�LW�DOVR�H[SOLFLWO\�VHWV�WKH�FRORUV�RI�GDWD�LWHP�JURXSV����

Page 29: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�28

)RQWV�DQG�)RUPDW�7ULJJHUV�

:KHQHYHU�DQ�2*'�LV�UXQ��ZKHWKHU�LQ�D�IRUP��LQ�D�UHSRUW��RU�VWDQGDORQH�LQ�2UDFOH�*UDSKLFV��L�UXQWLPH��WKH�FKDUW�E\�GHIDXOW�LV�FRPSOHWHO\�UHGUDZQ�VR�DV�WR�WDNH�LQWR�DFFRXQW�WKH�UXQWLPH�GDWD���7KLV�UHGUDZLQJ�FDQ�EH�FRQWUROOHG�IURP�WKH�RSHQ�WULJJHU�ZLWK�WKH�EXLOW�LQV�2*B6(7B$87283'$7(�DQG�2*B83'$7(B&+$57���3ULRU�WR�SDWFK���RI�)RUPV��L��VXFK�UHGUDZLQJ�UHVXOWHG�LQ�D�ORVV�RI�IRQW�LQIRUPDWLRQ�LQ�FKDUWV�ZKHQ�WKH\�ZHUH�GLVSOD\HG�LQ�:HE�IRUPV��7\SLFDOO\��VXFK�ORVV�PHDQW�WKDW�FKDUW�ODEHOV�DSSHDUHG�ODUJHU�LQ�IRUPV�RQ�WKH�:HE�WKDQ�LQ�IRUPV�UXQQLQJ�LQ�D�FOLHQW�VHUYHU�HQYLURQPHQW��7KLV�LVVXH�KDV�QRZ�EHHQ�FRUUHFWHG��+RZHYHU��ORVV�RI�IRQW�LQIRUPDWLRQ�FDQ�VWLOO�RFFXU�ZKHQ�ODEHO�WH[W�LV�SURJUDPPDWLFDOO\�UHVHW��W\SLFDOO\�LQ�D�IRUPDW�WULJJHU�RQ�D�WLFN�ODEHO�WKDW�LVVXHV�DQ�2*B6(7B675�WR�FKDQJH�WKH�WH[W���,W�PD\�EH�SRVVLEOH�WR�DYRLG�WKLV�IRUPDW�WULJJHU�OLPLWDWLRQ�E\�PRYLQJ�WKH�IRUPDW�WULJJHU·V�IXQFWLRQDOLW\�LQWR�WKH�TXHU\��$�WULYLDO�H[DPSOH�ZRXOG�EH�D�FKDUW�ZLWK�WKH�TXHU\��

SELECT ename, sal FROM emp

DQG�WKH�IRUPDW�WULJJHU���

PROCEDURE OGFORMATTRIG0(elem IN og_object, query IN og_query) IS

BEGIN

OG_SET_STR(elem, INITCAP(OG_GET_STR(elem,0,0)));

END;

<RX�FRXOG�MXVW�UHSODFH�WKH�TXHU\�E\�

��6(/(&7�,1,7&$3�HQDPH��HQDPH��VDO�)520�HPS�

2WKHU�VLWXDWLRQV�ZKHUH�WH[W�LV�HQODUJHG�EHFDXVH�LW�LV�VHW�SURJUDPPDWLFDOO\�FRXOG�SHUKDSV�EH�GHDOW�ZLWK�HLWKHU�E\�PDNLQJ�DOORZDQFH�IRU�WKH�VL]H�RI�WKH�WH[W�DV�LW�DSSHDUV�RQ�WKH�:HE��RU�E\�VLPXODWLQJ�WKH�WH[W�LQ�IRUPV�DV�LW�LV�GRQH�LQ�´6LPXODWLQJ�WKH�$[HV�/DEHOV�DQG�&KDUW�7LWOH�RQ�WKH�)RUPV�FDQYDVµ��

6800$5<�

0LJUDWLRQ�WR�WKH�:HE�RI�IRUPV�ZLWK�HPEHGGHG�2UDFOH�*UDSKLFV�GLVSOD\V�PD\�ZHOO�HQWDLO�PRGLILFDWLRQV�WR�PRGXOHV��$OORZ�WLPH�WR�FKHFN�WKH�EHKDYLRU�RI�HDFK�HPEHGGHG�FKDUW�RQ�WKH�:HE��DQG�GHFLGH�LI�DQ\�RI�WKH�VXJJHVWLRQV�LQ�WKLV�ZKLWH�SDSHU�QHHG�WR�EH�LPSOHPHQWHG��6HH�KRZ�WKH�FKDUW�ORRNV�ZLWK�WKH�ODUJHVW�VHW�RI�GDWD�LW�LV�OLNHO\�WR�EH�SDVVHG��QRW�MXVW�D�VPDOO�VHW�RI�WHVW�GDWD��JRRG�SUDFWLFH�ZKHWKHU�UXQQLQJ�LQ�D�FOLHQW�VHUYHU�HQYLURQPHQW�RU�RQ�WKH�:HE���&RQVLGHU�ZKHWKHU�UHSRUWV�GHSOR\PHQW�PD\�EH�SUHIHUDEOH�LQ�VRPH�FDVHV��5HYLHZ�WKH�FKDUWV�WR�VHH�LI�WKHUH�DUH�DQ\�LWHPV�WKDW�FDQ�EH�UHPRYHG��SDUWLFXODUO\�UHGXQGDQW�D[HV�ODEHOV�RU�OHJHQGV��,I�\RX�DUH�PLJUDWLQJ�IRUPV�ZLWK�HPEHGGHG�2*'V�IURP�FOLHQW�VHUYHU�GHSOR\PHQW�WR�2UDFOH�L$6�RQ�WKH�:HE��LW�ZRXOG�EH�EHVW�WR�EUHDN�WKLV�GRZQ�LQWR�WZR�VWDJHV��)LUVW�PLJUDWH�WR�)RUPV�6HUYLFHV��L�:HE�GHSOR\PHQW�DQG�WKHQ�XSJUDGH�WR�2UDFOH�L$6��,Q�WKLV�ZD\��\RX�FDQ�GHDO�ZLWK�DQ\�2UDFOH�*UDSKLFV�:HE�PLJUDWLRQ�LVVXHV�LQ�WKH��L�HQYLURQPHQW�LQ�ZKLFK�\RX�VWLOO�KDYH�*UDSKLFV�%XLOGHU�DQG�WKH�&KDUW�:L]DUG��1HYHUWKHOHVV��LQ�WKH�VHFRQG�VWDJH��WKH�XSJUDGH�WR�2UDFOH�L$6��FKHFN�RXW�WKH�DSSHDUDQFH�RI�\RXU�FKDUWV�RQFH�DJDLQ�

Page 30: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�29

$33(1',;��

&RGH�IURP�$GG/HJHQG�RJG�

3URFHGXUH�2SHQ7ULJJHU�IURP�DGGOHJHQG�RJG�

PROCEDURE OpenTrigger IS

/******************************************************************************

** Ensure you have given the chart a name in the Chart Properties chart tab. **

** Assign this, in exactly the case it appears in the object navigator, **

** ’mychart’, not ’MyChart’ or ’MYCHART’ in this case. **

******************************************************************************/

vChartName VARCHAR2(30) := ’mychart’;

/*******************************************************************************

** vSubCategorySuffix should be set to the suffix of the name of all the data **

** bars, lines or columns as they appear in the object Navigator, it will be **

** of the format ’_{column_name}_lines’ or ’_{column_name}_bars’. In this **

** example they are named 20_SAL_lines, 30_SAL_lines etc, hence the suffix is **

** ’_SAL_lines’. The case must be exactly as it appears in the object **

** Navigator, so ’_SAL_lines’ not ’_Sal_lines’. **

*******************************************************************************/

vSubCategorySuffix VARCHAR2(30) := ’_SAL_lines’;

vChart OG_OBJECT := OG_GET_OBJECT(vChartName);

vChartQuery OG_QUERY := OG_GET_QUERY(vChart);

vSubCategoryPrefix VARCHAR2(30);

vSubCategoryGroupObject OG_OBJECT;

vColorQuery OG_QUERY := OG_GET_QUERY(’colors’);

vLegendItemPrefix VARCHAR2(30);

vTotal NUMBER;

BEGIN

/******************************************************************************

** Disable auto query execution so chart creation can be controlled from the **

** opentrigger. **

******************************************************************************/

OG_SET_EXECOPEN(vChartQuery, FALSE);

OG_SET_AUTOUPDATE(vChart, FALSE);

OG_EXECUTE_QUERY(vChartQuery);

/*******************************************************************************

** Updating the chart ensures that a group of data bars or a data line exists **

** for each of the subCategory groups, in this case depts 10, 20, 30 (and 40 **

** or 50 if employees in these departments had recently been created). **

*******************************************************************************/

Page 31: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�30

OG_UPDATE_CHART(vChart,OG_ALL_CHUPDA);

/***************************************************************************

** **

** This is this the likely place to insert any code already in the Open **

** Trigger **

** **

***************************************************************************/

/******************************************************************************

** Each of the SubCategory groups of data-representing bars or lines will be **

** named {SubCategory-column-value}_{SubCategory-column-name}_{lines-or-bars)**

** - in example they are named 10_SAL_lines, 20_SAL_lines etc. We need to **

** loop through each one and assign it a format trigger which will set their **

** color appropriately. **

** The SubCategory-column-values will be passed from Forms in the colors **

** query. **

******************************************************************************/

OG_EXECUTE_QUERY(vColorQuery);

OG_START_FROM(vColorQuery, OG_NEWDATA, 0);

vTotal := OG_NUMROWS(vColorQuery,OG_NEWDATA);

FOR i IN 0..vTotal-1 LOOP

vSubCategoryPrefix := OG_GET_CHARCELL(vColorQuery, ’LegendItem’);

vSubCategoryGroupObject := OG_GET_OBJECT(

vSubCategoryPrefix||vSubCategorySuffix);

IF NOT OG_ISNULL(vSubCategoryGroupObject) THEN

OG_SET_FMTTRIG(vSubCategoryGroupObject,’SETCOLOR’);

END IF;

OG_NEXT_ROW(vColorQuery, OG_NEWDATA);

END LOOP;

/***************************************************************************

** Update the data section of the chart to ensure the format trigger gets **

** fired on the data bars or lines. **

***************************************************************************/

OG_UPDATE_CHART(vChart,OG_INFRAME_CHUPDA);

END;

Page 32: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�31

&RGH�IURP�$GG/HJHQG�IPE�

3URFHGXUH�&UHDWH&KDUW$QG/HJHQG�IURP�DGGOHJHQG�IPE�

PROCEDURE CreateChartAndLegend IS

/**********************************************************

** Set RGChartQuery to match the chart query in your OGD **

**********************************************************/

RGChartQueryText VARCHAR(2000) := ’SELECT empno, deptno, sal FROM emp’;

/****************************************************************

** You may need to modify the default values for the following **

****************************************************************/

vOGDFile VARCHAR2(100) := :OGD;

vChartItem VARCHAR2(60) := ’chart_area6’; -- Chart item on the Form

vLegendItemHeight NUMBER := 16; -- Used for sizing Legend stacked canvas

vLegendTitleHeight NUMBER := 20; -- Used for sizing Legend stacked canvas

vChartQueryName VARCHAR2(30) := ’query0’;

/********************************************************************************

** DO NOT CHANGE the following two default values which should correspond to a **

** two-column query called ’colors’ in the OGD with column aliases of the same **

** names. Query should look like: **

** SELECT ’samplevalue’ legenditem, ’samplecolor’ color FROM dual. **

********************************************************************************/

RGLegendItemsColumnName VARCHAR(30) := ’legenditem’; -- column name alias

RGLegendColorColumnName VARCHAR(30) := ’color’; -- column name alias

/*****************************************************************************

** You will need to modify this query to retrieve and order a list of all **

** distinct values which will appear in the legend, i.e. the sub-category **

** column in the embedded OGD. **

** ENSURE the two column aliases, RGLegendItemsColumnName and **

** RGLegendColorColumnName, remain as they correspond to the colors query **

** in the OGD. **

*****************************************************************************/

RGLegendQueryText VARCHAR(2000) := ’SELECT DISTINCT TO_CHAR(deptno) ’

||RGLegendItemsColumnName ||’, ’

|| ’ ’’ XXXXXXWillBeUpdatedXXXXXX ’’ ’

|| RGLegendColorColumnName

|| ’ FROM emp ’

|| ’ ORDER BY ’ || RGLegendItemsColumnName;

RGChartQueryName VARCHAR(30) := ’ChartQuery’;

-- Record Group to populate the query on which chart is based

Page 33: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�32

RGChartQueryID RecordGroup;

RGLegendName VARCHAR(30) := ’LegendItems’;

-- Record Group of legend items and corresponding colors.

-- used in setting the colors of sub-category groups on the chart.

RGLegendID RecordGroup;

RGNameColumnID GroupColumn; -- Legend item names

RGColorColumnID GroupColumn; -- Legend item colors

vErrNo NUMBER;

vNumLegendItems NUMBER;

vParamList ParamList;

vParamListName VARCHAR2(30) := ’TheParamList’;

TYPE ColorTableType IS TABLE OF VARCHAR2(30) INDEX BY BINARY_INTEGER;

vColorTable ColorTableType;

BEGIN

/*******************************************************************************

** Ensure you have a visual attribute named after each of the following with **

** its background color matching its name. Add more rows if your legend could **

** exceed 10 items. **

*******************************************************************************/

vColorTable(1) := ’blue’;

vColorTable(2) := ’red’;

vColorTable(3) := ’green’;

vColorTable(4) := ’magenta’;

vColorTable(5) := ’yellow’;

vColorTable(6) := ’cyan’;

vColorTable(7) := ’darkblue’;

vColorTable(8) := ’darkred’;

vColorTable(9) := ’darkmagenta’;

vColorTable(10) := ’darkyellow’;

/***************************************************************************

** Populates RGLegendName and Legend Canvas with Legend items and colors. **

***************************************************************************/

GO_BLOCK(’Legend’);

CLEAR_BLOCK(NO_VALIDATE);

RGLegendID := Find_Group(RGLegendName);

IF NOT ID_NULL(RGLegendID) THEN

Delete_Group(RGLegendID);

END IF;

RGLegendID := Create_Group_From_Query(RGLegendName, RGLegendQueryText);

vErrNo := Populate_Group(RGLegendID);

vNumLegendItems := Get_Group_Row_Count(RGLegendID);

RGNameColumnID := Find_Column(RGLegendName||’.’||RGLegendItemsColumnName);

Page 34: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�33

RGColorColumnID := Find_Column(RGLegendName||’.’||RGLegendColorColumnName);

FOR i IN 1..vNumLegendItems LOOP

:Legend.Legend_Item_Name := Get_Group_Char_Cell(RGNameColumnID, i);

Set_Item_Instance_Property(’Legend.Legend_Item_Color’,i,

VISUAL_ATTRIBUTE, vColorTable(i));

Set_Group_Char_Cell(RGColorColumnID, i, vColorTable(i));

Next_Record;

END LOOP;

/*******************************************************************************

** Allow for height of legend title and each legend item in sizing the legend **

** stacked canvas, plus a small margin. **

*******************************************************************************/

SET_VIEW_PROPERTY(’Legend’,HEIGHT, vLegendTitleHeight +

(vLegendItemHeight * vNumLegendItems) + 2);

SET_VIEW_PROPERTY(’Legend’,VISIBLE, property_true);

SET_ITEM_PROPERTY(’XAxisLable’,VISIBLE, property_true);

SET_ITEM_PROPERTY(’YAxisLable’,VISIBLE, property_true);

/*****************************************

** Create the query data for the chart. **

*****************************************/

RGChartQueryID := Find_Group(RGChartQueryName);

IF NOT ID_NULL(RGChartQueryID) THEN

Delete_Group(RGChartQueryID);

END IF;

RGChartQueryID := Create_Group_From_Query(RGChartQueryName, RGChartQueryText);

vErrNo := Populate_Group(RGChartQueryID);

vParamList := GET_PARAMETER_LIST(vParamListName);

IF NOT ID_NULL(vParamList) THEN

DESTROY_PARAMETER_LIST(vParamListName);

END IF;

vParamList := CREATE_PARAMETER_LIST(vParamListName);

Add_Parameter(vParamList, vChartQueryName, DATA_PARAMETER, RGChartQueryName);

Add_Parameter(vParamList,’colors’ ,DATA_PARAMETER, RGLegendName);

/******************************************************************************

** Ensure you have CLIP - third parameter, set to TRUE. Size your chart item **

** so that it slightly exceeds the size of the chart as it appears in **

** Graphics Builder **

******************************************************************************/

OG.OPEN(vOGDFile, vChartItem, true, true, vParamList);

END;

Page 35: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�34

&RGH�IURP�6HW&RORUV�RJG�

3URFHGXUH�2SHQ7ULJJHU�IURP�VHWFRORUV�RJG�

PROCEDURE OpenTrigger IS

vChart OG_OBJECT := OG_GET_OBJECT(’mychart’);

vQuery OG_QUERY := OG_GET_QUERY(vChart);

BEGIN

/*

** Control query execution and chart update from the

** open trigger.

*/

OG_SET_EXECOPEN(vQuery, FALSE);

OG_SET_AUTOUPDATE(vChart, FALSE);

OG_EXECUTE_QUERY(vQuery);

/*

** Retain the Design time legend in updating the chart

*/

OG_UPDATE_CHART(vChart,OG_ALL_CHUPDA - OG_LEGEND_CHUPDA);

/*

** Get the colors in the legend and use these to color the

** data item groups.

*/

GetLegendColors;

END;

3URFHGXUH�6HW'DWD*URXS&RORU�IURP�VHWFRORUV�RJG�

PROCEDURE SetDataGroupColor(DataGroupNameIn IN VARCHAR2,

FFColorIn IN VARCHAR2,

BFColorIn IN VARCHAR2,

FEColorIn IN VARCHAR2,

BEColorIn IN VARCHAR2) IS

vDataGroup OG_OBJECT;

BEGIN

vDataGroup := OG_GET_OBJECT(DataGroupNameIn);

IF NOT OG_ISNULL(vDataGroup) THEN

OG_SET_FFCOLOR(vDataGroup, FFColorIn);

OG_SET_BFCOLOR(vDataGroup, BFColorIn);

OG_SET_FECOLOR(vDataGroup, FEColorIn);

OG_SET_BECOLOR(vDataGroup, BEColorIn);

END IF;

END;

Page 36: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�35

3URFHGXUH�*HW/HJHQG&RORUV�IURP�VHWFRORUV�RJG�

PROCEDURE GetLegendColors IS

vLegendGroup OG_OBJECT; -- group object for legend items

vNumChildren NUMBER; -- number of items in the legend

vChildIndex NUMBER;

vLegendText OG_OBJECT;

vLegendTextName VARCHAR2(30);

vLegendColorSample OG_OBJECT;

vBFColor VARCHAR2(30);

vFFColor VARCHAR2(30);

vBEColor VARCHAR2(30);

vFEColor VARCHAR2(30);

vDataGroupName VARCHAR2(30);

BEGIN

vLegendGroup := OG_GET_PARENT(OG_GET_OBJECT(’legend_frame’));

vNumChildren := OG_GET_CHILDCOUNT(vLegendGroup);

/*

** Skip vLegendGroup[0], which is the legend frame.

** Thereafter odd-numbered index items are text and

** even-numbered index items are color samples.

*/

vChildIndex := 1;

WHILE vChildIndex < vNumChildren LOOP

vLegendColorSample := OG_GET_CHILD(vLegendGroup, vChildIndex);

vFFColor := OG_GET_FFCOLOR(vLegendColorSample);

vBFColor := OG_GET_BFCOLOR(vLegendColorSample);

vFEColor := OG_GET_FECOLOR(vLegendColorSample);

vBEColor := OG_GET_BECOLOR(vLegendColorSample);

vChildIndex := vChildIndex + 1;

vLegendText := OG_GET_CHILD(vLegendGroup, vChildIndex);

vLegendTextName := REPLACE(OG_GET_NAME(vLegendText),’_legend_label’);

vChildIndex := vChildIndex + 1;

/*

** Data item groups are suffixed ’_bars’, ’_lines’ or ’_fills’.

** Set the colors for all possibilities. SetDataGroupColor does

** nothing if there is no group item corresponding to the

** object name it is passed.

*/

vDataGroupName := vLegendTextName||’_bars’;

SetDataGroupColor(vDataGroupName, vFFColor, vBFColor, vFEcolor, vBEColor);

vDataGroupName := vLegendTextName||’_lines’;

SetDataGroupColor(vDataGroupName, vFFColor, vBFColor, vFEcolor, vBEColor);

vDataGroupName := vLegendTextName||’_fills’;

Page 37: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�36

SetDataGroupColor(vDataGroupName, vFFColor, vBFColor, vFEcolor, vBEColor);

END LOOP;

END;

)857+(5�5($',1*�$1'�5()(5(1&(6

'HSOR\LQJ�LQWHUDFWLYH�FKDUWV�RQ�WKH�ZHE��PLJUDWLQJ�IURP�WKH�*UDSKLFV�&DUWULGJH�

$YDLODEOH�RQ�2UDFOH�7HFKQRORJ\�1HWZRUN��KWWS���RWQ�RUDFOH�FRP��6HH�´7LSV�DQG�7HFKQLTXHVµ�LQ�WKH�5HSRUWV�SURGXFW�VHFWLRQ��

,QWHJUDWLQJ�2UDFOH�K$6�5HSRUWV�LQ�2UDFOH�K$6�)RUPV�

$YDLODEOH�RQ�2UDFOH�7HFKQRORJ\�1HWZRUN��KWWS���RWQ�RUDFOH�FRP��6HH�´,QWHUQHW�'HSOR\PHQWµ�LQ�WKH�)RUPV�SURGXFW�VHFWLRQ��

Page 38: LQJ2UDFOH*UDSKLFVLQ 2UDFOH˝L$69 )RUPV6HUYLFHV˛€¦ · &grnq[kpi1cteng)tcrjkeukp1tceng k #58 (qtou5gtxkegu 2 ’hsor\lqj2udfoh*udsklfvlq2udfoh˝ l$6)rupv6huylfhv (;(&87,9(29(59,(:

&GRNQ[KPI�1TCENG�)TCRJKEU�KP�1TCENG�K#5�8��(QTOU�5GTXKEGU�37

:KLWH�3DSHU�7LWOH�

)HEUXDU\������

$XWKRU��'DYLG�.OHLQ�

&RQWULEXWLQJ�$XWKRUV��)UDQN�1LPSKLXV�

2UDFOH�&RUSRUDWLRQ�

:RUOG�+HDGTXDUWHUV�

����2UDFOH�3DUNZD\�

5HGZRRG�6KRUHV��&$������

8�6�$��

:RUOGZLGH�,QTXLULHV��

3KRQH������������������

)D[������������������

ZZZ�RUDFOH�FRP�

2UDFOH�LV�D�UHJLVWHUHG�WUDGHPDUN�RI�2UDFOH�&RUSRUDWLRQ��9DULRXV�

SURGXFW�DQG�VHUYLFH�QDPHV�UHIHUHQFHG�KHUHLQ�PD\�EH�WUDGHPDUNV�

RI�2UDFOH�&RUSRUDWLRQ��$OO�RWKHU�SURGXFW�DQG�VHUYLFH�QDPHV�

PHQWLRQHG�PD\�EH�WUDGHPDUNV�RI�WKHLU�UHVSHFWLYH�RZQHUV��

&RS\ULJKW��������2UDFOH�&RUSRUDWLRQ�

$OO�ULJKWV�UHVHUYHG��