Frequently Asked Questions - Web Site Administrator Self Service#

Web Site Administrator Questions#

Q:HOW DO I CREATE A FUNCTION?#

A:When you create a function, you will actually need to complete two processes. You will first create the function and then attach that function to a screen.

Only external and manual functions may be created. (i.e. creating a link to your company’s web site.) All other functions are only created either by us or under our direction. You may, however, copy an existing function in order to modify the form.

Create a Function
  1. Access the Maintain Function form (IMFN) through the Web Site Administrator main menu. You will be presented with a list of functions.
  2. Click the Add icon found at the bottom of this list. A blank row will now appear in the list.
  3. Ensure your cursor is on this row. Directly beneath the list are fields that allow you to define the function you wish to enter.
  4. Enter the Product to which the function belongs. e.g. BE
  5. In the appropriate fields, enter the function’s
    • Name
    • Description
    • Usage (User Defined)
    • Type (External or Manual)
    • Purpose
  6. Enter either the URL in the Web Address field or the external function path in PL/SQL Block field.
  7. Define the general execution rights for this function through the Create Allowed, Retrieve Allowed, Update Allowed and Delete Allowed booleans. Normally, external functions are Retrieve Allowed only.
  8. Define the execution rights to this function for a specific role in the Execution Rights tab at the bottom of this form.
  9. Once you are satisfied with the data you have provided, Save the file.
Attach Function to Form
The new function must be attached to a form in order to be accessed.
  1. Access the Create Menus form (IMMU) through the Web Site Administrator main menu.
  2. Select the menu you wish to add the new function to.
  3. Click the Add icon found at the bottom of the list of the menu’s functions and sub-menus; Located below the Menu Code and Menu Usage. A blank row will now appear in the list.
  4. Ensure your cursor is on that row.
  5. Identify the menu items (functions or menus) that will compose your menu and the order in which they should appear through the Sequence, Code and Type fields.
  6. Enter the name of the new function in the Call Function field
  7. Complete the Label field and if desired, the Icon Name field.
  8. Set the Menu Action Usage to User Defined. This must be completed as stated.
  9. When you are satisfied with the data you have provided, click the Save button.

Q:HOW DO I COPY/EXTEND A FUNCTION?#

A:Copying a function is referred to as ‘extending’. This is due to the fact that when a function is copied, the form attached to the function is also copied.

Functions should only be copied if you wish to make changes to the form attached to the function. (For example, customizing the Employee Time sheet (WEPTS) to your company’s time codes.)

  1. Access the Maintain Function form (IMFN) through the Web Site Administrator main menu. You will be presented with a list of functions.
  2. Select the function you wish to extend.
  3. Click on Extend Form button located directly beneath the execution rights booleans on the right side of the form.
  4. Find the original function. You will see that you have a new function with CPY added to the original function. In addition, the usage field on the function as well as the form for the function in IMFD have been marked as User Defined.
  5. Go to the Function Name and rename the new function to something more meaningful. i.e. WEPTS CPY can be renamed WEPTS_HL
If you copy/extend a function you should go to IMMS and copy the ‘_FIND’ code as well. i.e. You copy WAPPT and call it WAPPT_HL. Copy the WAPPT_FIND and call it WAPPT_HL_FIND.

Q:HOW DO I DELETE/REMOVE A FUNCTION?#

A:Only functions that you created yourself should be removed. NEVER remove a supplied ‘Pre-loaded’ function.
  1. Access the Maintain Function form (IMFN) through the Web Site Administrator main menu. You will be presented with a list of functions.
  2. Select the function you wish to remove.
  3. If not already marked as such, change the Function Usage to User Defined.
  4. Save the file.
  5. Re-select the function you wish to remove.
  6. Click the Remove icon within the function.

Q:HOW DO I CREATE A FORM?#

A: You are restricted from creating new forms. All forms are created by us or under our direction. You may, however, copy an existing function in order to modify the form - see How Do I Copy a Function?.

Q:HOW DO I COPY A FORM?#

A:You are restricted from copying new forms. You may, however, copy an existing function in order to modify the form - see How Do I Copy a Function?.

Q: HOW DO I ADD A HEADER OR FOOTER TO A SCREEN?#

A: Although headers and footers appear on the form, they are set up at the Function level.
  1. Access the Maintain Function form (IMFN) through the Web Site Administrator main menu. You will be presented with a list of functions.
  2. Select the function to which you wish to add the Header and/or Footer.
  3. Click on the Preferences tab.
  4. Click the Add icon found at the bottom of the list of functions.
  5. Enter a Seq. number. We recommend using numbers increased by increments of ten. (e.g. 10, 20, 30, etc.)
  6. Enter in the Preference; HEADER INFO or FOOTER INFO.
  7. Enter the location of the html or jsp file in the Value field i.e. docs/WEDPN_Header.html
  8. Save the file.

We have supplied various sample screen headers and footers throughout Self Service. These headers and footers are either HTML or JSP files which are saved in the "docs" folder under selfService on your 9ias server.

The headers and footers provided can be edited to your requirements. It is recommended, however, that you follow our naming conventions for these files.

Header
Each header is named as follows: FUNCTION_Header.html or FUNCTION_Header.jsp, where FUNCTION is the name of the function to which you will be applying this header (e.g. WEEPP_Header.html).
Footer
Each footer is named as follows: FUNCTION_Footer.html or FUNCTION_Footer.jsp, where FUNCTION is the name of the function to which you will be applying this footer (e.g. WEEP_Footer.html).

A header and/or footer will only appear on a screen if the Header Info and/or Footer Info preferences have been properly setup via the Maintain Functions (IMFN) screen in Self Service Administration module to call the appropriate HTML or JSP document from the "docs" directory.

Whenever Self Service software updates are provided there is the chance that supplied documents in the "docs" folder will be overwritten. To avoid losing any newly created documents or changes made to the delivered documents, we recommend that you keep a master copy of ALL required headers and footers outside of the server environment.

Q: HOW DO I CREATE A MENU?#

A:
  1. Access the Create Menus form (IMMU) through the Web Site Administrator main menu. You will be presented with a list of menus.
  2. Click the Add icon found at the bottom of this list. A blank row will now appear in the list.
  3. Ensure your cursor is on that row. Directly beneath the list, there are a series of fields allowing you to define the new menu.
  4. Fill in the name of the menu in the Menu Code field.
  5. Complete the Sequence, Code and Type fields to identify the menu items (functions or menus) that will compose your menu and the order in which they should appear.
  6. Complete either the Call Function or Call Menu field for each menu item. A menu item may only call either a function or a menu, so you will fill in only one of these two fields.
  7. Complete the Label field and if desired, the Icon Name field.
  8. Set the Menu Action Usage must be User Defined. This must be completed.
  9. Once you are satisfied with the data you have provided, click the Save button.

Q:HOW DO I CREATE A USER NAME?#

A:
  1. Access the Create User (IMUS) form through the Web Site Administrator main menu. You will be presented with a list of users.
  2. Click the Add icon found at the bottom of this list. A blank row will now appear in the list;
  3. A ensure your cursor is on that row. Directly beneath the list are the fields that allow you to define the user you wish to enter.
  4. Enter the user’s ID/Name and Description in the appropriate fields.
  5. If the user should have access for a limited time period, you may define that time period through the Start Date and End Date fields.
  6. You may provide an Email Address and Password in the appropriate fields
  7. Define the general execution rights for this user through the Create Allowed, Retrieve Allowed, Update Allowed and Delete Allowed Boolean.
  8. Define execution rights to a specific function for this user through the Execution Rights tab at the bottom of the form.
  9. At this point you may also define the role’s Preferences and assign Roles.
  10. Once you are satisfied with the data you have provided, click the Save button.

Q: HOW DO I SET UP A GENERIC USER OR USER PROFILE?#

A: This procedure is a two step process. There are a set of instructions on how to create and assign the Generic User (Group, Shared) or User Profile to multiple employees. Following those instructions are the steps the employee must do when they first enter the application.

Be careful to follow these steps exactly. Create and Assign Generic User or User Profile

  1. Create a generic user profile through Create Users (IMUS) in the Self Service application as specified in How do I create a User Name? For example, EMPLOYEE_PT.
  2. Leave the Self Service application
  3. Access the Professional application.
  4. Go to the Define Identity Information (IEID) form.
  5. From the list of employees, pick the employee to whom you would like to give the new User Profile. For example, Jacqueline Myers.
  6. Click on the User Name field; found in the Access section on the bottom right corner of the form.
  7. Enter the name of User Profile you created in Self Service. As Professional and Self Service are on the same database, any data created in Self Service may be called up in Professional. In the example we are using, you would enter EMPLOYEE_PT. IMPORTANT - at this point you must save the form before you go anywhere else.
  8. Make note of the Person Code. For example, # 4112.
  9. Access the Reset Pin Number (IMRE) form.
  10. Type in the Person Code. In our example, 4112.
  11. In the New PIN# field, type in the PIN you want to set for this employee. The PIN must include one digit and one alpha character. For example, P123
  12. In the Confirm PIN# field, re-type in the PIN you want to set for this employee
  13. When you are finished, click OK. You will receive a prompt to tell you that the password has been reset.
  14. Click OK. You will be brought back to the IMRE form.
  15. Click Cancel to close the form.
  16. If the IEID form was left open, you will notice that the PIN number field is still blank. You may re-query (F8) or exit and re-enter the IEID form for that employee, to see the PIN number field is filled.
Employee Access
When the employee needs to access the Self Service application for the first time, they will go through the following steps:
  1. Go to into Self Service.
  2. In the Last Name field, they will enter their last name. In our example, myers
  3. In the Person Code field, they will enter their employee number. In our example, 4112
  4. In the PIN Number field, they will enter the generic password. In our example, P123
  5. The employee may then change their PIN by going to Employee Self Service > My Self Service > My Self Service PIN

Q:HOW DO I CREATE A ROLE?#

A:
  1. Access the Create Roles form through the Web Site Administrator main menu, or through the Navigation tree. You will be presented with a list of roles.
  2. Click the Add icon found at the bottom of this list. A blank row will now appear in the list.
  3. Ensure your cursor is on this row. Directly beneath the list are fields that allow you to define the role you wish to create.
  4. Enter the role’s Name and Description.
  5. Select Role Type (e.g. Executions)
  6. If you wish to indicate that this will be the default role outside of the Professional world, indicate YES for Default Role and assign a Password in the next field.
  7. At this point you may also define the role’s Preferences and assign Users.
  8. Save the file.

Q: HOW DO I ASSIGN A USER TO A ROLE?#

A:
  1. Access the Create Roles form through the Web Site Administrator main menu, or through the Navigation tree. You will be presented with a list of roles.
  2. Locate the role to which you would like to assign a user.
  3. Place your cursor on that role and highlight it.
  4. Go to the User tab and from the User drop down menu, select the user to which you would like to assign the role.
  5. Save the file.

Q:HOW DO I ASSIGN A ROLE TO A USER?#

A:
  1. Access the Assign Roles to Users form through the Web Site Administrator main menu, or through the Navigation tree. You will be presented with a list of users.
  2. Click the Add icon found at the bottom of this list. A blank row will now appear in the list.
  3. Ensure your cursor is on this row. Directly beneath the list are fields that allow you to define the role you wish to create.
  4. From the User Name pop-up menu, select the user to whom you would like to assign a role.
  5. From the Role Name pop-up menu, select the role.
  6. Complete the Role Sequence.
  7. If you wish to indicate that this will be the default role outside of the Professional world, indicate YES for Default Role. Only one Professional role (not Self Service) per user may be assigned as a default role.
  8. Save the file.

Q:HOW DO I CHANGE A MESSAGE TO THE USER?#

A:
  1. Access Professional.
  2. Go to System Messages (IMMS).
  3. In the Message Description field enter in a key word or two from the message. In our example,%administration%.
  4. Select the message you wish to change.
  5. In the Help Text field make the changes.
  6. Save the file.

Q:HOW DO I ATTACH ASSESSMENTS TO THE NEW CANDIDATE PROCEDURE?#

A:
  1. Create the assessment in Professional.
  2. Create an ‘html’ file with the following information:
    • <HTML>
      <li><a href="..\Assessment.jsp?ASSESSMENT_CODE=GENERAL&
      ASSESSMENT_EVENT=NEW" TARGET=_blank>
      Click here to take the General Survey
      </a></li>
      </HTML>
      where ‘GENERAL’ is the assessment code.
  3. Save the file in the "docs" folder under selfService on your 9ias server.
  4. Access the Maintain Function form through the Web Site Administrator main menu, or through the Navigation tree. You will be presented with a list of functions.
  5. Click the Add icon found at the bottom of this list. A blank row will now appear in the list;
  6. Ensure your cursor is on this row. Directly beneath the list are fields that allow you to define the function you wish to enter.
  7. Enter data into these fields as indicated below.
    • Field: Data
    • Product: RE
    • Function Name: GENERAL
    • Description: General Candidate Survey Assessment
    • Function Usage: User Defined
    • Function Type: Manual
    • Web Address: docs/GeneralSurvey.html
  8. Set the execution rights allowed to ‘Yes’ for Retrieve Allowed and Update Allowed
  9. In the Execution Rights tab, assign the function to P2K_MASTER and WWW_CANDIDATE with Retrieve and Update set to ‘Yes’
  10. Once you are satisfied with the data you have provided, Save the file. The new function may now be added to the NEW CANDIDATE procedure.

Q:HOW DO I ALLOW NEW CANDIDATES FROM THE NEW CANDIDATE PROCEDURE?#

A: All new candidate procedures MUST start with MAINTAINING your Name and Password (WCRLI). Do not give your procedures and functions the same file name.

If your function is named the same as your procedure, the function file will overwrite the procedure file and your original procedure file will be lost.

  1. Through the IMPC form in Professional, create as many procedures as you need to use in Self Service.
  2. Create an ‘html’ file (e.g. New_Candidate.html) with the following information:
    • <HTML>
      What type of positions are you looking for?
      <UL>
      <LI><a target="_parent" href="..\candidate.form?FORM=NEW_CAND_1"> New Candidate Procedure 1</a></LI>
      <P></P>
      <LI><a target="_parent" href="..\candidate.form?FORM=NEW_CAND_2"> New Candidate Procedure 2</a></LI>
      <P></P>
      <LI><a target="_parent" href="..\candidate.form?FORM=NEW_CAND_3"> New Candidate Procedure 3</a></LI>
      </UL>
      </HTML>
    • In the above information, ‘NEW_CAND_1’,'NEW_CAND_2' and 'NEW_CAND_3' will be the names of the procedures you created in IMPC.
  3. Save the file in the "docs" folder under selfService on your 9ias server.
  4. Access the Maintain Function form (IMFN) either through the Web Site Administrator main menu or through the Navigation tree. You will be presented with a list of functions.
  5. Click the Add icon found at the bottom of this list. A blank row will now appear.
  6. Ensure that your cursor is on this blank row.
  7. Directly beneath the list are fields that allow you to define the function you wish to enter. Enter data into the fields as indicated bellow:
    • Field: Data
    • Product: RE
    • Function Name: NEW CAND FUNCT
    • Description: 'New Candidate Procedures'
    • Function Usage: User Defined
    • Function Type: Manual
    • Web Address: docs/New_Candidate.html
  8. Set the function's execution rights allowed to ‘Yes’ for Retrieve Allowed'
  9. In the ‘Execution Rights’ tab, assign the function to P2K_MASTER and WWW_CANDIDATE with Retrieve set to ‘YES’.
  10. Once you are satisfied with the data you have provided, Save the file


Notes #

Click to create a new notes page