OFC305 Advanced XML Programming In Excel 2003 Joseph Chirilov
Program Manager Slide 2 Resumes Joseph Chirilov Program Manager
Excel Data Services demo demo Slide 3 Exportability Data not
exportable when you have: Fill down List of lists Sparse layout
Data is exportable when required elements are not mapped Taskpane:
Verify Map for Export OM: XmlMap.IsExportable Slide 4 Schema
Support W3C XML Schema 1.0 spec, except: Abstract elements
Substitution groups xsd:any xsd:anyAttribute Recursive Structures
Mixed Content Excel can derive XML schema from sample data Slide 5
Object Model XML Scenarios Adding a schema / map Mapping
non-repeating elements Mapping repeating elements Importing
Exporting Querying for map structure & data Catching Import /
Export Events Slide 6 XmlMap Object Represents a schema attached to
the workbook. Methods:.Import /.ImportXml.Export /.ExportXml.Delete
Properties:.Schemas.DataBinding Many others Slide 7 Adding an XML
map Workbook.XmlMaps.Add( Schema As String, [RootElementName] As
String) As XmlMap Example: Set myMap = ActiveWorkbook.XmlMaps.Add(
C:\expense.xsd ) Slide 8 XPath Object Representation of an element
mapping in the spreadsheet Methods:.SetValue.Clear
Properties:.Map.Repeating.Value Slide 9 Mapping Non-Rep Elements
Range.XPath.SetValue ( Map As XmlMap, XPath As String,
[SelectionNamespace] As String, [Repeating] As Boolean ) Example:
ActiveCell.XPath.SetValue( ActiveWorkbook.XmlMaps(1),
/Expense/Meta/FirstName,, False ) Slide 10 Selection Namespace
Example: If the XPath you want to map is:
/ns0:Expense/Meta/ns1:Firstname then the selection namespace should
be: xmlns:ns0=http://urnexpense xmlns:ns1=http://urnempinfo Slide
11 ListObject Object Represents a List Methods:.Delete Many others
Properties:.DataBodyRange.ListColumns.Range.XPath.ListRows.Range.Name.XmlMap
Slide 12 Mapping Rep Elements ListColumn.XPath.SetValue ( Map As
XmlMap, XPath As String, [SelectionNamespace] As String,
[Repeating] As Boolean ) Example: Set myList =
ActiveSheet.ListObjects.Add( xlSrcRange, Range(A1:D10))
myList.ListColumns(1).XPath.SetValue( ActiveWorkbook.XmlMaps(1),
/Expense/Meta/FirstName,, False ) Slide 13 OM: Mapping Joseph
Chirilov Program Manager Excel Data Services demo demo Slide 14
Importing XML Data XmlMap.Import( Url As String, [Overwrite] As
Boolean ) As XlXmlImportResult XmlMap.ImportXml( XmlData As String,
[Overwrite] As Boolean ) As XlXmlImportResult Slide 15 Importing
XML Data Example: result = ActiveWorkbook.XmlMaps(1).Import(
\\expense\empinfo.xml ) result =
ActiveWorkbook.XmlMaps(1).ImportXml( sWSData ) Slide 16
XlXmlImportResult Import results are for non-failing imports only
Only most severe condition is returned Possible results (in order
of increasing severity): Success Schema validation failed Some data
truncated to fit cell Failing imports will result in an run-time
error Slide 17 Exporting XML Data XmlMap.Export( Url As String,
[Overwrite] As Boolean ) As XlXmlExportResult XmlMap.ExportXml(
Data As String ) As XlXmlExportResult (Note: Data is an IN/OUT
variable) Slide 18 Exporting XML Data Example: If
ActiveWorkbook.XmlMaps(1).IsExportable Then result =
ActiveWorkbook.XmlMaps(1).Export( C:\expenseData\JDoe.xml ) Dim
sData As String result = ActiveWorkbook.XmlMaps(1).ExportXml( sData
) (sData now contains exported data) Slide 19 XlXmlExportResult
Export results are for non-failing exports only Only most severe
condition is returned Possible results (in order of increasing
severity): Success Schema validation failed Failing exports will
result in an run-time error Dont forget to check exportability
first! Slide 20 OM: Import / Export Joseph Chirilov Program Manager
Excel Data Services demo demo Slide 21 Auto Map and Import Quick
& easy way to import data without the need to map elements
before hand Workbook.XmlImport( Url As String, ImportMap As XmlMap,
[Overwrite], [Destination] ) As XlXmlImportResult Example:
ActiveWorkbook.XmlImport C:\expense.xml, Nothing,, Range(A1)
Workbook.XmlImportXml for in-memory strings Slide 22 Query Methods
Use XmlMapQuery to discover mappings, and XmlDataQuery to extract
data from those mappings Worksheet.XmlMapQuery( XPath As String,
[SelectionNamespaces] As String, [Map] As XmlMap ) As Range
Worksheet.XmlDataQuery( XPath As String, [SelectionNamespaces] As
String, [Map] As XmlMap ) As Range Slide 23 Query Methods sXPath =
/Expense/Items/Amount If Not XmlMapQuery(sXPath) Is Nothing Then
Set myRange = XmlDataQuery(sXPath) perform normal range
manipulation End If Slide 24 Import Events Hang off Workbook and
Application Object BeforeXmlImport( Map As XmlMap, Url As String,
IsRefresh As Boolean, Cancel As Boolean ) AfterXmlImport( Map As
XmlMap, IsRefresh As Boolean, Result As XlXmlImportResult ) Slide
25 Export Events Hang off Workbook and Application Object
BeforeXmlExport( Map As XmlMap, Url As String, Cancel As Boolean )
AfterXmlExport( Map As XmlMap, Url As String, Result As
XlXmlExportResult ) Slide 26 Event Examples Before Export: Validate
sheet data according to business rules before export and cancel if
rules are broken. Before Import: warn user that data will be
discarded upon subsequent import / refresh After Import: Examine
data that was imported (according to business rules, etc.) Enforce
that a map is Import-only or Export-only Slide 27 Web Services
Getting data from web services is easier with Excel. Methods:
Existing COM objects OfficeXP Web Services Toolkit 2.0 Visual
Studio Slide 28 Web Services Joseph Chirilov Program Manager Excel
Data Services demo demo Slide 29 Community Resources
http://www.microsoft.com/communities/default.mspx Most Valuable
Professional (MVP) http://www.mvp.support.microsoft.com/ Newsgroups
Converse online with Microsoft Newsgroups, including Worldwide
http://www.microsoft.com/communities/newsgroups/default.mspx User
Groups Meet and learn with your peers
http://www.microsoft.com/communities/usergroups/default.mspx Slide
30 evaluations evaluations Slide 31 2003 Microsoft Corporation. All
rights reserved. This presentation is for informational purposes
only. MICROSOFT MAKES NO WARRANTIES, EXPRESS OR IMPLIED, IN THIS
SUMMARY.
