WebSVN – oidinfo_new_design – Blame – /trunk/submit.raw.htm

Rev	Author	Line No.	Line
2	daniel-mar	1	<div id="global_content">
		2
		3	<TABLE cellspacing="0" cellpadding="0" border="0" width="100%">
		4	<TR>
		5	<TD height="20" colspan="3" valign="top" width="100%"> </TD>
		6	</TR>
		7	<TR>
		8	<TD height="40" valign="top" width="440">
		9	<span class="page_title">
		10	<font class="color_orange">Submit OID descriptions as XML files</font></span><br>
		11	</TD>
		12	<TD height="40" valign="top" width="20"> </TD>
		13	<TD width="150" height="40" valign="middle">
		14	</TD>
		15	</TR>
		16	</TABLE>
		17
		18	<TABLE cellspacing="0" cellpadding="0" border="0" width="100%">
		19	<TR>
		20	<TD width="10" valign="top"></TD>
		21	<TD valign="top" width="430">
		22	<P align="justify">
		23	The form below provides for the submission of XML
		24	files containing OID descriptions conforming to the <a href="oid.xsd">XML
		25	schema</a> of the OID repository.
		26	</P>
		27	<ul>
		28	<li>
		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
		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>
		33	<li>
		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>,"
		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
		38	walk down the OID tree; <br></li>
		39	<li>
		40	If the description corresponds to an OID which is already described
		41	in the OID repository, it is ignored.<br></li>
		42	</ul>
		43	<p>
		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
		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">
		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
		50	creating such XML files.<br></font><font size="-1">
		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
		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
		55	OIDs from such files. Please make sure that the top OID of your MIB
		56	is defined in the file.
		57	</font>
		58	</p>
		59	</TD>
		60	<TD width="20" valign="top"> </TD>
		61	<TD width="150" valign="top">
		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
		64	</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
		67	</p>
		68	</TD>
		69	</TR>
		70	</TABLE>
		71
		72	<FORM method="post" action="/cgi-bin/submit" enctype="multipart/form-data" name="submit">
		73	<TABLE cellspacing="0" cellpadding="0" border="0" width="600">
		74	<TR>
		75	<TD valign="middle" width="390">
		76	<FONT face="Arial, Helvetica, sans-serif" size="2">
		77	<B>File
		78	name</B>(a single XML file containing all the OID descriptions, or
		79	a zipped archive of XML files):
		80	</FONT><FONT face="Arial, Helvetica, sans-serif" size="2">
		81	<BR><INPUT type="file" name="fichier" size="50">
		82	<INPUT type="submit" name="submit" value="Submit"></FONT><BR></TR>
		83	</TABLE>
		84
		85	<TABLE border=0 cellspacing=0 cellpadding=0 width="600" dwcopytype="CopyTableRow">
		86	<!-- <tr>
		87	<td> </td>
		88	<td> </td>
		89	</tr>
		90	<tr>
		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>
		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
		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
		97	and you would then miss the resulting messages)</font></td>
		98	</tr>
		99	-->
		100	<TR>
		101	<TD> </TD>
		102	<TD> </TD>
		103	</TR>
		104	<tr>
		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>
		107	</td>
		108	<td valign=CENTER width="454" height="19" bgcolor="#CCCCCC">
		109	<font face="Arial, Helvetica, sans-serif" size="-1">
		110	Ignore
		111	all newline characters used in text descriptions between XML tags. By
		112	default, newline characters are turned into <tt><br></tt> elements
		113	when displayed in HTML. When this box is checked, newline characters
		114	are replaced with a whitespace.
		115	</font>
		116	</td>
		117	</tr>
		118	</TABLE>
		119	</FORM>
		120
		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>
		123
		124	<TABLE cellspacing="0" cellpadding="0" border="0" width="100%" id="xml_explanations" style="display:none;">
		125	<TR>
		126	<TD width="10" valign="top"></TD>
		127
		128	<TD valign="top" colspan="3">
		129	<p>
		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>
		132	{joint-iso-itu-t(2)
		133	example(999) xml-submission(777)}
		134	</tt>).
		135	</p>
		136	<ul>
		137	<li>
		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>
		140	per XML file.
		141	</li>
		142	<li>
		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
		145	information to the OID repository.
		146	</li>
		147	<li>
		148	The <tt><font color="#009933"><submitter></font></tt> part
		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
		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
		153	you submitted are updated in the future.
		154	</li>
		155	<li>
		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>,
		158	<tt><information></tt> and <tt><address></tt> elements.
		159	</li>
		160	<li>
		161	HTML entity references (such as "<tt>&eacute;</tt>")
		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
		164	entity references</a> in a <tt><!DOCTYPE...></tt> block at the
		165	beginning of your XML document as follows:<br><font size="-1">
		166	<tt>
		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
		169	entity references</a> as needed</i> -->]>
		170	</tt>
		171	</font>.
		172	</li>
		173	<li>
		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>.
		176	Please have a look at it.<br></li>
		177	</ul>
		178	<font size="-1">
		179	<tt>
		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>
		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">
		184	<a
		185	href="http://oid-info.com/oid.xsd">
		186	</font>XML Schema of the
		187	OID repository<font color="#FF9933"></a></font><br>    </description><br>    <information>More information can be found
		188	in<br><font color="#FF9933">
		189	<a
18	daniel-mar	190	href="https://itu.int/ITU-T/X.660">
2	daniel-mar	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>
18	daniel-mar	192	</font>
2	daniel-mar	193	</TD>
		194	</TR>
		195	</TABLE>
		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
18	daniel-mar	198	example</a>.</p>
2	daniel-mar	199
		200
		201	</div>

Subversion Repositories oidinfo_new_design

oidinfo_new_design/trunk/submit.raw.htm @ 34 – Rev 18