SlideShare une entreprise Scribd logo
1  sur  25
Télécharger pour lire hors ligne
Baby Steps
Automated Publishing Using
Arbortext and SharePoint
Brett McCorkle, Rita Briody
May 8, 2013
• Where we started
• Small, manageable improvements we implemented
• Publishing alternatives we evaluated
• Proof of concept we constructed
• Struggles and challenges we encountered
Agenda
5/8/2013 2
Peeps
Brett McCorkle
– Senior Technical Writer with 8 Years Experience
– Arbortext System Administrator
– Focus on IT Documentation, Diagrams, Standards, etc.
– Bachelors, Management Information Systems
Rita Briody
– Technical Writer II with 5 Years Experience
– Focus on new software and technology
– Bachelors, Political Science, candidate
Master of Science in Computer and
Information Science
5/8/2013 3
Who We Are
Company
– Established 1925
– Property/Casualty, Commercial, and Life Insurance
– 11 states and the District of Columbia
Team
– 14 writers in IT Division
– Various backgrounds including
IT, Mathematics, and English
– Experience levels ranging from 2 to 20+
years in technical writing
5/8/2013 4
Background
• BookMaster mainframe publishing
• Large monolithic books
– Copious amounts of content
– We documented the features,
not the tasks
• Print and online distribution
• Word documents eventually became the norm
– Developed templates for several document types
– Published as PDFs
• ERIEbooks designed for mainframe docs, not PDFs
5/8/2013 5
Approach
• Baby steps!
– Small improvements
over 8 years
• New methods
– Minimalism
– Structured Authoring
• New tools
– Arbortext
– ECM
• ERIEbooks became
our biggest limitation
5/8/2013 6
New Methods
• Attended webinars and performed research
– Minimalism
– Structured Authoring
– What the heck is DITA???
• Assigned small groups to provide training to the rest
of the team
– Divide and conquer
– Presentations, working sessions, email newsletters
• Reinforced later with formal on-site training from
ComTech Services
5/8/2013 7
New Tools
• Inherited budget from another group to purchase
Arbortext (very, very lucky)
• Controlled our own destiny
– Assigned technical writers with IT backgrounds to configure and
support the tool
• Began a several year effort to manually convert the
content from our legacy systems
• Implemented content management
– The company already owned IBM Document Manager
– Small work requests to prove and implement Arbortext and DM
5/8/2013 8
New Capabilities
• Our content is now XML-based
– Began with DITA 1.1, upgraded to DITA 1.2
• Multiple output formats from the same source
– PDF, HTML, EPUB, and online help
• But… we are only publishing to PDF
• Users want more options and better search results
– They are all spoiled by Google
• ERIEbooks, our current delivery system,
is not up to the task
5/8/2013 9
I‟m sorry sir, but I
can„t do that…
Benefits
• Minimalism greatly improved our documents
– Action-oriented approach
– Focused on users goals
– Reduced wasteful, repetitive content
• DITA saves us time
– Focus on content, not formatting
– Reuse between documents
– Arbortext creates documents in minutes, not hours (BookMaster)
5/8/2013 10
ERIEbooks Problems
• Users are unable to find our documentation
• ERIEbooks, our content delivery system, is very
limited
– Created 15+ years ago as a “temporary solution”
– Pointer system, does not store our content
– Can only reference PDFs and old mainframe documents
– Search limited to document number, title, and 5 keywords
– Limited browsing by subject matter
– No usage tracking or feedback mechanisms
• We must make it easier for users to find the
information they need in the format they want
5/8/2013 11
Options
• Do nothing
– Continue using ERIEbooks in its current state (boo!)
• Buy something
– Purchase and implement an off-the-shelf solution ($$$$)
• Dream big
– Build an adapter to connect SharePoint to our source files in IBM
Document Manager
• Use what we already have
– Develop a solution to publish our content to SharePoint 2010 using
Arbortext
5/8/2013 12
First Attempt
• We had big dreams
– Big, Hairy, Audacious Goals (BHAGs!)
– Created a wish list of requirements
– Wanted drastic improvements over our current system
• Unrealistic expectations produced few results
– Little progress made for about a year
– Evaluated vendor solutions, all were expensive, none fully met our
lofty requirements
– Worked with internal and external resources to produce a design
that was ultimately unfeasible
• We needed to change our mindset and our approach
5/8/2013 13
The Chosen One
• We took a step back and simplified our goals
– Shaved the BHAG!
– Scaled back our wish list
– Reviewed our existing technology
• Focused on the most important requirements
– Modern features: full-text search, usage tracking
– Deliver multiple formats: PDF, HTML, EPUB
– Use tools we already own: Arbortext, SharePoint
– Does not require external resources
• Provides a foundation for future enhancements
5/8/2013 14
Design Summary
1. Authors send SOAP requests to the Arbortext
Publishing Engine containing the document ID and
any required parameters
2. Connect to our source repository, IBM Document
Manager
3. Create an HTML version of the requested DITA
document
4. Send a SOAP response with the HTML document
attached
5. Load the document from the SOAP response into
SharePoint, replacing the previous version
5/8/2013 15
Design Diagram
5/8/2013 16
Proof of Concept
Needed to prove we could:
– Connect the Arbortext Publishing Engine to Document Manager
– Create an interface for SOAP requests
– Send the output to SharePoint
– Eliminate use of out-of-support applications (BookMaster)
5/8/2013 17
What We Did
• Three months to complete a proof of concept (POC)
• Connected Arbortext Publishing Engine to DM
– Adapter bundled with Arbortext
– Already in use by writers using Arbortext Editor
• Created interface to submit publish requests
– Began an official POC with our IT Lab (thanks, Rita!)
– Worked with the IT Lab developers to create an application
– Application sends requests to Arbortext and loads the resulting
document into SharePoint
5/8/2013 18
Challenges Faced
• Providing metrics to management
– No usage tracking in ERIEbooks
– Difficult to prove anyone used it
• Generating interest and forming alliances
• Budget and resource limitations
– No money to purchase hardware or software
– Low priority effort, work completed during “down time”
• Lack of necessary skills
– Needed other groups to help develop the solution
• Performance issues
– Needed to upgrade the Publishing Engine server
5/8/2013 19
Results
• Successfully proved our design
– HTML content automatically loads into SharePoint
– SharePoint returns full-text search results of our content
• Benefits from SharePoint features
– Full text search with in-line results
– Usage tracking
– Versioning
– Personalization (through Active Directory)
• Overwhelming management support
– Approved project to implement our design
– Obtained estimates from required company resources
5/8/2013 20
Reality Check
• Budgets and corporate priorities don‟t always directly
support our goals, we‟re here to support theirs
– Competed with other projects for developer resources
– Lost priority to higher rated initiatives
– Placed on hold indefinitely
• The need to replace our archaic system still exists
– We have simplified our approach again
– Still using SharePoint while showing we are adaptable to limited
company resources
• New approach lays the ground work for future
enhancements
5/8/2013 21
What‟s Next?
• Continue our Baby Steps journey
• Implement ERIEbooks “Lite”
– Start simple: Replicate ERIEbooks
– Remove existing limitations
– Perform usage tracking
• Goals
– Help our users find what they‟re looking for
– Demonstrate innovation using SharePoint to the company
• Slowly implement additional features
– Publish our content in SharePoint
– Provide full text search, personalization, etc.
5/8/2013 22
Timeline
5/8/2013 23
Questions
Brett McCorkle
– brett.mccorkle@erieinsurance.com
– http://www.linkedin.com/in/brettmccorkle
– @DrunkenMonkie
Rita Briody
– rita.briody@erieinsurance.com
– http://www.linkedin.com/in/ritalillianbriody
– @nerdiva
5/8/2013 24
Thank You
Please provide feedback on SurveyMonkey
Kiosks Available in the Registration Area
www.surveymonkey.com/s/STC13sessions
5/8/2013 25

Contenu connexe

Tendances

Mct Summit 2013 Why SharePoint 2013
Mct Summit 2013   Why SharePoint 2013Mct Summit 2013   Why SharePoint 2013
Mct Summit 2013 Why SharePoint 2013Chris Givens
 
Office 365 Deployment Strategies
Office 365 Deployment StrategiesOffice 365 Deployment Strategies
Office 365 Deployment StrategiesBert Johnson
 
Sahil Gupta- Latest
Sahil Gupta- LatestSahil Gupta- Latest
Sahil Gupta- LatestSahil Gupta
 
Introduction to SharePoint 2013 Content Management
Introduction to SharePoint 2013 Content ManagementIntroduction to SharePoint 2013 Content Management
Introduction to SharePoint 2013 Content ManagementNetwoven Inc.
 
Troubleshooting: The Two Laws - IXIASOFT User Conference 2016
Troubleshooting: The Two Laws - IXIASOFT User Conference 2016Troubleshooting: The Two Laws - IXIASOFT User Conference 2016
Troubleshooting: The Two Laws - IXIASOFT User Conference 2016IXIASOFT
 
June 2018 spc recap visual
June 2018 spc recap visualJune 2018 spc recap visual
June 2018 spc recap visualCaitlin Young
 
Lessons In Sharing Open Source
Lessons In Sharing Open SourceLessons In Sharing Open Source
Lessons In Sharing Open SourceLeslie Labrecque
 
Metrics for continual improvements - Nolwenn Kerzreho LavaconDublin2016
Metrics for continual improvements - Nolwenn Kerzreho LavaconDublin2016Metrics for continual improvements - Nolwenn Kerzreho LavaconDublin2016
Metrics for continual improvements - Nolwenn Kerzreho LavaconDublin2016IXIASOFT
 
How ECM Has Improved in SharePoint 2013 and What’s Still Missing
How ECM Has Improved in SharePoint 2013 and What’s Still MissingHow ECM Has Improved in SharePoint 2013 and What’s Still Missing
How ECM Has Improved in SharePoint 2013 and What’s Still MissingMike Ferrara
 
Going with the Flow: Rationalizing the workflow options in SharePoint Online
Going with the Flow: Rationalizing the workflow options in SharePoint OnlineGoing with the Flow: Rationalizing the workflow options in SharePoint Online
Going with the Flow: Rationalizing the workflow options in SharePoint OnlineBob German
 
Power Users Guide to Office 365 - Collab365 Summit 2016
Power Users Guide to Office 365 - Collab365 Summit 2016Power Users Guide to Office 365 - Collab365 Summit 2016
Power Users Guide to Office 365 - Collab365 Summit 2016Chirag Patel
 
aOS Canadian Tour Share point migration tips
aOS Canadian Tour Share point migration tipsaOS Canadian Tour Share point migration tips
aOS Canadian Tour Share point migration tipsMike Maadarani
 
CPS - Transitioning from SharePoint to Project Server 2013 for Enterprise Pro...
CPS - Transitioning from SharePoint to Project Server 2013 for Enterprise Pro...CPS - Transitioning from SharePoint to Project Server 2013 for Enterprise Pro...
CPS - Transitioning from SharePoint to Project Server 2013 for Enterprise Pro...Giles Hamson
 
Migrating Lotus Notes Applications to Sharepoint: Preparations and Analysis
Migrating Lotus Notes Applications to Sharepoint: Preparations and AnalysisMigrating Lotus Notes Applications to Sharepoint: Preparations and Analysis
Migrating Lotus Notes Applications to Sharepoint: Preparations and AnalysisMaarga Systems
 
Power BI vs Tableau: Which is Better Business Tool
Power BI vs Tableau: Which is Better Business ToolPower BI vs Tableau: Which is Better Business Tool
Power BI vs Tableau: Which is Better Business ToolStat Analytica
 
Lifecycle Management with SharePoint Apps and Solutions
Lifecycle Management with SharePoint Apps and SolutionsLifecycle Management with SharePoint Apps and Solutions
Lifecycle Management with SharePoint Apps and SolutionsSPC Adriatics
 

Tendances (20)

Webinar: The Slippery Slope of Migrating to SharePoint Online or On-Premise
Webinar: The Slippery Slope of Migrating to SharePoint Online or On-PremiseWebinar: The Slippery Slope of Migrating to SharePoint Online or On-Premise
Webinar: The Slippery Slope of Migrating to SharePoint Online or On-Premise
 
Mct Summit 2013 Why SharePoint 2013
Mct Summit 2013   Why SharePoint 2013Mct Summit 2013   Why SharePoint 2013
Mct Summit 2013 Why SharePoint 2013
 
121 shaffer
121 shaffer121 shaffer
121 shaffer
 
Office 365 Deployment Strategies
Office 365 Deployment StrategiesOffice 365 Deployment Strategies
Office 365 Deployment Strategies
 
Sahil Gupta- Latest
Sahil Gupta- LatestSahil Gupta- Latest
Sahil Gupta- Latest
 
Introduction to SharePoint 2013 Content Management
Introduction to SharePoint 2013 Content ManagementIntroduction to SharePoint 2013 Content Management
Introduction to SharePoint 2013 Content Management
 
Troubleshooting: The Two Laws - IXIASOFT User Conference 2016
Troubleshooting: The Two Laws - IXIASOFT User Conference 2016Troubleshooting: The Two Laws - IXIASOFT User Conference 2016
Troubleshooting: The Two Laws - IXIASOFT User Conference 2016
 
June 2018 spc recap visual
June 2018 spc recap visualJune 2018 spc recap visual
June 2018 spc recap visual
 
Lessons In Sharing Open Source
Lessons In Sharing Open SourceLessons In Sharing Open Source
Lessons In Sharing Open Source
 
Metrics for continual improvements - Nolwenn Kerzreho LavaconDublin2016
Metrics for continual improvements - Nolwenn Kerzreho LavaconDublin2016Metrics for continual improvements - Nolwenn Kerzreho LavaconDublin2016
Metrics for continual improvements - Nolwenn Kerzreho LavaconDublin2016
 
How ECM Has Improved in SharePoint 2013 and What’s Still Missing
How ECM Has Improved in SharePoint 2013 and What’s Still MissingHow ECM Has Improved in SharePoint 2013 and What’s Still Missing
How ECM Has Improved in SharePoint 2013 and What’s Still Missing
 
Enterprise PM use of SP at NAU
Enterprise PM use of SP at NAUEnterprise PM use of SP at NAU
Enterprise PM use of SP at NAU
 
Lotus Notes to SharePoint Migration
Lotus Notes to SharePoint MigrationLotus Notes to SharePoint Migration
Lotus Notes to SharePoint Migration
 
Going with the Flow: Rationalizing the workflow options in SharePoint Online
Going with the Flow: Rationalizing the workflow options in SharePoint OnlineGoing with the Flow: Rationalizing the workflow options in SharePoint Online
Going with the Flow: Rationalizing the workflow options in SharePoint Online
 
Power Users Guide to Office 365 - Collab365 Summit 2016
Power Users Guide to Office 365 - Collab365 Summit 2016Power Users Guide to Office 365 - Collab365 Summit 2016
Power Users Guide to Office 365 - Collab365 Summit 2016
 
aOS Canadian Tour Share point migration tips
aOS Canadian Tour Share point migration tipsaOS Canadian Tour Share point migration tips
aOS Canadian Tour Share point migration tips
 
CPS - Transitioning from SharePoint to Project Server 2013 for Enterprise Pro...
CPS - Transitioning from SharePoint to Project Server 2013 for Enterprise Pro...CPS - Transitioning from SharePoint to Project Server 2013 for Enterprise Pro...
CPS - Transitioning from SharePoint to Project Server 2013 for Enterprise Pro...
 
Migrating Lotus Notes Applications to Sharepoint: Preparations and Analysis
Migrating Lotus Notes Applications to Sharepoint: Preparations and AnalysisMigrating Lotus Notes Applications to Sharepoint: Preparations and Analysis
Migrating Lotus Notes Applications to Sharepoint: Preparations and Analysis
 
Power BI vs Tableau: Which is Better Business Tool
Power BI vs Tableau: Which is Better Business ToolPower BI vs Tableau: Which is Better Business Tool
Power BI vs Tableau: Which is Better Business Tool
 
Lifecycle Management with SharePoint Apps and Solutions
Lifecycle Management with SharePoint Apps and SolutionsLifecycle Management with SharePoint Apps and Solutions
Lifecycle Management with SharePoint Apps and Solutions
 

En vedette

STC Summit 2013: DITA Collaboration - Paul Wlodarczyk - easyDITA 2013-05-07
STC Summit 2013: DITA Collaboration - Paul Wlodarczyk - easyDITA 2013-05-07STC Summit 2013: DITA Collaboration - Paul Wlodarczyk - easyDITA 2013-05-07
STC Summit 2013: DITA Collaboration - Paul Wlodarczyk - easyDITA 2013-05-07easyDITA
 
Impac Systems Iso Draw
Impac Systems   Iso DrawImpac Systems   Iso Draw
Impac Systems Iso Drawjackieliles
 
Redish stc summit 2013
Redish stc summit 2013Redish stc summit 2013
Redish stc summit 2013Ginny Redish
 
Purposes, Personas, Conversations -- Practical Techniques for Everything You ...
Purposes, Personas, Conversations -- Practical Techniques for Everything You ...Purposes, Personas, Conversations -- Practical Techniques for Everything You ...
Purposes, Personas, Conversations -- Practical Techniques for Everything You ...Ginny Redish
 
S1000D Compliant Technical Illustrations
S1000D Compliant Technical IllustrationsS1000D Compliant Technical Illustrations
S1000D Compliant Technical IllustrationsVizualsite LLC
 
Writing Vibrant, Compelling Copy
Writing Vibrant, Compelling CopyWriting Vibrant, Compelling Copy
Writing Vibrant, Compelling CopyGinny Redish
 
Redish understanding users
Redish understanding usersRedish understanding users
Redish understanding usersGinny Redish
 
S1000D - An Overview
S1000D - An OverviewS1000D - An Overview
S1000D - An OverviewMonaRice
 

En vedette (11)

STC Summit 2013: DITA Collaboration - Paul Wlodarczyk - easyDITA 2013-05-07
STC Summit 2013: DITA Collaboration - Paul Wlodarczyk - easyDITA 2013-05-07STC Summit 2013: DITA Collaboration - Paul Wlodarczyk - easyDITA 2013-05-07
STC Summit 2013: DITA Collaboration - Paul Wlodarczyk - easyDITA 2013-05-07
 
Impac Systems Iso Draw
Impac Systems   Iso DrawImpac Systems   Iso Draw
Impac Systems Iso Draw
 
Redish stc summit 2013
Redish stc summit 2013Redish stc summit 2013
Redish stc summit 2013
 
Purposes, Personas, Conversations -- Practical Techniques for Everything You ...
Purposes, Personas, Conversations -- Practical Techniques for Everything You ...Purposes, Personas, Conversations -- Practical Techniques for Everything You ...
Purposes, Personas, Conversations -- Practical Techniques for Everything You ...
 
s1000d Data Modules
s1000d Data Modules   s1000d Data Modules
s1000d Data Modules
 
S1000D Compliant Technical Illustrations
S1000D Compliant Technical IllustrationsS1000D Compliant Technical Illustrations
S1000D Compliant Technical Illustrations
 
S1000D tutorial
S1000D tutorialS1000D tutorial
S1000D tutorial
 
Writing Vibrant, Compelling Copy
Writing Vibrant, Compelling CopyWriting Vibrant, Compelling Copy
Writing Vibrant, Compelling Copy
 
Introduction to S1000D
Introduction to S1000DIntroduction to S1000D
Introduction to S1000D
 
Redish understanding users
Redish understanding usersRedish understanding users
Redish understanding users
 
S1000D - An Overview
S1000D - An OverviewS1000D - An Overview
S1000D - An Overview
 

Similaire à Baby Steps: Automated Publishing Using Arbortext and SharePoint

Microsoft SharePoint & Project Server are Better Together
Microsoft SharePoint & Project Server are Better TogetherMicrosoft SharePoint & Project Server are Better Together
Microsoft SharePoint & Project Server are Better TogetherC/D/H Technology Consultants
 
Advanced SharePoint for Project Managers
Advanced SharePoint for Project ManagersAdvanced SharePoint for Project Managers
Advanced SharePoint for Project ManagersHaniel Croitoru
 
Movin’ on Up SPS Houston 2016
Movin’ on Up SPS Houston 2016Movin’ on Up SPS Houston 2016
Movin’ on Up SPS Houston 2016Jim Adcock
 
Where did design view go in SharePoint Designer
Where did design view go in SharePoint DesignerWhere did design view go in SharePoint Designer
Where did design view go in SharePoint DesignerPatrick O'Toole
 
Collaborative Working: University of Sunderland & Roundhouse Digital
Collaborative Working: University of Sunderland & Roundhouse Digital Collaborative Working: University of Sunderland & Roundhouse Digital
Collaborative Working: University of Sunderland & Roundhouse Digital Terminalfour
 
Exploring SharePoint 2013 and Improving your Business Applications
Exploring SharePoint 2013 and Improving your Business ApplicationsExploring SharePoint 2013 and Improving your Business Applications
Exploring SharePoint 2013 and Improving your Business ApplicationsSociusPartner
 
15 tips for bullet proof requirements analysis on SharePoint projects
15 tips for bullet proof requirements analysis on SharePoint projects15 tips for bullet proof requirements analysis on SharePoint projects
15 tips for bullet proof requirements analysis on SharePoint projectsDocFluix, LLC
 
SharePoint and Drupal: Yes, We Can Coexist!
SharePoint and Drupal: Yes, We Can Coexist!SharePoint and Drupal: Yes, We Can Coexist!
SharePoint and Drupal: Yes, We Can Coexist!Donna Rodriguez
 
SharePoint 2013 Migration - Your 5 Rules for Success
SharePoint 2013 Migration  - Your 5 Rules for SuccessSharePoint 2013 Migration  - Your 5 Rules for Success
SharePoint 2013 Migration - Your 5 Rules for SuccessChristian Buckley
 
Share Point Sat Share Point 2010 And Content Migration
Share Point Sat Share Point 2010 And Content MigrationShare Point Sat Share Point 2010 And Content Migration
Share Point Sat Share Point 2010 And Content MigrationNadir Kamdar
 
Movin’ On Up - SP Engage Oct 2015
Movin’ On Up - SP Engage Oct 2015Movin’ On Up - SP Engage Oct 2015
Movin’ On Up - SP Engage Oct 2015Jim Adcock
 
The Future of SharePoint - SharePoint 2016
The Future of SharePoint - SharePoint 2016The Future of SharePoint - SharePoint 2016
The Future of SharePoint - SharePoint 2016Don Donais
 
Shop talk - Project Server 2013
Shop talk - Project Server 2013Shop talk - Project Server 2013
Shop talk - Project Server 2013Chris Givens
 
SPTechCon Austin - The Slippery Slope of SharePoint Migrations
SPTechCon Austin - The Slippery Slope of SharePoint MigrationsSPTechCon Austin - The Slippery Slope of SharePoint Migrations
SPTechCon Austin - The Slippery Slope of SharePoint MigrationsJill Hannemann
 
Movin’ On Up - A #SharePoint Migration Case Study #HSPUG
Movin’ On Up - A #SharePoint Migration Case Study #HSPUGMovin’ On Up - A #SharePoint Migration Case Study #HSPUG
Movin’ On Up - A #SharePoint Migration Case Study #HSPUGJim Adcock
 
SharePoint Development
SharePoint DevelopmentSharePoint Development
SharePoint DevelopmentMalin De Silva
 

Similaire à Baby Steps: Automated Publishing Using Arbortext and SharePoint (20)

Microsoft SharePoint & Project Server are Better Together
Microsoft SharePoint & Project Server are Better TogetherMicrosoft SharePoint & Project Server are Better Together
Microsoft SharePoint & Project Server are Better Together
 
Sharepoint
SharepointSharepoint
Sharepoint
 
Real world rm in share point 2013
Real world rm in share point 2013Real world rm in share point 2013
Real world rm in share point 2013
 
Advanced SharePoint for Project Managers
Advanced SharePoint for Project ManagersAdvanced SharePoint for Project Managers
Advanced SharePoint for Project Managers
 
Real world records management in SharePoint 2013
Real world records management in SharePoint 2013Real world records management in SharePoint 2013
Real world records management in SharePoint 2013
 
Real world records management in share point 2013
Real world records management in share point 2013Real world records management in share point 2013
Real world records management in share point 2013
 
Movin’ on Up SPS Houston 2016
Movin’ on Up SPS Houston 2016Movin’ on Up SPS Houston 2016
Movin’ on Up SPS Houston 2016
 
Where did design view go in SharePoint Designer
Where did design view go in SharePoint DesignerWhere did design view go in SharePoint Designer
Where did design view go in SharePoint Designer
 
Collaborative Working: University of Sunderland & Roundhouse Digital
Collaborative Working: University of Sunderland & Roundhouse Digital Collaborative Working: University of Sunderland & Roundhouse Digital
Collaborative Working: University of Sunderland & Roundhouse Digital
 
Exploring SharePoint 2013 and Improving your Business Applications
Exploring SharePoint 2013 and Improving your Business ApplicationsExploring SharePoint 2013 and Improving your Business Applications
Exploring SharePoint 2013 and Improving your Business Applications
 
15 tips for bullet proof requirements analysis on SharePoint projects
15 tips for bullet proof requirements analysis on SharePoint projects15 tips for bullet proof requirements analysis on SharePoint projects
15 tips for bullet proof requirements analysis on SharePoint projects
 
SharePoint and Drupal: Yes, We Can Coexist!
SharePoint and Drupal: Yes, We Can Coexist!SharePoint and Drupal: Yes, We Can Coexist!
SharePoint and Drupal: Yes, We Can Coexist!
 
SharePoint 2013 Migration - Your 5 Rules for Success
SharePoint 2013 Migration  - Your 5 Rules for SuccessSharePoint 2013 Migration  - Your 5 Rules for Success
SharePoint 2013 Migration - Your 5 Rules for Success
 
Share Point Sat Share Point 2010 And Content Migration
Share Point Sat Share Point 2010 And Content MigrationShare Point Sat Share Point 2010 And Content Migration
Share Point Sat Share Point 2010 And Content Migration
 
Movin’ On Up - SP Engage Oct 2015
Movin’ On Up - SP Engage Oct 2015Movin’ On Up - SP Engage Oct 2015
Movin’ On Up - SP Engage Oct 2015
 
The Future of SharePoint - SharePoint 2016
The Future of SharePoint - SharePoint 2016The Future of SharePoint - SharePoint 2016
The Future of SharePoint - SharePoint 2016
 
Shop talk - Project Server 2013
Shop talk - Project Server 2013Shop talk - Project Server 2013
Shop talk - Project Server 2013
 
SPTechCon Austin - The Slippery Slope of SharePoint Migrations
SPTechCon Austin - The Slippery Slope of SharePoint MigrationsSPTechCon Austin - The Slippery Slope of SharePoint Migrations
SPTechCon Austin - The Slippery Slope of SharePoint Migrations
 
Movin’ On Up - A #SharePoint Migration Case Study #HSPUG
Movin’ On Up - A #SharePoint Migration Case Study #HSPUGMovin’ On Up - A #SharePoint Migration Case Study #HSPUG
Movin’ On Up - A #SharePoint Migration Case Study #HSPUG
 
SharePoint Development
SharePoint DevelopmentSharePoint Development
SharePoint Development
 

Dernier

Boat Trailers Market PPT: Growth, Outlook, Demand, Keyplayer Analysis and Opp...
Boat Trailers Market PPT: Growth, Outlook, Demand, Keyplayer Analysis and Opp...Boat Trailers Market PPT: Growth, Outlook, Demand, Keyplayer Analysis and Opp...
Boat Trailers Market PPT: Growth, Outlook, Demand, Keyplayer Analysis and Opp...IMARC Group
 
Live-Streaming in the Music Industry Webinar
Live-Streaming in the Music Industry WebinarLive-Streaming in the Music Industry Webinar
Live-Streaming in the Music Industry WebinarNathanielSchmuck
 
Michael Vidyakin: Introduction to PMO (UA)
Michael Vidyakin: Introduction to PMO (UA)Michael Vidyakin: Introduction to PMO (UA)
Michael Vidyakin: Introduction to PMO (UA)Lviv Startup Club
 
Project Brief & Information Architecture Report
Project Brief & Information Architecture ReportProject Brief & Information Architecture Report
Project Brief & Information Architecture Reportamberjiles31
 
Lecture_6.pptx English speaking easyb to
Lecture_6.pptx English speaking easyb toLecture_6.pptx English speaking easyb to
Lecture_6.pptx English speaking easyb toumarfarooquejamali32
 
Mihir Menda - Member of Supervisory Board at RMZ
Mihir Menda - Member of Supervisory Board at RMZMihir Menda - Member of Supervisory Board at RMZ
Mihir Menda - Member of Supervisory Board at RMZKanakChauhan5
 
MC Heights construction company in Jhang
MC Heights construction company in JhangMC Heights construction company in Jhang
MC Heights construction company in Jhangmcgroupjeya
 
Borderless Access - Global Panel book-unlock 2024
Borderless Access - Global Panel book-unlock 2024Borderless Access - Global Panel book-unlock 2024
Borderless Access - Global Panel book-unlock 2024Borderless Access
 
Chicago Medical Malpractice Lawyer Chicago Medical Malpractice Lawyer.pdf
Chicago Medical Malpractice Lawyer Chicago Medical Malpractice Lawyer.pdfChicago Medical Malpractice Lawyer Chicago Medical Malpractice Lawyer.pdf
Chicago Medical Malpractice Lawyer Chicago Medical Malpractice Lawyer.pdfSourav Sikder
 
NASA CoCEI Scaling Strategy - November 2023
NASA CoCEI Scaling Strategy - November 2023NASA CoCEI Scaling Strategy - November 2023
NASA CoCEI Scaling Strategy - November 2023Steve Rader
 
Borderless Access - Global Panel book-unlock 2024
Borderless Access - Global Panel book-unlock 2024Borderless Access - Global Panel book-unlock 2024
Borderless Access - Global Panel book-unlock 2024Borderless Access
 
IIBA® Melbourne - Navigating Business Analysis - Excellence for Career Growth...
IIBA® Melbourne - Navigating Business Analysis - Excellence for Career Growth...IIBA® Melbourne - Navigating Business Analysis - Excellence for Career Growth...
IIBA® Melbourne - Navigating Business Analysis - Excellence for Career Growth...AustraliaChapterIIBA
 
Team B Mind Map for Organizational Chg..
Team B Mind Map for Organizational Chg..Team B Mind Map for Organizational Chg..
Team B Mind Map for Organizational Chg..dlewis191
 
Graham and Doddsville - Issue 1 - Winter 2006 (1).pdf
Graham and Doddsville - Issue 1 - Winter 2006 (1).pdfGraham and Doddsville - Issue 1 - Winter 2006 (1).pdf
Graham and Doddsville - Issue 1 - Winter 2006 (1).pdfAnhNguyen97152
 
TalentView Webinar: Empowering the Modern Workforce_ Redefininig Success from...
TalentView Webinar: Empowering the Modern Workforce_ Redefininig Success from...TalentView Webinar: Empowering the Modern Workforce_ Redefininig Success from...
TalentView Webinar: Empowering the Modern Workforce_ Redefininig Success from...TalentView
 
BCE24 | Virtual Brand Ambassadors: Making Brands Personal - John Meulemans
BCE24 | Virtual Brand Ambassadors: Making Brands Personal - John MeulemansBCE24 | Virtual Brand Ambassadors: Making Brands Personal - John Meulemans
BCE24 | Virtual Brand Ambassadors: Making Brands Personal - John MeulemansBBPMedia1
 
Harvard Business Review.pptx | Navigating Labor Unrest (March-April 2024)
Harvard Business Review.pptx | Navigating Labor Unrest (March-April 2024)Harvard Business Review.pptx | Navigating Labor Unrest (March-April 2024)
Harvard Business Review.pptx | Navigating Labor Unrest (March-April 2024)tazeenaila12
 
Plano de marketing- inglês em formato ppt
Plano de marketing- inglês  em formato pptPlano de marketing- inglês  em formato ppt
Plano de marketing- inglês em formato pptElizangelaSoaresdaCo
 
Fabric RFID Wristbands in Ireland for Events and Festivals
Fabric RFID Wristbands in Ireland for Events and FestivalsFabric RFID Wristbands in Ireland for Events and Festivals
Fabric RFID Wristbands in Ireland for Events and FestivalsWristbands Ireland
 
AMAZON SELLER VIRTUAL ASSISTANT PRODUCT RESEARCH .pdf
AMAZON SELLER VIRTUAL ASSISTANT PRODUCT RESEARCH .pdfAMAZON SELLER VIRTUAL ASSISTANT PRODUCT RESEARCH .pdf
AMAZON SELLER VIRTUAL ASSISTANT PRODUCT RESEARCH .pdfJohnCarloValencia4
 

Dernier (20)

Boat Trailers Market PPT: Growth, Outlook, Demand, Keyplayer Analysis and Opp...
Boat Trailers Market PPT: Growth, Outlook, Demand, Keyplayer Analysis and Opp...Boat Trailers Market PPT: Growth, Outlook, Demand, Keyplayer Analysis and Opp...
Boat Trailers Market PPT: Growth, Outlook, Demand, Keyplayer Analysis and Opp...
 
Live-Streaming in the Music Industry Webinar
Live-Streaming in the Music Industry WebinarLive-Streaming in the Music Industry Webinar
Live-Streaming in the Music Industry Webinar
 
Michael Vidyakin: Introduction to PMO (UA)
Michael Vidyakin: Introduction to PMO (UA)Michael Vidyakin: Introduction to PMO (UA)
Michael Vidyakin: Introduction to PMO (UA)
 
Project Brief & Information Architecture Report
Project Brief & Information Architecture ReportProject Brief & Information Architecture Report
Project Brief & Information Architecture Report
 
Lecture_6.pptx English speaking easyb to
Lecture_6.pptx English speaking easyb toLecture_6.pptx English speaking easyb to
Lecture_6.pptx English speaking easyb to
 
Mihir Menda - Member of Supervisory Board at RMZ
Mihir Menda - Member of Supervisory Board at RMZMihir Menda - Member of Supervisory Board at RMZ
Mihir Menda - Member of Supervisory Board at RMZ
 
MC Heights construction company in Jhang
MC Heights construction company in JhangMC Heights construction company in Jhang
MC Heights construction company in Jhang
 
Borderless Access - Global Panel book-unlock 2024
Borderless Access - Global Panel book-unlock 2024Borderless Access - Global Panel book-unlock 2024
Borderless Access - Global Panel book-unlock 2024
 
Chicago Medical Malpractice Lawyer Chicago Medical Malpractice Lawyer.pdf
Chicago Medical Malpractice Lawyer Chicago Medical Malpractice Lawyer.pdfChicago Medical Malpractice Lawyer Chicago Medical Malpractice Lawyer.pdf
Chicago Medical Malpractice Lawyer Chicago Medical Malpractice Lawyer.pdf
 
NASA CoCEI Scaling Strategy - November 2023
NASA CoCEI Scaling Strategy - November 2023NASA CoCEI Scaling Strategy - November 2023
NASA CoCEI Scaling Strategy - November 2023
 
Borderless Access - Global Panel book-unlock 2024
Borderless Access - Global Panel book-unlock 2024Borderless Access - Global Panel book-unlock 2024
Borderless Access - Global Panel book-unlock 2024
 
IIBA® Melbourne - Navigating Business Analysis - Excellence for Career Growth...
IIBA® Melbourne - Navigating Business Analysis - Excellence for Career Growth...IIBA® Melbourne - Navigating Business Analysis - Excellence for Career Growth...
IIBA® Melbourne - Navigating Business Analysis - Excellence for Career Growth...
 
Team B Mind Map for Organizational Chg..
Team B Mind Map for Organizational Chg..Team B Mind Map for Organizational Chg..
Team B Mind Map for Organizational Chg..
 
Graham and Doddsville - Issue 1 - Winter 2006 (1).pdf
Graham and Doddsville - Issue 1 - Winter 2006 (1).pdfGraham and Doddsville - Issue 1 - Winter 2006 (1).pdf
Graham and Doddsville - Issue 1 - Winter 2006 (1).pdf
 
TalentView Webinar: Empowering the Modern Workforce_ Redefininig Success from...
TalentView Webinar: Empowering the Modern Workforce_ Redefininig Success from...TalentView Webinar: Empowering the Modern Workforce_ Redefininig Success from...
TalentView Webinar: Empowering the Modern Workforce_ Redefininig Success from...
 
BCE24 | Virtual Brand Ambassadors: Making Brands Personal - John Meulemans
BCE24 | Virtual Brand Ambassadors: Making Brands Personal - John MeulemansBCE24 | Virtual Brand Ambassadors: Making Brands Personal - John Meulemans
BCE24 | Virtual Brand Ambassadors: Making Brands Personal - John Meulemans
 
Harvard Business Review.pptx | Navigating Labor Unrest (March-April 2024)
Harvard Business Review.pptx | Navigating Labor Unrest (March-April 2024)Harvard Business Review.pptx | Navigating Labor Unrest (March-April 2024)
Harvard Business Review.pptx | Navigating Labor Unrest (March-April 2024)
 
Plano de marketing- inglês em formato ppt
Plano de marketing- inglês  em formato pptPlano de marketing- inglês  em formato ppt
Plano de marketing- inglês em formato ppt
 
Fabric RFID Wristbands in Ireland for Events and Festivals
Fabric RFID Wristbands in Ireland for Events and FestivalsFabric RFID Wristbands in Ireland for Events and Festivals
Fabric RFID Wristbands in Ireland for Events and Festivals
 
AMAZON SELLER VIRTUAL ASSISTANT PRODUCT RESEARCH .pdf
AMAZON SELLER VIRTUAL ASSISTANT PRODUCT RESEARCH .pdfAMAZON SELLER VIRTUAL ASSISTANT PRODUCT RESEARCH .pdf
AMAZON SELLER VIRTUAL ASSISTANT PRODUCT RESEARCH .pdf
 

Baby Steps: Automated Publishing Using Arbortext and SharePoint

  • 1. Baby Steps Automated Publishing Using Arbortext and SharePoint Brett McCorkle, Rita Briody May 8, 2013
  • 2. • Where we started • Small, manageable improvements we implemented • Publishing alternatives we evaluated • Proof of concept we constructed • Struggles and challenges we encountered Agenda 5/8/2013 2
  • 3. Peeps Brett McCorkle – Senior Technical Writer with 8 Years Experience – Arbortext System Administrator – Focus on IT Documentation, Diagrams, Standards, etc. – Bachelors, Management Information Systems Rita Briody – Technical Writer II with 5 Years Experience – Focus on new software and technology – Bachelors, Political Science, candidate Master of Science in Computer and Information Science 5/8/2013 3
  • 4. Who We Are Company – Established 1925 – Property/Casualty, Commercial, and Life Insurance – 11 states and the District of Columbia Team – 14 writers in IT Division – Various backgrounds including IT, Mathematics, and English – Experience levels ranging from 2 to 20+ years in technical writing 5/8/2013 4
  • 5. Background • BookMaster mainframe publishing • Large monolithic books – Copious amounts of content – We documented the features, not the tasks • Print and online distribution • Word documents eventually became the norm – Developed templates for several document types – Published as PDFs • ERIEbooks designed for mainframe docs, not PDFs 5/8/2013 5
  • 6. Approach • Baby steps! – Small improvements over 8 years • New methods – Minimalism – Structured Authoring • New tools – Arbortext – ECM • ERIEbooks became our biggest limitation 5/8/2013 6
  • 7. New Methods • Attended webinars and performed research – Minimalism – Structured Authoring – What the heck is DITA??? • Assigned small groups to provide training to the rest of the team – Divide and conquer – Presentations, working sessions, email newsletters • Reinforced later with formal on-site training from ComTech Services 5/8/2013 7
  • 8. New Tools • Inherited budget from another group to purchase Arbortext (very, very lucky) • Controlled our own destiny – Assigned technical writers with IT backgrounds to configure and support the tool • Began a several year effort to manually convert the content from our legacy systems • Implemented content management – The company already owned IBM Document Manager – Small work requests to prove and implement Arbortext and DM 5/8/2013 8
  • 9. New Capabilities • Our content is now XML-based – Began with DITA 1.1, upgraded to DITA 1.2 • Multiple output formats from the same source – PDF, HTML, EPUB, and online help • But… we are only publishing to PDF • Users want more options and better search results – They are all spoiled by Google • ERIEbooks, our current delivery system, is not up to the task 5/8/2013 9 I‟m sorry sir, but I can„t do that…
  • 10. Benefits • Minimalism greatly improved our documents – Action-oriented approach – Focused on users goals – Reduced wasteful, repetitive content • DITA saves us time – Focus on content, not formatting – Reuse between documents – Arbortext creates documents in minutes, not hours (BookMaster) 5/8/2013 10
  • 11. ERIEbooks Problems • Users are unable to find our documentation • ERIEbooks, our content delivery system, is very limited – Created 15+ years ago as a “temporary solution” – Pointer system, does not store our content – Can only reference PDFs and old mainframe documents – Search limited to document number, title, and 5 keywords – Limited browsing by subject matter – No usage tracking or feedback mechanisms • We must make it easier for users to find the information they need in the format they want 5/8/2013 11
  • 12. Options • Do nothing – Continue using ERIEbooks in its current state (boo!) • Buy something – Purchase and implement an off-the-shelf solution ($$$$) • Dream big – Build an adapter to connect SharePoint to our source files in IBM Document Manager • Use what we already have – Develop a solution to publish our content to SharePoint 2010 using Arbortext 5/8/2013 12
  • 13. First Attempt • We had big dreams – Big, Hairy, Audacious Goals (BHAGs!) – Created a wish list of requirements – Wanted drastic improvements over our current system • Unrealistic expectations produced few results – Little progress made for about a year – Evaluated vendor solutions, all were expensive, none fully met our lofty requirements – Worked with internal and external resources to produce a design that was ultimately unfeasible • We needed to change our mindset and our approach 5/8/2013 13
  • 14. The Chosen One • We took a step back and simplified our goals – Shaved the BHAG! – Scaled back our wish list – Reviewed our existing technology • Focused on the most important requirements – Modern features: full-text search, usage tracking – Deliver multiple formats: PDF, HTML, EPUB – Use tools we already own: Arbortext, SharePoint – Does not require external resources • Provides a foundation for future enhancements 5/8/2013 14
  • 15. Design Summary 1. Authors send SOAP requests to the Arbortext Publishing Engine containing the document ID and any required parameters 2. Connect to our source repository, IBM Document Manager 3. Create an HTML version of the requested DITA document 4. Send a SOAP response with the HTML document attached 5. Load the document from the SOAP response into SharePoint, replacing the previous version 5/8/2013 15
  • 17. Proof of Concept Needed to prove we could: – Connect the Arbortext Publishing Engine to Document Manager – Create an interface for SOAP requests – Send the output to SharePoint – Eliminate use of out-of-support applications (BookMaster) 5/8/2013 17
  • 18. What We Did • Three months to complete a proof of concept (POC) • Connected Arbortext Publishing Engine to DM – Adapter bundled with Arbortext – Already in use by writers using Arbortext Editor • Created interface to submit publish requests – Began an official POC with our IT Lab (thanks, Rita!) – Worked with the IT Lab developers to create an application – Application sends requests to Arbortext and loads the resulting document into SharePoint 5/8/2013 18
  • 19. Challenges Faced • Providing metrics to management – No usage tracking in ERIEbooks – Difficult to prove anyone used it • Generating interest and forming alliances • Budget and resource limitations – No money to purchase hardware or software – Low priority effort, work completed during “down time” • Lack of necessary skills – Needed other groups to help develop the solution • Performance issues – Needed to upgrade the Publishing Engine server 5/8/2013 19
  • 20. Results • Successfully proved our design – HTML content automatically loads into SharePoint – SharePoint returns full-text search results of our content • Benefits from SharePoint features – Full text search with in-line results – Usage tracking – Versioning – Personalization (through Active Directory) • Overwhelming management support – Approved project to implement our design – Obtained estimates from required company resources 5/8/2013 20
  • 21. Reality Check • Budgets and corporate priorities don‟t always directly support our goals, we‟re here to support theirs – Competed with other projects for developer resources – Lost priority to higher rated initiatives – Placed on hold indefinitely • The need to replace our archaic system still exists – We have simplified our approach again – Still using SharePoint while showing we are adaptable to limited company resources • New approach lays the ground work for future enhancements 5/8/2013 21
  • 22. What‟s Next? • Continue our Baby Steps journey • Implement ERIEbooks “Lite” – Start simple: Replicate ERIEbooks – Remove existing limitations – Perform usage tracking • Goals – Help our users find what they‟re looking for – Demonstrate innovation using SharePoint to the company • Slowly implement additional features – Publish our content in SharePoint – Provide full text search, personalization, etc. 5/8/2013 22
  • 24. Questions Brett McCorkle – brett.mccorkle@erieinsurance.com – http://www.linkedin.com/in/brettmccorkle – @DrunkenMonkie Rita Briody – rita.briody@erieinsurance.com – http://www.linkedin.com/in/ritalillianbriody – @nerdiva 5/8/2013 24
  • 25. Thank You Please provide feedback on SurveyMonkey Kiosks Available in the Registration Area www.surveymonkey.com/s/STC13sessions 5/8/2013 25