Crear una regla para archivar elementos de correo enviados por un administrador y marcarlos para seguimiento
En este ejemplo se muestra cómo configurar una regla para archivar elementos de correo enviados por el administrador de un usuario y marcarlos para seguimiento.
Ejemplo
Nota:
El siguiente ejemplo de código es un fragmento de Programming Applications for Microsoft Office Outlook 2007 (Programación de aplicaciones para Microsoft Office Outlook 2007).
Las reglas de Outlook pueden funcionar en el lado servidor o cliente, según el tipo de cuenta y regla. Hay muchas formas para implementar reglas con el fin de aplicar sus propios esquemas organizativos al organizar los elementos en su buzón. Por ejemplo, puede crear una jerarquía de subcarpetas que organice el correo leído y no leído por áreas temáticas. O bien, puede crear una jerarquía de subcarpetas que corresponda al remitente del mensaje. También, puede clasificar el correo y, después, utilizar las carpetas de búsqueda para agregar el correo por categoría.
El modelo de objetos Rules, que incluye un objeto Rule que representa una regla en Outlook, le permite crear reglas mediante programación para aplicar un esquema organizativo determinado, crear una regla específica única para la solución o garantizar que se implementen determinadas reglas para un grupo de usuarios. Al usar el modelo de objetos Rules, podrá agregar, editar y eliminar reglas mediante programación. Al usar la colección Rules y el objeto Rule, también podrá agregar y eliminar reglas definidas para una sesión y obtener acceso a las mismas.
Un objeto Rule tiene una propiedad RuleType que indica si la regla es una regla de envío o recepción. Cuando se crea una regla, se especifica la propiedad RuleType, y no se puede modificar a no ser que se elimine y se vuelva a crear la regla con otra propiedad RuleType. Los objetos RuleAction y RuleCondition, los objetos de la colección y los objetos de acción y condición derivados también se usan para permitir la edición de las acciones de las reglas y las condiciones de las reglas.
El modelo de objetos Rules no admite todas las reglas que puede crear mediante el Asistente para reglas y alertas de la interfaz de usuario de Outlook, pero sí admite las acciones y condiciones de reglas más comunes. Las reglas creadas con este asistente que se aplican a los mensajes, que incluyen elementos de correo, convocatorias de reunión, solicitudes de tareas, documentos, confirmaciones de entrega, confirmaciones de lectura, respuestas de votaciones y avisos de fuera de la oficina, también se pueden crear mediante programación.
Se puede ejecutar una regla en el servidor de Exchange o en el cliente de Outlook, siempre y cuando el buzón de correo del usuario actual se hospede en un servidor Exchange. La propiedad IsLocalRule del objeto Rule devuelve true para indicar que la regla se ejecuta en un cliente, y que Outlook debe estar ejecutándose para que se pueda ejecutar la regla. Si la regla se ejecuta en el servidor, no es necesario que Outlook esté en ejecución para que se evalúen las condiciones de la regla y se completen las acciones de la regla.
Nota:
No hay ninguna colección independiente que represente las condiciones de excepción de la regla. Use la propiedad Exceptions del objeto Rule para obtener una colección RuleConditions que represente las condiciones de excepción de la regla.
Para crear reglas a través del modelo de objetos de Outlook, siga estos pasos:
Obtenga la colección Rules de la propiedad DefaultStore del objeto NameSpace llamando al método GetRules() en el objeto Store predeterminado. Use un bloque try…catch para incluir a los usuarios que estén desconectados del servidor de Exchange. Esto evita que Outlook muestre un error.
Llame al método Create(String, OlRuleType) en el objeto Rules para crear una variable de instancia o un objeto Rule, especificando un nombre y un parámetro OlRuleType.
Use las colecciones RuleActions y RuleConditions para habilitar las acciones, condiciones y excepciones en el objeto Rule. Tenga en cuenta que cualquier condición habilitada en la colección RuleConditions, devuelta por la propiedad Exceptions, se trata como una condición de excepción de regla, y que no se pueden agregar acciones o condiciones personalizadas integradas a la colección.
Establezca la propiedad Enabled en true para que cualquier acción, condición o excepción de regla determinada esté operativa. Algunas acciones o condiciones, como la propiedad Folder, requieren que se establezcan propiedades adicionales en la acción o condición para guardar sin errores el objeto Rule.
Por último, llame al método Save(Object) en la colección Rules para guardar las reglas creadas o modificadas. Incluya el método Save en un bloque try... catch para controlar las excepciones.
En el ejemplo de código siguiente, CreateManagerRule implementa los pasos descritos anteriormente. CreateManagerRule comprueba primero si la propiedad CurrentUser representa un objeto ExchangeUser, lo que indica que el usuario actual es un usuario de Exchange. Si el usuario actual es un usuario de Exchange, CreateManagerRule obtiene el administrador del usuario actual llamando al método GetExchangeUserManager() en el objeto ExchangeUser de la propiedad CurrentUser del objeto NameSpace. Después se crea una regla de recepción para mover los mensajes recibidos a una subcarpeta de la Bandeja de entrada si se cumplen las condiciones siguientes:
El mensaje es del administrador del usuario.
El destinatario se encuentra en la línea Para: del mensaje.
El mensaje no es una actualización ni una convocatoria de reunión.
Por último, el mensaje está marcado para realizar seguimiento hoy. CreateManagerRule también ilustra el adecuado control de errores de las condiciones que podrían provocar una excepción, como que el usuario esté sin conexión o desconectado en modo caché de Exchange.
Si usa Visual Studio para probar este ejemplo de código, primero debe agregar una referencia al componente de la biblioteca de objetos de Microsoft Outlook 15.0 y especificar la variable de Outlook al importar el espacio de nombres Microsoft.Office.Interop.Outlook. La instrucción using no debe producirse directamente antes de las funciones en el ejemplo de código, pero debe agregarse antes de la declaración de clase pública. La siguiente línea de código muestra cómo realizar la importación y la asignación en C#.
using Outlook = Microsoft.Office.Interop.Outlook;
private void CreateManagerRule()
{
Outlook.ExchangeUser manager;
Outlook.Folder managerFolder;
Outlook.AddressEntry currentUser =
Application.Session.CurrentUser.AddressEntry;
if (currentUser.Type == "EX")
{
try
{
manager = currentUser.
GetExchangeUser().GetExchangeUserManager();
}
catch
{
Debug.WriteLine("Could not obtain user's manager.");
return;
}
Outlook.Rules rules;
try
{
rules = Application.Session.DefaultStore.GetRules();
}
catch
{
Debug.WriteLine("Could not obtain rules collection.");
return;
}
if (manager != null)
{
string displayName = manager.Name;
Outlook.Folders folders =
Application.Session.GetDefaultFolder(
Outlook.OlDefaultFolders.olFolderInbox).Folders;
try
{
managerFolder =
folders[displayName] as Outlook.Folder;
}
catch
{
managerFolder =
folders.Add(displayName, Type.Missing)
as Outlook.Folder;
}
Outlook.Rule rule = rules.Create(displayName,
Outlook.OlRuleType.olRuleReceive);
// Rule conditions
// From condition
rule.Conditions.From.Recipients.Add(
manager.PrimarySmtpAddress);
rule.Conditions.From.Recipients.ResolveAll();
rule.Conditions.From.Enabled = true;
// Sent only to me
rule.Conditions.ToMe.Enabled = true;
// Rule exceptions
// Meeting invite or update
rule.Exceptions.MeetingInviteOrUpdate.Enabled = true;
// Rule actions
// MarkAsTask action
rule.Actions.MarkAsTask.MarkInterval =
Outlook.OlMarkInterval.olMarkToday;
rule.Actions.MarkAsTask.FlagTo = "Follow-up";
rule.Actions.MarkAsTask.Enabled = true;
// MoveToFolder action
rule.Actions.MoveToFolder.Folder = managerFolder;
rule.Actions.MoveToFolder.Enabled = true;
try
{
rules.Save(true);
}
catch (Exception ex)
{
Debug.WriteLine(ex.Message);
}
}
}
}