Elemento Rule

Especifica las reglas de activación que se deben evaluar para este complemento contextual de correo.

Tipo de complemento: Correo (contextual)

Importante

Este valor de elemento o atributo se documenta para ayudar a los desarrolladores a solucionar problemas de complementos contextuales de Outlook existentes. Se recomienda no crear nuevos complementos contextuales de Outlook.

  • Los complementos contextuales de Outlook basados en entidades han sido retirados.
  • Escenarios que antes requerían reglas de expresión regular en complementos contextuales ahora se pueden implementar con complementos de Outlook basados en eventos, que se activan automáticamente en respuesta a eventos como la creación de un nuevo mensaje o una reunión. JavaScript tiene compatibilidad integrada con expresiones regulares, y también puedes hacer referencia a bibliotecas de JavaScript que proporcionan funcionalidad avanzada de expresiones regulares. A diferencia de los complementos contextuales, los complementos basados en eventos pueden funcionar en contextos de redacción, así como en modo de lectura.

Forma parte de

Atributos

Atributo Obligatorio Descripción
xsi:type Sí El tipo de regla que se está definiendo.

El tipo de regla puede ser uno de los siguientes:

Regla ItemIs

Define una regla que da como resultado verdadero si el elemento seleccionado en el formato de lectura o redacción es del tipo especificado. Puede especificar más de una ItemIs regla en el manifiesto.

Atributos

Atributo Obligatorio Descripción
ItemType Sí Especifica el tipo de elemento con el que debe coincidir. Puede ser Message o Appointment. El tipo de elemento Message incluye correo electrónico, convocatorias de reunión, respuestas a la reunión y cancelaciones de reunión.
FormType No (dentro de ExtensionPoint), Sí (dentro de OfficeApp) Especifica si la aplicación debe aparecer en el formulario de edición o lectura para el elemento. Puede ser uno de los siguientes: Read, Edit, ReadOrEdit. Si se especifica en a Rule dentro de un ExtensionPoint, este valor DEBE ser Read.
ItemClass No Especifica la clase de mensaje personalizada con la que debe coincidir. Para obtener más información, consulte Tipos de elementos y Clases de mensajes.
IncludeSubClasses No Especifica si la regla debería evaluar en verdadero si el elemento es de una subclase de la clase del mensaje especificada; el valor predeterminado es false.

ItemType

En la tabla siguiente se describen los Appointment tipos de elementos que Message puede especificar en el ItemType atributo.

Valor Description
Appointment Especifica un elemento en un calendario de Outlook. Esto incluye un elemento de reunión al que se ha respondido y tiene un organizador y asistentes, o una cita que no tiene un organizador o asistente y es simplemente un elemento en el calendario. Corresponde a la clase de mensaje IPM.Appointment en Outlook.
Message Especifica uno de los siguientes elementos recibidos normalmente en la Bandeja de entrada.

  • Un mensaje de correo. Corresponde a la clase de mensaje IPM.Note en Outlook.

  • Una convocatoria, respuesta o cancelación de reunión. Esto corresponde a las siguientes clases de mensajes en Outlook.

    IPM.Schedule.Meeting.Request

    IPM.Schedule.Meeting.Neg

    IPM.Schedule.Meeting.Pos

    IPM.Schedule.Meeting.Tent

    IPM.Schedule.Meeting.Canceled

Ejemplo

<Rule xsi:type="ItemIs" ItemType= "Message" />

Regla ItemHasAttachment

Define una regla que da como resultado verdadero si el elemento, en forma de lectura, contiene datos adjuntos.

Ejemplo

<Rule xsi:type="ItemHasAttachment" />

Regla ItemHasKnownEntity (en desuso)

Advertencia

El <elemento ItemHasKnownEntity> ya está en desuso. En su lugar, especifique reglas de expresión regular con el elemento ItemHasRegularExpressionMatch .

Define una regla que evalúa en verdadero si el elemento contiene texto del tipo de entidad especificado en el asunto o en el cuerpo.

Atributos

Atributo Obligatorio Descripción
EntityType Sí Especifica el tipo de entidad que se tiene que encontrar para que la regla evalúe en verdadero. Puede ser uno de los siguientes: MeetingSuggestion, TaskSuggestion, Address, Url, PhoneNumber, EmailAddress o Contact.
RegExFilter No Especifica una expresión regular que se debe ejecutar con esta entidad para su activación.
FilterName No Especifica el nombre del filtro de expresión regular, de modo que después sea posible hacerle referencia en el código de su complemento.
IgnoreCase No Especifica si debe distinguirse entre mayúsculas y minúsculas al buscar resultados con la expresión regular especificada por el atributo RegExFilter.
Highlight No Nota: esto solo se aplica a los <elementos de regla> dentro de <los elementos de ExtensionPoint> . Especifica cómo debe resaltar el cliente las entidades coincidentes. Puede ser uno de los siguientes: all o none. Si no se especifica, el valor predeterminado es all.

Ejemplo

<Rule xsi:type="ItemHasKnownEntity" EntityType="EmailAddress" />

Regla ItemHasRegularExpressionMatch

Define una regla que da como resultado verdadero si se puede encontrar una coincidencia para la expresión regular especificada en la propiedad especificada del elemento en forma de lectura.

Para obtener información sobre cómo implementar la ItemHasRegularExpressionMatch regla, vea Complementos contextuales de Outlook.

Atributos

Atributo Obligatorio Descripción
RegExName Sí Especifica el nombre de una expresión regular para que pueda hacer referencia a dicha expresión en el código de su complemento.
RegExValue Sí Especifica la expresión regular que se evaluará para determinar si se debe mostrar el complemento de correo.
PropertyName Sí Especifica el nombre de la propiedad contra la que se evaluará la expresión regular. Puede ser uno de los siguientes: Subject, BodyAsPlaintext, BodyAsHTML o SenderSMTPAddress.

Si especifica BodyAsHTML, Outlook solo aplicará la expresión regular si el cuerpo del elemento es HTML. En caso contrario, Outlook no devuelve ninguna coincidencia de esa expresión regular.

Si especifica BodyAsPlaintext, Outlook siempre aplicará la expresión regular en el cuerpo del elemento.

Importante: Si necesita especificar el atributo Resaltar para el <elemento Regla> , debe establecer el atributo PropertyName en BodyAsPlaintext.
IgnoreCase No Especifica si debe distinguirse entre mayúsculas y minúsculas al buscar resultados con la expresión regular especificada por el atributo RegExName.
Highlight No Especifica cómo debe resaltar el cliente el texto coincidente. Este atributo solo se puede aplicar a <los elementos Rule> dentro de <los elementos ExtensionPoint> . Puede ser uno de los siguientes: all o none. Si no se especifica, el valor predeterminado es all.

Importante: Para especificar el atributo Resaltar en el <elemento Regla> , debe establecer el atributo PropertyName en BodyAsPlaintext.

Ejemplo

<Rule xsi:type="ItemHasRegularExpressionMatch" RegExName="SupportArticleNumber" RegExValue="(\W|^)kb\d{6}(\W|$)" PropertyName="BodyAsPlaintext" IgnoreCase="true" Highlight="all" />

RuleCollection

Define una colección de reglas y el operador lógico que se debe usar cuando se evalúen.

Atributos

Atributo Obligatorio Descripción
Mode Sí Especifica el operador lógico que se usará al evaluar esta colección de reglas. Puede ser: And o Or.

Ejemplo

<ExtensionPoint xsi:type="DetectedEntity">
  <Label resid="Context.Label"/>
  <SourceLocation resid="DetectedEntity.URL" />
  <Rule xsi:type="RuleCollection" Mode="And">
    <Rule xsi:type="ItemIs" ItemType="Message"/>
    <Rule xsi:type="ItemHasRegularExpressionMatch" RegExName="videoURL" RegExValue="http://www\.youtube\.com/watch\?v=[a-zA-Z0-9_-]{11}" PropertyName="BodyAsPlaintext"/>
  </Rule>
</ExtensionPoint>

Vea también

  • Se actualizó por última vez el