internal mark myers, knowledge transfer architect [email protected] dita 1.3 learning and training...
TRANSCRIPT
INTERNAL
Mark Myers, Knowledge Transfer [email protected]
DITA 1.3 Learning and Training Proposal 13089
© 2011 SAP AG. All rights reserved. 2
Agenda
■ Example of a standard SAP training with multi-modal outputs
■ Challenge: how to enable learning object reuse among multiple delivery modes
■ Proposal for learningObjectMap support in DITA 1.3
© 2011 SAP AG. All rights reserved. 3
SAP Education Overview
Milestone First XML-based
instructor-led training content @ SAP
2001 2003 2005 2007 2011 2012
Milestone Multilingual Content
in 22 languages
Milestone XML-based SAP
Documentation Education Content
Customizer to enable dynamic course assembly
Milestone Modular and multi-
modal training content based on DITA 1.2
Enable outputs for Instructor-Led, Virtual, and E-Learning
Milestone XML-based
e-learning
Milestone 10 courses
completed by Q1 120 course in
production over Q2-Q4
© 2011 SAP AG. All rights reserved. 4
Simplified Example of DITA 1.2 Learning & Training Model
learningBookmap (map)
learningOverview (topic) learningContent (topic) learningSummary (topic)
learningOverviewbody learningSummarybody
Indicator Meaning
One and only one
None or one
None, one, or more
One or more
?
*+
learningContentRef (topicref)learningOverviewRef (topicref) learningSummaryRef (topicref)
+
learningObject (topicref)
learningGroup (topicref)
? + ?
Standard DITA Element
Modeled Elsewhere
Separate File in CMS
learningSummarybody
© 2011 SAP AG. All rights reserved. 5
Standard Training Offering
■ Standard classroom offering■ Covers wide range of content
Unit 1
Lesson 1
Lesson 2
Lesson 3
SAP 100Delivery: Instructor-Led TrainingDuration: 5 Days
Unit 2
Unit 3
Unit 4
. . .
© 2011 SAP AG. All rights reserved. 6
Multi-Modal Variants of Standard Offering
■ Variants of standard offering■ Subsets of same content in multiple delivery methods
Unit 1
Lesson 1
Lesson 2
Lesson 3
SAP 100aDelivery: Instructor-Led TrainingDuration: 3 Days
Unit 2
Unit 3
Unit 4
. . .
Unit 1
Lesson 1
Lesson 2
Lesson 3
SAP 100bDelivery: Virtual-Live ClassroomDuration: 2 Days
Unit 2
Unit 3
Unit 4
. . .
Unit 1
Lesson 1
Lesson 2
Lesson 3
SAP 100cDelivery: SCORM E-learningDuration: 1 Day
Unit 2
Unit 3
Unit 4
. . .
© 2011 SAP AG. All rights reserved. 7
Mapping SAP Courses to DITA 1.2
■ We mapped a “course” to a learningBookmap and “unit” to a learningGroup■ Lesson mapping was not so easy, we wanted to reuse them directly■ DITA 1.2 defines learningObject in learningMap/learningBookmap, not optimal for reuse
Unit 1
Lesson 1
Lesson 2
Lesson 3
SAP 100Delivery: Instructor-Led TrainingDuration: 5 Days
Unit 2
Unit 3
Unit 4
. . .
bookmap (map)
learningGroup (topicref)
?
© 2011 SAP AG. All rights reserved. 8
One Possible Solution to Enable Learning Object Reuse
■ Add two specializations■ learningObjectMapRef is defined inside maps, references learningObjectMap■ learningObjectMap files can then be stored as separate reusable components
Unit 1
Lesson 1
Lesson 2
Lesson 3
SAP 100Delivery: Instructor-Led TrainingDuration: 5 Days
Unit 2
Unit 3
Unit 4
. . .
learningBookmap (map)
learningGroup (topicref)
learningObjectMap (map)
learningObject (topicref)
learningObjectMapRef (topicref)
© 2011 SAP AG. All rights reserved. 9
DITA 1.2 Learning and Training Model – SAP Specialization
bookmap (map)
learningOverview (topic) learningContent (topic) learningSummary (topic)
learningOverviewbody learningSummarybody
Indicator Meaning
One and only one
None or one
None, one, or more
One or more
?
*+
learningContentRef (topicref)learningOverviewRef (topicref) learningSummaryRef (topicref)
+
learningObjectMap (map)
learningObject (topicref)
learningGroup (topicref)
? + ?
learningObjectMapRef (topicref)+
Standard DITA Element
Modeled Elsewhere
Specialized Element
Separate File in CMS
Specialized Element in Separate File in CMS
Modeled Elsewhere
Course
Unit
Lesson
learningSummarybody
© 2011 SAP AG. All rights reserved. 10
DITA 1.3 Proposal
We found the above statement to be true, we could easily create the specializations we needed to enable learning object reuse
However, tool support was lacking, we had to make many customizations for content authoring, management, and publishing
Since learning objects will likely be a common reuse component, we propose that the DITA TC officially support such a feature in DITA 1.3
• Will allow for standardized tool support
• Make learning objects truly “reusable”, even cross-company
DITA provides a framework by which XML vocabulary and constraint modules can be combined in an infinite number of ways to create specific document types
“- DITA Version 1.2 Specification”
© 2011 SAP AG. All rights reserved. 12
Standard DITA 1.2 Learning and Training Model
map (map)
learningOverview (topic) learningContent (topic)
learningSummary (topic)
Indicator Meaning
One and only one
None or one
None, one, or more
One or more
?
*+
learningContentRef (topicref)learningOverviewRef (topicref)
learningSummaryRef (topicref)
learningObject (topicref)
learningGroup (topicref)
Standard DITA Element
Modeled Elsewhere
Separate File in CMS
learningPlanRef learningPreAssRef learningOverviewRef learningPostAssRef learningSummaryRef
learningObject (topicref)
learningGroup (topicref)
learningPostAss (topic)
learningPostAssRef (topicref)
learningPreAss (topic)
learningPreAssRef (topicref)
learningPlan (topic)
learningPlanRef (topicref)
learningOverview (topic) learningSummary (topic)learningPostAss (topic)learningPreAss (topic)learningPlan (topic)
* *
**
? ? ? ? ?
? ? ?
??*
© 2011 SAP AG. All rights reserved. 13
DITA 1.2 Learning and Training Model – SAP Constraints
bookmap (map)
learningOverview (topic) learningContent (topic)
learningSummary (topic)
Indicator Meaning
One and only one
None or one
None, one, or more
One or more
?
*+
learningContentRef (topicref)learningOverviewRef (topicref)
learningSummaryRef (topicref)
learningObject (topicref)
learningGroup (topicref)
Standard DITA Element
Modeled Elsewhere
Separate File in CMS
learningPlanRef learningPreAssRef learningOverviewRef learningPostAssRef learningSummaryRef
learningObject (topicref)
learningGroup (topicref)
learningPostAss (topic)
learningPostAssRef (topicref)
learningPreAss (topic)
learningPreAssRef (topicref)
learningPlan (topic)
learningPlanRef (topicref)
learningOverview (topic) learningSummary (topic)learningPostAss (topic)learningPreAss (topic)learningPlan (topic)
* *
**
? ? ? ? ?
? ? ?
??*
© 2011 SAP AG. All rights reserved. 14
DITA 1.2 Learning and Training as Implemented by SAP
bookmap (map)
learningOverview (topic) learningContent (topic) learningSummary (topic)
learningContentbody
lcObjectives
learningAssessment (topic)
learningOverviewbody learningSummarybody
Indicator Meaning
One and only one
None or one
None, one, or more
One or more
?
*+
learningContentRef (topicref)learningOverviewRef (topicref) learningSummaryRef (topicref)
+
concept (topic)
procedure (topic/task) exercise (topic/task)
demonstration (topic/task)
reference (topic)
frontmatter backmatter
learningObjectMap (map)
learningObject (topicref)
learningGroup (topicref)
conref
?
? + ?
learningObjectMapRef (topicref)+
Standard DITA Element
Modeled Elsewhere
Specialized Element
Separate File in CMS
Specialized Element in Separate File in CMS
Modeled Elsewhere
+
Course
Unit
Lesson
© 2011 SAP AG. All rights reserved. 15
MMCP Unified Infrastructure Increments 1 & 2
Content ManagementAlfresco 3.3.4
Content DesignModified DITA 1.2 SchemaDITAWorks Webtop 1.1.26
Content AuthoringModified DITA 1.2 Schema
DITA XML - Xopus 4.2.4Media - PowerPoint & Flash
Simulations - Captivate
Link Mgmt. & XML Validation
Componize 1.3 Modified DITA 1.2 Schema
ILT/VLC PublishingAntenna House 5.2
Custom KPS Stylesheets
E-Learning Publishing
KPS E-Learning PlayerCustom KPS Stylesheets
Content RenderingComponize 1.3 XPROC Pipelines
DITA Open ToolkitMedia Transformation Server
Production WorkflowJBOSS jBPM Workflow Engine & Alfresco ActionsMicrosoft Outlook
Content RepositorymySQL 5.0
TranslationSLS Translation Portal
Project ManagementKPS Project Management & Translation Dashboards. Alfresco Standard UIAlfresco JavaServer Faces
User AccessInternet Explorer 8.0+, Firefox 5.0+, Windows Explorer (via CIFS)Single-Sign On