Este documento presenta una introducción al desarrollo para Office 2007 utilizando Visual Studio Tools for Office (VSTO). Cubre temas como introducción a VSTO, OpenXML, desarrollo para Outlook y Excel, y extender la cinta de Office. También incluye demostraciones de estas capacidades.

1. Developing for Office 2007 Jonathan Cisneros (Southworks SRL) Ezequiel Jadib (Southworks SRL)

2. Agenda Introducción a Visual Studio Tools for Office (VSTO) Introducción a OpenXML VSTO para Outlook VSTO para Excel Extender Office Ribbon Demos Preguntas y Respuestas

3. Introducción a VSTO

4. Office como Plataforma de Desarrollo

5. Visual Studio Tools for the Microsoft Office System Templates de proyectos para Visual Studio Permite crear y extender Office Business Applications (OBA) Permite aprovechar la UI de Office Colaboración e integración del flujo de negocio

7. Evolución V 3.0 Soporte para Microsoft SharePoint Office 2007 formato archivos, características especificas, UI Add-ins de nivel de aplicación para mas aplicaciones Programación del lado del servidor Integración total con Visual Studio 2008 2005 SE Add-ins para las aplicaciones Office mas populares Soporte para elementos de la interfaz de usuario de Office 2007 (Custom Taskpane, Ribbon, Outlook formregions) Soporte para correr personalizaciones de documentos de Office 2003 en Office 2007 2007 2007 2003 2003 2005 Personalizar Panel de Acciones del documento Controles de host en la superficie del documento Almacenar datos en memoria caché en el documento Procesamiento de datos del lado del servidor Add-ins de nivel de aplicación para Outlook

9. Nuevos designers,

10. Ext. funcionales

11. Infrastructura

12. Office 11 add-ins,

13. Infrastructura

14. Outlook add-ins

15. VSTA en InfoPath

16. Extensiones funcionales

17. Infrastructura

19. Personalizaciones de nivel de documento Constan de un assembly asociado a un único documento, libro o plantilla de Microsoft Office Word o Microsoft Office Excel: El assembly se carga cuando se abre el documento asociado Las características de las personalizaciones que cree sólo estarán disponibles cuando se abra el documento asociado

20. Add-ins de nivel de aplicacion Constan de un assembly asociado a una aplicación de Microsoft Office Normalmente, el complemento se ejecuta cuando se inicia la aplicación asociada Las características de los complementos que cree están disponibles para la propia aplicación, independientemente de los documentos que se abran.

21. Tipos de proyectos disponibles para las diferentes aplicaciones de Microsoft Office

22. Ensamblados de interoperabilidad primarios de Office (PIA) Para usar las características de una aplicación de Microsoft Office en un proyecto de Visual Studio Tools para Office Permiten que el código administrado interactúe con el modelo de objetos basado en COM de una aplicación de Office. Ensamblados de interoperabilidad primarios de 2007 Microsoft Office System:

23. Introducción a Open XML

24. Introducción a Open XML Formato de archivo para representar hojas de cálculo, gráficos, presentaciones y documentos Contiene archivos basados en XML comprimidos en un paquete ZIP Estándar internacional: Office Open XML (ECMA-376)

26. Vsto Para Outlook Introducción al modelo de objetos de Microsoft Office Outlook

27. Introducción VSTO proporciona templates de proyectos para crear add-ins de nivel de aplicación para Outlook Ejemplos de add-ins: Automatizar Outlook Extender funcionalidad de Outlook Personalizar la interfaz de usuario de Outlook El desarrollo de add-ins para Outlook involucra la interacción con los objetos proporcionados por el modelo de objetos de Outlook

28. Modelo de objetos de Outlook Proporciona clases que representan elementos de la interfaz de usuario Contenido en dos assemblies: PIA: Microsoft.Office.Interop.Outlook.dll VSTO: Microsoft.Office.Tools.Outlook.dll Clases mas importantes: Application Explorer Inspector MAPIFolder MailItem AppointmentItem TaskItem ContactItem

29. La clase ThisAddIn El archivo de código ThisAddIn.vb o ThisAddIn.cs se crea automáticamente cuando se crea un nuevo proyecto La clase ThisAddIn hereda de la clase OutlookAddIn El código que esta fuera de la clase ThisAddIn puede obtener acceso al objeto ThisAddin mediante la propiedad estática Globals.ThisAddIn

30. La clase Application La clase de nivel superior del modelo de objetos de Outlook Representa la aplicación de Outlook Para obtener una instancia de la clase Application, utilice la propiedad Application de la clase ThisAddin. Miembros mas importantes: Método CreateItem: crear un nuevo elemento, como un mensaje de correo, una tarea o una cita Propiedad Explorers Propiedad Inspectors

31. La clase MailItem Representa un mensaje de correo electrónico. Los objetos MailItem suelen encontrarse en carpetas, como por ejemplo Bandeja de Entrada, Elementos Enviados y Bandeja de Salida. Expone propiedades y métodos que se pueden utilizar para crear y enviar mensajes de correo electrónico. private void CreateMailItem() { Outlook.MailItemmailItem = (Outlook.MailItem) this.Application.CreateItem(Outlook.OlItemType.olMailItem); mailItem.Subject = “Este es el subject"; mailItem.To = "someone@example.com"; mailItem.Body = “Este es el mensaje"; mailItem.Importance = Outlook.OlImportance.olImportanceLow; mailItem.Display(false); //if true  muestraventana de email //para enviarlo: ((Outlook._MailItem)mailItem).Send(); }

32. La clase ContactItem Representa un contacto en la carpeta Contactos. Contienen información de contacto de diversa índole para las personas a las que representan, como por ejemplo, domicilio y direcciones de correo electrónico. private void AddContact() { Outlook.ContactItemnewContact = (Outlook.ContactItem) this.Application.CreateItem(Outlook.OlItemType.olContactItem); newContact.FirstName = "Jo"; newContact.LastName = "Berry"; newContact.Email1Address = "somebody@example.com"; newContact.CustomerID = "123456"; newContact.PrimaryTelephoneNumber = "(425)555-0111"; newContact.MailingAddressStreet = "123 Main St."; newContact.MailingAddressCity = "Redmond"; newContact.MailingAddressState = "WA"; newContact.Save(); newContact.Display(true); }

33. Demo Outlook

34. VSTO para Excel Introducción al modelo de objetos de Microsoft Office Excel

35. Introducción VSTO provee templatesde proyectos para crear personalizaciones a nivel de documento y add-ins a nivel de applicación para Excel. Tipos de templates: Excel Add-in Excel Template Excel Workbook

36. Modelo de Objectos para Excel Clases COM más importantes: Microsoft.Office.Interop.Excel.Application Microsoft.Office.Interop.Excel.Workbook Microsoft.Office.Interop.Excel.Worksheet Microsoft.Office.Interop.Excel.Range Microsoft.Office.Tools.Excel.NamedRange El modelo de objectos sigue la interfaz de usuario: Application: representa la aplicación entera (Excel) Workbook: contiene una colección de objetos Worksheet (hojas). Range: representa las celdas y permite trabajar con celdas individuales o un grupo de celdas.

37. Acceso a Objectos en un Proyecto Excel Proyectos a nivel de aplicación: Visual Studio crea un archivo de código ThisAddIn.cs o ThisAddIn.vb Objeto Application: This.Application o Me.Application Proyectos a nivel de documento: Creando un nuevo proyecto Workbook o Template. Archivos generados: Para acceder a las clases desde fuera de los archivos generados usar la clase Globals.

38. Objeto Range El más usado en aplicaciones Excel Cualquier region dentro de Excel es expresada como un objeto Range Un objeto Range puede representar celdas, filas, columnas, una selección de celdas que contiene uno o más bloques de celdas, o incluso un grupo de celdas en múltiples hojas. Para una personalización a nivel de documento, existen dos controles que contienen range: NamedRange XmlMappedRange

39. Add-ins a Nivel de Aplicación Un add-in a nivel de aplicación consiste de un assembly cargado por Excel. Usualmente extiende Excel automatizándolo o personalización su interfaz de usuario. Personalización de la UI: Crear un taskpane personalizado. Añadir tabs que aparecerán en la Ribbon. Añadir grupos personalizados a un tab existente en la Ribbon.

40. Task Panes y Actions Panes Actions Pane Más robusto y fácil de programar que la alternativa de la tecnologia de “SmartDocument” de Office. Custom Task Pane La misma idea general que los Actions Pane, sólo en nivel de add-in de aplicación, no para un documento individual. VSTO simplifica y optimiza el proceso de diseño de la UI de un taskpane con los visual designers.

41. Personalización de los Paneles

42. Demo Excel

43. Extendiendo LA Office Ribbon

44. Office Ribbon Nuevo Look & Feel para la Interfaz de Usuario Introduce un nuevo modelo de extensibilidad llamado RibbonX Permite: Personalizar tabs Agregar a tabs existentes Remover tabs, grupos y controles Agregar menus Group Tab Control Ribbon

45. Extendiendo la Office Ribbon Soporte en Visual Studio VSTO Office 2007: Diseñador Visual Opción para “Exportar Ribbon a XML” Property Grid Ribbon Control Toolbox Design Surface

46. Extendiendo la Office Ribbon La estructura de la Ribbon XML requiere una jerarquia especifica Ejemplo de Ribbon XML <customUI xmlns="http://schemas.microsoft.com/office/2006/01/customui" onLoad="OnLoad"> <ribbon> <tabs> <tab idMso="TabAddIns"> <group id="MyGroup" label="My Group"> <toggleButton id="toggleButton1" size="large" label="My Button" screentip="My Button Screentip" onAction="OnToggleButton1" imageMso="AccessFormModalDialog" /> </group> </tab> </tabs> </ribbon> </customUI>

47. Demo Ribbon

48. Conclusiones

49. Conclusiones ¿Porque VSTO? Conecta Office con .NET Proporciona una solida infrastructura Proporciona una experiencia de desarrollo sofisticada Office es una verdadera plataforma de desarrollo

50. ? Jonathan Cisneros jonathan.cisneros@southworks.net http://blogs.southworks.net/jcisneros Ezequiel Jadib ezequiel.jadib@southworks.net http://blogs.southworks.net/ejadib

51. Downloads Microsoft Visual Studio Tools for the Microsoft Office System (version 3.0 Runtime) Service Pack 1 (x86)http://www.microsoft.com/Downloads/details.aspx?familyid=D8EB4921-891A-4B5E-973F-0B96E6CCF376&displaylang=en 2007 Microsoft Office System Update: Redistributable Primary Interop Assemblieshttp://www.microsoft.com/downloads/details.aspx?FamilyID=59daebaa-bed4-4282-a28c-b864d8bfa513&displaylang=en Open XML Format SDK 2.0http://www.microsoft.com/downloads/details.aspx?FamilyId=C6E744E5-36E9-45F5-8D8C-331DF206E0D0&displaylang=en

52. Recursos VSTO Developer Center http://msdn.microsoft.com/en-us/vsto/default.aspx VSTO Documentación en MSDN http://msdn.microsoft.com/es-es/library/d2tx7z6d.aspx VSTO “How do I Video” http://msdn.microsoft.com/en-us/office/bb496949.aspx VSTO Team Blog http://blogs.msdn.com/vsto

53. Referencias Información general sobre el desarrollo de soluciones de Officehttp://msdn.microsoft.com/es-ar/library/hy7c6z9k.aspx Introducción a la programación de personalizaciones de nivel de documento para Excelhttp://msdn.microsoft.com/es-ar/library/f27xe9xb.aspx Introducción a la programación de personalizaciones de nivel de documento para Wordhttp://msdn.microsoft.com/es-ar/library/zb7cf7a4.aspx Arquitectura de las personalizaciones de nivel de documentohttp://msdn.microsoft.com/es-ar/library/zcfbd2sk.aspx Introducción a la programación de complementos de nivel de aplicaciónhttp://msdn.microsoft.com/es-ar/library/ms268878.aspx Arquitectura de los complementos de nivel de aplicaciónhttp://msdn.microsoft.com/es-ar/library/bb386298.aspx

54. Referencias (cont.) Ensamblados de interoperabilidad primarios de Officehttp://msdn.microsoft.com/es-ar/library/15s06t57.aspx Características disponibles por aplicación y tipo de proyectohttp://msdn.microsoft.com/es-ar/library/aa942839.aspx Información general sobre el modelo de objetos de Outlookhttp://msdn.microsoft.com/es-ar/library/ms268893.aspx Información general sobre el modelo de objetos de Excelhttp://msdn.microsoft.com/es-ar/library/wss56bz7.aspx Welcome to the Open XML Format SDK 2.0http://msdn.microsoft.com/en-us/library/bb448854(office.14).aspx

55. Gracias Jonathan Cisneros jonathan.cisneros@southworks.net http://blogs.southworks.net/jcisneros Ezequiel Jadib ezequiel.jadib@southworks.net http://blogs.southworks.net/ejadib