SIF Activity
This SIF (School Interoperability Framework) activity allows the user to take a Workflow model triggered by an HR Employee table record (BT20.HREmpmstr) and send the change in employee information to a ZIS defined Web Site. The Workflow model should process data for each life flow to ensure that any changes to the employee flows through the ZIS Web site. When triggering through the BusinessPlus page, it is not necessary to adhere to any particular Workflow model naming convention.
Properties
A Workflow Activity can be defined as a SIF Activity by either selected the "Edit Properties" of an existing activity within a Workflow model, or by inserting a new generic activity or special exception handler activity.
Transaction Set: The type of transaction being set to the ZIS URL site. This determines the type handling of the resulting XML Document that is sent to the site. Currently, the only valid transaction set is "StaffPersonal."
ZIS URL: This field contains the name of the URL that the resulting transaction will be sent to. Setting the value to "TEST" allows the user to execute this activity in test mode. When this occurs, the resulting XML HTTP request will be routed to a flat file in Web Server's subdirectory C:\inetpub\wwwroot\SIFEvent.xml for independent validation of the resulting XML Document.
SIF Agent Name: This field represents the agent's name for the transaction being routed to the ZIS URL Web Site.
In addition, it is necessary to perform some setup prior to executing this activity within a Workflow model. The SIF specifications require some codes to adhere to a standard set of codes. This requirement necessitates mapping tables to convert the BusinessPlus codes to SIF-recognized codes. All of these mappings are done in the HR Code page (HRTBHR).
The BusinessPlus Code is always defined in the CODE VALUE field while the SIF Code is always defined in the DESCRIPTION field. The LONG DESCRIPTION is free for the user to describe the entries in more detail if needed. However, it is not used explicitly by the SIF Activity.
The below table shows a list of definitions that must exist for the SIF Activity to execute properly.
HR BusinessPlus Page | Definition | Code ID | Code Value | Description |
|---|---|---|---|---|
HRCODE | County Codes | SIF_COUNTY | IFAS Value | SIF Value |
HRCODE | Ethnic Codes | SIF_ETHNIC | IFAS Value | SIF Value |
HRCODE | Phone Codes | SIF_PHONE | IFAS Value | SIF Value |
HRCODE | Marital Status | SIF_MARITAL_ST | IFAS Value | SIF Value |
HRCODE | ID | SIF_ID | IFAS Value | SIF Value |
HRCODE | Job Class | SIF_JOBCLASS | IFAS Value | SIF Value |
HRCODE | School | SIF_SCHOOL | IFAS Value | SIF Value |
- SIF_JOBCLASS should have one single entry that defines the OtherId SIF object type to use for communicating the Job Classification Code.
- SIF_ID should have a single entry that defines the OtherId SIF object type to use for communicating the BusinessPlus ID.
- SIF_SCHOOL can have the following two entries:
- NONE – This defines a school value to assign to teachers that are not assigned to any school or have no pay assignments.
- ANY – This specifies the school value to place on all teacher assignments in addition to any they are assigned to through pay assignments.
The following fields are the data sources for the SIF Activity:
Job Code: HR PCN Table (HRPcntble), Miscellaneous Code #1
School: HR Pay Assignment Table (HREmppay), Position[1, 2]
Phone Number: Format = "NA".
Type = HR Employee Definition (HREmpmstr), PhoneCd1, PhoneCd2
Data = HR Employee Definition (HREmpmstr), PhoneNo1, PhoneNo2
Email Type: Type = "primary." Data = HR Employee Definition (HREmpmstr), Email
Name: Type = "02"
FirstName = HR Employee Definition (HREmpmstr), FName
LastName = HR Employee Definition (HREmpmstr), LName
MiddleName = HR Employee Definition (HREmpmstr), MName
Prefix = HR Employee Definition (HREmpmstr), Salute
Suffix = HR Employee Definition (HREmpmstr), Suffix
Demographics: Gender – HR Employee Definition (HREmpmstr), Gender
BirthDate – HR Employee Definition (HREmpmstr), Bdt
PlaceOfBirth – HR Employee Definition(HREmpmstr), BirthPlace
MaritalStatus = HR Employee Definition (HREmpmstr), Mrt
CitizenShip = HR Employee Definition (HREmpmstr), CitizenShip
Ethnic Type: Type = "NA"
Proportion = "100"
Code = HR Employee Definition (HREmpmstr), Ethnic
Address: Street Line 1 = HR Employee Definition (HREmpmstr), St1
Street Line 2 = HR Employee Definition (HREmpmstr), St2
City = HR Employee Definition (HREmpmstr), City
State = HR Employee Definition (HREmpmstr), State
County = HR Employee Definition (HREmpmstr), County
Country = HR Employee Definition (HREmpmstr), Country
PostalCode = HR Employee Definition (HREmpmstr), Zip
SSN: Type = "01"
Data = HR Employee Definition (HREmpmstr), Ssn
Execution
When the SIF activity executes within a Workflow model, an XML HTTP request is created using the Workflow model information on the employee. The ZIS Web Site is sent the XML HTTP Request and the response saved in the Workflow model's record data. Error in the XML HTTP requests or failure to contact the ZIS Web Site successfully will result in the activity's failure.