Compartilhar via

Elemento Rule

  • Artigo

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

Tipo de suplemento: Correio (contextual)

Importante

Os suplementos contextuais do Outlook baseados em entidades foram descontinuados. Como solução alternativa, implemente regras de expressão regulares no seu suplemento contextual. Para obter orientações sobre como implementar estas regras, veja Suplementos contextuais do Outlook.

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 num Rule dentro de um ExtensionPoint, este valor TEM de 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 (preterida)

Aviso

O <elemento ItemHasKnownEntity> foi preterido. Em alternativa, especifique regras de expressão regulares com o elemento ItemHasRegularExpressionMatch .

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 Nota: isto aplica-se apenas a <elementos de Regra> nos <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 precisar de especificar o atributo Realçar para o <elemento Regra> , tem de 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. Este atributo só pode ser aplicado a elementos de< Regra> nos <elementos do 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 Realçar no <elemento Regra> , tem de 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

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

Confira também