Elemento Rule

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

Tipo de suplemento: Email (contextual)

Importante

Esse valor de elemento ou atributo é documentado para ajudar os desenvolvedores a solucionar problemas de suplementos contextuais existentes do Outlook. Recomendamos que você não crie novos suplementos contextuais do Outlook.

  • Os suplementos contextuais do Outlook baseados em entidades foram desativados.
  • Cenários que antes exigiam regras de expressão regular em suplementos contextuais agora podem ser implementados com suplementos do Outlook baseados em eventos, que são ativados automaticamente em resposta a eventos como a criação de uma nova mensagem ou reunião. O JavaScript tem suporte integrado para expressões regulares, e você também pode fazer referência a bibliotecas JavaScript que fornecem funcionalidades avançadas de expressões regulares. Ao contrário dos complementos contextuais, os suplementos baseados em eventos podem funcionar em contextos de composição, bem como no modo de leitura.

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 verdadeira se o item selecionado no formato lido ou redigido for do tipo especificado. Você pode especificar mais de 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 em um Rule dentro de um ExtensionPoint, esse valor DEVE ser Read.
ItemClass Não Especifica a classe de mensagens personalizada para fazer a correspondência. Para obter mais informações, consulte Tipos de item e classes de mensagem.
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 a seguir descreve os Appointment tipos de item e Message que você pode especificar no ItemType atributo.

Valor Descrição
Compromisso Especifica um item em um calendário do Outlook. Isso 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. Isso corresponde ao IPM. Classe de mensagem de compromisso no Outlook.
Mensagem Especifica um dos seguintes itens recebidos normalmente 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. Isso corresponde às seguintes classes de mensagem 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 é avaliada como verdadeira se o item no formato lido contiver um anexo.

Exemplo

<Rule xsi:type="ItemHasAttachment" />

Regra ItemHasKnownEntity (preterida)

Aviso

O <elemento ItemHasKnownEntity> agora está preterido. Especifique regras de expressão regular usando 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 Observação: isso só se aplica a <elementos Rule> dentro <de elementos 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 verdadeira se uma correspondência para a expressão regular especificada puder ser encontrada na propriedade especificada do item no formato de leitura.

Para saber como implementar a ItemHasRegularExpressionMatch regra, consulte Suplementos contextuais do 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 você precisar especificar o atributo Highlight para o <elemento Rule> , 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 a <elementos Rule> dentro <de 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 Rule> , 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

<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

  • Última atualização em