view the slides here.

Rolling Out DITA by Rolling In
SharePoint and DITA Exchange
Sheila D’Annunzio, STMicroelectronics
Steffen Frederiksen, DITA Exchange
Content Strategies/DITA NA, Baltimore April 2011
About STMicroelectronics
 STMicroelectronics is a global leader serving customers
across the spectrum of electronics applications with
innovative semiconductor solutions.
 In 2010, the Company’s net revenues were $10.35 billion.
Further information on ST can be found at www.st.com.
2
DITA
SharePoint
Word
About DITA Exchange




DITA on Microsoft SharePoint & Office
Open (use any other tool)
Key part of the Microsoft “Intelligent Content Framework”
Customers in:
 Semiconductors
 Pharma & Life sciences
 Hi-Tech manufacturing
 www.dita-exchange.com / [email protected]
>< DITA Exchange ApS
Katrinebjerg Science Park
Aabogade 15
DK-8200 Aarhus N
DENMARK
>< DITA Exchange Inc.
900 E. Hamilton
Campbell
California 95008
USA
4
Contents
 The business drivers
 SharePoint as a CCMS with DITA Exchange
 Word as an XML editor and publishing engine.
 Overcoming challenges in the implementation process
 Publishing process
 Metadata
 The future roadmap
 Connecting to the corporate web site
 Implementing workflows via SharePoint
 Handling translation
 Exchanging data with joint-venture-partners.
5
The business drivers
Introduction - DITA in ST
 Ran pilot in 2008 / 2009
 Used only versioning system for pilot – no CCMS
 Stopped as files soon became unmanageable

Put in CCMS DITA Exchange in 2010
Managing the hundreds of files converted in the pilot caused a lot of pain!
7
Basic CCMS requirements
File management (file names, versions, links and metadata)
Link management (where topics are used)
Map download and upload (with all linked files)
Workflows
Integrate publication process
Integrate conditional processing
Related topics (branch/clone)
Access rights
8
Extra CCMS requirements
Within budget
IT department approval
Collaboration tool easy to
deploy to SMEs
Scale up to hundreds of SMEs
9
How Dx met these needs
IT deployed SharePoint, in-line with
company policy
SMEs know SharePoint
DITA Word editor easy to use for SMEs
Cost reasonable, SharePoint already
budgeted, only buy Dx part
Can easily scale up due to
reasonable cost
10
DITA Word editor
11
DITA Word editor
12
DITA Word editor
13
Additional benefits
No need to buy editor
Word-based output process
Can tweak output for things like page breaks
Can easily change output format (change the Word template)
Can add custom stylesheet for more complex transformations
Easy to integrate with other business systems (out-of-the-box SharePoint)
TopicPicker - allows any employee to reuse DITA content in classic Word docs
Can produce OpenXML – use as input to other processes (e.g. IP-XACT database)
We got up and running very quickly as we started with a hosted (cloud) solution 
15
Overcoming challenges in the
implementation process
The publishing process
 In pilot had customized the DITA-OT and
integrated it into XMetaL
 Dx has choice of DITA-OT or Dx Word publisher
 DITAWord (OpenXML)PDF
 Was skeptical about using the Dx Word publisher
but decided to try…………………….
17
Dx Word publisher benefits
Uses a .dotm template
which is very easy to
modify without any
programming
knowledge!
18
Dx Word publisher benefits
 Going through Microsoft Word gives you some “artistic license” with
the layout
 For example you can force tables to start at the top of a page or
insert a page break
 This avoids the criticism of ugly PDFs – a common complaint from
customers after moving to XML!
 But beware – tech writers must not update the content here!!!!
19
And it worked…………………..
Word output
PDF

Save as
20
DITA Exchange Word Publisher
21
DITA Exchange Word Publisher
 Other “Use Cases”:
 Publish from DITA to Word template, with instructional
text, optional text, standard required text, drop-down
lists, etc.
 Publish hybrid DITA content: DITA topics and Word
documents mixed in a DITA map
 “Word Washer” publishing: Standardize all styling
 Checking for document policies/business rules
22
Metadata
 Underestimated the importance
 Thought could just use out-of-box metadata
23
Metadata
 Dx has no folder structure
 If metadata is not well defined cannot find
anything
24
Why Folders Are “Bad”
Topic 1
?
25
Why Folders Are “Bad”
Topic 1
!
Topic 1
Topic 1
26
Why Metadata are Great
27
Customized metadata
 Customized the metadata without
specializing DITA
 Used <data> element
28
Metadata mapping, Word editor
 Easy to fill-in, even for SMEs who make the first draft
29
Metadata mapping, CCMS
 Easy to search and filter
30
Dynamic Metadata Configuration
SharePoint “Content Types”
With built-in inheritance
Document
Dx
Document
DITA
Office
Map
Topic
DITAVAL
Task
Concept
Reference
Publication
Word
Excel
Media
PowerPoint
Image
Video
Math
31
Dynamic Metadata Configuration
Document
Dx
Document
DITA
Office
Map
Topic
DITAVAL
Task
Concept
Reference
Publication
Word
Excel
Media
PowerPoint
Image
Video
Math
32
Dynamic Metadata Configuration
Document
Dx
Document
DITA
Office
Map
Topic
DITAVAL
Task
Concept
Reference
Publication
Word
Excel
Media
PowerPoint
Image
Video
Math
33
Dynamic Metadata Configuration
Document
Dx
Document
DITA
Office
Map
Topic
DITAVAL
Task
Concept
Reference
Publication
Word
Excel
Media
PowerPoint
Image
Video
Math
34
Dynamic Metadata Configuration
Document
Dx
Document
DITA
Office
Map
Topic
DITAVAL
Task
Concept
Reference
Publication
Word
Excel
Media
PowerPoint
Image
Video
Math
35
Metadata Mapping To DITA XML
36
Metadata Mapping To DITA XML
//prolog/metadata/data[@name=“DrugDosageForm”]/@value
37
Dynamic Metadata Configuration
1. Create a metadata field
2. Attach to a content type
3. Define XML mapping (for XML files)
4. DONE!
38
Dynamic Metadata Configuration
1. Create a metadata field
2. Attach to a content type
And BTW, as a side effect of
this, you get “Where Used”,
“Family
Tree”,(for
andXML
link files)
3. Define XML
mapping
management for all Office files
too…
4. DONE!
39
The future roadmap
Next steps
 Bring tool in-house
 Connect to internal tools
Translation
memory
Product
catalog
Web
CMS
41
Connect to internal tools

42
Connect to internal tools
1. (Open external content (with IPXACT/SIDSC) in
Word editor)
2. Insert or edit (in Word) IPXACT/SIDSC building
blocks
3. Publish (Word Publisher) with embedded
IPXACT tagging
4. Extract IPXACT from published document
43
Workflows
 DITA Exchange workflows = SharePoint workflows
44
Collaboration?
Collaboration!
Customer
Customer
Shared Content Collaboration Platform
Sub-contractor
Sub-contractor
Sub-contractor
DITA
I
Love
48
SharePoint
Loves
Dita
49
THANK YOU!
DITA Exchange
50