Email Group Notifications

Email Group Notifications provide a mechanism for maintaining single or groups of email addresses for use by Jobs and iqxWEB when distributing messages reports etc. Individual email addresses etc can then be changed in IQX without having to edit the jobs each time.

• Topic - a pre-agreed token e.g. RegisterCandidate or CompleteTimesheet

• Email Address - can be one or more recipient addresses, separated by commas or semicolons

• Message Text - the text of the email. May contain tokens such as

  {loadform}/person/{personid}/cv

  which will convert to hyperlinks to load a specified form and view in IQX

• Supported tokens are:
  • {personid}
  • {companyid}
  • {vacancyid}
  • {loadform}

• Division and Department can be used to narrow down the recipients for a particular notification. If they are left blank this recipient will receive all notifications for the topic

A Scheduled Job, EmailStaffNotifier.xml or equivalent, must be running to do the actual sending.

Sample Job

<?xml version="1.0"?>
<Job title="Dispatch Email Notifications" autoclose="Yes">
	<SQLQuery>
		<SQLSelect>
			<![CDATA[
				select id, topic, body, hyperlink, departmentid, divisionid 
				from EmailStaffNotification
				where Dispatched is null and Requested > current date - 3
			]]>
		</SQLSelect>
		<ForEachRow>
			<SetVariable name="recipients" sql="select list(emailaddress,';') from EmailStaffNotificationAddress where topic=:topic and (departmentid=:departmentid or departmentid is null) and (divisionid=:divisionid or divisionid is null)"/>
			<If x1="{recipients}" x2="" comparison="!=">
				<SetVariable name="emailbody">
					<WriteLn>{body}</WriteLn>
					<If x1="{hyperlink}" x2="" comparison="!=">
						<WriteLn/>
						<WriteLn>http://localhost:55000/iqx/loadform/{hyperlink}</WriteLn>
						<WriteLn>Note: the above link will only work if IQX is running on the current device and configured to respond</WriteLn>
					</If>
				</SetVariable>
				<SendEmail subject="IQX Notification" smtpsettings="EMAILSTAFFNOTIFY">
					<EmailRecipients>{recipients}</EmailRecipients>
					<EmailBody>{emailbody}</EmailBody>
				</SendEmail>
			</If>
			<SQLExec>
				<![CDATA[update EmailStaffNotification set Dispatched=current timestamp, Recipients=:recipients where id=:id]]>
			</SQLExec>
		</ForEachRow>
	</SQLQuery>
</Job>

There are two alternative functions which can be invoked from a web net procedure or anywhere else:

RequestEmailStaffNotification ( in pTopic char(50),in pBody long varchar,in pHyperLink char(100),in pDepartmentID char(2) default null,in pDivisionID char(20) default null )

pTopic links to the Topic in Agency Setup - Email Group Notifications. pHyperLink is the woodpecker form to load with parameters e.g. person/xxpersonidyy

Alternatively structured Message Text can be created in the maintenance containing tokens like

{loadform} /

{personid} and the alternative call used: RequestLinkedEmailStaffNotification( in pTopic char(50),in pPersonID char(20) default null,in pCompanyID char(20) default null,in pVacancyID char(20) default null,in pDepartmentID char(2) default null,in pDivisionID char(20) default null )