Using the TopClass – Personify Bridge

The TopClass–Personify360 Bridge provides a seamless two-way integration between your AMS and LMS:

  • Real-time profile sync: Individual and group accounts created or updated in Personify360 automatically sync to TopClass.
  • Single Sign-On (SSO): Members log in once on your website via Personify360 and are automatically logged into TopClass.
  • Product and enrollment management: Training product orders entered in Personify360 automatically create enrollments in TopClass, ensuring members can start courses immediately.
  • Completion writeback: TopClass can write completions, credits, and certification tracking information back to Personify360, updating member transcripts in real time.

This integration ensures accurate data flow, reduces manual effort, and gives members immediate access to learning activities.

Prerequisites

Before implementation, confirm you have the following:

  • A Personify test server with URL and test account credentials.
  • The URL to the Personify eBusiness production system (for example, http://company.personifycorp.com:105/PersonifyEbusiness/default.aspx)
  • The URL to the Personify data services
    • Note if the Personify data services has been customized (for example, http://company.personifycorp.com:105/PersonifyDataServices/PersonifyData.svc/)
  • URL to the Personify SSO services (for example, http://company.personifycorp.com:105/SSO/webservice/service.asmx)

Single Sign On (SSO)

TopClass’ Personify360 integration includes a standard single sign-on mechanism via Personify360:

  1. User authentication
    • A user logs into Personify360 first.
    • If the user is already logged into Personify, they must navigate to the following URL in order to be logged into TopClass automatically: https://<DOMAIN>/topclass/login.do?bridgeSource=personify.
    • If the user is not logged into Personify and tries to access any TopClass URL, access will be denied.
    • If the user has not authenticated in Personify360, they are redirected to Personify360 to log in.
  2. Redirect to Personify360 login page
    • When a user attempts to access TopClass without an active Personify360 session, they are redirected to the Personify360 login page.
      📘

      Note

      The TopClass redirect URL must be set as

      https://<DOMAIN>/topclass/login.do?bridgeSource=personifyin the system settings

    • After successful authentication, the user is redirected back to TopClass automatically.
  3. Token validation
    • Personify360 issues a token to TopClass upon successful authentication.
    • TopClass validates the token/assertion to ensure it is authentic.
  4. Redirect to TopClass with user ID
    • TopClass uses the validated token to identify the user.
    • The user is then directed to the appropriate TopClass endpoint for login.
  5. User login to TopClass
    • With the user identifier from Personify360, TopClass initiates the userJIT process.
    • The user is logged into TopClass automatically.

Data flow: Personify360 > TopClass

The TopClass–Personify360 Bridge enables seamless data transfer between your AMS and LMS:

  • User and group information: Accounts and groups created or updated in Personify360 automatically sync to TopClass.
  • Activity information: Activities created or updated in Personify360 are synchronized to TopClass, reducing duplicate data entry.
  • Enrollment and order information: User enrollments or orders in Personify360 are synchronized to TopClass, allowing immediate access to purchased courses.

The bridge uses Personify Data Services (PDS) and is compliant with Personify360 version 7.4.2. TopClass Support provides default database views for each data set, which can be customized to meet your requirements. Data is retrieved via the PDS.

User and Group Information

User and group data can be synchronized using two complementary mechanisms:

  1. Batch synchronization (ETL)
    • Synchronizes all groups into TopClass.
    • Synchronizes all users and assigns them to their Primary Group.
    • Runs on a scheduled interval via the TopClass UI, with a report generated after each run.
    • Only records that have changed since the last ETL run are extracted; changed records can be customized using USR_WBT_USERS_CHANGED_SINCE_SP.
  2. Just-in-Time (JIT) synchronization
    • Updates user information at the point of authentication.

    • Allows creation of new users on-the-fly when they log into TopClass for the first time.

    📘

    Note

    Groups are not available via JIT. Groups must already exist for user assignment.

ETL and JIT can be used in parallel, such as nightly ETL for all users while JIT picks up users created during the day.

Activity Information

  • Activities from Personify360 are synchronized to TopClass via ETL.
  • ETL runs can be scheduled via the TopClass UI and generate a report after each sync.

Enrollment/Order Information

  • User enrollments or orders in Personify360 are synchronized to TopClass using JIT.
  • This ensures that purchased items are immediately available to the user in TopClass upon login.

Data flow: TopClass > Personify360

TopClass can transfer data back to Personify360 using a standard web service. No additional configuration is required for this process.

  • Completion writeback: Completions and activity data are sent from TopClass to Personify360 for activities originally created via the Personify Bridge (i.e., the activity exists in both systems).
  • Certification tracking: If the activity is part of a certification program, completion writeback can also update the corresponding certification requirements in Personify360.

Responsibilities: TopClass Support & Customer

TopClass Support and the customer are expected to manage the following responsibilities.

AreaTopClass SupportCustomer
SSO- Enable Personify SSO within TopClass- Set up Vendor information in the Personify SSO database:
- VendorName: WBTSYSTEMS
- VendorIdentifier: 8
- VendorPassword: B643757F4330067FB6EDB04FCEADEDE7
- VendorBlock: 87B172C131181DD6A791FAFD0EE475EB
- Configure your website to provide a link to TopClass with this URL format: http://<yourserver>/topclass/personifySSO.do?bridgeSource=personify
- Confirm the URL with the TopClass Support team during the implementation
Users & groups (Personify > TopClass)- Provide default views to extract data
- Discuss user data requirements during the functional requirements workshop to confirm what data and fields are needed
- Configure the Personify Bridge to map the fields from Personify to their respective fields in TopClass
- Provide information on fields needed in TopClass
- Confirm if JIT or batch should be used (or both)
- Update and install views on the Personify database
Activities (Personify > TopClass)- Provide default views to extract data
- Discuss activity data requirements to be passed to TopClass
- Discuss which activities should be created in TopClass and how to restrict them
- Configure the Personify Bridge to map the fields from Personify to their respective fields in TopClass
- Provide information on fields needed in TopClass
- Update and install views on the Personify database
Enrollments/orders (Personify > TopClass)- Provide default views to extract data- Update and install views on the Personify database
Data from TopClass > Personify- Confirm if the Certification module in Personify is being used and if so, should the Bridge update the requirements as being completed as part of a transcript write back

ADDENDUM 1 – List of Procedures and Views

NameObject TypeDescriptionType
USR_WBT_USERS_CHANGED_SINCE_SPProcedureCalled by the ETL process for Users.  It will take all users from the common view who have changed since the last time synchedETL
USR_WBT_USER_JIT_SPProcedureCalled by the JIT process for Users.  It will take details about a specific userJIT
USR_WBT_USER_SYNC_DETAILS_VWViewThe view which contains the details of the attributes of a user to synchronize from Personify to TopClass.BOTH
USR_WBT_ALL_COMPANIES_SPProcedureCalled by the ETL process for Groups.  It will take all companies from the underlying view who have changed since the last time synchedETL
USR_WBT_COMPANY_SYNC_DETAILS_VWViewThe view which contains the details of the attributes of a group to synchronize from Personify to TopClass.ETL
USR_WBT_ONLINES_CHANGED_SINCE_SPProcedureCalled by the ETL process for Online Activities.  It will take all courses from the underlying view who have changed since the last time synchedETL
USR_WBT_ONLINES_CHANGED_SINCE_SPViewThe view which contains the details of the attributes of a course to synchronize from Personify to TopClass.ETL
USR_WBT_ONLINEENROL_CHANGED_SINCE_SPProcedureCalled by the JIT process for Users enrollments/orders.  It will take all enrollments for a specified user since the last time enrollments were synchronizedJIT
USR_WBT_ONLINEENROL_SYNC_DETAILS_VWViewThe view which contains the details of the attributes of online enrollments/orders to synchronize from Personify to TopClass.JIT