home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _666c0d318413f4cc5e37fa979c98873f < prev    next >
Encoding:
Text File  |  2000-03-23  |  9.8 KB  |  241 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>WWW::Search::Dice - class for searching Dice</TITLE>
  5. <LINK REL="stylesheet" HREF="../../../../Active.css" TYPE="text/css">
  6. <LINK REV="made" HREF="mailto:">
  7. </HEAD>
  8.  
  9. <BODY>
  10. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  11. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  12. <STRONG><P CLASS=block> WWW::Search::Dice - class for searching Dice</P></STRONG>
  13. </TD></TR>
  14. </TABLE>
  15.  
  16. <A NAME="__index__"></A>
  17. <!-- INDEX BEGIN -->
  18.  
  19. <UL>
  20.  
  21.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  22.  
  23.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  24.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  25.     <LI><A HREF="#options">OPTIONS</A></LI>
  26.     <UL>
  27.  
  28.         <LI><A HREF="#format / treatment of query terms">Format / Treatment of Query Terms</A></LI>
  29.         <LI><A HREF="#restrict by date">Restrict by Date</A></LI>
  30.         <LI><A HREF="#restrict by location">Restrict by Location</A></LI>
  31.         <LI><A HREF="#restrict by job term">Restrict by Job Term</A></LI>
  32.         <LI><A HREF="#restrict by job type">Restrict by Job Type</A></LI>
  33.         <LI><A HREF="#limit total number of hits">Limit total number of hits</A></LI>
  34.     </UL>
  35.  
  36.     <LI><A HREF="#author">AUTHOR</A></LI>
  37.     <LI><A HREF="#legalese">LEGALESE</A></LI>
  38. </UL>
  39. <!-- INDEX END -->
  40.  
  41. <HR>
  42. <P>
  43. <H1><A NAME="name">NAME</A></H1>
  44. <P>WWW::Search::Dice - class for searching Dice</P>
  45. <P>
  46. <HR>
  47. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  48. <UL>
  49. <LI>Linux</LI>
  50. <LI>Solaris</LI>
  51. <LI>Windows</LI>
  52. </UL>
  53. <HR>
  54. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  55. <PRE>
  56.  use WWW::Search;
  57.  my $oSearch = new WWW::Search('Dice');
  58.  my $sQuery = WWW::Search::escape_query("unix and (c++ or java)");
  59.  $oSearch->native_query($sQuery,
  60.                         {'method' => 'bool',
  61.                          'state' => 'CA',
  62.                          'daysback' => 14});
  63.  while (my $res = $oSearch->next_result()) {
  64.      if(isHitGood($res->url)) {
  65.          my ($company,$title,$date,$location) = 
  66.              $oSearch->getMoreInfo($res->url);
  67.          print "$company $title $date $location " . $res->url . "\n";
  68.      } 
  69.  }</PRE>
  70. <PRE>
  71.  sub isHitGood {return 1;}</PRE>
  72. <P>
  73. <HR>
  74. <H1><A NAME="description">DESCRIPTION</A></H1>
  75. <P>This class is a Dice specialization of WWW::Search.
  76. It handles making and interpreting Dice searches at
  77. <EM><A HREF="http://www.dice.com">http://www.dice.com</A></EM>.</P>
  78. <P>By default, returned WWW::SearchResult objects contain only url, title
  79. and description which is a mixture of location and skills wanted.
  80. Function <STRONG>getMoreInfo( $url )</STRONG> provides more specific info - it has to
  81. be used as</P>
  82. <PRE>
  83.     my ($company,$title,$date,$location) = 
  84.         $oSearch->getMoreInfo($res->url);</PRE>
  85. <P>
  86. <HR>
  87. <H1><A NAME="options">OPTIONS</A></H1>
  88. <P>The following search options can be activated by sending
  89. a hash as the second argument to native_query().</P>
  90. <P>
  91. <H2><A NAME="format / treatment of query terms">Format / Treatment of Query Terms</A></H2>
  92. <P>The default is to treat entire query as a boolean
  93. expression with AND, OR, NOT and parentheses</P>
  94. <DL>
  95. <DT><STRONG><A NAME="item_%7B%27method%27_%3D%3E_%27and%27%7D">{'method' => 'and'}</A></STRONG><BR>
  96. <DD>
  97. Logical AND of all the query terms.
  98. <P></P>
  99. <DT><STRONG><A NAME="item_%7B%27method%27_%3D%3E_%27or%27%7D">{'method' => 'or'}</A></STRONG><BR>
  100. <DD>
  101. Logical OR of all the query terms.
  102. <P></P>
  103. <DT><STRONG><A NAME="item_%7B%27method%27_%3D%3E_%27bool%27%7D">{'method' => 'bool'}</A></STRONG><BR>
  104. <DD>
  105. treat entire query as a boolean expression with 
  106. AND, OR, NOT and parentheses.
  107. This is the default option.
  108. <P></P></DL>
  109. <P>
  110. <H2><A NAME="restrict by date">Restrict by Date</A></H2>
  111. <P>The default is to return jobs posted in last 30 days</P>
  112. <DL>
  113. <DT><STRONG><A NAME="item_%7B%27daysback%27_%3D%3E_%24number%7D">{'daysback' => $number}</A></STRONG><BR>
  114. <DD>
  115. Display jobs posted in last $number days
  116. <P></P></DL>
  117. <P>
  118. <H2><A NAME="restrict by location">Restrict by Location</A></H2>
  119. <P>The default is ``ALL'' which means all US states</P>
  120. <DL>
  121. <DT><STRONG><A NAME="item_%7B%27state%27_%3D%3E_%24state%7D_%2D_Only_jobs_in">{'state' => $state} - Only jobs in state $state.</A></STRONG><BR>
  122. <DD>
  123. <DT><STRONG><A NAME="item_%7B%27state%27_%3D%3E_%27CDA%27%7D_%2D_Only_jobs_i">{'state' => 'CDA'} - Only jobs in Canada.</A></STRONG><BR>
  124. <DD>
  125. <DT><STRONG><A NAME="item_%7B%27state%27_%3D%3E_%27INT%27%7D_%2D_To_select_i">{'state' => 'INT'} - To select international jobs.</A></STRONG><BR>
  126. <DD>
  127. <DT><STRONG><A NAME="item_%7B%27state%27_%3D%3E_%27TRV%27%7D_%2D_Require_tra">{'state' => 'TRV'} - Require travel.</A></STRONG><BR>
  128. <DD>
  129. <DT><STRONG><A NAME="item_%7B%27state%27_%3D%3E_%27TEL%27%7D_%2D_Display_tel">{'state' => 'TEL'} - Display telecommute jobs.</A></STRONG><BR>
  130. <DD>
  131. </DL>
  132. <P>Multiple selections are possible. To do so, add a ``+'' sign between
  133. desired states, e.g. {'state' => 'NY+NJ+CT'}</P>
  134. <P>You can also restrict by 3-digit area codes. The following option does that:</P>
  135. <DL>
  136. <DT><STRONG><A NAME="item_%7B%27acode%27_%3D%3E_%24area_code%7D">{'acode' => $area_code}</A></STRONG><BR>
  137. <DD>
  138. </DL>
  139. <P>Multiple area codes (up to 5) are supported.</P>
  140. <P>
  141. <H2><A NAME="restrict by job term">Restrict by Job Term</A></H2>
  142. <P>No restrictions by default.</P>
  143. <DL>
  144. <DT><STRONG><A NAME="item_%7B%27term%27_%3D%3E_%27CON%27%7D_%2D_contract_job">{'term' => 'CON'} - contract jobs</A></STRONG><BR>
  145. <DD>
  146. <DT><STRONG><A NAME="item_%7B%27term%27_%3D%3E_%27C%2FH%27%7D_%2D_contract_t">{'term' => 'C/H'} - contract to hire</A></STRONG><BR>
  147. <DD>
  148. <DT><STRONG><A NAME="item_%7B%27term%27_%3D%3E_%27FTE%27%7D_%2D_full_time">{'term' => 'FTE'} - full time</A></STRONG><BR>
  149. <DD>
  150. </DL>
  151. <P>Use a '+' sign for multiple selection.</P>
  152. <P>There is also a switch to select either W2 or Independent:</P>
  153. <DL>
  154. <DT><STRONG><A NAME="item_%7B%27addterm%27_%3D%3E_%27W2ONLY%27%7D_%2D_W2_onl">{'addterm' => 'W2ONLY'} - W2 only</A></STRONG><BR>
  155. <DD>
  156. <DT><STRONG><A NAME="item_%7B%27addterm%27_%3D%3E_%27INDOK%27%7D_%2D_Indepen">{'addterm' => 'INDOK'} - Independent ok</A></STRONG><BR>
  157. <DD>
  158. </DL>
  159. <P>
  160. <H2><A NAME="restrict by job type">Restrict by Job Type</A></H2>
  161. <P>No restriction by default. To select jobs with specific job type use the
  162. following option:</P>
  163. <DL>
  164. <DT><STRONG><A NAME="item_%7B%27jtype%27_%3D%3E_%24jobtype%7D">{'jtype' => $jobtype}</A></STRONG><BR>
  165. <DD>
  166. </DL>
  167. <P>Here $jobtype (according to <EM><A HREF="http://www.dice.com">http://www.dice.com</A></EM>) can be one or more 
  168. of the following:</P>
  169. <UL>
  170. <LI><STRONG><A NAME="item_ANL_%2D_Business_Analyst%2FModeler">ANL - Business Analyst/Modeler</A></STRONG><BR>
  171.  
  172. <LI><STRONG><A NAME="item_COM_%2D_Communications_Specialist">COM - Communications Specialist</A></STRONG><BR>
  173.  
  174. <LI><STRONG><A NAME="item_DBA_%2D_Data_Base_Administrator">DBA - Data Base Administrator</A></STRONG><BR>
  175.  
  176. <LI><STRONG><A NAME="item_ENG_%2D_Other_types_of_Engineers">ENG - Other types of Engineers</A></STRONG><BR>
  177.  
  178. <LI><STRONG><A NAME="item_FIN_%2D_Finance_%2F_Accounting">FIN - Finance / Accounting</A></STRONG><BR>
  179.  
  180. <LI><STRONG><A NAME="item_GRA_%2D_Graphics%2FCAD%2FCAM">GRA - Graphics/CAD/CAM</A></STRONG><BR>
  181.  
  182. <LI><STRONG><A NAME="item_HWE_%2D_Hardware_Engineer">HWE - Hardware Engineer</A></STRONG><BR>
  183.  
  184. <LI><STRONG><A NAME="item_INS_%2D_Instructor%2FTrainer">INS - Instructor/Trainer</A></STRONG><BR>
  185.  
  186. <LI><STRONG><A NAME="item_LAN_%2D_LAN%2FNetwork_Administrator">LAN - LAN/Network Administrator</A></STRONG><BR>
  187.  
  188. <LI><STRONG><A NAME="item_MGR_%2D_Manager%2FProject_leader">MGR - Manager/Project leader</A></STRONG><BR>
  189.  
  190. <LI><STRONG><A NAME="item_OPR_%2D_Data_Processing_Operator">OPR - Data Processing Operator</A></STRONG><BR>
  191.  
  192. <LI><STRONG><A NAME="item_PA_%2D_Application_Programmer%2FAnalyst">PA - Application Programmer/Analyst</A></STRONG><BR>
  193.  
  194. <LI><STRONG><A NAME="item_QA_%2D_Quality_Assurance%2FTester">QA - Quality Assurance/Tester</A></STRONG><BR>
  195.  
  196. <LI><STRONG><A NAME="item_REC_%2D_Recruiter">REC - Recruiter</A></STRONG><BR>
  197.  
  198. <LI><STRONG><A NAME="item_SLS_%2D_Sales%2FMarketing">SLS - Sales/Marketing</A></STRONG><BR>
  199.  
  200. <LI><STRONG><A NAME="item_SWE_%2D_Software_Engineer">SWE - Software Engineer</A></STRONG><BR>
  201.  
  202. <LI><STRONG><A NAME="item_SYA_%2D_Systems_Administrator">SYA - Systems Administrator</A></STRONG><BR>
  203.  
  204. <LI><STRONG><A NAME="item_SYS_%2D_Systems_Programmer%2FSupport">SYS - Systems Programmer/Support</A></STRONG><BR>
  205.  
  206. <LI><STRONG><A NAME="item_TEC_%2D_Custom%2FTech_Support">TEC - Custom/Tech Support</A></STRONG><BR>
  207.  
  208. <LI><STRONG><A NAME="item_TWR_%2D_Technical_Writer">TWR - Technical Writer</A></STRONG><BR>
  209.  
  210. <LI><STRONG><A NAME="item_WEB_%2D_Web_Developer_%2F_Webmaster">WEB - Web Developer / Webmaster</A></STRONG><BR>
  211.  
  212. </UL>
  213. <P>
  214. <H2><A NAME="limit total number of hits">Limit total number of hits</A></H2>
  215. <P>The default is to stop searching after 500 hits.</P>
  216. <DL>
  217. <DT><STRONG><A NAME="item_%7B%27num_to_retrieve%27_%3D%3E_%24num_to_retrieve">{'num_to_retrieve' => $num_to_retrieve}</A></STRONG><BR>
  218. <DD>
  219. Changes the default to $num_to_retrieve.
  220. <P></P></DL>
  221. <P>
  222. <HR>
  223. <H1><A NAME="author">AUTHOR</A></H1>
  224. <P><CODE>WWW::Search::Dice</CODE> is written and maintained by Alexander Tkatchev
  225. (<A HREF="mailto:Alexander.Tkatchev@cern.ch">Alexander.Tkatchev@cern.ch</A>)</P>
  226. <P>
  227. <HR>
  228. <H1><A NAME="legalese">LEGALESE</A></H1>
  229. <P>THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
  230. WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
  231. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.</P>
  232. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  233. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  234. <STRONG><P CLASS=block> WWW::Search::Dice - class for searching Dice</P></STRONG>
  235. </TD></TR>
  236. </TABLE>
  237.  
  238. </BODY>
  239.  
  240. </HTML>
  241.