martes, 6 de noviembre de 2007
Un Addin para Outlook 2003/2007
"A partir de ahora crear un Addin y hacer que funcione a la primera, dejará de ser un problema".
Hace un par de semanas "me tocó" llevar a cabo la creación de un addinl, y bueno, aunque ya lo había desarrollado otren otras ocasiones, una vez más me volví a encontrar con algún que otro problemilla (claro está que con la ayuda de Eduardo conseguí resolverlo en un menor tiempo). Así que para que no vuelva a ocurrirme esto ni a mí ni ninguno de vosotros, dejo constancia aquí de los pasos que seguí:
Creando el Addin
- Instalar el paquete para el desarrollo del addin en Visual Studio 2005, para ello instalar Microsoft Visual Studio 2005 Tools for the 2007 Microsoft Office System.
- Crear un nuevo proyecto.
- Seleccionar Visual C# - Office - 2003 Add-ins - "Outlook Add-in" tal y como se muestra en la siguiente imagen:
- Desarrollar el Add-in a partir de los siguientes métodos de carga y descarga del. Aquí tenéis algunos ejemplos de como implementar un add-in. Por el momento y para probar que el Deploy esta
"chupado"conseguido prueba a mostrar un mensaje en cada evento/método.
private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
MessageBox.Show("Start");
}
private void ThisAddIn_Shutdown(object sender, System.EventArgs e)
{
MessageBox.Show("Shutdown");
}
"Deployando" el Addin
Asegurar que las entradas del registro generadas al crear el proyecto son correctas y se corresponden con el siguiente fragmento a excepción del clsId y del nombre del addin, que en este ejemplo es; "OutlookAddin1":
Windows Registry Editor Version 5.00
[HKEY_CURRENT_USER\Software\Classes\CLSID\{19AAED53-31A2-4DA2-B9AE-26491E3D3FD8}]
@="OutlookAddin1 -- an addin created with VSTO technology"
[HKEY_CURRENT_USER\Software\Classes\CLSID\{19AAED53-31A2-4DA2-B9AE-26491E3D3FD8}\InprocServer32]
"ThreadingModel"="Both"
"ManifestLocation"="C:\\Archivos de Programa\\Microsoft\\OutlookAddin1\\"
@=hex(2):25,00,43,00,6f,00,6d,00,6d,00,6f,00,6e,00,50,00,72,00,6f,00,67,00,72,\
00,61,00,6d,00,46,00,69,00,6c,00,65,00,73,00,25,00,5c,00,4d,00,69,00,63,00,\
72,00,6f,00,73,00,6f,00,66,00,74,00,20,00,53,00,68,00,61,00,72,00,65,00,64,\
00,5c,00,56,00,53,00,54,00,4f,00,5c,00,38,00,2e,00,30,00,5c,00,41,00,64,00,\
64,00,69,00,6e,00,4c,00,6f,00,61,00,64,00,65,00,72,00,2e,00,64,00,6c,00,6c,\
00,00,00
"ManifestName"="OutlookAddin1.dll.manifest"
[HKEY_CURRENT_USER\Software\Classes\CLSID\{19AAED53-31A2-4DA2-B9AE-26491E3D3FD8}\ProgID]
@="OutlookAddin1"
[HKEY_CURRENT_USER\Software\Classes\CLSID\{19AAED53-31A2-4DA2-B9AE-26491E3D3FD8}\Programmable]
[HKEY_CURRENT_USER\Software\Classes\CLSID\{19AAED53-31A2-4DA2-B9AE-26491E3D3FD8}\VersionIndependentProgID]
@="OutlookAddin1"
[HKEY_CURRENT_USER\Software\Classes\OutlookAddin1]
@=""
[HKEY_CURRENT_USER\Software\Classes\OutlookAddin1\CLSID]
@="{19AAED53-31A2-4DA2-B9AE-26491E3D3FD8}"
[HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\Addins\OutlookAddin1]
"CommandLineSafe"=dword:00000001
"Description"="OutlookAddin1 -- an addin created with VSTO technology"
"FriendlyName"="OutlookAddin1"
"LoadBehavior"=dword:00000003
"Manifest"="C:\\Archivos de Programa\\Microsoft\\OutlookAddin1\\OutlookAddin1.dll.manifest"
Aquí os dejo una buena y clara referencia sobre este tema anterior: Deploying Application-Level Add-ins.
Nota: Comprueba que el ClsId al que se hace referencia en el proyeco de instalación se corresponde con el del proyecto que contiene el Addin. Para ello edita el ".csproj" en formato texto y comprueba que el atributo "ProjectGuid" tiene el mismo valor:
<ProjectGuid>{19AAED53-31A2-4DA2-B9AE-26491E3D3FD8}</ProjectGuid>
Y lo más importante, como conseguir "Full-Trust" para que la instalación se realice correctamente y el addin se cargue sin problemas (Custom Actions):
- Crear el proyecto "OutlookAddIn1.SetSecurity"
- Crear y anadir las clases "CaspolSecurityPolicyCreator" y "SetSecurity". El contenido de estas clases puede obtenerse desde aquí.
- Install - CustomActionData: /assemblyName="OutlookAddIn1.dll" /targetDir="[TARGETDIR]\" /solutionCodeGroupName="Pruebas.OutlookAddIn1" /solutionCodeGroupDescription="Code group for OutlookAddIn1" /assemblyCodeGroupName="OutlookAddIn1" /assemblyCodeGroupDescription="Code group for OutlookAddIn1" /allUsers=[ALLUSERS]
- "Rollback - CustomActionData" y "Uninstall - CustomActionData": /solutionCodeGroupName="Pruebas.OutlookAddIn1"
- Dejar en blanco la acción "Commit - CustomActionData".
Prerrequisitos:
- .NET Framework 2.0
- Visual Studio Tools for Office: VSTO SE Runtime.
- Redistributable Primary Interop Assemblies: PIAS2003
- (Opcional) VSTO SE Language Package: http://www.microsoft.com/downloads/details.aspx?displaylang=es&FamilyID=d64ba959-82c5-42cd-9af7-bd57f6eff12c. Este prerrequisito sólo será necesario si el idioma del Outlook es distinto del Ingles.
Nota: El desarrollo no sólo permitirá la ejecución en Outlook 2003 sino que además en Office 2007, ahora, eso sí, a falta de los maravillos "Ribbons", para lo que será necesario ampliar con el desarrollo adecuado.
En fin, espero haber servido de ayuda una vez más, ¡seguro que si! :-P
Hasta la próxima
Juanlu
El add-in funciona muy bien en modo de pruebas. Cuando lo instalo en otro equipo, outllok indica un error al intentar cargarlo
Yo lo he instalado en más de un cliente y te puedo asegurara que funciona correctamente.
Saludos
Es que necesito que mi ADD-In instale tambien el Outlook sino esta instalado en el PC.
Muchas Gracias.
Adicionalmente podrías hacerlo generando previamente un nuevo MSI que se encarge de ello, de instalar primero el Outlook y a continuación el Add-in, pero creo que no es lo más lógico. También, prodrías hacer esto mismo pero añadiendo el MSI de Outlook como prerrequisito, sin embargo será necesario validar alguna clave de registro de Outlook para validar la existencia de su instalación.
Espero haber aclaro la duda, sino es así, aquí estaré de nuevo, :-D
Saludos
EL problema es que la empresa me obliga a que instale el outlook sino lo tiene instalado el PC, no quieren preocuparse ellos de si esta instalado o no.
Lo jodido es que no se como poner para que me salga el outlook como prerequisito!!!
Saludos y gracias.
<< Home