TalentMatch User Guide

🚀 Revolutionize Your Recruitment Process

TalentMatch is the ultimate power tool for HR recruiters in Singapore SMEs who are drowning in internship applications from local universities and need a lifeline. Say goodbye to spreadsheet nightmares and scattered emails!

💪 Built for Busy HR Professionals Like You

Are you tired of:

• Losing track of promising candidates?
• Forgetting which round of interviews applicants are in?
• Struggling to match the right skills to the right positions?
• Wasting hours on administrative busywork instead of finding your next star intern?

TalentMatch combines lightning-fast command-line efficiency with intuitive visuals to give you complete control over your recruitment pipeline. Our SME-focused solution lets you manage your entire internship program from a single dashboard.

⚡ Work at the Speed of Thought

With TalentMatch's CLI interface, you can:

• Process applications 3x faster than traditional methods
• Track candidate progress across multiple interview rounds
• Visualize your talent pipeline with powerful stats and charts
• Never lose an applicant's details again with automatic data organization

The more you type, the more time you save. Master our simple commands and watch your productivity soar!

---

Quick start

1. Ensure you have Java 17 or above installed in your Computer.
   Mac users: Ensure you have the precise JDK version prescribed here.

2. Download the latest .jar file from here.

3. Copy the file to the folder you want to use as the home folder for your AddressBook.

4. Open a command terminal, cd into the folder you put the jar file in, and use the java -jar TalentMatch.jar command to run the application.
   A GUI similar to the below should appear in a few seconds. Note how the app contains some sample data.
   

5. Type the command in the command box and press Enter to execute it. e.g. typing help and pressing Enter will open the help window.
   Some example commands you can try:

• listjob : Lists all job entries.

• addjob jt/Software Developer jr/3 k/JavaScript: Adds a job titled Software Developer to TalentMatch.

• deljob 3 : Deletes the 3rd job shown in the current list.

• clear : Deletes all entries.

• exit : Exits the app.

Refer to the Features below for details of each command.

---

Features

Command History

TalentMatch supports remembering command history, allowing you to be able to navigate through your past inputs and reduce the need to type out every command from scratch!
Simply use the up and down arrow keys after clicking on the command box text input area and navigate through your past inputs like how you would in terminal.

Generic commands

---

Commands that are suitable for use in either person view or job view.

Viewing help : help

Shows a message explaining how to access the help page.

Format: help

Switching views : switch

Switches the view of GUI from job view to person view and vice versa.

Please note the differences in job view and person view as the commands available are different.

Job View: Displays a list of all jobs and applications

Person View: Displays a list of all persons

Format: switch

Clearing all entries : clear

Clears all entries from TalentMatch, removing applications, jobs and persons.

Format: clear

Expected Output:

Exiting the program : exit

Exits the program.

Format: exit

Job Commands

---

These commands support CRUD operations on Jobs and are only available to you in Job View so that you are able to see real time updates on the GUI.

Adding a job: addjob

Adds a job to TalentMatch

Format: addjob jt/JOB_TITLE jr/INTERVIEW_ROUNDS [k/SKILL]…​

Expected output:
addjob jt/Quant Analyst jr/5 k/Maths k/Analytic adds a job with the specified details

Examples:

• addjob jt/Software Engineering jr/3 k/React k/JavaScript adds Software Engineering job with 3 rounds and requires applicants to know React and JavaScript.

Editing a job: editjob

Edits an existing job in TalentMatch.

Format: editjob INDEX [jt/JOB_TITLE] [jr/JOB_ROUNDS] [k/SKILL]…​

• Edits the job at the specified INDEX. The index refers to the index number shown in the displayed job list.
• The index must be a natural number 1, 2, 3, …​
• At least one of the optional fields must be provided.
• Existing values will be updated to the input values.
• When editing job skills, the existing skills of the person will be removed i.e adding of skills is not cumulative.
• You can remove all the job's skills by typing k/ without specifying any skills after it.

Expected output:
editjob 2 jr/5 edits the 2nd job and changes JOB_ROUNDS to 5.

Examples:

• editjob 7 jt/Software Engineering jr/3 edits the 7th job and changes its JOB_TITLE to Software Engineering and JOB_ROUNDS to 3.

Listing all jobs: listjob

Shows a list of all jobs in TalentMatch.

Format: listjob

Locating jobs: findjob

Finds jobs whose details contain any of the given keywords.

Format: findjob KEYWORD [MORE_KEYWORDS]…​

• The search is case-insensitive. e.g. software will match Software
• The order of the keywords does not matter. e.g. Engineering Software will match Software Engineering
• Only full words will be matched e.g. Engi will not match Engineer
• Jobs matching at least one keyword will be returned (i.e. OR search).
  e.g. Engineer will return Software Engineer, AI Engineer
• Keywords are searched across multiple fields. e.g. findjob 2 will return jobs that contain 2 any of the searchable fields.
• Keywords used in a single findjob command searches the displayed list using logical OR. e.g. findjob data engineering will return Software Engineering and Data Scientist
• Consecutive findjob commands continue the search based on the current displayed list. e.g. findjob data engineering followed by findjob engineering will only return Software Engineering
• To reset the displayed list (i.e. when the displayed list is empty or the job you are searching for is no longer in the list), use listjob to reset back to original list and continue searching again.

Searchable fields:

• JOB_TITLE
• JOB_ROUNDS
• SKILL

Expected output:

• findjob data engineer returns jobs which contain data or engineer in their details.

• findjob data engineer followed by findjob software returns jobs which contains data or engineer, and software in its details.

Examples:

• findjob Software returns jobs that contain Software in their details.

Deleting a job: deljob

Deletes the specified job from TalentMatch.

Format: deljob INDEX

• Deletes the job at the specified INDEX.
• The index refers to the index number shown in the displayed job list.
• The index must be a natural number 1, 2, 3, …​

Expected output:
deljob 7 deletes the job at the 7th index.

Examples:

• listjob followed by deljob 2 deletes the 2nd job in TalentMatch.
• findjob Software Engineering followed by deljob 1 deletes the 1st job in the results of the findjob command.

Person Commands

---

These commands support CRUD operations on Persons and are only available to you in Person View so that you are able to see real time updates on the GUI.

Adding a person: add

Adds a person to TalentMatch.

Format: add n/NAME s/SCHOOL d/DEGREE p/PHONE_NUMBER e/EMAIL a/ADDRESS [k/SKILL]…​

Expected output:
add n/John Doe s/NUS d/Computer Science p/98765432 e/johnd@example.com a/John street, block 123, #01-01 adds a person with the specified details.

Examples:

• add n/John Doe s/NUS d/Computer Science p/98765432 e/johnd@example.com a/John street, block 123, #01-01 adds a person with the specified details without skills.
• add n/Betsy Crowe s/NTU d/Civil Engineering k/Communication e/betsycrowe@example.com a/Newgate Prison p/97542384 k/Python adds a person with the specified details with skills.

Editing a person: edit

Edits an existing person in TalentMatch.

Format: edit INDEX [n/NAME] [s/SCHOOL] [d/DEGREE] [p/PHONE] [e/EMAIL] [a/ADDRESS] [k/SKILL]…​

• Edits the person at the specified INDEX. The index refers to the index number shown in the displayed person list.
• The index must be a natural number 1, 2, 3, …​
• At least one of the optional fields must be provided.
• Existing values will be updated to the input values.
• When editing skills, the existing skills of the person will be removed i.e adding of skills is not cumulative.
• You can remove all the person's skills by typing k/ without specifying any skills after it.

Expected output:
edit 7 k/python edits the person at the 7th index to have 1 skill.

Examples:

• edit 1 p/91234567 e/johndoe@example.com Edits the phone number and email address of the 1st person to be 91234567 and johndoe@example.com respectively.
• edit 2 n/Betsy Crower k/ Edits the name of the 2nd person to be Betsy Crower and clears all existing skills.

Listing all persons: list

Shows a list of all persons in TalentMatch.

Format: list

Locating persons: find

Finds persons whose details contain any of the given keywords.

Format: find KEYWORD [MORE_KEYWORDS]…​

• The search is case-insensitive. e.g. hans will match Hans
• The order of the keywords does not matter. e.g. Hans Bo will match Bo Hans
• Only full words will be matched e.g. Han will not match Hans
• Persons matching at least one keyword will be returned (i.e. OR search).
  e.g. Hans Bo will return Hans Gruber, Bo Yang
• Keywords are searched across multiple fields. e.g. find Alice will return persons that contain Alice in any of the searchable fields.
• Keywords used in a single findjob command searches the displayed list using logical OR. e.g. find Hans Bo will return Hans Gruber, Bo Yang
• Consecutive find commands continue the search based on the current displayed list. e.g. find Hans Bo followed by find Hans will only return Hans Gruber
• To reset the displayed list (i.e. when the displayed list is empty or the person you are searching for is no longer in the list), use list to reset back to original list and continue searching again.

Searchable fields:

• NAME
• SCHOOL
• DEGREE
• PHONE
• EMAIL
• ADDRESS
• SKILL

Expected output:

• find alex irfan returns persons who contain alex or irfan in their details

• find alex irfan followed by find yeoh returns persons who contain alex or irfan, and yeoh in their details.

Examples:

• find John returns john and John Doe
• find alex david returns Alex Yeoh, David Li

Deleting a person: del

Deletes the specified person from TalentMatch.

Format: del INDEX

• Deletes the person at the specified INDEX.
• The index refers to the index number shown in the displayed person list.
• The index must be a natural number 1, 2, 3, …​

Expected output:
del 7 deletes the person at the 7th index.

Examples:

• list followed by del 2 deletes the 2nd person in TalentMatch.
• find Betsy followed by del 1 deletes the 1st person in the results of the find command.

Application Commands

---

These commands support CRUD operations on Applications and are only available to you in Job View so that you are able to see real time updates on the GUI.

Here is a brief label of the various parameters:

Adding an application: addapp

Adds an application to TalentMatch

Format: addapp ip/PERSON_INDEX ij/JOB_INDEX

Expected output:
addapp ip/1 ij/4 adds an application which has the person at index 1 as the applicant and the job at index 4 as the job that he/she is applying for.

Examples:

• addapp ip/3 ij/6 adds an application for the 3rd person to the 6th job in the current displayed person and job list respectively.

Locating application: findapp

Finds application by JOB_INDEX and APPLICATION_STATUS in Job View.

Format: findapp as/APPLICATION_STATUS [ij/JOB_INDEX]

Expected output:
findapp as/2 returns all applications in TalentMatch that currently have APPLICATION_STATUS of 2.

Example: findapp as/3 ij/2 returns all applications with APPLICATION_STATUS of 3 for the 2nd job in the displayed job list.

Deleting an application: delapp

Deletes the specified application from TalentMatch.

Format: delapp ij/JOB_INDEX ia/APPLICATION_INDEX

Expected output:
delapp ij/1 ia/1 deletes the 1st application for the 1st job.

Example: delapp ij/2 ia/3 deletes the 3rd application for the 2nd job.

Advancing applications: advapp

Advances an application to the next round of interview.

Format: advapp ij/JOB_INDEX ia/APPLICATION_INDEX

• All applications are advanced by exactly 1 round each time.
• You should exercise discretion in advancing an application as it signifies that the applicant has not only gone for the round, but also passed it! Therefore, an applicant who has reached the final round of an application (i.e. round 5 of 5) will be deemed to have received a job offer. Congratulations!
• You should exercise discretion in advancing an application of any applicant who has reached the final round of another application, as this would otherwise imply the applicant has more than 1 offers for this company!

Expected output:
advapp ij/2 ia/1 advances the 1st application for the 2nd job by one round.

Example:

• advapp ij/1 ia/2 advances the 2nd application for the 1st job by one round (if it exists).

Viewing job details: viewjob

Displays a sidebar that shows the job title and the number of applicants for that job. It also shows the distribution of applicants across different interview rounds in a bar chart, and the skills required for the job.

Format: viewjob INDEX

• Shows detailed information of the job at the specified INDEX.
• The index refers to the index number shown in the displayed job list.
• The index must be a natural number 1, 2, 3, …​

Expected output:

• viewjob 1 displays information about the 1st job in the sidebar.

Examples:

• listjob followed by viewjob 2 displays detailed information of the 2nd job in TalentMatch.
• viewjob 1 shows detailed information about the first job in the current list.
• viewjob 10 will return a INVALID_INDEX_MESSAGE if there is no job at index 10.
• viewjob 0 will return a INVALID_COMMAND_MESSAGE as the index must be a natural number.

Viewing person details from job application: viewperson

Shows a sidebar that shows the applicant's name, school, degree, phone number, email, address, and skills. It also shows the application status of the applicant for the job through a progress bar.

Format: viewperson ij/JOB_INDEX ia/APPLICATION_INDEX

• Shows detailed information of the person associated with the application at the specified APPLICATION_INDEX for the job at the specified JOB_INDEX.
• Both indices refer to the index numbers shown in the respective displayed lists.
• Both indices must be natural numbers 1, 2, 3, …​

Expected Output:

• viewperson ia/1 ij/1 displays information about the 1st applicant of the 1st job in the sidebar.

Examples:

• viewperson ij/1 ia/1 in job view will generate a sidebar with detailed information of the applicant associated with the 1st application for the 1st job (if it exists).
• viewjob 1 followed by viewperson ij/1 ia/2 displays detailed information of the applicant associated with the 2nd application for the 1st job.
• viewperson ij/1 ia/2 will return a NOT_FOUND_MESSAGE if there are no applications at index 2 for the job at index 1.
• viewperson ij/1 ia/0 will return a INVALID_COMMAND_MESSAGE as the application index must be a natural number.

---

Saving the data

TalentMatch data are saved in the hard disk automatically after any command that changes the data. There is no need to save manually.

Editing the data file

TalentMatch stores data in two separate JSON files:

• [JAR file location]/data/addressbook.json - Contains all person and job data
• [JAR file location]/data/applicationbook.json - Contains all application data linking persons to jobs

Advanced users can update data directly by editing these files, but caution is advised.

Do note that all case-insensitive fields are stored in lowercase in these files and casing is done automatically by TalentMatch.

---

FAQ

Q: How do I transfer my data to another Computer?
A: Install the app in the other computer and overwrite the empty data file it creates with the file that contains the data of your previous AddressBook home folder.

Q: Why are the commands limited to specific views?
A: We limit commands to their specific views to ensure you are able to see real time updates in the GUI. This is in consideration of the case you type the wrong command and accidentally change data in the other view unknowingly.

Q: Why are the find commands so restrictive?
A: TalentMatch is built with the assumption that experienced users will be unlikely to make typing mistakes when searching for a certain job/person, hence having a find function that continuously reduces the search space improves your experience by being able to narrow down your displayed lists for easier addition of applications. In the event of typing a wrong keyword, you can use list/listjob in the appropriate view to reset your current search and try searching again.

Q: Why are skills limited to 1 word?
A: TalentMatch follows typical resume formats where skills are listed as single words. In the event of skills that take up multiple words, you can compromise by concatenating them into a single word.

---

Known issues

UI Issues

1. Multiple Window Usages: When using multiple screens, if you move the application to a secondary screen, and later switch to using only the primary screen, the GUI will open off-screen. The remedy is to delete the preferences.json file created by the application before running the application again.
2. Minimizing the Help Window: If you minimize the Help Window and then run the help command again, the original Help Window will remain minimized, and no new Help Window will appear. The remedy is to manually restore the minimized Help Window.
3. Text Truncation in Display: Long text entries may be truncated with "..." when the application window isn't wide enough. You may not be able to see the complete information for some fields.
4. Viewport Issues: Parts of the application may be cut off at smaller window sizes, including the default size at first startup. We have included a minimum viewport size for most devices, however in the case where your device is unable to support this viewport, then you may run into unexpected UI issues as mentioned before.
5. Oversized Messages: Some success and error messages may be too long to read easily in the current application.
6. Inconsistent Casing: TalentMatch automatically capitalizes the case-insensitive fields, which could result in weird capitalization in some cases.

Data Storage Issues

6. Storage File Synchronization: The application generates two storage files: applicationsmanager.json and addressbook.json. Both files contain information related to persons and jobs. If you make changes to persons or jobs in one file, you MUST replicate these changes in the other file. Failure to synchronize these files will result in data mismatches when the application loads, leading to undefined application behavior.
7. Command Syntax Sensitivity: Any non-adherence to the case sensitivity and input validation rules given in the command descriptions may cause unexpected errors. You should read through and follow these case sensitivity and input validation rules carefully.
8. Multiple Instance Conflicts: Running multiple instances of the application simultaneously can corrupt your data files. You should only run one instance of TalentMatch at a time. Close any existing instance before opening a new one.
9. Skill Storage Limitation: Adding skills that are more than 1 word long will result in an error. You can concatenate the skill into a single word before adding them as a compromise.

---

Command summary