Compartir a través de

Elemento Rule

  • Artículo

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

Tipo de complemento: Correo (contextual)

Importante

Ahora se han retirado los complementos contextuales de Outlook basados en entidades. Como solución alternativa, implemente reglas de expresión regular en el complemento contextual. Para obtener instrucciones sobre cómo implementar estas reglas, vea Complementos contextuales de Outlook.

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 evalúa en verdadero si el elemento seleccionado es del tipo especificado.

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 dentro de Rule , ExtensionPointeste valor DEBE ser Read.
ItemClass No Especifica la clase de mensaje personalizada con la que debe coincidir. Para obtener más información, vea Activar un complemento de correo de Outlook para una clase de mensaje específica.
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.

Ejemplo

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

Regla ItemHasAttachment

Define una regla que evalúa en verdadero si el elemento contiene datos adjuntos.

Ejemplo

<Rule xsi:type="ItemHasAttachment" />

Regla ItemHasKnownEntity (en desuso)

Advertencia

El <elemento ItemHasKnownEntity> ahora está en desuso. Especifique reglas de expresión regular mediante el elemento ItemHasRegularExpressionMatch en su lugar.

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 Rule> dentro de <los elementos 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 evalúa en verdadero si se encuentra una coincidencia para la expresión regular especificada en la propiedad indicada del elemento.

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 Highlight para el <elemento Rule> , 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 Highlight en el <elemento Rule>, debe establecer el atributo BodyAsPlaintextPropertyName en .

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