Connecting to Edval - PosiEd K-12
If the Edval app is not yet created and configured in your Org, follow the steps below.
Go to Setup -> App Manager.
In the Lightning Experience App Manager, click New Connected App button.
Input the following values:
Connected App Name = Edval
API Name = Edval (autopopulated)
Contact Email = product email/company email
Enable OAuth Settings = Checked
Callback URL = (URL is login if production, test if sandbox)
Selected OAuth Scopes = Full access (full)
Go back to the App Manager and click Manage beside the LISS/Edval app.
Click Edit Policies and update the IP Relaxation to Relax IP restrictions and save.
Go to Setup > OAuth and OpenID Connect Settings > enable Allow OAuth Username-Password Flows
Sharing Settings
Note: If this has already been configured in the Org during the Edval Daily setup, there's no need to repeat it.
OBJECT | READ | CREATE | EDIT | Default Internal Access | Default External Access |
Account | Private | Private | |||
Asset | Private | Private | |||
Bell Time | Controlled by Parent | Controlled by Parent | |||
Cohort | Private | Private | |||
Cohort Member | Controlled by Parent | Controlled by Parent | |||
Cohort Schedule | Controlled by Parent | Controlled by Parent | |||
Cohort Schedule Connection | Controlled by Parent | Controlled by Parent | |||
Cohort Session | Controlled by Parent | Controlled by Parent | |||
Employee Role | Controlled by Parent | Controlled by Parent | |||
Calendar | Show Details and Add Events | Show Details and Add Events | |||
PosiEd Log | Private | Private | |||
PosiEd Settings (custom) | -- | -- | |||
PosiEd Value Mapping (custom) | -- | -- | |||
Session | Private | Private | |||
Student Record | Controlled by Parent | Controlled by Parent | |||
Subject | Private | Private | |||
Subject Offering | Private | Private | |||
Timetable Structure | Controlled by Parent | Controlled by Parent | |||
User | Public Read Only | Public Read Only |
User Setup for Integration
Note: If this has already been configured in the Org during the Edval Daily setup, there's no need to repeat it.
Create a user with the following details:
Note: When trying to log in with the user above, you will see the message below.
Create the Permission Set first.
Label: Edval
API Name: (auto-populated)
Description: Permission set for objects and fields used for Edval processes
License: Salesforce API Integration
Give access to the following objects and fields
OBJECT | READ | CREATE | EDIT | VIEW ALL | MODIFY ALL |
Account | |||||
Asset | |||||
Bell Time | |||||
Cohort | |||||
Cohort Member | |||||
Cohort Schedule | |||||
Cohort Schedule Connection | |||||
Cohort Session | |||||
Employee Role | |||||
Event | |||||
PosiEd Log | |||||
Session | |||||
Student Record | |||||
Subject | |||||
Subject Offering | |||||
Timetable Structure |
Go to the user record and assign the EDVAL permission set. The EDVAL permission set provides access to the objects and fields needed for the sync process.
Edval Syncing Process
After creating the Edval app, connect your Org and the Edval file.
Go to the updated Edval app > go to File -> Synchronise -> Configure and select Posimente and click Configure.
Populate the fields with their corresponding values:
URL = https:// + {instance URL, from Setup -> My Domain -> Current My Domain URL+
/services/apexrest/PosiEd/liss
In the URL, if the connection is not working, try to:
exclude the Posi_Ed
or do not include the _ between Posi and Ed
Username = Salesforce org username
Password = Salesforce org password
School code = an Educational Institution record’s School code in Salesforce
Client Id = previous Connected App’s Consumer Key
Client Secret = previous Connected App’s Consumer Secret
Go to App Manager > Edval > View > Manage Consumer Details
Click Test connection to confirm.
Save the configuration.
You can now start the Publish process.
These records must be imported into the Org before the Publish process. Please refer to the instructions in the link below.
After importing the necessary records into the Org, you can begin the publishing process.
Publish the data sets in the order shown below. Publish each item separately and allow a few minutes before publishing the next item. This is to ensure that the processing of the data that was transferred is complete before the next set of data is sent.
From Edval App:
Publish Student
Before doing the Publish Student synching, make sure to set up the PosiEd Value Mapping (custom settings) for the LISS Grade Level values and Gender field automation. See the file below for your reference.
Publish Teachers
Before doing the Publish Teacher, make sure the etz file for Teachers from Edval has the Email and Staff IDs field populated. These two should be unique. This is one of the criteria for the linking of the Users to the Employee Role records.
Workaround: You can also turn off the Employee Role triggered flow before publishing, and then turn it On again after publishing.
You have the option to turn off the Employee role and create a User instead. The User created should follow the following criteria:
The Profile should be the School Personnel.
The role has been set.
Permission Set Group should be added based on the role.
The user should be added to his/her designated School Public group.
Employee Role triggered flow includes the creation of the Users and will automatically link to the Employee Role records. The User will have a Profile entered and specified in the Default Profile ID field of the custom settings.
Note: The Staff users should have a correct profile license for the Calendar access. The Chatter Free license is a non-calendar license.
Publish Rooms/Assets
Publish Bell times/Time Block
Before doing the Publish Bell Time, we need to add the complete Period values.
Make sure TTStructure records are set correctly. (Check how many TTStructure is linked to the School account).
If the TTStructure is not set up correctly, the PPublish Bell time will be affected. There will be missing bell time records after synching.
Publish Classes (Cohort)
Import the PosiEd Value Mapping for the Primary Grade Level population before doing the Publish Classes
Publish Timetable/Cohort Schedule
Publish Class lists/Cohort Member