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 se evalúa como true si el elemento seleccionado en el formulario 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 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 Tipos de elementos y clases de mensaje.
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 elemento y Message que se pueden especificar en el ItemType atributo .

Valor Descripción
Appointment Especifica un elemento en un calendario de Outlook. Esto incluye un elemento de reunión al que se ha respondido y que tiene un organizador y asistentes, o una cita que no tiene un organizador o un asistente y es simplemente un elemento del 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 mensaje 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 se evalúa como true si el elemento en el formulario de lectura 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 se evalúa como true si se puede encontrar una coincidencia para la expresión regular especificada en la propiedad especificada del elemento en formato 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 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