No more double entries! Your training data is automatically synchronized between Ammon and Edusign. 🥰
Caution! When using a connection between an ERP and Edusign, it is not recommended to create or modify elements directly on Edusign while connected to an ERP, as this may result in data deletion or duplication.
Functioning
The Edusign-Ammon integration is bidirectional:
Downstream synchronization (Ammon to Edusign): Training data (attendance sheets, learners, instructors, groups) is automatically retrieved from Ammon and created in Edusign.
Upstream synchronization (Edusign to Ammon): Attendance records (presences, excused/unexcused absences, tardies, early departures) are uploaded to Ammon once the attendance sheets have been locked.
By default, only sessions with a status of "In Progress" (confirmed) are synchronized. Sessions marked "In preparation" are not retrieved. If you want these sessions to also be synchronized, a specific option can be enabled.
Synchronization Frequency
Downstream synchronization (Ammon to Edusign)
The connector synchronizes twice a day:
Between 11:30 a.m. and 2:00 p.m. (Paris time)
Between 6:30 p.m. and 10:00 p.m. (Paris time)
Synchronization schedules may vary slightly. We do not recommend making last-minute changes. It's best to submit any changes at least one day before a class scheduled for the following day.
The rolling window covers the next 14 calendar days (by default). A course scheduled to take place on Ammon more than 14 days from now will not yet be visible on Edusign. Classes that took place or were created on the same day are not synchronized.
Upstream synchronization (Edusign to Ammon)
Upstream attendance is recorded twice a day:
Between 11:30 a.m. and 1:30 p.m. (Paris time)
Between 6:30 p.m. and 9:00 p.m. (Paris time)
Note: Only report sheets that have been locked since the last synchronization.
Installation
Prerequisite Information
Please provide the following information to your Edusign contact. They are available from Valsoftware.
Parameter | Description |
API Access URL | URL provided by Valsoftware (e.g., |
Username | API Access Token |
Password | API Access Password |
Authentication token | Authentication token provided by Valsoftware |
Edusign API Token | Available from your Edusign representative |
Filter Options
These options allow you to precisely target the sessions that will be synchronized to Edusign.
Option | Description |
Filter by structure(s) | Allows you to synchronize only the sessions associated with one or more specific organizations. |
Filter by training activity(ies) | Allows you to synchronize only those sessions whose training activity corresponds to one or more specified statuses. |
Filter by session status | Allows you to synchronize only those sessions whose status matches one or more specified identifiers. |
Filter by subject code (exclusion) | Allows you to exclude sessions whose course code matches one or more specified codes. |
Filter by material code (inclusion) | Allows you to synchronize only those sessions whose course code matches one or more specified codes. |
Number of days to retrieve | Allows you to change the synchronization window (default: 14 days). |
Downstream Synchronization Options
These options customize the data that is sent back from Ammon to Edusign.
Option | Description |
Attendance sheets |
|
Display rooms in the comments | Displays the names of resources/rooms in the attendance sheet description. |
Display rooms as training rooms | Displays the names of resources/rooms in the "Room" field of the attendance sheet. |
Display the address of the training room | Displays the address of the training location in the "Room" field of the attendance sheet. |
Display the primary administrative contact | Add the name of the primary administrative contact to the attendance sheet description. |
Individual Sessions | Allows you to synchronize individual sessions (a single learner, not associated with a group). |
students |
|
Learners' email types | Allows you to choose the type of email to be forwarded: personal, work, or regular. By default, the work email address is displayed. |
Import only learners with email addresses | If enabled, learners without an email address will not be created on Edusign. |
Automatic sending of login details to students | Automatically send login credentials to students when they are added to Edusign during synchronization. |
Speakers |
|
Retrieving a Phone Number | Allows you to retrieve and synchronize the phone numbers of service providers from Ammon. |
Automatic sending of login details to speakers | Automatically send login credentials to participants when they are added to Edusign during synchronization. |
Upstream Synchronization Options
These options customize how Edusign reports attendance data to Ammon.
Option | Description |
Reasons for Absence | Allows you to configure the mapping between Edusign absence reasons and those in Ammon. Justified absences are then reported with the corresponding Ammon reason. |
Management of Early Departures | Allows you to specify the reason that will be reported to Ammon in the event of an early departure. The pattern must exist on Ammon. |
Your connector is already in place and you want to enable a feature? Support is here to help you. 🤗
Downstream Synchronization — Ammon to Edusign
Attendance Sheets
When you create or edit events on Ammon, all the information associated with them is synced back to Edusign in the form of attendance sheets:
Their name
Their date
The start and end time
The training room (if available)
Description (reference number + name of the training course)
The speaker(s)
The student(s)
Learner and instructor profiles are created on Edusign only when an attendance sheet is linked to them in the synchronization window. They will appear as soon as a training session is scheduled.
The learners
Once synchronization is complete, learners with a scheduled class during the synchronization window are automatically created:
Their name (required)
Their first name (required)
Their email address (optional, depending on the type of email configured)
Their phone number (optional)
Their company (optional)
Their training (optional—reference and name of the training session)
Speakers
Similarly, instructors with a class scheduled during the synchronization window are created automatically:
Their name (required)
Their first name (required)
Their email address (required)
Their phone number (optional, if the option is enabled)
Groups
Groups are created automatically for each training session. They show:
Their name (reference + ID + title of the training session)
Their description (reference, dates, number of hours)
Enrolled students
Upward Synchronization — Reporting Attendance to Ammon
Functioning
Signing in on Edusign: Students and instructors sign their attendance sheets on Edusign.
Lock: The attendance sheet is locked (manually or automatically).
Automatic Upload: Attendance records are uploaded to Ammon on the corresponding attendance sheet.
Reported data
For each learner:
Present: The duration of attendance is entered (total duration of the session).
Unexcused absence: The duration of the unexcused absence is entered.
Excused absence: The duration of the excused absence is entered, along with the corresponding reason for the absence (if reasons have been configured).
Late Arrival: The duration of the late arrival is recorded in addition to the attendance record.
Early Departure: If this option is enabled, the actual time present and the excused absence time are calculated based on the configured reason for early departure.
Comment: The learner's comment on the sheet has been submitted.
For each instructor:
Present (signed): Attendance is recorded on Ammon's instructor sign-in sheet.
Absent (did not sign): The total duration of unexcused absences is recorded on the instructor's sign-in sheet.
Common Problems and Checks
Verification | Details |
The attendance sheet was created on the same day or refers to a past session | Edusign synchronizes only the sessions for the next 14 days (by default). |
The attendance sheet has no instructor listed | The instructor must have a valid first name, last name, and email address on Ammon. |
The instructor's email address appears twice on Ammon | This prevents the sheet from being synchronized to avoid duplicates. |
The session has the status "In preparation" | By default, only "confirmed" sessions are synchronized. Enable the session filter option if necessary. |
The session has no learners or instructors | Sessions without learners or instructors are not created on Edusign. |
The learner is disabled on Ammon | Deactivated learners are ignored by the connector. |
The learner does not have an email address (with the option enabled) | If the "Import only learners with email addresses" option is enabled, learners without email addresses are ignored. |
Absences are not being reported | Verify that the attendance sheet is properly locked on Edusign and that the connector is in production. |
A list of events and errors related to synchronization is available in your account settings, under the "Connectors" tab > "More info."
If the problem persists despite these checks, our support team is here to help you. Please attach:
The Edusign account name
The session ID or the ID of the relevant learner
A screenshot of the problem
Downstream Synchronization FAQ.
If you still have questions about downward synchronization, a FAQ written by us may provide more answers. 😉
Upstream synchronization FAQ
⏱️ Optimize time with your account settings. ⏱️
To explore further, visit our help center.
💬 If you can't find what you're looking for, contact us via chat. 💬