Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

This is a LearningBuilder-specific feature that supports LearningBuilder Subscribers.

Overview

Excerpt
nameSummaryForParentPage

API that is called from LearningBuilder to initiate a nightly sync with the Learning Hub.

LearningBuilder can perform a daily “sync” with the Learning Hub. The process is:

  • A scheduled task is set up for the LearningBuilder client that hits a Learning Hub API every night

  • The Hub keeps track of the last date that a sync was performed and identifies all new Events that were created since that time

  • The Hub converts those Events into a Workflow Import Queue API payload and sends it to LearningBuilder

  • LearningBuilder processes the imported data on a background queue, just like when a CSV file is uploaded

Calling the API

API Hostnames

See https://heuristicsolutions.atlassian.net/wiki/spaces/DOCS/pages/3697770890/Learning+Hub#API-Hostnames

Authentication

See https://heuristicsolutions.atlassian.net/wiki/spaces/DOCS/pages/3697770890/Learning+Hub#Authentication

POST /api/processEvents
Handy status macro
set36399
isLabeledfalse
historySnapshotId7cfb151d-d309-448c-9e11-ef4dcd1953cc
status185953
historyChainId995d84a4-485f-470b-9882-e5f4d573912a

Info

Initiates a process in which the Hub identifies new Events (from Publishers that the caller is subscribed to) and then posts those events to the caller’s LearningBuilder instance using API/WorkflowImportQueue/CreateBatch.

Requires that the Event Subscription record contains a translation template that maps the Publisher’s Activity Type to the Workflow Import Queue process that should be performed.

HTTP POST Payload

Code Block

Parameter

Description

ProgramId

The Program to sync.

Info

The specified API Key must have write access to this Program, or be a system-level key.

Responses

Response Code

Headers and Body

200 (Ok)

A Workflow Import Queue batch was successfully created on the Subscriber’s LearningBuilder instance.

This does NOT mean that the data is valid, just that the batch was accepted and will begin processing in the background.