Elemento Rule
Especifica las reglas de activación que se deben evaluar para este complemento de correo contextual.
Tipo de complemento: Correo (contextual)
Importante
Los complementos contextuales de Outlook basados en entidades se retirarán en el segundo trimestre de 2024. El trabajo para retirar esta característica comenzará en mayo y continuará hasta finales de junio. Después de junio, los complementos contextuales ya no podrán detectar entidades en elementos de correo para realizar tareas en ellos. También se retirarán las siguientes API.
- Office.context.mailbox.item.getEntities()
- Office.context.mailbox.item.getEntitiesByType(entityType)
- Office.context.mailbox.item.getFilteredEntitiesByName(name)
- Office.context.mailbox.item.getSelectedEntities()
Para ayudar a minimizar las posibles interrupciones, se seguirá admitiendo lo siguiente después de que se retiren los complementos contextuales basados en entidades.
- Se está desarrollando una implementación alternativa del botón Unirse a la reunión , que se activa mediante complementos de reunión en línea. Una vez finalizada la compatibilidad con complementos contextuales basados en entidades, los complementos de reunión en línea pasarán automáticamente a la implementación alternativa para activar el botón Unirse a la reunión .
- Las reglas de expresión regular seguirán siendo compatibles después de retirar los complementos contextuales basados en entidades. Se recomienda actualizar el complemento contextual para usar reglas de expresión regular como solución alternativa. Para obtener instrucciones sobre cómo implementar estas reglas, vea Usar reglas de activación de expresiones regulares para mostrar un complemento de Outlook.
Para obtener más información, vea Retirada de complementos contextuales de Outlook basados en entidades.
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
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
<Rule xsi:type="RuleCollection" Mode="And">
<Rule xsi:type="ItemIs" ItemType="Message" />
<Rule xsi:type="ItemHasKnownEntity" EntityType="MeetingSuggestion" />
<Rule xsi:type="ItemHasKnownEntity" EntityType="Address" Highlight="none" />
</Rule>
Vea también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de