| <html xmlns:o="urn:schemas-microsoft-com:office:office" |
| xmlns:w="urn:schemas-microsoft-com:office:word" |
| xmlns="http://www.w3.org/TR/REC-html40"> |
| |
| <head> |
| <meta http-equiv=Content-Type content="text/html; charset=windows-1252"> |
| <meta name=ProgId content=Word.Document> |
| <meta name=Generator content="Microsoft Word 11"> |
| <meta name=Originator content="Microsoft Word 11"> |
| <title>DTP Connectivity Framework Quick Start Guide</title> |
| <!--[if gte mso 9]><xml> |
| <o:DocumentProperties> |
| <o:Author>Sybase, Inc.</o:Author> |
| <o:LastAuthor>Sybase, Inc.</o:LastAuthor> |
| <o:Revision>2</o:Revision> |
| <o:TotalTime>2</o:TotalTime> |
| <o:Created>2005-11-12T03:22:00Z</o:Created> |
| <o:LastSaved>2005-11-12T03:22:00Z</o:LastSaved> |
| <o:Pages>1</o:Pages> |
| <o:Words>2299</o:Words> |
| <o:Characters>13107</o:Characters> |
| <o:Company>CleanPackaging</o:Company> |
| <o:Lines>109</o:Lines> |
| <o:Paragraphs>30</o:Paragraphs> |
| <o:CharactersWithSpaces>15376</o:CharactersWithSpaces> |
| <o:Version>11.5606</o:Version> |
| </o:DocumentProperties> |
| </xml><![endif]--><!--[if gte mso 9]><xml> |
| <w:WordDocument> |
| <w:DoNotHyphenateCaps/> |
| <w:PunctuationKerning/> |
| <w:ValidateAgainstSchemas>false</w:ValidateAgainstSchemas> |
| <w:SaveIfXMLInvalid>false</w:SaveIfXMLInvalid> |
| <w:IgnoreMixedContent>false</w:IgnoreMixedContent> |
| <w:AlwaysShowPlaceholderText>false</w:AlwaysShowPlaceholderText> |
| <w:DoNotUnderlineInvalidXML/> |
| <w:Compatibility> |
| <w:SelectEntireFieldWithStartOrEnd/> |
| <w:UseWord2002TableStyleRules/> |
| </w:Compatibility> |
| <w:BrowserLevel>MicrosoftInternetExplorer4</w:BrowserLevel> |
| </w:WordDocument> |
| </xml><![endif]--><!--[if gte mso 9]><xml> |
| <w:LatentStyles DefLockedState="false" LatentStyleCount="156"> |
| </w:LatentStyles> |
| </xml><![endif]--> |
| <style> |
| <!-- |
| /* Font Definitions */ |
| @font-face |
| {font-family:Wingdings; |
| panose-1:5 0 0 0 0 0 0 0 0 0; |
| mso-font-charset:2; |
| mso-generic-font-family:auto; |
| mso-font-pitch:variable; |
| mso-font-signature:0 268435456 0 0 -2147483648 0;} |
| /* Style Definitions */ |
| p.MsoNormal, li.MsoNormal, div.MsoNormal |
| {mso-style-parent:""; |
| margin:0in; |
| margin-bottom:.0001pt; |
| mso-pagination:widow-orphan; |
| font-size:12.0pt; |
| font-family:"Times New Roman"; |
| mso-fareast-font-family:"Times New Roman";} |
| h1 |
| {mso-style-update:auto; |
| mso-style-next:Normal; |
| margin-top:12.0pt; |
| margin-right:0in; |
| margin-bottom:3.0pt; |
| margin-left:.55in; |
| text-indent:-.3in; |
| mso-pagination:widow-orphan; |
| page-break-after:avoid; |
| mso-outline-level:1; |
| mso-list:l13 level1 lfo19; |
| tab-stops:list .55in; |
| font-size:16.0pt; |
| font-family:Arial; |
| mso-font-kerning:16.0pt;} |
| h2 |
| {mso-style-update:auto; |
| mso-style-next:Normal; |
| margin-top:12.0pt; |
| margin-right:0in; |
| margin-bottom:3.0pt; |
| margin-left:.65in; |
| text-indent:-.4in; |
| mso-pagination:widow-orphan; |
| page-break-after:avoid; |
| mso-outline-level:2; |
| mso-list:l13 level2 lfo19; |
| tab-stops:list .65in; |
| font-size:14.0pt; |
| font-family:Arial; |
| font-style:italic;} |
| h3 |
| {mso-style-next:Normal; |
| margin-top:12.0pt; |
| margin-right:0in; |
| margin-bottom:3.0pt; |
| margin-left:.75in; |
| text-indent:-.5in; |
| mso-pagination:widow-orphan; |
| page-break-after:avoid; |
| mso-outline-level:3; |
| mso-list:l13 level3 lfo19; |
| tab-stops:list .75in; |
| font-size:13.0pt; |
| font-family:Arial;} |
| h4 |
| {mso-style-next:Normal; |
| margin-top:12.0pt; |
| margin-right:0in; |
| margin-bottom:3.0pt; |
| margin-left:.85in; |
| text-indent:-.6in; |
| mso-pagination:widow-orphan; |
| page-break-after:avoid; |
| mso-outline-level:4; |
| mso-list:l13 level4 lfo19; |
| tab-stops:list .85in; |
| font-size:14.0pt; |
| font-family:"Times New Roman";} |
| h5 |
| {mso-style-next:Normal; |
| margin-top:12.0pt; |
| margin-right:0in; |
| margin-bottom:3.0pt; |
| margin-left:.95in; |
| text-indent:-.7in; |
| mso-pagination:widow-orphan; |
| mso-outline-level:5; |
| mso-list:l13 level5 lfo19; |
| tab-stops:list .95in; |
| font-size:13.0pt; |
| font-family:"Times New Roman"; |
| font-style:italic;} |
| h6 |
| {mso-style-next:Normal; |
| margin-top:12.0pt; |
| margin-right:0in; |
| margin-bottom:3.0pt; |
| margin-left:1.05in; |
| text-indent:-.8in; |
| mso-pagination:widow-orphan; |
| mso-outline-level:6; |
| mso-list:l13 level6 lfo19; |
| tab-stops:list 1.05in; |
| font-size:11.0pt; |
| font-family:"Times New Roman";} |
| p.MsoHeading7, li.MsoHeading7, div.MsoHeading7 |
| {mso-style-next:Normal; |
| margin-top:12.0pt; |
| margin-right:0in; |
| margin-bottom:3.0pt; |
| margin-left:1.15in; |
| text-indent:-.9in; |
| mso-pagination:widow-orphan; |
| mso-outline-level:7; |
| mso-list:l13 level7 lfo19; |
| tab-stops:list 1.15in; |
| font-size:12.0pt; |
| font-family:"Times New Roman"; |
| mso-fareast-font-family:"Times New Roman";} |
| p.MsoHeading8, li.MsoHeading8, div.MsoHeading8 |
| {mso-style-next:Normal; |
| margin-top:12.0pt; |
| margin-right:0in; |
| margin-bottom:3.0pt; |
| margin-left:1.25in; |
| text-indent:-1.0in; |
| mso-pagination:widow-orphan; |
| mso-outline-level:8; |
| mso-list:l13 level8 lfo19; |
| tab-stops:list 1.25in; |
| font-size:12.0pt; |
| font-family:"Times New Roman"; |
| mso-fareast-font-family:"Times New Roman"; |
| font-style:italic;} |
| p.MsoHeading9, li.MsoHeading9, div.MsoHeading9 |
| {mso-style-next:Normal; |
| margin-top:12.0pt; |
| margin-right:0in; |
| margin-bottom:3.0pt; |
| margin-left:1.35in; |
| text-indent:-1.1in; |
| mso-pagination:widow-orphan; |
| mso-outline-level:9; |
| mso-list:l13 level9 lfo19; |
| tab-stops:list 1.35in; |
| font-size:11.0pt; |
| font-family:Arial; |
| mso-fareast-font-family:"Times New Roman";} |
| p.MsoTitle, li.MsoTitle, div.MsoTitle |
| {margin-top:12.0pt; |
| margin-right:0in; |
| margin-bottom:3.0pt; |
| margin-left:0in; |
| text-align:center; |
| mso-pagination:widow-orphan; |
| mso-outline-level:1; |
| font-size:24.0pt; |
| font-family:Arial; |
| mso-fareast-font-family:"Times New Roman"; |
| mso-font-kerning:14.0pt; |
| font-weight:bold;} |
| a:link, span.MsoHyperlink |
| {color:blue; |
| text-decoration:underline; |
| text-underline:single;} |
| a:visited, span.MsoHyperlinkFollowed |
| {color:purple; |
| text-decoration:underline; |
| text-underline:single;} |
| p.Code, li.Code, div.Code |
| {mso-style-name:Code; |
| mso-style-update:auto; |
| margin:0in; |
| margin-bottom:.0001pt; |
| mso-pagination:widow-orphan; |
| font-size:10.0pt; |
| font-family:"Courier New"; |
| mso-fareast-font-family:"Times New Roman";} |
| span.CodeChar |
| {mso-style-name:"Code Char"; |
| font-family:"Courier New"; |
| mso-ascii-font-family:"Courier New"; |
| mso-hansi-font-family:"Courier New"; |
| mso-bidi-font-family:"Courier New"; |
| mso-ansi-language:EN-US; |
| mso-fareast-language:EN-US;} |
| @page Section1 |
| {size:8.5in 11.0in; |
| margin:1.0in 1.25in 1.0in 1.25in; |
| mso-header-margin:.5in; |
| mso-footer-margin:.5in; |
| mso-paper-source:0;} |
| div.Section1 |
| {page:Section1;} |
| /* List Definitions */ |
| @list l0 |
| {mso-list-id:-132; |
| mso-list-type:simple; |
| mso-list-template-ids:-1497718988;} |
| @list l0:level1 |
| {mso-level-tab-stop:1.25in; |
| mso-level-number-position:left; |
| margin-left:1.25in; |
| text-indent:-.25in;} |
| @list l1 |
| {mso-list-id:-131; |
| mso-list-type:simple; |
| mso-list-template-ids:1869654438;} |
| @list l1:level1 |
| {mso-level-tab-stop:1.0in; |
| mso-level-number-position:left; |
| margin-left:1.0in; |
| text-indent:-.25in;} |
| @list l2 |
| {mso-list-id:-130; |
| mso-list-type:simple; |
| mso-list-template-ids:-1499317336;} |
| @list l2:level1 |
| {mso-level-tab-stop:.75in; |
| mso-level-number-position:left; |
| margin-left:.75in; |
| text-indent:-.25in;} |
| @list l3 |
| {mso-list-id:-129; |
| mso-list-type:simple; |
| mso-list-template-ids:-160370542;} |
| @list l3:level1 |
| {mso-level-tab-stop:.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in;} |
| @list l4 |
| {mso-list-id:-128; |
| mso-list-type:simple; |
| mso-list-template-ids:-1234381944;} |
| @list l4:level1 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:1.25in; |
| mso-level-number-position:left; |
| margin-left:1.25in; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l5 |
| {mso-list-id:-127; |
| mso-list-type:simple; |
| mso-list-template-ids:1856790098;} |
| @list l5:level1 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:1.0in; |
| mso-level-number-position:left; |
| margin-left:1.0in; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l6 |
| {mso-list-id:-126; |
| mso-list-type:simple; |
| mso-list-template-ids:-1863649932;} |
| @list l6:level1 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:.75in; |
| mso-level-number-position:left; |
| margin-left:.75in; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l7 |
| {mso-list-id:-125; |
| mso-list-type:simple; |
| mso-list-template-ids:991455398;} |
| @list l7:level1 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l8 |
| {mso-list-id:-120; |
| mso-list-type:simple; |
| mso-list-template-ids:-1789483062;} |
| @list l8:level1 |
| {mso-level-tab-stop:.25in; |
| mso-level-number-position:left; |
| margin-left:.25in; |
| text-indent:-.25in;} |
| @list l9 |
| {mso-list-id:-119; |
| mso-list-type:simple; |
| mso-list-template-ids:307132474;} |
| @list l9:level1 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:.25in; |
| mso-level-number-position:left; |
| margin-left:.25in; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l10 |
| {mso-list-id:111748955; |
| mso-list-type:hybrid; |
| mso-list-template-ids:476980380 1390160746 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;} |
| @list l10:level1 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l10:level2 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:.75in; |
| mso-level-number-position:left; |
| margin-left:.75in; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l10:level3 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:1.25in; |
| mso-level-number-position:left; |
| margin-left:1.25in; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l10:level4 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:1.75in; |
| mso-level-number-position:left; |
| margin-left:1.75in; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l10:level5 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:2.25in; |
| mso-level-number-position:left; |
| margin-left:2.25in; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l10:level6 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:2.75in; |
| mso-level-number-position:left; |
| margin-left:2.75in; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l10:level7 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:3.25in; |
| mso-level-number-position:left; |
| margin-left:3.25in; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l10:level8 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:3.75in; |
| mso-level-number-position:left; |
| margin-left:3.75in; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l10:level9 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:4.25in; |
| mso-level-number-position:left; |
| margin-left:4.25in; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l11 |
| {mso-list-id:220407916; |
| mso-list-type:hybrid; |
| mso-list-template-ids:-1097688924 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;} |
| @list l11:level1 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:1.0in; |
| mso-level-number-position:left; |
| margin-left:1.0in; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l11:level2 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:1.5in; |
| mso-level-number-position:left; |
| margin-left:1.5in; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l11:level3 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:2.0in; |
| mso-level-number-position:left; |
| margin-left:2.0in; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l11:level4 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:2.5in; |
| mso-level-number-position:left; |
| margin-left:2.5in; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l11:level5 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:3.0in; |
| mso-level-number-position:left; |
| margin-left:3.0in; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l11:level6 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:3.5in; |
| mso-level-number-position:left; |
| margin-left:3.5in; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l11:level7 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:4.0in; |
| mso-level-number-position:left; |
| margin-left:4.0in; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l11:level8 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:4.5in; |
| mso-level-number-position:left; |
| margin-left:4.5in; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l11:level9 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:5.0in; |
| mso-level-number-position:left; |
| margin-left:5.0in; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l12 |
| {mso-list-id:559291531; |
| mso-list-type:hybrid; |
| mso-list-template-ids:1486527768 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;} |
| @list l12:level1 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l12:level2 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:1.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l12:level3 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:1.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l12:level4 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:2.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l12:level5 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:2.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l12:level6 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:3.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l12:level7 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:3.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l12:level8 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:4.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l12:level9 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:4.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l13 |
| {mso-list-id:648442011; |
| mso-list-template-ids:1588597184;} |
| @list l13:level1 |
| {mso-level-style-link:"Heading 1"; |
| mso-level-text:%1; |
| mso-level-tab-stop:.55in; |
| mso-level-number-position:left; |
| margin-left:.55in; |
| text-indent:-.3in;} |
| @list l13:level2 |
| {mso-level-style-link:"Heading 2"; |
| mso-level-text:"%1\.%2"; |
| mso-level-tab-stop:.65in; |
| mso-level-number-position:left; |
| margin-left:.65in; |
| text-indent:-.4in;} |
| @list l13:level3 |
| {mso-level-style-link:"Heading 3"; |
| mso-level-text:"%1\.%2\.%3"; |
| mso-level-tab-stop:.75in; |
| mso-level-number-position:left; |
| margin-left:.75in; |
| text-indent:-.5in;} |
| @list l13:level4 |
| {mso-level-style-link:"Heading 4"; |
| mso-level-text:"%1\.%2\.%3\.%4"; |
| mso-level-tab-stop:.85in; |
| mso-level-number-position:left; |
| margin-left:.85in; |
| text-indent:-.6in;} |
| @list l13:level5 |
| {mso-level-style-link:"Heading 5"; |
| mso-level-text:"%1\.%2\.%3\.%4\.%5"; |
| mso-level-tab-stop:.95in; |
| mso-level-number-position:left; |
| margin-left:.95in; |
| text-indent:-.7in;} |
| @list l13:level6 |
| {mso-level-style-link:"Heading 6"; |
| mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6"; |
| mso-level-tab-stop:1.05in; |
| mso-level-number-position:left; |
| margin-left:1.05in; |
| text-indent:-.8in;} |
| @list l13:level7 |
| {mso-level-style-link:"Heading 7"; |
| mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7"; |
| mso-level-tab-stop:1.15in; |
| mso-level-number-position:left; |
| margin-left:1.15in; |
| text-indent:-.9in;} |
| @list l13:level8 |
| {mso-level-style-link:"Heading 8"; |
| mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8"; |
| mso-level-tab-stop:1.25in; |
| mso-level-number-position:left; |
| margin-left:1.25in; |
| text-indent:-1.0in;} |
| @list l13:level9 |
| {mso-level-style-link:"Heading 9"; |
| mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8\.%9"; |
| mso-level-tab-stop:1.35in; |
| mso-level-number-position:left; |
| margin-left:1.35in; |
| text-indent:-1.1in;} |
| @list l14 |
| {mso-list-id:848370878; |
| mso-list-template-ids:-911071030;} |
| @list l14:level1 |
| {mso-level-tab-stop:.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in;} |
| @list l14:level2 |
| {mso-level-number-format:alpha-lower; |
| mso-level-tab-stop:1.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in;} |
| @list l14:level3 |
| {mso-level-number-format:roman-lower; |
| mso-level-tab-stop:1.5in; |
| mso-level-number-position:right; |
| text-indent:-9.0pt;} |
| @list l14:level4 |
| {mso-level-tab-stop:2.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in;} |
| @list l14:level5 |
| {mso-level-number-format:alpha-lower; |
| mso-level-tab-stop:2.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in;} |
| @list l14:level6 |
| {mso-level-number-format:roman-lower; |
| mso-level-tab-stop:3.0in; |
| mso-level-number-position:right; |
| text-indent:-9.0pt;} |
| @list l14:level7 |
| {mso-level-tab-stop:3.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in;} |
| @list l14:level8 |
| {mso-level-number-format:alpha-lower; |
| mso-level-tab-stop:4.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in;} |
| @list l14:level9 |
| {mso-level-number-format:roman-lower; |
| mso-level-tab-stop:4.5in; |
| mso-level-number-position:right; |
| text-indent:-9.0pt;} |
| @list l15 |
| {mso-list-id:1065644895; |
| mso-list-type:hybrid; |
| mso-list-template-ids:1889939798 -772000116 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;} |
| @list l15:level1 |
| {mso-level-tab-stop:.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in;} |
| @list l15:level2 |
| {mso-level-number-format:alpha-lower; |
| mso-level-tab-stop:1.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in;} |
| @list l15:level3 |
| {mso-level-number-format:roman-lower; |
| mso-level-tab-stop:1.5in; |
| mso-level-number-position:right; |
| text-indent:-9.0pt;} |
| @list l15:level4 |
| {mso-level-tab-stop:2.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in;} |
| @list l15:level5 |
| {mso-level-number-format:alpha-lower; |
| mso-level-tab-stop:2.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in;} |
| @list l15:level6 |
| {mso-level-number-format:roman-lower; |
| mso-level-tab-stop:3.0in; |
| mso-level-number-position:right; |
| text-indent:-9.0pt;} |
| @list l15:level7 |
| {mso-level-tab-stop:3.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in;} |
| @list l15:level8 |
| {mso-level-number-format:alpha-lower; |
| mso-level-tab-stop:4.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in;} |
| @list l15:level9 |
| {mso-level-number-format:roman-lower; |
| mso-level-tab-stop:4.5in; |
| mso-level-number-position:right; |
| text-indent:-9.0pt;} |
| @list l16 |
| {mso-list-id:1119715156; |
| mso-list-type:hybrid; |
| mso-list-template-ids:897715254 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;} |
| @list l16:level1 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l16:level2 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:1.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l16:level3 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:1.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l16:level4 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:2.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l16:level5 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:2.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l16:level6 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:3.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l16:level7 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:3.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l16:level8 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:4.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l16:level9 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:4.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l17 |
| {mso-list-id:1158423639; |
| mso-list-template-ids:-1670240630;} |
| @list l17:level1 |
| {mso-level-text:%1; |
| mso-level-tab-stop:.3in; |
| mso-level-number-position:left; |
| margin-left:.3in; |
| text-indent:-.3in;} |
| @list l17:level2 |
| {mso-level-text:"%1\.%2"; |
| mso-level-tab-stop:.4in; |
| mso-level-number-position:left; |
| margin-left:.4in; |
| text-indent:-.4in;} |
| @list l17:level3 |
| {mso-level-text:"%1\.%2\.%3"; |
| mso-level-tab-stop:.5in; |
| mso-level-number-position:left; |
| margin-left:.5in; |
| text-indent:-.5in;} |
| @list l17:level4 |
| {mso-level-text:"%1\.%2\.%3\.%4"; |
| mso-level-tab-stop:.6in; |
| mso-level-number-position:left; |
| margin-left:.6in; |
| text-indent:-.6in;} |
| @list l17:level5 |
| {mso-level-text:"%1\.%2\.%3\.%4\.%5"; |
| mso-level-tab-stop:.7in; |
| mso-level-number-position:left; |
| margin-left:.7in; |
| text-indent:-.7in;} |
| @list l17:level6 |
| {mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6"; |
| mso-level-tab-stop:.8in; |
| mso-level-number-position:left; |
| margin-left:.8in; |
| text-indent:-.8in;} |
| @list l17:level7 |
| {mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7"; |
| mso-level-tab-stop:.9in; |
| mso-level-number-position:left; |
| margin-left:.9in; |
| text-indent:-.9in;} |
| @list l17:level8 |
| {mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8"; |
| mso-level-tab-stop:1.0in; |
| mso-level-number-position:left; |
| margin-left:1.0in; |
| text-indent:-1.0in;} |
| @list l17:level9 |
| {mso-level-text:"%1\.%2\.%3\.%4\.%5\.%6\.%7\.%8\.%9"; |
| mso-level-tab-stop:1.1in; |
| mso-level-number-position:left; |
| margin-left:1.1in; |
| text-indent:-1.1in;} |
| @list l18 |
| {mso-list-id:1250768220; |
| mso-list-type:hybrid; |
| mso-list-template-ids:-1409129900 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;} |
| @list l18:level1 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l18:level2 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:1.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l18:level3 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:1.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l18:level4 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:2.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l18:level5 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:2.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l18:level6 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:3.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l18:level7 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:3.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l18:level8 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:4.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l18:level9 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:4.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l19 |
| {mso-list-id:1319460181; |
| mso-list-type:hybrid; |
| mso-list-template-ids:2127745428 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;} |
| @list l19:level1 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l19:level2 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:1.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l19:level3 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:1.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l19:level4 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:2.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l19:level5 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:2.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l19:level6 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:3.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l19:level7 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:3.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l19:level8 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:4.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l19:level9 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:4.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l20 |
| {mso-list-id:1684935455; |
| mso-list-type:hybrid; |
| mso-list-template-ids:1693589938 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;} |
| @list l20:level1 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l20:level2 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:1.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l20:level3 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:1.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l20:level4 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:2.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l20:level5 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:2.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l20:level6 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:3.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l20:level7 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:3.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l20:level8 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:4.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l20:level9 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:4.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l21 |
| {mso-list-id:1905290458; |
| mso-list-type:hybrid; |
| mso-list-template-ids:618662720 1390160746 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;} |
| @list l21:level1 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:.75in; |
| mso-level-number-position:left; |
| margin-left:.75in; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l21:level2 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:1.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l21:level3 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:1.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l21:level4 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:2.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l21:level5 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:2.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l21:level6 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:3.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l21:level7 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:3.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l21:level8 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:4.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l21:level9 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:4.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l22 |
| {mso-list-id:2041317414; |
| mso-list-type:hybrid; |
| mso-list-template-ids:-1981365992 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;} |
| @list l22:level1 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l22:level2 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:1.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l22:level3 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:1.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l22:level4 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:2.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l22:level5 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:2.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l22:level6 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:3.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l22:level7 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:3.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l22:level8 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:4.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l22:level9 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:4.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l23 |
| {mso-list-id:2080707808; |
| mso-list-type:hybrid; |
| mso-list-template-ids:618662720 1390160746 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;} |
| @list l23:level1 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:.75in; |
| mso-level-number-position:left; |
| margin-left:.75in; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l23:level2 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:1.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l23:level3 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:1.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l23:level4 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:2.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l23:level5 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:2.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l23:level6 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:3.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| @list l23:level7 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0B7; |
| mso-level-tab-stop:3.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Symbol; |
| mso-bidi-font-family:Symbol;} |
| @list l23:level8 |
| {mso-level-number-format:bullet; |
| mso-level-text:o; |
| mso-level-tab-stop:4.0in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:"Courier New";} |
| @list l23:level9 |
| {mso-level-number-format:bullet; |
| mso-level-text:\F0A7; |
| mso-level-tab-stop:4.5in; |
| mso-level-number-position:left; |
| text-indent:-.25in; |
| font-family:Wingdings; |
| mso-bidi-font-family:Wingdings;} |
| ol |
| {margin-bottom:0in;} |
| ul |
| {margin-bottom:0in;} |
| --> |
| </style> |
| <!--[if gte mso 10]> |
| <style> |
| /* Style Definitions */ |
| table.MsoNormalTable |
| {mso-style-name:"Table Normal"; |
| mso-tstyle-rowband-size:0; |
| mso-tstyle-colband-size:0; |
| mso-style-noshow:yes; |
| mso-style-parent:""; |
| mso-padding-alt:0in 5.4pt 0in 5.4pt; |
| mso-para-margin:0in; |
| mso-para-margin-bottom:.0001pt; |
| mso-pagination:widow-orphan; |
| font-size:10.0pt; |
| font-family:"Times New Roman"; |
| mso-ansi-language:#0400; |
| mso-fareast-language:#0400; |
| mso-bidi-language:#0400;} |
| </style> |
| <![endif]--> |
| </head> |
| |
| <body lang=EN-US link=blue vlink=purple style='tab-interval:.5in'> |
| |
| <div class=Section1> |
| |
| <p class=MsoTitle>DTP Connectivity Framework</p> |
| |
| <p class=MsoTitle>Developers Quick Start Guide</p> |
| |
| <p class=MsoNormal><o:p> </o:p></p> |
| |
| <h1><![if !supportLists]><span style='mso-fareast-font-family:Arial'><span |
| style='mso-list:Ignore'>1<span style='font:7.0pt "Times New Roman"'> |
| </span></span></span><![endif]>Implementing a Connection Profile</h1> |
| |
| <p class=MsoNormal>Connection profiles are created by developers using the <span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.connectionProfile</span> |
| extension point.</p> |
| |
| <p class=MsoNormal><o:p> </o:p></p> |
| |
| <p class=MsoNormal>When implementing a connection profile extension, the |
| following additional elements should be specified:</p> |
| |
| <ul style='margin-top:0in' type=disc> |
| <li class=MsoNormal style='mso-list:l12 level1 lfo13;tab-stops:list .5in'><span |
| style='font-size:10.0pt;font-family:"Courier New"'>newWizard</span> used |
| for specifying the new wizard used to create instances of your profile</li> |
| <li class=MsoNormal style='mso-list:l12 level1 lfo13;tab-stops:list .5in'><span |
| style='font-size:10.0pt;font-family:"Courier New"'>connectionFactory</span> |
| (<span style='font-size:10.0pt;font-family:"Courier New"'>id=org.eclipse.datatools.connectivity.pingFactory</span>) |
| used for creating connections to servers represented by your profile</li> |
| <li class=MsoNormal style='mso-list:l12 level1 lfo13;tab-stops:list .5in'><span |
| style='font-size:10.0pt;font-family:"Courier New"'>propertyPage</span> (<span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.ui.propertyPages</span>) |
| used for editing the properties associated with your profile</li> |
| </ul> |
| |
| <p class=MsoNormal><o:p> </o:p></p> |
| |
| <p class=MsoNormal>In addition to the above elements, the following may be |
| specified:</p> |
| |
| <ul style='margin-top:0in' type=disc> |
| <li class=MsoNormal style='mso-list:l16 level1 lfo14;tab-stops:list .5in'><span |
| style='font-size:10.0pt;font-family:"Courier New"'>category</span> the |
| category under which instances of your profile should be displayed</li> |
| <li class=MsoNormal style='mso-list:l16 level1 lfo14;tab-stops:list .5in'><span |
| style='font-size:10.0pt;font-family:"Courier New"'>connectionFactory</span> |
| additional connection factories for your profile</li> |
| </ul> |
| |
| <p class=MsoNormal><o:p> </o:p></p> |
| |
| <p class=MsoNormal>The following base classes are provided to help implement |
| some of the above classes:</p> |
| |
| <ul style='margin-top:0in' type=disc> |
| <li class=MsoNormal style='mso-list:l22 level1 lfo15;tab-stops:list .5in'><span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.ui.wizards.NewConnectionProfileWizard</span> |
| use as a base class for implementing the new wizard associated with your |
| connection profile.<span style='mso-spacerun:yes'> </span>Override <span |
| style='font-size:10.0pt;font-family:"Courier New"'>addCustomPages()</span> |
| to add wizard pages for collecting the connection properties associated |
| with your profile.</li> |
| <li class=MsoNormal style='mso-list:l22 level1 lfo15;tab-stops:list .5in'><span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.ui.wizards.ConnectionProfileDetailsPage</span> |
| use as base class for implementing your custom wizard page.<span |
| style='mso-spacerun:yes'> </span>Comes complete with a button for testing |
| the connection using the properties specified on the page (functionality |
| is implemented using the <span style='font-size:10.0pt;font-family:"Courier New"'>pingFactory</span> |
| noted above).</li> |
| <li class=MsoNormal style='mso-list:l22 level1 lfo15;tab-stops:list .5in'><span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.VersionProviderConnection</span> |
| use as a base class for implementing your <span style='font-size:10.0pt; |
| font-family:"Courier New"'>IConnection</span> object.<span |
| style='mso-spacerun:yes'> </span>This class adds functionality for |
| querying and storing name and version information about the server.<span |
| style='mso-spacerun:yes'> </span>This information is displayed in the DSE |
| when connected and the property page.<span style='mso-spacerun:yes'> |
| </span>The <span style='font-size:10.0pt;font-family:"Courier New"'>pingFactory</span> |
| is used to collect this information (other connection factories are used |
| to specify technology name and version information).</li> |
| <li class=MsoNormal style='mso-list:l22 level1 lfo15;tab-stops:list .5in'><span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.DriverConnectionBase</span> |
| use as a base class for implementing your <span style='font-size:10.0pt; |
| font-family:"Courier New"'>IConnection</span> object.<span |
| style='mso-spacerun:yes'> </span>This takes care of locating the |
| referenced driver definition along with creating a <span style='font-size: |
| 10.0pt;font-family:"Courier New"'>ClassLoader</span> for loading the |
| relevant driver and connection classes.<span style='mso-spacerun:yes'> |
| </span>The base implementation assumes the driver definition ID is stored |
| in the connection profile using the property key, <span style='font-size: |
| 10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.driverDefinitionID</span>. |
| You can override <span style='font-size:10.0pt;font-family:"Courier New"'>getDriverDefinition()</span> |
| if you need to locate the driver definition some other way (e.g. different |
| key, hard-coded driver definition, etc.).<span style='mso-spacerun:yes'> |
| </span>This class is derived from <span style='font-size:10.0pt; |
| font-family:"Courier New"'>VersionProviderConnection</span>.<span |
| style='mso-spacerun:yes'> </span>Implement <span style='font-size:10.0pt; |
| font-family:"Courier New"'>initVersions()</span> to collect version |
| information (this method is invoked after a successful connection |
| attempt).</li> |
| </ul> |
| |
| <h1><![if !supportLists]><span style='mso-fareast-font-family:Arial'><span |
| style='mso-list:Ignore'>2<span style='font:7.0pt "Times New Roman"'> |
| </span></span></span><![endif]>Integrating with the Driver Definition Framework</h1> |
| |
| <p class=MsoNormal>For connection profiles capable of connecting to multiple |
| vendor implementations using a common set of connection properties, but whose |
| driver details differ, a driver definition can be used for describing these |
| properties.<span style='mso-spacerun:yes'> </span>A driver definition can be |
| referenced by each connection profile instance that connects to a specific server |
| type.<span style='mso-spacerun:yes'> </span>For example, a database connection |
| profile might reference a driver definition that defines the driver JAR files |
| and driver class required to open a connection.<span style='mso-spacerun:yes'> |
| </span>The connection profile itself would contain properties such as |
| connection URL, user ID and password.</p> |
| |
| <p class=MsoNormal><o:p> </o:p></p> |
| |
| <p class=MsoNormal>The connectivity framework provides a few utility classes |
| for integrating the driver definition framework into your connection profile.</p> |
| |
| <p class=MsoNormal><o:p> </o:p></p> |
| |
| <p class=MsoNormal><span style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.internal.ui.DriverListCombo</span> |
| can be used to add a control to your connection profile wizard or property page.<span |
| style='mso-spacerun:yes'> </span>Filters can be applied to the control so that |
| only driver definition meeting your requirements are displayed (e.g. only |
| driver definitions in the Database category).</p> |
| |
| <p class=MsoNormal><o:p> </o:p></p> |
| |
| <p class=MsoNormal><span style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.DriverConnectionBase</span> |
| can be used as a base class for your <span style='font-size:10.0pt;font-family: |
| "Courier New"'>IConnection</span> implementation.<span |
| style='mso-spacerun:yes'> </span>This class takes care of locating the driver |
| definition and creating a <span style='font-size:10.0pt;font-family:"Courier New"'>ClassLoader</span> |
| based on the JAR files specified in the driver definition.<span |
| style='mso-spacerun:yes'> </span>This class assumes the ID for the driver |
| definition is stored under the key, <span style='font-size:10.0pt;font-family: |
| "Courier New"'>org.eclipse.datatools.connectivity.driverDefinitionID</span> |
| (this property key is defined in <span style='font-size:10.0pt;font-family: |
| "Courier New"'>org.eclipse.datatools.connectivity.ConnectionProfileConstants.PROP_DRIVER_DEFINITION_ID</span>).<span |
| style='mso-spacerun:yes'> </span>(Note, this class also implements the <span |
| style='font-size:10.0pt;font-family:"Courier New"'>IServerVersionProvider</span> |
| interface, which is used by the framework for collecting the servers type name |
| and version (e.g. Adaptive Server Enterprise, 15.0.0.0).)</p> |
| |
| <h1><![if !supportLists]><span style='mso-fareast-font-family:Arial'><span |
| style='mso-list:Ignore'>3<span style='font:7.0pt "Times New Roman"'> |
| </span></span></span><![endif]>Implementing a Connection Factory</h1> |
| |
| <p class=MsoNormal>In general, a connection factory simply returns an <span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.IConnection</span> |
| instance.<span style='mso-spacerun:yes'> </span>This interface provides |
| consumers with methods for accessing generic capabilities common to most |
| connection types (e.g. <span style='font-size:10.0pt;font-family:"Courier New"'>close()</span> |
| is useful for closing connections whose raw type is unknown to the caller).<span |
| style='mso-spacerun:yes'> </span>(Note, this interface will be enhanced as new |
| connection management features are added to the connectivity framework.)</p> |
| |
| <p class=MsoNormal><o:p> </o:p></p> |
| |
| <p class=MsoNormal><span style='font-size:10.0pt;font-family:"Courier New"'>IConnection</span> |
| objects can also implement the <span style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.IServerVersionProvider</span> |
| interface.<span style='mso-spacerun:yes'> </span>This interface is used by the |
| framework for acquiring version information related to the server (e.g. server |
| name, Adaptive Server Enterprise;server version, 15.0;technology name, |
| JDBC;technology version, 3.0).<span style='mso-spacerun:yes'> </span><span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.VersionProviderConnection</span> |
| should be used as your base connection class if you wish to enable this |
| functionality for your connection.<span style='mso-spacerun:yes'> </span>This |
| base class takes care of updating the version properties stored with the |
| profile.<span style='mso-spacerun:yes'> </span>Refer to the Javadoc for more |
| information on using this class.</p> |
| |
| <p class=MsoNormal><o:p> </o:p></p> |
| |
| <p class=MsoNormal>When implementing a connection factory, it is recommended |
| that connection factories be identified using the object type returned by <span |
| style='font-size:10.0pt;font-family:"Courier New"'>IConnection.getRawConnection()</span> |
| (e.g. <span style='font-size:10.0pt;font-family:"Courier New"'>java.sql.Connection</span>).<span |
| style='mso-spacerun:yes'> </span>If this convention is used, consumers will |
| have a good idea what type of connection is returned by the factory.</p> |
| |
| <h1><![if !supportLists]><span style='mso-fareast-font-family:Arial'><span |
| style='mso-list:Ignore'>4<span style='font:7.0pt "Times New Roman"'> |
| </span></span></span><![endif]>Building Tooling around Connection Profiles</h1> |
| |
| <p class=MsoNormal>There are several options for integrating tooling components |
| with connection profiles.<span style='mso-spacerun:yes'> </span>Most involve |
| keying tooling components to specific properties of the profile.</p> |
| |
| <h2><![if !supportLists]><span style='mso-fareast-font-family:Arial'><span |
| style='mso-list:Ignore'>4.1<span style='font:7.0pt "Times New Roman"'> |
| </span></span></span><![endif]>Keying to Specific Connection Types</h2> |
| |
| <p class=MsoNormal>Tooling can be keyed to work with a specific type of |
| connection.<span style='mso-spacerun:yes'> </span>This is accomplished by |
| keying the tooling to a specific connection factory using the <span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.profile.property.factoryID</span> |
| filter property.</p> |
| |
| <p class=MsoNormal><o:p> </o:p></p> |
| |
| <p class=MsoNormal>The main benefit of keying to a connection factory is that |
| it decouples the tooling from any specific connection profile type.<span |
| style='mso-spacerun:yes'> </span>This allows the tooling to work with any type |
| of profile as long as the specified connection factory exists for the profile.</p> |
| |
| <p class=MsoNormal><o:p> </o:p></p> |
| |
| <p class=MsoNormal>If some portions of the tooling need to be customized for |
| working with specific profiles, it is recommended that the tooling provide |
| extension points that can be keyed to a specific profile type (see below).<span |
| style='mso-spacerun:yes'> </span>For example, providers can specify custom |
| catalog loaders for that support their specific databases.<span |
| style='mso-spacerun:yes'> </span>Another example would be overriding an action |
| for a specific profile type (in this case the action is provided by the generic |
| tooling and overridden for the specific profile by the profile provider).</p> |
| |
| <p class=MsoNormal><o:p> </o:p></p> |
| |
| <p class=MsoNormal>This is the preferred method for interacting with connection |
| profiles.</p> |
| |
| <h2><![if !supportLists]><span style='mso-fareast-font-family:Arial'><span |
| style='mso-list:Ignore'>4.2<span style='font:7.0pt "Times New Roman"'> |
| </span></span></span><![endif]>Keying to Specific Profile Types</h2> |
| |
| <p class=MsoNormal>Tooling can also be keyed for use with a specific type of |
| connection profile.<span style='mso-spacerun:yes'> </span>This is accomplished |
| by keying the tooling to specific profile type using the <span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.profile.property.id</span> |
| filter property.</p> |
| |
| <p class=MsoNormal><o:p> </o:p></p> |
| |
| <p class=MsoNormal>This option may be desirable if you know exactly which types |
| of profiles you wish to interact with, or if you wish to provide custom tooling |
| for a specific profile type.</p> |
| |
| <h2><![if !supportLists]><span style='mso-fareast-font-family:Arial'><span |
| style='mso-list:Ignore'>4.3<span style='font:7.0pt "Times New Roman"'> |
| </span></span></span><![endif]>Other Useful Profile Properties</h2> |
| |
| <p class=MsoNormal><span style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.IConnectionProfileActionFilter</span> |
| contains a full list of available properties for use in enabling tooling.</p> |
| |
| <h2><![if !supportLists]><span style='mso-fareast-font-family:Arial'><span |
| style='mso-list:Ignore'>4.4<span style='font:7.0pt "Times New Roman"'> |
| </span></span></span><![endif]>Accessing Connection Profiles</h2> |
| |
| <p class=MsoNormal><span style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.ProfileManager</span> |
| is provided for programmatically working with profile instances within the |
| workspace (e.g. <span style='font-size:10.0pt;font-family:"Courier New"'>createProfile()</span>, |
| <span class=CodeChar><span style='font-size:10.0pt'>deleteProfile()</span></span>, |
| <span style='font-size:10.0pt;font-family:"Courier New"'>getProfilesByCategory()</span>, |
| etc.).</p> |
| |
| <h1><![if !supportLists]><span style='mso-fareast-font-family:Arial'><span |
| style='mso-list:Ignore'>5<span style='font:7.0pt "Times New Roman"'> |
| </span></span></span><![endif]>Implementing a Content Extension for the DSE</h1> |
| |
| <p class=MsoNormal>You can display custom content for a connection profile in |
| the DSE using the common navigator extension, <span style='font-size:10.0pt; |
| font-family:"Courier New"'>org.eclipse.ui.navigator.navigatorContent</span> |
| (the common navigator framework is part of the Eclipse platform).</p> |
| |
| <p class=MsoNormal><o:p> </o:p></p> |
| |
| <p class=MsoNormal>Ideally, content extensions should be keyed toward using a |
| particular connection type.<span style='mso-spacerun:yes'> </span>This will |
| enable your contribution for any connection profile type, provided the required |
| connection factory type is implemented for that profile.</p> |
| |
| <p class=MsoNormal><span style='mso-spacerun:yes'> </span></p> |
| |
| <p class=MsoNormal>TODO: update helper classes once weve migrated them to the |
| platform navigator framework (<span style='font-size:10.0pt;font-family:"Courier New"'>ProfileNavigatorContentExtensionBase</span> |
| and <span style='font-size:10.0pt;font-family:"Courier New"'>ContentExtensionFactoryBase</span>)</p> |
| |
| <h1><![if !supportLists]><span style='mso-fareast-font-family:Arial'><span |
| style='mso-list:Ignore'>6<span style='font:7.0pt "Times New Roman"'> |
| </span></span></span><![endif]>Data Tools Connectivity Integration</h1> |
| |
| <p class=MsoNormal>The following sections detail how DTP is using the |
| connectivity framework for database connections.<span |
| style='mso-spacerun:yes'> </span>The <span style='font-size:10.0pt;font-family: |
| "Courier New"'>org.eclipse.datatools.connectivity.db.generic</span> plug-in |
| contains base implementations for creating wizard pages, property pages, and |
| connections specific to DB servers that can be connected to using JDBC.</p> |
| |
| <h2><![if !supportLists]><span style='mso-fareast-font-family:Arial'><span |
| style='mso-list:Ignore'>6.1<span style='font:7.0pt "Times New Roman"'> |
| </span></span></span><![endif]>Driver Definition Integration</h2> |
| |
| <p class=MsoNormal>The generic DB connection factory, wizard and property page |
| implementations are designed to work with driver definitions containing the |
| following properties:</p> |
| |
| <ul style='margin-top:0in' type=disc> |
| <li class=MsoNormal style='mso-list:l18 level1 lfo20;tab-stops:list .5in'><span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.db.driverClass</span> |
| the driver class name.</li> |
| <li class=MsoNormal style='mso-list:l18 level1 lfo20;tab-stops:list .5in'><span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.db.dbDefinition</span> |
| the location of a file containing dbdefinition model instance.<span |
| style='mso-spacerun:yes'> </span>(Note, this may be changing so that the |
| driver definition specifies a vendor name and version that is then used to |
| lookup the dbdefinition instance from the dbdefinition registry.)</li> |
| <li class=MsoNormal style='mso-list:l18 level1 lfo20;tab-stops:list .5in'><span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.db.defaultURL</span> |
| a default connection URL.<span style='mso-spacerun:yes'> </span>This is |
| used to initialize the wizard or property page when the driver definition |
| is selected.<span style='mso-spacerun:yes'> </span>This is an optional |
| property.</li> |
| <li class=MsoNormal style='mso-list:l18 level1 lfo20;tab-stops:list .5in'><span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.db.defaultUID</span> |
| a default user ID.<span style='mso-spacerun:yes'> </span>This is used |
| to initialize the wizard or property page when the driver definition is |
| selected.<span style='mso-spacerun:yes'> </span>This is an optional |
| property.</li> |
| <li class=MsoNormal style='mso-list:l18 level1 lfo20;tab-stops:list .5in'><span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.db.defaultPWD</span> |
| a default password.<span style='mso-spacerun:yes'> </span>This is used |
| to initialize the wizard or property page when the driver definition is |
| selected.<span style='mso-spacerun:yes'> </span>This is an optional |
| property.</li> |
| </ul> |
| |
| <p class=MsoNormal><o:p> </o:p></p> |
| |
| <p class=MsoNormal>All of the above property keys are defined in <span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.db.generic.IDBDriverDefinitionConstants</span>.</p> |
| |
| <h2><![if !supportLists]><span style='mso-fareast-font-family:Arial'><span |
| style='mso-list:Ignore'>6.2<span style='font:7.0pt "Times New Roman"'> |
| </span></span></span><![endif]>Connection Profile Implementations</h2> |
| |
| <p class=MsoNormal>The generic DB connection factory, wizard and property page |
| implementations are designed to work with connection profiles containing the |
| following properties:</p> |
| |
| <ul style='margin-top:0in' type=disc> |
| <li class=MsoNormal style='mso-list:l18 level1 lfo20;tab-stops:list .5in'><span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.db.connectURL</span> |
| the connection URL.</li> |
| <li class=MsoNormal style='mso-list:l18 level1 lfo20;tab-stops:list .5in'><span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.db.connectionProperties</span> |
| additional JDBC connection properties.<span style='mso-spacerun:yes'> |
| </span>This is a comma separated list of name-value pairs.<span |
| style='mso-spacerun:yes'> </span>These are passed as the property |
| argument to <span style='font-size:10.0pt;font-family:"Courier New"'>java.sql.Driver.connect()</span>.</li> |
| <li class=MsoNormal style='mso-list:l18 level1 lfo20;tab-stops:list .5in'><span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.uid</span> |
| the user ID.</li> |
| <li class=MsoNormal style='mso-list:l18 level1 lfo20;tab-stops:list .5in'><span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.pwd</span> |
| the password.</li> |
| <li class=MsoNormal style='mso-list:l18 level1 lfo20;tab-stops:list .5in'><span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.driverDefinitionID</span> |
| the driver definition ID.</li> |
| </ul> |
| |
| <p class=MsoNormal><o:p> </o:p></p> |
| |
| <p class=MsoNormal>The first two property keys are defined in <span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.db.generic.IDBConnectionProfileConstants</span>.<span |
| style='mso-spacerun:yes'> </span>The remaining property keys are defined in <span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.ConnectionProfileConstants</span>.</p> |
| |
| <h2><![if !supportLists]><span style='mso-fareast-font-family:Arial'><span |
| style='mso-list:Ignore'>6.3<span style='font:7.0pt "Times New Roman"'> |
| </span></span></span><![endif]>Connection Factory Implementations</h2> |
| |
| <p class=MsoNormal>The following connection factory implementations are |
| provided:</p> |
| |
| <ul style='margin-top:0in' type=disc> |
| <li class=MsoNormal style='mso-list:l20 level1 lfo21;tab-stops:list .5in'><span |
| style='font-size:10.0pt;font-family:"Courier New"'>java.sql.Connection</span> |
| used for creating JDBC connections.</li> |
| <li class=MsoNormal style='mso-list:l20 level1 lfo21;tab-stops:list .5in'><span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.modelbase.sql.schema.Database</span> |
| used for creating a SQL model connection.<span |
| style='mso-spacerun:yes'> </span>(Note, this is subject to change.<span |
| style='mso-spacerun:yes'> </span>This connection type will most likely |
| wrap a <span style='font-size:10.0pt;font-family:"Courier New"'>java.sql.Connection</span> |
| object.<span style='mso-spacerun:yes'> </span>We will be considering |
| mechanisms for chaining connection factories together as part of the |
| connection management design.)</li> |
| <li class=MsoNormal style='mso-list:l20 level1 lfo21;tab-stops:list .5in'><span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.oda.IConnection</span> |
| used for creating ODA connections.<span style='mso-spacerun:yes'> |
| </span>(Note, once again, this connection type will most likely wrap a <span |
| style='font-size:10.0pt;font-family:"Courier New"'>java.sql.Connection</span> |
| object.)</li> |
| </ul> |
| |
| <p class=MsoNormal><o:p> </o:p></p> |
| |
| <p class=MsoNormal>Ideally these IDs should be obtained programmatically using |
| the class name (e.g. <span style='font-size:10.0pt;font-family:"Courier New"'>java.sql.Connection.class.getName()</span>).</p> |
| |
| <h1><![if !supportLists]><span style='mso-fareast-font-family:Arial'><span |
| style='mso-list:Ignore'>7<span style='font:7.0pt "Times New Roman"'> |
| </span></span></span><![endif]>Implementing an Open Data Access (ODA) Extension</h1> |
| |
| <p class=MsoNormal>The Open Data Access (ODA) component is an open and flexible |
| data access framework that provides a common way for a consumer application to |
| access data from heterogeneous data sources.<span style='mso-spacerun:yes'> |
| </span>The DTP ODA framework is actively consumed by the <a |
| href="http://www.eclipse.org/birt">Eclipse BIRT project</a>.</p> |
| |
| <p class=MsoNormal>See this link for an overview of the ODA framework and its |
| scope of functionalities:</p> |
| |
| <p class=MsoNormal><a |
| href="http://www.eclipse.org/datatools/project_connectivity/connectivity_doc/OdaOverview.htm">http://www.eclipse.org/datatools/project_connectivity/connectivity_doc/OdaOverview.htm</a></p> |
| |
| <p class=MsoNormal><o:p> </o:p></p> |
| |
| <p class=MsoNormal>The following ODA plug-ins are included in the current DTP |
| Milestone 1 build:</p> |
| |
| <ul style='margin-top:0in' type=disc> |
| <li class=MsoNormal style='mso-list:l10 level1 lfo22;tab-stops:list .5in'><span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.oda</span> |
| the ODA run-time framework</li> |
| <li class=MsoNormal style='mso-list:l10 level1 lfo22;tab-stops:list .5in'><span |
| style='font-size:10.0pt;font-family:"Courier New"'>org.eclipse.datatools.connectivity.oda.flatfile</span><span |
| style='font-size:10.0pt;font-family:Arial'> </span> <span |
| style='font-size:10.0pt;font-family:Arial'><span |
| style='mso-spacerun:yes'> </span></span>a Flat File data source provider, |
| which serves as an exemplary implementation of the ODA extension point and |
| run-time interfaces. </li> |
| </ul> |
| |
| <p class=MsoNormal style='margin-left:.5in'>Additional DTP ODA data source |
| plug-ins can be found in the Eclipse BIRT project source tree in CVS, and are |
| available in the BIRT download builds: <a |
| href="http://download.eclipse.org/birt/downloads/">http://download.eclipse.org/birt/downloads/</a> |
| .</p> |
| |
| <p class=MsoNormal><o:p> </o:p></p> |
| |
| <p class=MsoNormal>The ODA framework will be integrated with the Connection |
| Profiles in Milestone 2.<span style='mso-spacerun:yes'> </span>More details |
| will be provided then.</p> |
| |
| <p class=MsoNormal><span style='mso-spacerun:yes'> </span></p> |
| |
| <p class=MsoNormal>When implementing a custom ODA data source provider, the |
| plug-in extension must implement the <span style='font-size:10.0pt;font-family: |
| "Courier New"'>org.eclipse.datatools.connectivity.oda.dataSource</span> |
| extension point.<span style='mso-spacerun:yes'> </span></p> |
| |
| <p class=MsoNormal>See the schema and documentation defined in <span |
| style='font-size:10.0pt;font-family:"Courier New"'>datasource.exsd</span>.</p> |
| |
| <p class=MsoNormal><o:p> </o:p></p> |
| |
| <p class=MsoNormal>The ODA extension point defines a <span style='font-size: |
| 10.0pt;font-family:"Courier New"'>driverClass</span> attribute in the <span |
| style='font-size:10.0pt;font-family:"Courier New"'>dataSource</span> |
| element.<span style='mso-spacerun:yes'> </span>It serves as <span |
| style='color:black;background:white;mso-highlight:white'>the entry point to an |
| ODA driver that implements the ODA run-time interfaces.</span><span |
| style='color:black'><span style='mso-spacerun:yes'> </span>A custom ODA |
| implementation has a high degree of flexibility on the scope of functionalities |
| it wants to provide.<span style='mso-spacerun:yes'> </span>A good number of |
| the interface methods are optional, and can simply throw an |
| UnsupportedOperationException.<span style='mso-spacerun:yes'> </span><o:p></o:p></span></p> |
| |
| <p class=MsoNormal><span style='color:black'>Below are the required ODA |
| run-time interfaces, defined in the </span><span style='font-size:10.0pt; |
| font-family:"Courier New"'>org.eclipse.datatools.connectivity.oda</span> <span |
| style='color:black'>package.<span style='mso-spacerun:yes'> </span>See the |
| package's Javadoc documentation for more information.<o:p></o:p></span></p> |
| |
| <p class=MsoNormal><span style='color:black'><o:p> </o:p></span></p> |
| |
| <p class=MsoNormal style='margin-left:.75in;text-indent:-.25in;mso-list:l23 level1 lfo23; |
| tab-stops:list .75in'><![if !supportLists]><span style='font-size:10.0pt; |
| font-family:Symbol;mso-fareast-font-family:Symbol;mso-bidi-font-family:Symbol; |
| color:black'><span style='mso-list:Ignore'>·<span style='font:7.0pt "Times New Roman"'> |
| </span></span></span><![endif]><span style='font-size:10.0pt;font-family:"Courier New"; |
| color:black'>IDriver </span> The entry point to a custom ODA run-time drivers |
| implementation<span style='font-size:10.0pt;font-family:"Courier New"; |
| color:black'><o:p></o:p></span></p> |
| |
| <p class=MsoNormal style='margin-left:.75in;text-indent:-.25in;mso-list:l23 level1 lfo23; |
| tab-stops:list .75in'><![if !supportLists]><span style='font-size:10.0pt; |
| font-family:Symbol;mso-fareast-font-family:Symbol;mso-bidi-font-family:Symbol; |
| color:black'><span style='mso-list:Ignore'>·<span style='font:7.0pt "Times New Roman"'> |
| </span></span></span><![endif]><span style='font-size:10.0pt;font-family:"Courier New"; |
| color:black'>IConnection </span> <span style='color:black'>Establishes a live |
| connection to the underlying data provider</span><span style='font-size:10.0pt; |
| font-family:"Courier New";color:black'><o:p></o:p></span></p> |
| |
| <p class=MsoNormal style='margin-left:.75in;text-indent:-.25in;mso-list:l23 level1 lfo23; |
| tab-stops:list .75in'><![if !supportLists]><span style='font-size:10.0pt; |
| font-family:Symbol;mso-fareast-font-family:Symbol;mso-bidi-font-family:Symbol; |
| color:black'><span style='mso-list:Ignore'>·<span style='font:7.0pt "Times New Roman"'> |
| </span></span></span><![endif]><span style='font-size:10.0pt;font-family:"Courier New"; |
| color:black'>IQuery </span> Prepares and executes a query text to return data |
| in an <span style='font-size:10.0pt;font-family:"Courier New"'>IResultSet</span> |
| <span style='font-size:10.0pt;font-family:"Courier New";color:black'><o:p></o:p></span></p> |
| |
| <p class=MsoNormal style='margin-left:.75in;text-indent:-.25in;mso-list:l23 level1 lfo23; |
| tab-stops:list .75in'><![if !supportLists]><span style='font-size:10.0pt; |
| font-family:Symbol;mso-fareast-font-family:Symbol;mso-bidi-font-family:Symbol; |
| color:black'><span style='mso-list:Ignore'>·<span style='font:7.0pt "Times New Roman"'> |
| </span></span></span><![endif]><span style='font-size:10.0pt;font-family:"Courier New"; |
| color:black'>IResultSet </span> Used to access a set of data rows retrieved by |
| an <span style='font-size:10.0pt;font-family:"Courier New"'>IQuery</span> |
| instance<span style='font-size:10.0pt;font-family:"Courier New";color:black'><o:p></o:p></span></p> |
| |
| <p class=MsoNormal style='margin-left:.75in;text-indent:-.25in;mso-list:l23 level1 lfo23; |
| tab-stops:list .75in'><![if !supportLists]><span style='font-size:10.0pt; |
| font-family:Symbol;mso-fareast-font-family:Symbol;mso-bidi-font-family:Symbol; |
| color:black'><span style='mso-list:Ignore'>·<span style='font:7.0pt "Times New Roman"'> |
| </span></span></span><![endif]><span style='font-size:10.0pt;font-family:"Courier New"; |
| color:black'>IResultSetMetaData </span><span style='color:black'> Represents |
| the meta-data of an </span><span style='font-size:10.0pt;font-family:"Courier New"'>IResultSet</span><span |
| style='color:black'> instance</span><span style='font-size:10.0pt;font-family: |
| "Courier New";color:black'><o:p></o:p></span></p> |
| |
| <p class=MsoNormal style='margin-left:.75in;text-indent:-.25in;mso-list:l23 level1 lfo23; |
| tab-stops:list .75in'><![if !supportLists]><span style='font-size:10.0pt; |
| font-family:Symbol;mso-fareast-font-family:Symbol;mso-bidi-font-family:Symbol; |
| color:black'><span style='mso-list:Ignore'>·<span style='font:7.0pt "Times New Roman"'> |
| </span></span></span><![endif]><span style='font-size:10.0pt;font-family:"Courier New"; |
| color:black'>IDataSetMetaData </span> Provides comprehensive information on |
| the drivers capabilities for each type of data set query<span |
| style='font-size:10.0pt;font-family:"Courier New";color:black'><o:p></o:p></span></p> |
| |
| <p class=MsoNormal style='margin-left:.75in;text-indent:-.25in;mso-list:l23 level1 lfo23; |
| tab-stops:list .75in'><![if !supportLists]><span style='font-size:10.0pt; |
| font-family:Symbol;mso-fareast-font-family:Symbol;mso-bidi-font-family:Symbol; |
| color:black'><span style='mso-list:Ignore'>·<span style='font:7.0pt "Times New Roman"'> |
| </span></span></span><![endif]><span style='font-size:10.0pt;font-family:"Courier New"; |
| color:black'>IParameterMetaData</span><span style='color:black'> Represents |
| the meta-data of input/output parameters defined in a prepared query; required |
| only if the driver supports query parameters</span><span style='font-size:10.0pt; |
| font-family:"Courier New";color:black'><o:p></o:p></span></p> |
| |
| <p class=MsoNormal><span style='color:black'><o:p> </o:p></span></p> |
| |
| <p class=MsoNormal><span style='color:black'>To aid in the development of a |
| custom ODA driver, a set of default implementation of the main ODA runtime |
| interfaces is provided in the </span><span style='font-size:10.0pt;font-family: |
| "Courier New"'>org.eclipse.datatools.connectivity.oda.impl</span><span |
| style='color:black'> package. These classes assume the behavior of a simple ODA |
| driver, and have labeled TODO tasks for a driver developer to add on data |
| source-specific behavior.<span style='mso-spacerun:yes'> </span>These concrete |
| classes are provided as an aid only, for use as templates or base classes; |
| their use is purely optional.<o:p></o:p></span></p> |
| |
| <p class=MsoNormal><o:p> </o:p></p> |
| |
| <p class=MsoNormal><o:p> </o:p></p> |
| |
| </div> |
| |
| </body> |
| |
| </html> |
