Generally, no adjustments will be required after initial setup of the pssRecruit application. In a few situations, however, you may need to change some entries in the pssRecruit.ini file or in the AreaDefinitions.tpl file. These two files are covered here in detail.
The pssRecruit.ini file is the application's configuration initialization file. Using this file you can customize many of the features of pssRecruit. Within the ini file, any line
beginning with a pound sign "#" is treated as a comment line and will be
ignored. The parameter key names (words to the left of the equal sign) must be specified
exactly as they appear and must not be changed. The application reads these parameters and
sets them equal to what follows the equal sign.
- Company = Progressive Software Solutions This parameter is the name of your company. Your registration key is dependent on the company name. This will ensure that only you can use the software, and that none of your competitors can. Your company name as entered here will be displayed in the Browser's title bar. Once the registration key is set you cannot change your company name without contacting Progressive Software Solutions for a new registration key.
- URL = http://YourDomainName/cgi-bin/pssRecruit/pssRecruit.exe This parameter represents the URL of the pssRecruit application.
- RegistrationURL = NULL This parameter is used to direct the client user to an online registration page. If you do not have an online registration page set this parameter to NULL.
- AdminPath = NULL This parameter specifies the full local path to the auxiliary files required by pssRecruit. Also the directory "Postings" must be a subdirectory of this location. If this parameter is missing or set to NULL the files and the 'Postings' subdirectory must be in the same directory as the pssRecruit.exe. This parameter must precede the definitions of all the auxiliary files.
- UseAsFileName = Job ID This parameter will be used as the file name for the postings. It should be unique and it MUST match an input parameter name specified in pssRecruit.tpl.
- MaxFilenameLength = 14 This parameter is used to limit the maximum number of characters used in the filename. This is not a pssRecruit limitation but some Operating Systems may limit the filename length. If the user tries to use a filename which exceeds this value an alert will occur. The default value for this parameter is 14.
- UseAsDatePosted = Date Posted This parameter will be used as the date of the postings. It should be unique and it MUST match an input parameter name specified in pssRecruit.tpl. It will be automatically filled in but can be changed on-line.
- UseAsArea = Discipline This parameter will be used as the list of job areas. It is the field-name of a catagory in each posting record. It should be unique and it MUST also appear in the pssRecruit.tpl file.
- AllowSearch = Yes This parameter will place a search box and button on the Welcome Page to allow direct search of the postings for keywords. Set this value to NULL if you do not want your postings to be searchable. If it is anything except "Yes" the search will not appear.
- AreaDefinitions = DisciplineDefinitions.tpl This parameter is the file containing definitions of the job areas. For example, one discipline area might be Marketing and the definition might include Brand Marketing, Professional Services Marketing, and Market Research. These sub-area definitions help guide the user to the right discipline. These labels will appear on the default Welcome Page when a user holds the mouse over the name of the Discipline area. If you do not have sub-areas set this parameter to NULL.
- PopupHTML = NULL This parameter is the HTML code to use in a "popup" window which will be displayed when your client moves the mouse over a discipline. We have included an example PopupHTML.tpl file. You may want to experiment with this file. In general, any valid HTML tag may be used in this file including fonts, etc. Do not include the standard opening and closing HTML tags (<HTML>, <BODY>, </BODY>, </HTML>, etc) in the .tpl file. The default value is NULL, which means that the "popup" window will not be displayed.
- SummarySortBy = NULL This parameter can be used to specify the sort criteria for the Summary page. You can specify any number of parameters from the pssRecruit.tpl Separate parameters with a comma. The sort will be done in the order presented. For example "SummarySortBy = Disciplines, Job Title" would sort the postings first by Disciplines then by Job Title.
- TitleFont = NULL This parameter is included to allow you to specify a font "face" for the titles displayed on the "welcome" screen, the titles in the "summary" screen and the lefthand side of the "detail" screen. The browser's default font is used if this parameter is set to "NULL". Note that the font you set here may not be available to your client's browser, in which case the client's browser will substitute a default font.
- Background = NULL This parameter allows you to specify an URL pointing to a picture file (*.gif, or *.jpg) to display as a background. The background will be used on all pages. If you do not have a background set this parameter to NULL.
- AdminHeader = header.tpl This parameter specifies a file to use as a header on all admin pages.
- WelcomePageHeader = WelcomePageHeader.tpl This parameter specifies a file to use as a header on the welcome page (first page viewed by a client).
- SummaryPageHeader = header.tpl This parameter specifies a file to use as a
header on area summary pages.
- DetailPageHeader = header.tpl This parameter specifies a
file to use as a header on job detail pages.
- AdminFooter = footer.tpl This parameter specifies a file to use as a footer on all admin pages.
- WelcomePageFooter = WelcomePageFooter.tpl This parameter specifies a file to use as a footer on the welcome page (first page viewed by a client).
- SummaryPageFooter = footer.tpl This parameter
specifies a file to use as a footer on area summary pages.
- DetailPageFooter = footer.tpl This parameter specifies a file to use as a footer on job detail pages.
- FurtherInformation = To receive further information on this job, please do the following: This parameter defines the statement that will appear above the Contact and/or Registration line on the Detail pages. The package comes with "To receive further information on this job, please do the following:" as the value for this parameter.
- ContactInstruction = If you are already registered with us, send us an email to
let us know you are interested and include the Job ID. This parameter is used to
display instructions with the "Contact" parameter. These instructions will only
appear if the entry "Contact|textfield|1|0|1" appears in our pssRecruit.tpl file.
Do not include any "carriage return linefeeds". The text must all be on one line
when viewed in a text editor with word wrapping off.
- RegisterInstruction = If you are not registered with us, click On-Line Registration
to register and submit your resume. This parameter is used to display instructions with the "Registration" parameter. This parameter is only used if there is a RegistrationURL entered in the ini file. Do not include any "carriage return linefeeds" The text must all be on one line when viewed in a text editor with word wrapping off.
- Key = AloNg5eRIEs0Flett3rsandNum8ers This parameter is your registration key. It is based on your company name. It ensures that only your company will be able to use this software.
The DisciplineDefinitions.tpl file sets the job categories and sub-categories that will be used to organize job postings. This enables the client to more easily find positions listed by pssRecruit. Each category (Discipline Area) starts with a line with only the category name. The next line(s) contain the sub-categories (specialty areas) within this category followed by <br>(the HTML Line Break tag). Each category ends with <EOD> (End of Definition).
<![CDATA[
All
All Postings
<EOD>
Engineering
Electrical<BR>
Mechanical<BR>
Software<BR>
<EOD>
Technical Writing
Proposal Preparation<BR>
User Manual Preparation<BR>
<EOD>
Finance
Chief Financial Officer<BR>
Accounting<BR>
Accounts Receivable<BR>
<EOD>
Recruiting
All Recruiting
<EOD>]]>
The pssRecruit.tpl file establishes certain parameters for the input and selection
boxes on the client and admin interfaces. Generally, changes are not required in this
file. The only line that may need adjustment is the Discipline line. You may add job area names at the end separated by commas. An associated entry must be made in the
AreaDefinitions.tpl file. The first line should not be changed at all.
<![CDATA[
#FIELD NAME|FIELD TYPE|RECRUITER|SUMMARY|DETAIL
Job ID|textfield|1|1|1
Date Posted|textfield|1|0|1
Disciplines|popup_menu|1|1|1|Engineering,Technical Writing,Finance,Recruiting
Job Title|textfield|1|1|1
Location|textfield|1|1|1
Job Description|textarea|1|0|1
Expertise|textfield|1|0|1
Salary Range|textfield|1|0|1
Years of Experience|textfield|1|0|1
Degree|textfield|1|0|1
Contact|textfield|1|0|1
]]>