editjob.html #1

<TITLE>Creating and Editing Jobs</TITLE>

<P>
A Perforce <i>job</i> is a essentially a description of a task. For more information about jobs, see <a href="job?help">Working with
Jobs</a>.

<P>
<b>To create a new job,</b>
<P>
<ol type=1>
<li>Click the <b>Jobs</b> tab.
<li>Click the <b>Create job</b> link at the top of the page.
<li>Edit the fields as desired. Default field descriptions can be found <a href="editjob?help#jobdesc">below</a>.
<li>When you have finished entering the job, click the <b>Save</b> button.
</ol>

<P>
<b>To edit a job,</b>
<p>
<ol type=1>
<li>Select the <b>Jobs</b> tab.
<li>Click on the name of the job that you want to edit.
  <li>Select <b>Edit job...</b> from the <b>Action</b> menu. 
  <li>Edit the fields as desired. 
  <li>When you have finished editing the job, click the <b>Save</b> button.
</ol>
<P><A NAME=jobdesc><B>Job field descriptions</B></A>
<p> Job fields are defined by the <a href="jobfields?help">jobspec</a>, which 
  can be modified for your site's specific purposes. The default P4Web job fields 
  are: 
<table width="66%" border="1" cellpadding="1">
  <tr> 
    <td><b>Field</b></td>
    <td><b>Description</b></td>
  </tr>
  <tr> 
    <td><b>Job</b></td>
    <td>The name of the job. Whitespace is not allowed. </td>
  </tr>
  <tr> 
    <td><b>Status</b></td>
    <td>The default options are <i>open, closed,</i> or <i>suspended</i>. 
      <ul>
        <li> <i>open</i>: a job that has not yet been completed. </li>
        <li> <i>closed</i>: a job  that has been completed. </li>
        <li> <i>suspended</i>: an open job that is not currently being worked 
          on. </li>
      </ul>
    </td>
  </tr>
  <tr> 
    <td><b>User</b></td>
    <td>This field is automatically populated with the username of the person 
      who created the job, but you can edit it. </td>
  </tr>
  <tr> 
    <td><b>Date</b></td>
    <td>The date and time that the job was created. </td>
  </tr>
  <tr> 
    <td><b>Description</b></td>
    <td>Optional information that can be used to describe this job. Usually a 
      written description of the problem that is meant to be fixed. It's a good 
      idea to make the first line of a job particularly meaningful, because the 
      first line can be viewed in the Jobs list and can be used for quick reference. 
    </td>
  </tr>
</table>