Globebyte Documentation
  • Learning Agents for Salesforce
  • Experience for Learning
    • Setting up xAPI for Salesforce
    • Send xAPI from a Flow
    • Form Action fields
    • Send xAPI from Apex
    • xApiStatement Class reference
      • Actor
      • Verb
      • Object
      • Context
      • Result
      • Authority
      • Version
      • Send methods
    • Logging and defaults
  • Data for Learning
  • Actions for Learning
    • Creating the xAPI Actions Connected App
    • Setting up xAPI Actions
    • Creating your first xAPI Action Flow
    • xAPI Statement Data explorer
      • Metadata
      • xapiActor
      • xapiVerb
        • Verb reference
      • xapiObject
      • authority
      • xapiResult
      • xapiContext
    • Filtering xAPI Statements
    • Viewing xAPI Statements
    • Viewing xAPI Usage
    • Setting a default statement language
    • Error messages and troubleshooting
  • Learning Journey Data Model (LDM)
    • Introduction
    • Curriculums & Pathways
    • Courses & Modules
    • Pedagogies & Objectives
    • Rubrics & Criteria
    • Learning Resources
    • Assessments & Tasks
    • Learning Groups
    • Step-by-step working example
    • Activity Tracking (Advanced)
    • Additional Pedagogies Reference
    • Best Practices
    • Assess for Learning Integration
    • Data for Learning Integration
    • Object References
      • Learning Curriculum
      • Learning Pathway
      • Learning Course
      • Learning Module
      • Learning Pedagogy
      • Learning Objective
      • Learning Objective Assignment
      • Learning Rubric
      • Learning Rubric Criterion
      • Learning Rubric Model Solution
      • Learning Resource Type
      • Learning Resource
      • Learning Assessment
      • Learning Text Task
      • Learner Text Attempt
      • Learner Text Criterion Score
      • Learning Choice Task
      • Learner Choice Attempt
      • Learner Mark
      • Learning Group
      • Learner Group Membership
      • Learner Activity
      • Learner Activity Instance
      • Learner XAPIStatement
      • Developer Cheat Sheet: Key LDM Objects
  • Assess for Learning
    • Creating the Assess Connected App
    • Setting up Assess for Learning
    • Viewing Assessments
    • Assessment Outcomes & Validation
    • Marking
    • Best Practices
  • Tutor for Learning
    • Setting up Tutor
    • Agent Actions
      • Tutor_Mark
      • Tutor_Task
      • Tutor_Criterion
      • Tutor_SenseMaking
      • Tutor_Instruction
    • Topics
      • Tutor_Assessment
      • Tutor_Knowledge
  • Globebyte.com
Powered by GitBook
On this page
  • Send xAPI from a Flow
  • Mandatory fields
  • Error handling
  1. Experience for Learning

Send xAPI from a Flow

PreviousSetting up xAPI for SalesforceNextForm Action fields

Last updated 5 months ago

Send xAPI from a Flow

From an existing or a new Flow, you can add a Globebyte xAPI, Send xAPI action.

Select to add an Action then select xAPI from the category list then select the apex-Globebyte__XapiFlowConnector action.

The form contains a set of mandatory and optional xAPI fields. A full list of fields and their purpose can be found here.

Mandatory fields

Field
Description

Actor name

Human-readable Identifier such as the user’s name, to represent the individual or entity involved in the learning experience. Examples: 1) “John Smith” (fixed text) 2) “{!$Record.FirstName} {!$Record.LastName}” – when constructing the name from the $User system object for a User object change trigger.

Object Id

Unique identifier representing the learning content, activity, or resource being interacted with, enabling precise tracking and analysis of learner engagement. Examples – must be a URI: 1) https://some.domain.com/object/id If you use CIP codes you can consider them to construct your Object Id. If you use Salesforce for Education you will find the CIP codes in that schema. Product Id with commerce cloud can also be effective. The Id should be in Uri format, so a format may look like https://[my org domain]/[learning course.ClipCode]/[learning program ClipCode]

Object name

Human-readable label or title of the learning content, activity, or resource being interacted with, aiding in understanding and contextualizing the associated learning experience. Examples – must resolve to a text string: 1) “Learning Object Name” 2) “{!$User.customFieldName__c}” – providing the name from a custom field Make this dynamic by obtaining the name from a Salesforce schema that matches your use case.

Verb display

Human-readable label or description of the action or verb performed in the learning experience, aiding in understanding and interpretation of the associated activity. Examples – must resolve to a text string: 1) “experienced” 2) “{!User.customVerbField__c}” – providing the string from a custom field

Verb Id

Unique identifier assigned to the specific action or verb performed in the learning experience, facilitating accurate tracking and analysis of learner activities. Examples – must be a URI: 1) “http://adlnet.gov/expapi/verbs/experienced” 2) “https://some.domain.com/verb/id”

You must also provide a way to identify the user, of which there there are a few methods. The most common method is by using the Actor MBox field, which is the user’s email address.

To enter, enable the MBox option and enter their email. In the example above we are using the email from the $User system object for a User object change trigger. Note that you do not need to include mailto:

Error handling

In various use cases, you might find it necessary to handle errors, such as sending an internal email notification or altering the user experience flow. You can incorporate a standard Fault Path from the Globebyte xAPI action to efficiently manage your error handling processes. Read about error logging here.