Especificando ações de regra

  • Artigo

The Rules object model supports the most commonly used rule actions and conditions. Each Rule object has an Actions property that represents the rule actions for that rule, as well as a Conditions property and an Exceptions property that represent the conditions for that rule. Este tópico descreve como o modelo de objeto Rules oferece suporte às ações de regra.

As ações de regra para uma regra são representadas por um objeto de coleção RuleActions . Um objeto RuleActions tem propriedades que correspondem a cada ação normalmente usada em uma regra. Por exemplo, se uma regra especificar duas ações - mover a mensagem para uma pasta específica e reproduzir um som - as propriedades MoveToFolder e PlaySound do objeto de coleção RuleActions da regra retornarão os respectivos objetos de ação de regra habilitados (RuleAction.Enableed é True).

As ações não especificadas em uma regra não serão habilitadas no objeto RuleAction correspondente (RuleAction.Enabled é False). Esses objetos de ação de regra são representados pelo objeto \ RuleAction ou objetos personalizados derivados do objeto RuleAction . No último exemplo, especificamente, a propriedade RuleActions.MoveToFolder retornará um objeto MoveOrCopyRuleAction e a propriedade RuleActions.PlaySound retornará um objeto PlaySoundRuleAction , ambos derivados do objeto RuleAction . O objeto RuleAction e seus objetos derivados têm a propriedade ActionType que indicará o tipo de ação de regra. Por exemplo, MoveOrCopyRuleAction.ActionType indicará o valor olRuleActionMoveToFolder e PlaySoundRuleAction.ActionType indicará olRuleActionPlay.

Observação

O modelo de objeto Regras mantém a paridade parcial com o Assistente de Regras e Alertas. Isso significa que, embora possa usar o Assistente para criar regras que especifiquem qualquer ação e condição vista no Assistente, você pode programaticamente criar regras que usem algumas dessas ações e condições, porém não todas. Um exemplo de uma ação à qual o modelo de objeto Rules oferece suporte para regras criadas pelo Assistente, mas não para aquelas criadas pelo modelo de objeto, é a solicitação de uma resposta do servidor. Use o Assistente para criar uma regra especificando uma determinada resposta do servidor como uma ação.

Usando o modelo de objeto Regras, você pode enumerar esses tipos de regras na coleção Regras - para cada regra na coleção Regras , enumerar sua coleção RuleActions e procurar uma ação de regra habilitada para uma resposta de servidor. No código, isso significaria para cada regra na coleção Regras , enumerar RuleActions.Item(Index) usando o Índice de 1 para RuleActions.Count e procurar uma ação habilitada com ActionType igual a olRuleActionServerReply. Você também pode habilitar ou desabilitar esse tipo de ação de regra em uma regra. No entanto, você não pode criar programaticamente uma regra que especifica a ação olRuleActionServerReply .

A tabela a seguir lista todas as ações de regra com suporte do Assistente de Regras e Alertas e se cada ação de regra tem suporte ao criar uma regra usando o modelo de objeto Regras. Uma ação de regra que não tem suporte em regras criadas pelo modelo de objeto Regras tem suporte apenas para enumeração programática e habilitação ou desabilitação em regras existentes criadas pelo Assistente de Regras e Alertas. A tabela também mostra se a ação de regra se aplica às regras do tipo olRuleReceive, olRuleSend ou ambas.

Action Constante em olRuleActionType Com suporte ao criar novas regras programaticamente? Aplica-se às regras olRuleReceive? Aplica-se às regras olRuleSend?
Atribuir a mensagem às categorias especificadas na propriedade AssignToCategoryRuleAction.Categories olRuleActionAssignToCategory Sim Sim Sim
Cc a mensagem para a lista de destinatários especificada na propriedade SendRuleAction.Recipients olRuleActionCcMessage Sim Não Sim
Apagar todas as categorias da mensagem olRuleActionClearCategories Sim Sim Sim
Copie a mensagem para a pasta especificada na propriedade MoveOrCopyRuleAction.Folder olRuleActionCopyToFolder Sim Sim Sim
Executar uma ação personalizada olRuleActionCustomAction Não Sim Sim
Adiar a entrega pelo número de minutos especificado olRuleActionDefer Não Não Sim
Excluir a mensagem olRuleActionDelete Sim Sim Não
Excluir permanentemente a mensagem olRuleActionDeletePermanently Sim Sim Não
Exibir um alerta da área de trabalho olRuleActionDesktopAlert Sim Sim Não
Apagar o sinalizador de mensagem olRuleActionFlagClear Não Sim Não
Sinalizar a mensagem com a cor especificada olRuleActionFlagColor Não Sim Não
Sinalizar a mensagem da ação nos dias especificados olRuleActionFlagForActionInDays Não Sim Sim
Encaminhar a mensagem para a lista de destinatários especificados na propriedade SendRuleAction.Recipients olRuleActionForward Sim Sim Não
Encaminhar a mensagem como um anexo para a lista de destinatários especificados na propriedade SendRuleAction.Recipients olRuleActionForwardAsAttachment Sim Sim Não
Marcar a mensagem com a prioridade especificada olRuleActionImportance Não Sim Sim
Marcar mensagem como uma tarefa para acompanhamento usando as propriedades FlagTo e MarkInterval do objeto MarkAsTaskRuleAction olRuleActionMarkAsTask Sim Sim Não
Marcar como lida olRuleActionMarkRead Não Sim Não
Mover a mensagem para a pasta especificada na propriedade oveOrCopyRuleAction.Folder olRuleActionMoveToFolder Sim Sim Não
Exibir a mensagem especificada na propriedade NewItemAlertRuleAction.Text olRuleActionNewItemAlert Sim Sim Não
Notificar a entrega da mensagem olRuleActionNotifyDelivery Sim Não Sim
Notificar a leitura da mensagem olRuleActionNotifyRead Sim Não Sim
Reproduzir o arquivo .wav especificado na propriedade PlaySoundRuleAction.FilePath olRuleActionPlaysound Sim Sim Não
Imprimir a mensagem na impressora padrão olRuleActionPrint Não Sim Não
Redirecionar a mensagem para a lista de destinatários especificados na propriedade SendRuleAction.Recipients olRuleActionRedirect Sim Sim Não
Iniciar uma cadeia de caracteres olRuleActionRunScript Não Sim Não
Marcar a mensagem com a sensibilidade especificada olRuleActionSensitivity Não Não Sim
Fazer com que o servidor responda usando a mensagem especificada olRuleActionServerReply Não Sim Não
Iniciar um arquivo .exe olRuleActionStartApplication Não Sim Não
Parar o processamento de mais regras olRuleActionStop Sim Sim Sim
Responder usando o arquivo de modelo especificado (.oft) olRuleActionTemplate Não Sim Não
Ação de regra desconhecida olRuleActionUnknown Não Sim Não

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.