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 avalia como verdadeira se o item selecionado no formulário de leitura ou composição for do tipo especificado. Pode especificar mais do que uma ItemIs regra no manifesto.

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 obter mais informações, veja Tipos de Itens e Classes de Mensagens.
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.

ItemType

A tabela seguinte descreve os Appointment tipos de itens e Message que pode especificar no ItemType atributo .

Valor Descrição
Compromisso Especifica um item num calendário do Outlook. Isto inclui um item de reunião que foi respondido e tem um organizador e participantes, ou um compromisso que não tem um organizador ou participante e é simplesmente um item no calendário. Isto corresponde ao IPM. Classe de mensagem de compromisso no Outlook.
Mensagem Especifica um dos seguintes itens recebidos na Caixa de Entrada.

  • Uma mensagem de email. Isso corresponde à classe de mensagem IPM.Note no Outlook.

  • Uma solicitação de reunião, resposta ou cancelamento. Isto corresponde às seguintes classes de mensagens no Outlook.

    IPM.Schedule.Meeting.Request

    IPM.Schedule.Meeting.Neg

    IPM.Schedule.Meeting.Pos

    IPM.Schedule.Meeting.Tent

    IPM.Schedule.Meeting.Canceled

Exemplo

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

Regra ItemHasAttachment

Define uma regra que avalia como verdadeira se o item no formulário de leitura 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 avalia como verdadeira se for possível encontrar uma correspondência para a expressão regular especificada na propriedade especificada do item no formulário de leitura.

Para saber como implementar a regra, veja Suplementos contextuais do ItemHasRegularExpressionMatch Outlook.

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