hat_12

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
hat_12 [2014/03/19 11:22] – barbarahat_12 [2019/07/23 15:59] (current) – [Boilerplate menu list size] Shelley Hunter
Line 1: Line 1:
-====== Boiler Plate Text (Standard Text / AutoText) ======+====== Boiler Plate Text (Standard Text/AutoText) ======
  
-Boiler Plate Text allows setting up of blocks of standard text which may be easily dropped into the current cursor position of the various free text notes fields.+===== Set Up Boiler Plate Text =====
  
-This is helpful for vacancy job description outlines, interview question outlines, contact events etc.+Boiler Plate Text, (BPT), allows the setting up of blocks of standard text which may be easily dropped into the current cursor position of the various free text notes fields. 
 + 
 +Useful for such things as meeting note headings, job description outlines or standard blocks of text for sending emails.
  
 Set up in Maintenance> Agency Setup> Boiler Plate Text. Set up in Maintenance> Agency Setup> Boiler Plate Text.
  
 Select whether you want the text to be accessible from: Select whether you want the text to be accessible from:
-\\ Company 
-\\ Vacancy 
-\\ Contact Event 
-\\ Company 
-\\ Applicant 
-\\ Text Message 
  
-Double click on the boiler plate text field to open the box to enter the text. +  * Company 
-\\ {{:bpt_double_click_to_add_text.jpg?500|}} +  * Vacancy 
-\\ {{:bpt_4.jpg?500|}}+  * Contact Event 
 +  * Company 
 +  * Applicant 
 +  * Text Message
  
-When inserting boiler plate fields, please make sure the fields are surrounded by {}s+The Type given to the Boiler Plate Text will determine where in IQX it can be used. For example, Progress type is available from the Insert Text on a progress record but if you want to use that block of text in a contact event from a progress record then it needs to be set up as a Contact Event Type.
  
- eg {APP_NAME}, {COM_NAME}+Text Message Type is used for sending SMS/Email from Shift Booking or Shift Confirmation.
  
-This allows the setting up of blocks of standard text which may be easily dropped into the current cursor position of the various free text notes fields. +Mail Merge Text buttons use the Contact Event Type.
-The below fields are available+
  
- SHIFTDETAILS          e.g. 01/02/2012 13:00-17:00+Insert a relevant Description, Division, (leaving this blank allows all Divisions to use the BPT), and a sort order.\\
  
- Applicant Fields : Accessible from Applicant, Vacancy, Placement +Double click on the boiler plate text field to open the box to enter the text.\\ 
- Boiler Plate Field    Table    Field        Example +{{ :bpt_double_click_to_add_text.jpg?500 |}}
- APP_NAME              Person         Name          Mr Fred Smith +
- APP_SURNAME          Person         Surname  Smith +
- APP_USURNAME          Person  Surname        SMITH +
- APP_FORENAMES        Person  Forenames      Fred +
- APP_UFORENAMES      Person  Forenames      FRED +
- APP_SALUTATION      Person         Salutation    Mr Smith +
- APP_ADDR1            Person  Addr1          Wester Newhouse +
- APP_ADDR2            Person  Addr2          Lilliesleaf +
- APP_ADDR3            Person  Addr3     +
- APP_TOWN              Person  Town          Melrose +
- APP_COUNTY            Person  County          Scottish Borders +
- APP_COUNTRY          Person  Country        Scotland +
- APP_POSTCODE          Person  Postcode        TD6 9JT +
- APP_DOB              Person  DOB            1/1/1990 +
- APP_SEX              Person  Sex            Male +
- APP_NI          Person         NI              AB123456C +
- APP_APPNUMBER        Person  AppNumber      123456 +
- APP_PAYROLLNUMBER    Person  Payrollnumber  1 +
- APP_REGISTRATIONDATE Person  RegistrationDate    01/01/2010 +
- APP_ADDRESS                                      Wester Newhouse, Lilliesleaf, Melrose, TD6 9JT +
- APP_PHN_HOME_TELEPHONE                                  01835 340034 +
- APP_PHN_DAY_TELEPHONE                                  01835 340034 +
- APP_PHN_FAX                                    01835 XXXXXX +
- APP_PHN_E-MAIL                                      Support@iqx.co.uk +
- APP_HEADERNAME                                  Mr Fred Smith +
- APP_LISTOFCVS                                    xxxxxx+
  
 +{{ :bpt_4.jpg?500 |}}\\
 +When inserting boiler plate fields, please make sure the fields are surrounded by {}s.
  
- Company Fields :  Accessible from Company, Vacancy and Progress + eg {APP_NAME}, {COM_NAME}... 
- Boiler Plate Table Field Example+ 
 +The fields that are available for the Boiler Plate Text will depend on where the text is being inserted from.  For example if you are making a contact event from the candidate record the Applicant Fields will be the only fields that are available.  However, if you make the contact event from a placement record then the applicant, company, vacancy, placement and progress fields will be available.   
 + 
 +==== Applicant Fields ==== 
 + 
 +Accessible from Applicant, Vacancy, Placement or a Contact Event (if it has a link to a Company, Vacancy, Placement record or via Shift Confirmation). 
 + 
 + Boiler Plate Field Table Field Example 
 + APP_NAME Person Name Mr Fred Smith 
 + APP_SURNAME          Person  Surname Smith 
 + APP_USURNAME          Person  Surname SMITH 
 + APP_FORENAMES        Person  Forenames Fred 
 + APP_UFORENAMES      Person  Forenames              FRED 
 + APP_SALUTATION      Person Salutation            Mr Smith 
 + APP_ADDR1            Person  Addr1                  Wester Newhouse 
 + APP_ADDR2            Person  Addr2                  Lilliesleaf 
 + APP_ADDR3            Person  Addr3     
 + APP_TOWN              Person  Town                  Melrose 
 + APP_COUNTY            Person  County                  Scottish Borders 
 + APP_COUNTRY          Person  Country                Scotland 
 + APP_POSTCODE          Person  Postcode                TD6 9JT 
 + APP_DOB              Person  DOB                    1/1/1990 
 + APP_SEX              Person  Sex                    Male 
 + APP_NI                Person  NI                      AB123456C 
 + APP_APPNUMBER        Person  AppNumber              123456 
 + APP_PAYROLLNUMBER    Person  Payrollnumber          1 
 + APP_REGISTRATIONDATE Person  RegistrationDate        01/01/2010 
 + APP_ADDRESSLONG Wester Newhouse, Lilliesleaf, Melrose, TD6 9JT 
 + APP_ADDRESS                                      Wester Newhouse 
 + Lilliesleaf 
 + Melrose 
 + TD6 9JT 
 + APP_PHN_HOME_TELEPHONE                          01835 340034 
 + APP_PHN_DAY_TELEPHONE                              01835 340034 
 + APP_PHN_MOBILE                              07777 XXXXXX 
 + APP_PHN_FAX                                          01835 XXXXXX 
 + APP_PHN_E-MAIL                                      [email protected] 
 + APP_HEADERNAME                                  Mr Fred Smith 
 + APP_LISTOFCVS                                    xxxxxx   
 + 
 +==== Company Fields ==== 
 + 
 +Accessible from Company, Vacancy, Progress or a Contact Event (if it has a link to a Company, Vacancy, Progress record or via Shift Confirmation). 
 + 
 + 
 + Boiler Plate Field Table Field Example
  COM_NAME Person  Name            Mr Fred Smith  COM_NAME Person  Name            Mr Fred Smith
- COM_SALUTATION Person   Salutation    Mr Smith+ COM_SALUTATION Person   Salutation    Mr Smith
  COM_COMPANYNAME Company Name          IQX Limited  COM_COMPANYNAME Company Name          IQX Limited
  COM_ADDR1 Company Addr1          Wester Newhouse  COM_ADDR1 Company Addr1          Wester Newhouse
- COM_ADDR2 Company  Addr2          Lilliesleaf + COM_ADDR2             Company  Addr2          Lilliesleaf 
- COM_ADDR3 Company  Addr3     + COM_ADDR3             Company  Addr3     
- COM_TOWN Company Town          Melrose + COM_TOWN             Company Town          Melrose 
- COM_COUNTY Company County          Scottish Borders + COM_COUNTY           Company County          Scottish Borders 
- COM_COUNTRY          Company  Country Scotland+ COM_COUNTRY          Company  Country         Scotland
  COM_POSTCODE          Company  Postcode        TD6 9JT  COM_POSTCODE          Company  Postcode        TD6 9JT
  COM_POSITION          Employment Position        Developer  COM_POSITION          Employment Position        Developer
  COM_DEPARTMENT        Employment Department      Development  COM_DEPARTMENT        Employment Department      Development
- COM_ADDRESS                          Wester Newhouse, Lilliesleaf, Melrose, TD6 9JT + COM_ADDRESSLONG                                    Wester Newhouse, Lilliesleaf, Melrose, TD6 9JT 
- COM_HOME_TELEPHONE                  01835 340034 + COM_ADDRESS                                      Wester Newhouse 
- COM_DAY_TELEPHONE                    01835 340034 + Lilliesleaf 
- COM_PHN_FAX                            01835 XXXXXX + Melrose 
- COM_PHN_E-MAIL                         [email protected] + TD6 9JT 
- COM_HEADERNAME                               Mr Fred Smith, IQX Limited+ COM_PHN_DIRECT_TELEPHONE                        01835 340034 
 + COM_PHN_MOBILE                              07777 XXXXXX 
 + COM_PHN_DIRECT_FAX                                      01835 XXXXXX 
 + COM_PHN_E-MAIL                                       [email protected] 
 + COM_HEADERNAME                                 Mr Fred Smith, IQX Limited
  
 +==== Vacancy Fields ====
 +
 +Accessible from Company, Vacancy, Progress, Placement, or a Contact Event (if it has a link to a Company, Vacancy, Progress record, Placement record or via Shift Confirmation).
  
- Vacancy Fields : Accessible from Company, Vacancy, Progress and Placement 
  Boiler Plate Field Table Field Example  Boiler Plate Field Table Field Example
  VAC_POSITION          Vacancy    Position        Desktop Support  VAC_POSITION          Vacancy    Position        Desktop Support
Line 89: Line 114:
  VAC_NOOFPOSTS        Vacancy    NoofPosts    1  VAC_NOOFPOSTS        Vacancy    NoofPosts    1
  VAC_EXPIRY            Vacancy    Expiry          01/12/2012  VAC_EXPIRY            Vacancy    Expiry          01/12/2012
 + VAC_SITEADDR1 Vacancy Addr1          Wester Newhouse
 + VAC_SITEADDR2           Vacancy  Addr2          Lilliesleaf
 + VAC_SITEADDR3           Vacancy  Addr3    
 + VAC_SITETOWN            Vacancy Town          Melrose
 + VAC_SITECOUNTY          Vacancy County          Scottish Borders
 + VAC_SITECOUNTRY         Vacancy  Country         Scotland
 + VAC_SITEPOSTCODE        Vacancy  Postcode        TD6 9JT
 + VAC_ADDRESSLONG                        Wester Newhouse, Lilliesleaf, Melrose, TD6 9JT
 + VAC_ADDRESS                    Wester Newhouse
 + Lilliesleaf
 + Melrose
 + TD6 9JT
 + VAC_SITENAME          Vacancy    SiteName        IQX Limited
 + VAC_SITECONTACT         Vacancy    SiteContact     Mr Fred Smith
 + VAC_SITEFAX          Vacancy    SiteFax        01835 XXXXXX
 + VAC_SITEEMAIL          Vacancy    SiteEmail       [email protected]
 + VAC_SITEPHONES          Vacancy    SitePhoneNumbers01835 340034
 + VAC_SITEROLE          Vacancy    Role        Manager
 +
 +
 +==== Shift Fields ====
 +
 +Accessible from Shift Confirmation buttons and can also be passed through to contact events via the shift confirmation and tempdesk – shifts screen.
 +
 +Can use **either** Shift Details **or** {SHF} fields but **not both**, if SHIFTDETAILS is used then none of the {SHF} fields will be available.
 +
 + Boiler Plate Field Example
 + SHIFTDETAILS          01/02/2012 13:00-17:00
 +
 +**OR**
 +
 + Boiler Plate Field Example
 + SHF_DATE 1/1/2015
 + SHF_FROM 8:00 
 + SHF_TO 10:30
 + SHF_NOTE Notes
 + SHF_BREAKMINUTES 30 
 + SHF_WHENCANCELLED 1/1/2015
 + SHF_THEIRREF A/1234
 + SHF_CANCELREASON Holiday
 + SHF_WHENCANCELLED 1/1/2015
 + SHF_PERSON Mr Fred Smith
 + SHF_CLIENTCONFIRMED 1
 + SHF_TEMPCONFIRMED 1
 + SHF_STATE P
 + SHF_STATEDESC Provisional
 + SHF_SERIALNUMBER 12345
 +
 +It is possible to list all shifts applicable (up to 365 days in advance) to an applicant. The shifts do not have to be referenced in the Shift Confirmation Screen.  This means that when confirming shifts you need only tick against one shift for a temp and it will list all of the shifts.
 +
 +{SHR_BEGIN}{SHR_DATE dd/mm/yyyy} {SHR_FROM} – {SHR_TO}{SHR_END}
 +
 +Would output something like:
 +
 + 01/07/2016 08:00 – 17-00
 + 02/07/2016 08:00 – 17-00
 + 03/07/2016 08:00 – 17-00
 + 04/07/2016 08:00 – 17-00
 +
 +SHR_BEGIN, can be replaced with {SHR_BEGIN_n}, where n is replaced by a number, e.g. {SHR_BEGIN_28}, which will list provisional/booked shift, in the period, current date ->current date + 28 days.  
 +
 +**Note** It is the current date that the Shift Range starts from and not the date of the shift you a confirming. This means that if you a confirming a shift in the future the SHR command might not list all of the shifts from the date you are confirming on.
 +
 +**These fields cannot be used with {SHIFTDETAILS}.**
 +
 +==== Shift Matching Fields ====
 + 
 + Boiler Plate Field Example
 + SHIFTDETAILS 01/02/2012 13:00-17:00
 + SHF_DATE 1/1/2015
 + SHF_FROM 8:00 
 + SHF_TO 10:30
 + SHF_THEIRREF A/1234
 +
 +If you wish to contact a candidate about their availability for more than one shift you can use {SHF_BEGIN} and {SHF_END} to list the shifts.
 +
 +{SHF_BEGIN}{SHF_DATE dd/mm/yyyy} {SHF_FROM} {SHF_TO}{SHF_END} {COM_COMPANYNAME}
 +
 +Would output something like:
 +
 + 01/07/2016 08:00 – 17-00
 + 02/07/2016 08:00 – 17-00
 + 03/07/2016 08:00 – 17-00 
 + IQX Limited
 +
 +**These fields cannot be used with {SHIFTDETAILS}.**
 +
 +==== Colleague Fields ====
 +
 +**ONLY** accessible from Shift Confirmation button.
 +Enables you to include the details of other candidates booked in to the same shift when confirming shifts.
 +
 + Boiler Plate Field Example 
 + {COL_DATE} 01/01/2016
 + {COL_FROM} 09:00
 + {COL_TO} 17:00
 + {COL_NOTE} Notes
 + {COL_BREAKMINUTES} 30
 + {COL_THEIRREF} A/645
 + {COL_CANCELREASON} Holiday
 + {COL_WHENCANCELLED} 01/01/2016
 + {COL_CLIENTCONFIRMED} 1
 + {COL_TEMPCONFIRMED} 1
 + {COL_STATE} P
 + {COL_STATEDESC} Provisional
 + {COL_SERIALNUMBER} 9876
 + {COL_ORDEREDBY} Jack Jones
 + {COL_CLIENTNOTE} Client Notes
 + {COL_APP_NAME} Fred Smith
 + {COL_APP_SURNAME} Smith
 + {COL_APP_ADDR1} Wester Newhouse
 + {COL_APP_ADDR2} Lilliesleaf
 + {COL_APP_ADDR3}
 + {COL_APP_TOWN} Melrose
 + {COL_APP_COUNTY} Scottish Borders
 + {COL_APP_COUNTRY} Scotland
 + {COL_APP_MOBILE} 07777 XXXXXX
 + {COL_APP_EMAIL} [email protected]
 +
 +==== Progress Fields ====
 +
 +Accessible from Progress, or a ContactEvent (if it has a link to a Progress Record)
  
-  
- Progress fields : Only accessible from Progress 
  Boiler Plate Field Table Field Example  Boiler Plate Field Table Field Example
  PRG_STATUS          Progress  Status          C  PRG_STATUS          Progress  Status          C
  PRG_ACTIONDATE      Progress    ActionDate      01/01/2012  PRG_ACTIONDATE      Progress    ActionDate      01/01/2012
- PRG_INTERVIEWDATE    Progress InterviewDate 01/01/2012+ PRG_INTERVIEWDATE    Progress  InterviewDate   01/01/2012
  PRG_INTERVIEWTIME    Progress  InterviewTime  12:45  PRG_INTERVIEWTIME    Progress  InterviewTime  12:45
-  
  
- Placement fields : Only accessible from Placement+==== Placement Fields ==== 
 + 
 +Accessible from Placement, or a ContactEvent (if it has a link to a Placement Record) 
  Boiler Plate Field Table Field Example  Boiler Plate Field Table Field Example
- PLC_SALARY          Placement Salary          20000 + PLC_SALARY          Placement Salary         20000 
- PLC_POSITION        Placement  Position        Desktop Support+ PLC_POSITION        Placement  Position       Desktop Support
  PLC_STARTDATE        Placement  StartDate      01/01/2012  PLC_STARTDATE        Placement  StartDate      01/01/2012
  PLC_LEAVEDATE        Placement  LeaveDate      01/06/2012  PLC_LEAVEDATE        Placement  LeaveDate      01/06/2012
Line 109: Line 256:
  
  
- Any additional phone types can be accessed (if present in the database) in the format of COM_<phonetype name> +==== Additional Phone Type Fields ====
- Eg +
- COM_PHN_SKYPE                                         +
- COM_PHN_FACEBOOK                                     +
- COM_PHN_LINKEDIN                                     +
- APP_PHN_SKYPE                                         +
- APP_PHN_FACEBOOK                                       +
- APP_PHN_LINKEDIN                                       +
- Only if the corresponding field is available.+
  
 +These can be accessed (if present in the database, Agency Set Up – Phone Types) in the 
 +format of COM_PHN_<phonetype name>
 +
 + E.g.
 +
 + COM_PHN_SKYPE xxxxxx
 + COM_PHN_FACEBOOK xxxxxx
 + COM_PHN_LINKEDIN xxxxxx
 + APP_PHN_SKYPE xxxxxx
 + APP_PHN_FACEBOOK xxxxxx
 + APP_PHN_LINKEDIN xxxxxx
 +
 +Only if the corresponding APP_PHN_E-MAIL or  COM_PHN_E-MAIL field is available.
 +
 +==== Custom Word Merge Fields ====
 +
 +Access via Maintenance->Database Setup.
 +
 +All merge fields can be accessed from within boiler plate text, if they follow same rules as above
 +
 +i.e.
 +
 +Applicant Fields : Accessible from Applicant, Vacancy, Placement or a ContactEvent (if it has a link to a Company, Vacancy, Placement record).\\
 +Company Fields :  Accessible from Company, Vacancy, Progress or a ContactEvent (if it has a link to a Company, Vacancy or Progress record).\\
 +Vacancy Fields : Accessible from Company, Vacancy, Progress, Placement, or a ContactEvent (if it has a link to a Company, Vacancy, Progress or Placement record).\\
 +Progress Fields : Accessible from Progress, or a ContactEvent (if it has a link to a Progress Record).\\
 +Placement Fields : Accessible from Placement, or a ContactEvent (if it has a link to a Placement Record).\\
 +
 +How to name a Custom Word Merge Field :-
 +
 +The same conventions apply, use the FieldCategory to determine the prefix
 +
 + Applicant Fields Starts with APP_\\
 + Company Fields Starts with COM_\\
 + Vacancy Fields Starts with VAC_\\
 + Progress Fields Starts with PRG_\\
 + Placement Fields Starts with PLC_\\
 + Contact Event Fields Starts with CON_\\
 + Branch Fields Starts with BRN_\\
 +
 +After the prefix, add on the FieldName
 +
 + e.g.
 + APP_UPPERTOWN
 + PLC_MINPAY
 +
 +The resulting name must be unique, i.e. if it is already a predefined boiler plate name, it will not be accessible. E.g. APP_NAME.\\
 +
 +
 +==== Questions ====
 +
 +Allows access to both the question answer and the description
 +
 +QTN_<Type>_<Tag Location>_<Tag Question ID>
 +
 +eg
 +  QTN_A_P_CUR   This could return the question answer for an applicant question CUR (currency)
 +  QTN_D_P_CUR   This could return the question description for an applicant question CUR (currency)
 +
 +Sub menu selection not currently supported.
 +Multiple / Graded and Scored Selection are output in a comma separated list.
 +
 +A question answer will only be evaluated if the question is applicable to the rest of the substitutions.
 +
 +
 +==== Letter / Consultant Fields ====
 +
 +All fields staff with ‘LET_’
 +
 + Boiler Plate Field Example
 + LET_TODAY 1st January 2015
 + LET_TODAY_dd/mm/yyyy 01/01/2015
 + LET_ADDRESSLONG Wester Newhouse, Lilliesleaf, Melrose, TD6 9JT
 + LET_ADDRESS Wester Newhouse
 + Lilliesleaf
 + Melrose
 + TD6 9JT
 + LET_CONSULTANT Fred Smith
 + LET_CONSULTANTTITLE Administrator
 + LET_CONSULTANTEMAIL [email protected]
 +
 +
 +==== Boilerplate menu list size====
 +
 +If you have large numbers of Boilerplate Text these will appear in one large list and some may disappear off the screen.  To make the list more manageable and ensure all templates can be seen it is possible to split the list into multiple smaller columns.\\ \\
 +
 +Switch off: {{:list_switch_off.jpg?200|}} Switch on: {{:list_switch_on.jpg?300|}}
 +
 +This requires system administrator set up in General Settings group of Settings number 1850, the value entered will be the number of templates in each column.
 +
 +\\ \\ \\
 Go back to [[hints_and_tips|Hints, Tips & Shortcuts]] Go back to [[hints_and_tips|Hints, Tips & Shortcuts]]
 +
 +Go back to [[ug1-22|References]]
  • hat_12.1395228138.txt.gz
  • Last modified: 2017/11/16 21:56
  • (external edit)