Elemento Rule

  • Artigo

Especifica as regras de ativação que devem ser avaliadas para este suplemento de email contextual.

Tipo de suplemento: Email (contextual)

Importante

Os suplementos contextuais do Outlook baseados em entidade serão desativados no segundo trimestre de 2024. O trabalho para aposentar esse recurso começará em maio e continuará até o final de junho. Após junho, os suplementos contextuais não poderão mais detectar entidades em itens de email para executar tarefas neles. As APIs a seguir também serão retiradas.

Para ajudar a minimizar possíveis interrupções, o seguinte ainda será suportado depois que os suplementos contextuais baseados em entidade forem retirados.

  • Uma implementação alternativa do botão Ingressar Reunião , que é ativado por suplementos de reunião online, está sendo desenvolvida. Depois que o suporte para suplementos contextuais baseados em entidade terminar, os suplementos de reunião online farão a transição automática para a implementação alternativa para ativar o botão Ingressar Reunião .
  • As regras de expressão regular continuarão a ser suportadas depois que os suplementos contextuais baseados em entidade forem retirados. Recomendamos atualizar seu suplemento contextual para usar regras de expressão regulares como uma solução alternativa. Para obter diretrizes sobre como implementar essas regras, consulte Usar regras regulares de ativação de expressão para mostrar um suplemento do Outlook.

Para obter mais informações, consulte Aposentadoria de suplementos contextuais do Outlook baseados em entidade.

Contido em

Atributos

Atributo Obrigatório Descrição
xsi:type Sim O tipo de regra que está sendo definida.

O tipo de regra pode ser um dos seguintes:

Regra ItemIs

Define uma regra que é avaliada como true se o item selecionado for do tipo especificado.

Atributos

Atributo Obrigatório Descrição
ItemType Sim Especifica o tipo de item para fazer a correspondência. Pode ser Message ou Appointment. O tipo de item Message inclui email, solicitações de reunião, respostas de reunião e cancelamentos de reunião.
FormType Não (dentro de ExtensionPoint), Sim (dentro de OfficeApp) Especifica se o aplicativo deve aparecer no formulário de leitura ou edição do item. Pode ser um dos seguintes: Read, Edit, ReadOrEdit. Se especificado em um dentro de Rule um ExtensionPoint, esse valor DEVE ser Read.
ItemClass Não Especifica a classe de mensagens personalizada para fazer a correspondência. Para saber mais, confira o artigo Ativar um suplemento de email no Outlook para uma classe de mensagens específica.
IncludeSubClasses Não Especifica se a regra deve ser avaliada como true se o item pertencer a uma subclasse da classe de mensagens especificada. O padrão é false.

Exemplo

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

Regra ItemHasAttachment

Define uma regra que é avaliada como true se o item contiver um anexo.

Exemplo

<Rule xsi:type="ItemHasAttachment" />

Regra ItemHasKnownEntity

Define uma regra que é avaliada como true se o item contiver texto do tipo de entidade especificada em seu assunto ou corpo.

Atributos

Atributo Obrigatório Descrição
EntityType Sim Especifica o tipo de entidade que deve ser encontrado para que a regra para que ela seja avaliada como true. Pode ser um dos seguintes: MeetingSuggestion, TaskSuggestion, Address, Url, PhoneNumber, EmailAddress, ou Contact.
RegExFilter Não Especifica uma expressão regular para executar esta entidade para ativação.
FilterName Não Especifica o nome do filtro de expressões regulares para que seja possível consultá-lo posteriormente no código do seu suplemento.
IgnoreCase Não Especifica se deve ignorar maiúsculas e minúsculas ao fazer a correspondência da expressão regular especificada por RegExFilter.
Realce Não Observação: isso só se aplica aos <elementos Rule> dentro <de elementos do ExtensionPoint> . Especifica como o cliente deve realçar entidades correspondentes. Pode ser um dos seguintes: all ou none. Se não for especificado, o valor padrão será all.

Exemplo

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

Regra ItemHasRegularExpressionMatch

Define uma regra que é avaliada como true se uma correspondência para a expressão regular especificada pode ser encontrada na propriedade especificada do item.

Atributos

Atributo Obrigatório Descrição
RegExName Sim Especifica o nome da expressão regular para que você possa fazer referência à expressão no código de seu suplemento.
RegExValue Sim Especifica a expressão regular que será avaliada para determinar se o suplemento de email deve ser mostrado.
PropertyName Sim Especifica o nome da propriedade em relação a qual a expressão regular será avaliada. Pode ser um dos seguintes: Subject, BodyAsPlaintext, BodyAsHTML, ou SenderSMTPAddress.

Se você especificar BodyAsHTML, o Outlook só aplicará a expressão regular se o corpo do item for HTML. Caso contrário, o Outlook não retornará nenhuma correspondência para essa expressão regular.

Se você especificar BodyAsPlaintext, o Outlook sempre aplicará a expressão regular no corpo do item.

Importante: Se você precisar especificar o atributo Highlight para o <elemento Regra> , deverá definir o atributo PropertyName como BodyAsPlaintext.
IgnoreCase Não Especifica se deve ignorar maiúsculas e minúsculas ao fazer a correspondência da expressão regular especificada pelo atributo RegExName.
Realce Não Especifica como o cliente deve realçar texto correspondente. Esse atributo só pode ser aplicado aos <elementos Rule> nos <elementos extensionpoint> . Pode ser um dos seguintes: all ou none. Se não for especificado, o valor padrão será all.

Importante: Para especificar o atributo Highlight no <elemento Regra> , você deve definir o atributo PropertyName como BodyAsPlaintext.

Exemplo

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

RuleCollection

Define uma coleção de regras e o operador lógico a ser usado ao avaliá-las.

Atributos

Atributo Obrigatório Descrição
Mode Sim Especifica o operador lógico a ser usado quando estiver avaliando essa coleção de regras. Pode ser: And ou Or.

Exemplo

<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>

Confira também