internal mark myers, knowledge transfer architect [email protected] dita 1.3 learning and training...

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


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


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


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

. . .


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

. . .


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


Unit 2

Unit 3

Unit 4

. . .

bookmap (map)


?


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


Unit 2

Unit 3

Unit 4

. . .

learningBookmap (map)


learningObjectMap (map)


learningObjectMapRef (topicref)


DITA 1.2 Learning and Training Model – SAP Specialization

bookmap (map)



Indicator Meaning

One and only one

None or one

None, one, or more

One or more

?

*+


+




? + ?

learningObjectMapRef (topicref)+


Modeled Elsewhere

Specialized Element


Specialized Element in Separate File in CMS

Modeled Elsewhere

Course

Unit

Lesson

learningSummarybody


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”


Appendix


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)




Modeled Elsewhere


learningPlanRef learningPreAssRef learningOverviewRef learningPostAssRef learningSummaryRef



learningPostAss (topic)

learningPostAssRef (topicref)

learningPreAss (topic)

learningPreAssRef (topicref)

learningPlan (topic)

learningPlanRef (topicref)

learningOverview (topic) learningSummary (topic)learningPostAss (topic)learningPreAss (topic)learningPlan (topic)

* *

**

? ? ? ? ?

? ? ?

??*


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)




Modeled Elsewhere


learningPlanRef learningPreAssRef learningOverviewRef learningPostAssRef learningSummaryRef



learningPostAss (topic)

learningPostAssRef (topicref)

learningPreAss (topic)

learningPreAssRef (topicref)

learningPlan (topic)

learningPlanRef (topicref)

learningOverview (topic) learningSummary (topic)learningPostAss (topic)learningPreAss (topic)learningPlan (topic)

* *

**

? ? ? ? ?

? ? ?

??*


DITA 1.2 Learning and Training as Implemented by SAP

bookmap (map)


learningContentbody

lcObjectives

learningAssessment (topic)


Indicator Meaning

One and only one

None or one

None, one, or more

One or more

?

*+


+

concept (topic)

procedure (topic/task) exercise (topic/task)

demonstration (topic/task)

reference (topic)

frontmatter backmatter




conref

?

? + ?

learningObjectMapRef (topicref)+


Modeled Elsewhere

Specialized Element


Specialized Element in Separate File in CMS

Modeled Elsewhere

+

Course

Unit

Lesson


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

internal mark myers, knowledge transfer architect [email protected] dita 1.3 learning and training...

Documents

days unit

reuse unit

sap ag

day unit

standard sap training

multiple delivery methods

training duration

standard training