Rev 2 | Only display areas with differences | Regard whitespace | Details | Blame | Last modification | View Log | RSS feed
| Rev 2 | Rev 18 | ||
|---|---|---|---|
| 1 | <div id="global_content"> |
1 | <div id="global_content"> |
| 2 | 2 | ||
| 3 | <TABLE cellspacing="0" cellpadding="0" border="0" width="100%"> |
3 | <TABLE cellspacing="0" cellpadding="0" border="0" width="100%"> |
| 4 | <TR> |
4 | <TR> |
| 5 | <TD height="20" colspan="3" valign="top" width="100%"> </TD> |
5 | <TD height="20" colspan="3" valign="top" width="100%"> </TD> |
| 6 | </TR> |
6 | </TR> |
| 7 | <TR> |
7 | <TR> |
| 8 | <TD height="40" valign="top" width="440"> |
8 | <TD height="40" valign="top" width="440"> |
| 9 | <span class="page_title"> |
9 | <span class="page_title"> |
| 10 | <font class="color_orange">Submit OID descriptions as XML files</font></span><br> |
10 | <font class="color_orange">Submit OID descriptions as XML files</font></span><br> |
| 11 | </TD> |
11 | </TD> |
| 12 | <TD height="40" valign="top" width="20"> </TD> |
12 | <TD height="40" valign="top" width="20"> </TD> |
| 13 | <TD width="150" height="40" valign="middle"> |
13 | <TD width="150" height="40" valign="middle"> |
| 14 | </TD> |
14 | </TD> |
| 15 | </TR> |
15 | </TR> |
| 16 | </TABLE> |
16 | </TABLE> |
| 17 | 17 | ||
| 18 | <TABLE cellspacing="0" cellpadding="0" border="0" width="100%"> |
18 | <TABLE cellspacing="0" cellpadding="0" border="0" width="100%"> |
| 19 | <TR> |
19 | <TR> |
| 20 | <TD width="10" valign="top"></TD> |
20 | <TD width="10" valign="top"></TD> |
| 21 | <TD valign="top" width="430"> |
21 | <TD valign="top" width="430"> |
| 22 | <P align="justify"> |
22 | <P align="justify"> |
| 23 | The form below provides for the submission of XML |
23 | The form below provides for the submission of XML |
| 24 | files containing OID descriptions conforming to the <a href="oid.xsd">XML |
24 | files containing OID descriptions conforming to the <a href="oid.xsd">XML |
| 25 | schema</a> of the OID repository. |
25 | schema</a> of the OID repository. |
| 26 | </P> |
26 | </P> |
| 27 | <ul> |
27 | <ul> |
| 28 | <li> |
28 | <li> |
| 29 | if the OID does not yet exist in the OID repository but its parent |
29 | if the OID does not yet exist in the OID repository but its parent |
| 30 | OID is described in the Repository, it is added but the description |
30 | OID is described in the Repository, it is added but the description |
| 31 | will not be visible until it is validated by the Repository administrator |
31 | will not be visible until it is validated by the Repository administrator |
| 32 | (a notification will be sent to you by email once this is done);<br></li> |
32 | (a notification will be sent to you by email once this is done);<br></li> |
| 33 | <li> |
33 | <li> |
| 34 | if the parent OID of the OID to be added does not yet exist in the |
34 | if the parent OID of the OID to be added does not yet exist in the |
| 35 | OID repository, the OID is said to be "<a href="faq.htm#orphan">orphan</a>," |
35 | OID repository, the OID is said to be "<a href="faq.htm#orphan">orphan</a>," |
| 36 | it will be added to the OID repository (after validation by the Repository |
36 | it will be added to the OID repository (after validation by the Repository |
| 37 | administrator) but will not be accessible for display to users who |
37 | administrator) but will not be accessible for display to users who |
| 38 | walk down the OID tree; <br></li> |
38 | walk down the OID tree; <br></li> |
| 39 | <li> |
39 | <li> |
| 40 | If the description corresponds to an OID which is already described |
40 | If the description corresponds to an OID which is already described |
| 41 | in the OID repository, it is ignored.<br></li> |
41 | in the OID repository, it is ignored.<br></li> |
| 42 | </ul> |
42 | </ul> |
| 43 | <p> |
43 | <p> |
| 44 | Please note that, if you submit a lot of XML descriptions, the time-out |
44 | Please note that, if you submit a lot of XML descriptions, the time-out |
| 45 | of your browser may be reached before the results are displayed on your |
45 | of your browser may be reached before the results are displayed on your |
| 46 | screen. In any case, the results will be sent to the email address indicated |
46 | screen. In any case, the results will be sent to the email address indicated |
| 47 | in the <tt><submitter></tt> part of the XML file. <br><br><font size="-1"> |
47 | in the <tt><submitter></tt> part of the XML file. <br><br><font size="-1"> |
| 48 | Note 1: Daniel Marschall has developed an <a href="https://www.viathinksoft.de/%7Edaniel-marschall/oid-repository/api/">Application |
48 | Note 1: Daniel Marschall has developed an <a href="https://www.viathinksoft.de/%7Edaniel-marschall/oid-repository/api/">Application |
| 49 | Programming Interface (API) in PHP</a> which can help developers in |
49 | Programming Interface (API) in PHP</a> which can help developers in |
| 50 | creating such XML files.<br></font><font size="-1"> |
50 | creating such XML files.<br></font><font size="-1"> |
| 51 | Note 2: If you have a text file gathering objects |
51 | Note 2: If you have a text file gathering objects |
| 52 | in a <a href="http://en.wikipedia.org/wiki/Management_information_base">Management |
52 | in a <a href="http://en.wikipedia.org/wiki/Management_information_base">Management |
| 53 | Information Base</a> (MIB), you can send it to the <a href="mailto:admin&oid-info.com">OID |
53 | Information Base</a> (MIB), you can send it to the <a href="mailto:admin&oid-info.com">OID |
| 54 | repository administrator</a> who has a tool to automatically extract |
54 | repository administrator</a> who has a tool to automatically extract |
| 55 | OIDs from such files. Please make sure that the top OID of your MIB |
55 | OIDs from such files. Please make sure that the top OID of your MIB |
| 56 | is defined in the file. |
56 | is defined in the file. |
| 57 | </font> |
57 | </font> |
| 58 | </p> |
58 | </p> |
| 59 | </TD> |
59 | </TD> |
| 60 | <TD width="20" valign="top"> </TD> |
60 | <TD width="20" valign="top"> </TD> |
| 61 | <TD width="150" valign="top"> |
61 | <TD width="150" valign="top"> |
| 62 | <p> |
62 | <p> |
| 63 | <img src="images/bullet.gif" width="10" height="8" border="0" align="bottom"><a href="oid.xsd">XML schema</a> for OID descriptions |
63 | <img src="images/bullet.gif" width="10" height="8" border="0" align="bottom"><a href="oid.xsd">XML schema</a> for OID descriptions |
| 64 | </p> |
64 | </p> |
| 65 | <p> |
65 | <p> |
| 66 | <a href="xhtml-light.xsd"><img src="images/bullet.gif" width="10" height="8" border="0" align="bottom">XML schema</a> for the allowed subset of XHTML |
66 | <a href="xhtml-light.xsd"><img src="images/bullet.gif" width="10" height="8" border="0" align="bottom">XML schema</a> for the allowed subset of XHTML |
| 67 | </p> |
67 | </p> |
| 68 | </TD> |
68 | </TD> |
| 69 | </TR> |
69 | </TR> |
| 70 | </TABLE> |
70 | </TABLE> |
| 71 | 71 | ||
| 72 | <FORM method="post" action="/cgi-bin/submit" enctype="multipart/form-data" name="submit"> |
72 | <FORM method="post" action="/cgi-bin/submit" enctype="multipart/form-data" name="submit"> |
| 73 | <TABLE cellspacing="0" cellpadding="0" border="0" width="600"> |
73 | <TABLE cellspacing="0" cellpadding="0" border="0" width="600"> |
| 74 | <TR> |
74 | <TR> |
| 75 | <TD valign="middle" width="390"> |
75 | <TD valign="middle" width="390"> |
| 76 | <FONT face="Arial, Helvetica, sans-serif" size="2"> |
76 | <FONT face="Arial, Helvetica, sans-serif" size="2"> |
| 77 | <B>File |
77 | <B>File |
| 78 | name</B>(a single XML file containing all the OID descriptions, or |
78 | name</B>(a single XML file containing all the OID descriptions, or |
| 79 | a zipped archive of XML files): |
79 | a zipped archive of XML files): |
| 80 | </FONT><FONT face="Arial, Helvetica, sans-serif" size="2"> |
80 | </FONT><FONT face="Arial, Helvetica, sans-serif" size="2"> |
| 81 | <BR><INPUT type="file" name="fichier" size="50"> |
81 | <BR><INPUT type="file" name="fichier" size="50"> |
| 82 | <INPUT type="submit" name="submit" value="Submit"></FONT><BR></TR> |
82 | <INPUT type="submit" name="submit" value="Submit"></FONT><BR></TR> |
| 83 | </TABLE> |
83 | </TABLE> |
| 84 | 84 | ||
| 85 | <TABLE border=0 cellspacing=0 cellpadding=0 width="600" dwcopytype="CopyTableRow"> |
85 | <TABLE border=0 cellspacing=0 cellpadding=0 width="600" dwcopytype="CopyTableRow"> |
| 86 | <!-- <tr> |
86 | <!-- <tr> |
| 87 | <td> </td> |
87 | <td> </td> |
| 88 | <td> </td> |
88 | <td> </td> |
| 89 | </tr> |
89 | </tr> |
| 90 | <tr> |
90 | <tr> |
| 91 | <td valign=top height="39" bgcolor="#CCCCCC"> |
91 | <td valign=top height="39" bgcolor="#CCCCCC"> |
| 92 | <input type="text" name="submit-email"><font face="Arial, Helvetica, sans-serif" size="-1"> </font></td> |
92 | <input type="text" name="submit-email"><font face="Arial, Helvetica, sans-serif" size="-1"> </font></td> |
| 93 | <td valign=CENTER width="454" height="19" bgcolor="#CCCCCC"> <font face="Arial, Helvetica, sans-serif" size="-1">Give |
93 | <td valign=CENTER width="454" height="19" bgcolor="#CCCCCC"> <font face="Arial, Helvetica, sans-serif" size="-1">Give |
| 94 | your email address if you want to receive an email with the results |
94 | your email address if you want to receive an email with the results |
| 95 | of your submission (when the submitted XML file is big, the time-out |
95 | of your submission (when the submitted XML file is big, the time-out |
| 96 | of your browser can be reached before the resulting webpage is produced |
96 | of your browser can be reached before the resulting webpage is produced |
| 97 | and you would then miss the resulting messages)</font></td> |
97 | and you would then miss the resulting messages)</font></td> |
| 98 | </tr> |
98 | </tr> |
| 99 | --> |
99 | --> |
| 100 | <TR> |
100 | <TR> |
| 101 | <TD> </TD> |
101 | <TD> </TD> |
| 102 | <TD> </TD> |
102 | <TD> </TD> |
| 103 | </TR> |
103 | </TR> |
| 104 | <tr> |
104 | <tr> |
| 105 | <td align=middle valign=top height="39" bgcolor="#CCCCCC"> |
105 | <td align=middle valign=top height="39" bgcolor="#CCCCCC"> |
| 106 | <input type="checkbox" name="ignoreNL" value="true"><font face="Arial, Helvetica, sans-serif" size="-1"> <tt>-ignoreNL</tt></font> |
106 | <input type="checkbox" name="ignoreNL" value="true"><font face="Arial, Helvetica, sans-serif" size="-1"> <tt>-ignoreNL</tt></font> |
| 107 | </td> |
107 | </td> |
| 108 | <td valign=CENTER width="454" height="19" bgcolor="#CCCCCC"> |
108 | <td valign=CENTER width="454" height="19" bgcolor="#CCCCCC"> |
| 109 | <font face="Arial, Helvetica, sans-serif" size="-1"> |
109 | <font face="Arial, Helvetica, sans-serif" size="-1"> |
| 110 | Ignore |
110 | Ignore |
| 111 | all newline characters used in text descriptions between XML tags. By |
111 | all newline characters used in text descriptions between XML tags. By |
| 112 | default, newline characters are turned into <tt><br></tt> elements |
112 | default, newline characters are turned into <tt><br></tt> elements |
| 113 | when displayed in HTML. When this box is checked, newline characters |
113 | when displayed in HTML. When this box is checked, newline characters |
| 114 | are replaced with a whitespace. |
114 | are replaced with a whitespace. |
| 115 | </font> |
115 | </font> |
| 116 | </td> |
116 | </td> |
| 117 | </tr> |
117 | </tr> |
| 118 | </TABLE> |
118 | </TABLE> |
| 119 | </FORM> |
119 | </FORM> |
| 120 | 120 | ||
| 121 | 121 | ||
| 122 | <p><a href="javascript: switchInfoPerso('xml_explanations');"><img src="images/Info.png" alt="" width="15" height="15"> See more detailed explanations</a></p> |
122 | <p><a href="javascript: switchInfoPerso('xml_explanations');"><img src="images/Info.png" alt="" width="15" height="15"> See more detailed explanations</a></p> |
| 123 | 123 | ||
| 124 | <TABLE cellspacing="0" cellpadding="0" border="0" width="100%" id="xml_explanations" style="display:none;"> |
124 | <TABLE cellspacing="0" cellpadding="0" border="0" width="100%" id="xml_explanations" style="display:none;"> |
| 125 | <TR> |
125 | <TR> |
| 126 | <TD width="10" valign="top"></TD> |
126 | <TD width="10" valign="top"></TD> |
| 127 | 127 | ||
| 128 | <TD valign="top" colspan="3"> |
128 | <TD valign="top" colspan="3"> |
| 129 | <p> |
129 | <p> |
| 130 | The example below is an XML document that conforms to our <a href="oid.xsd">XML |
130 | The example below is an XML document that conforms to our <a href="oid.xsd">XML |
| 131 | schema</a> and contains the description of one OID (namely, <tt> |
131 | schema</a> and contains the description of one OID (namely, <tt> |
| 132 | {joint-iso-itu-t(2) |
132 | {joint-iso-itu-t(2) |
| 133 | example(999) xml-submission(777)} |
133 | example(999) xml-submission(777)} |
| 134 | </tt>). |
134 | </tt>). |
| 135 | </p> |
135 | </p> |
| 136 | <ul> |
136 | <ul> |
| 137 | <li> |
137 | <li> |
| 138 | There can be more than one <tt><<b>oid</b>></tt> block per |
138 | There can be more than one <tt><<b>oid</b>></tt> block per |
| 139 | <tt><<b>oid-database</b>></tt> but only one <tt><<b>oid-database</b>></tt> |
139 | <tt><<b>oid-database</b>></tt> but only one <tt><<b>oid-database</b>></tt> |
| 140 | per XML file. |
140 | per XML file. |
| 141 | </li> |
141 | </li> |
| 142 | <li> |
142 | <li> |
| 143 | A father OID does not need to be described in the file prior to |
143 | A father OID does not need to be described in the file prior to |
| 144 | its child OIDs because the tool will sort the blocks before adding |
144 | its child OIDs because the tool will sort the blocks before adding |
| 145 | information to the OID repository. |
145 | information to the OID repository. |
| 146 | </li> |
146 | </li> |
| 147 | <li> |
147 | <li> |
| 148 | The <tt><font color="#009933"><submitter></font></tt> part |
148 | The <tt><font color="#009933"><submitter></font></tt> part |
| 149 | contains information about you. This information will not be displayed |
149 | contains information about you. This information will not be displayed |
| 150 | when people will query the OID repository. It is at that email address |
150 | when people will query the OID repository. It is at that email address |
| 151 | that you will receive the result of your XML submission. That email |
151 | that you will receive the result of your XML submission. That email |
| 152 | address will also be used to keep you informed if the OID descriptions |
152 | address will also be used to keep you informed if the OID descriptions |
| 153 | you submitted are updated in the future. |
153 | you submitted are updated in the future. |
| 154 | </li> |
154 | </li> |
| 155 | <li> |
155 | <li> |
| 156 | Note that a <a href="xhtml-light.xsd">subset</a> of <font color="#FF9933">XHTML</font> |
156 | Note that a <a href="xhtml-light.xsd">subset</a> of <font color="#FF9933">XHTML</font> |
| 157 | is allowed inside plain text for the <tt><description></tt>, |
157 | is allowed inside plain text for the <tt><description></tt>, |
| 158 | <tt><information></tt> and <tt><address></tt> elements. |
158 | <tt><information></tt> and <tt><address></tt> elements. |
| 159 | </li> |
159 | </li> |
| 160 | <li> |
160 | <li> |
| 161 | HTML entity references (such as "<tt>&eacute;</tt>") |
161 | HTML entity references (such as "<tt>&eacute;</tt>") |
| 162 | are not supported by default, so please use decimal codes (such as |
162 | are not supported by default, so please use decimal codes (such as |
| 163 | "<tt>&#233;</tt>") or include the needed <a href="http://www.w3.org/TR/xhtml1/DTD/xhtml-lat1.ent">XHTML |
163 | "<tt>&#233;</tt>") or include the needed <a href="http://www.w3.org/TR/xhtml1/DTD/xhtml-lat1.ent">XHTML |
| 164 | entity references</a> in a <tt><!DOCTYPE...></tt> block at the |
164 | entity references</a> in a <tt><!DOCTYPE...></tt> block at the |
| 165 | beginning of your XML document as follows:<br><font size="-1"> |
165 | beginning of your XML document as follows:<br><font size="-1"> |
| 166 | <tt> |
166 | <tt> |
| 167 | <!DOCTYPE oid-database[<br> <!ENTITY eacute "&#233;"> <!-- <i>latin small |
167 | <!DOCTYPE oid-database[<br> <!ENTITY eacute "&#233;"> <!-- <i>latin small |
| 168 | letter e with acute</i> --> <br> <!-- <i>please add <a href="http://www.w3.org/TR/xhtml1/DTD/xhtml-lat1.ent">XHTML |
168 | letter e with acute</i> --> <br> <!-- <i>please add <a href="http://www.w3.org/TR/xhtml1/DTD/xhtml-lat1.ent">XHTML |
| 169 | entity references</a> as needed</i> -->]> |
169 | entity references</a> as needed</i> -->]> |
| 170 | </tt> |
170 | </tt> |
| 171 | </font>. |
171 | </font>. |
| 172 | </li> |
172 | </li> |
| 173 | <li> |
173 | <li> |
| 174 | More detail about what is allowed for each XML tag is given as |
174 | More detail about what is allowed for each XML tag is given as |
| 175 | <tt><documentation></tt> tags in the <a href="oid.xsd">XML schema</a>. |
175 | <tt><documentation></tt> tags in the <a href="oid.xsd">XML schema</a>. |
| 176 | Please have a look at it.<br></li> |
176 | Please have a look at it.<br></li> |
| 177 | </ul> |
177 | </ul> |
| 178 | <font size="-1"> |
178 | <font size="-1"> |
| 179 | <tt> |
179 | <tt> |
| 180 | <<b>oid-database</b>><br><font color="#009933"> |
180 | <<b>oid-database</b>><br><font color="#009933"> |
| 181 | <submitter><br> <first-name>John</first-name><br> <last-name>Smith</last-name><br> <email>john.smith@myhost.com</email><br> </submitter> |
181 | <submitter><br> <first-name>John</first-name><br> <last-name>Smith</last-name><br> <email>john.smith@myhost.com</email><br> </submitter> |
| 182 | </font><br> <<b>oid</b>><br> <asn1-notation>{joint-iso-itu-t(2) example(999)<br> xml-submission(777)}</asn1-notation><br> <identifier>oid-repository</identifier><br> <description>Example of a description conforming |
182 | </font><br> <<b>oid</b>><br> <asn1-notation>{joint-iso-itu-t(2) example(999)<br> xml-submission(777)}</asn1-notation><br> <identifier>oid-repository</identifier><br> <description>Example of a description conforming |
| 183 | to the<br><font color="#FF9933"> |
183 | to the<br><font color="#FF9933"> |
| 184 | <a |
184 | <a |
| 185 | href="http://oid-info.com/oid.xsd"> |
185 | href="http://oid-info.com/oid.xsd"> |
| 186 | </font>XML Schema of the |
186 | </font>XML Schema of the |
| 187 | OID repository<font color="#FF9933"></a></font><br> </description><br> <information>More information can be found |
187 | OID repository<font color="#FF9933"></a></font><br> </description><br> <information>More information can be found |
| 188 | in<br><font color="#FF9933"> |
188 | in<br><font color="#FF9933"> |
| 189 | <a |
189 | <a |
| 190 | href="http://itu.int/ITU-T/X.660"> |
190 | href="https://itu.int/ITU-T/X.660"> |
| 191 | </font>Rec. ITU-T X.660<font color="#FF9933"></a></font>.<br> </information><br> <current-registrant><br> <first-name>John</first-name><br> <last-name>Doe</last-name><br> <email>john.doe@dummy.com</email><br> <address>Street Name<br> Town<br> Country<br> </address><br> <modification-date>2002-05-25</modification-date><br> </current-registrant><br> </<b>oid</b>><br></<b>oid-database</b>><br><br></tt> |
191 | </font>Rec. ITU-T X.660<font color="#FF9933"></a></font>.<br> </information><br> <current-registrant><br> <first-name>John</first-name><br> <last-name>Doe</last-name><br> <email>john.doe@dummy.com</email><br> <address>Street Name<br> Town<br> Country<br> </address><br> <modification-date>2002-05-25</modification-date><br> </current-registrant><br> </<b>oid</b>><br></<b>oid-database</b>><br><br></tt> |
| 192 | </font> . |
192 | </font> |
| 193 | </TD> |
193 | </TD> |
| 194 | </TR> |
194 | </TR> |
| 195 | </TABLE> |
195 | </TABLE> |
| 196 | <p>Once added to the OID repository, the above description |
196 | <p>Once added to the OID repository, the above description |
| 197 | will be displayed as shown on the <a href="display-example.htm">display |
197 | will be displayed as shown on the <a href="display-example.htm">display |
| 198 | example</a></p> |
198 | example</a>.</p> |
| 199 | 199 | ||
| 200 | 200 | ||
| 201 | </div> |
201 | </div> |
| 202 | 202 | ||