Limites para ativação e API JavaScript para suplementos do Outlook

  • Artigo

A fim de fornecer uma experiência satisfatória para os usuários dos suplementos do Outlook, você deve estar ciente das determinadas diretrizes de ativação e de uso da API e implementar seus suplementos dentro desses limites Essas diretrizes existem para que um suplemento individual não possa exigir do Exchange Server ou do Outlook que gastem um tempo excessivamente longo processando suas regras de ativação ou chamadas à API JavaScript para Office, afetando a experiência do usuário geral no Outlook e outros suplementos. Estas diretrizes existem para que um suplemento individual não possa exigir que Exchange Server ou o Outlook despendam um período de tempo invulgarmente longo para processar as suas regras de ativação ou chamadas para a API JavaScript do Office, afetando a experiência geral do utilizador para o Outlook e outros suplementos. Estes limites aplicam-se à conceção de regras de ativação no manifesto do suplemento e à utilização de propriedades personalizadas, definições de roaming, destinatários, pedidos e respostas dos Serviços Web exchange (EWS) e chamadas assíncronas.

Observação

Também tem de verificar se o suplemento é executado dentro de determinados limites de utilização de recursos de runtime. Para obter mais informações, consulte Runtimes nos Suplementos do Office.

Limites em que os suplementos são ativados

Para saber mais sobre onde os suplementos fazem e não são ativados, consulte a secção "Itens de caixa de correio disponíveis para suplementos" da descrição geral dos suplementos do Outlook.

Limites para a API JavaScript

Cada cliente do Outlook impõe determinados limites no modelo de objeto JavaScript, conforme descrito na tabela seguinte.

Recurso Limite API relacionada Descrição
Propriedades personalizadas 2.500 caracteres Objeto CustomProperties método

Item.loadCustomPropertiesAsync method (Método Item.loadCustomPropertiesAsync )		 Limite de todas as propriedades personalizadas para um item de compromisso ou mensagem. Todos os clientes do Outlook devolvem um erro se o tamanho total de todas as propriedades personalizadas de um suplemento exceder este limite.
Configurações de roaming 32 KB número de caracteres Objeto RoamingSettings propriedade

Propriedade Context.roamingSettings		 Limite para todas as configurações de roaming do suplemento. Todos os clientes do Outlook devolvem um erro se as suas definições excederem este limite.
Cabeçalhos de Internet 256 KB por mensagem no Exchange Online

Limite de tamanho de cabeçalho determinado pelos administradores da organização no Exchange no local		 InternetHeaders.setAsync method (Método InternetHeaders.setAsync ) O limite de tamanho total dos cabeçalhos que podem ser aplicados a uma mensagem.
Serviços de Web do Exchange Número de 5 MB de carateres no Outlook na Web, no Windows (a partir da Versão 2303 (Compilação 16225.10000)), no Mac (a partir da Versão 16.73 (23042601)) e no novo Outlook no Windows

1 MB de carateres em versões anteriores do Outlook no Windows (clássico) e no Mac		 Mailbox.makeEwsRequestAsync method (Método Mailbox.makeEwsRequestAsync ) Limite para um pedido ou resposta a uma Mailbox.makeEwsRequestAsync chamada.
Seleção múltipla de itens 100 mensagens Mailbox.getSelectedItemsAsync method (Método Mailbox.getSelectedItemsAsync ) O número máximo de mensagens selecionadas nas quais um suplemento do Outlook pode ser ativado.
Destinatários Varia entre clientes do Outlook Propriedade Item.requiredAttendees

Propriedade Item.optionalAttendees

propriedade Item.to

propriedade Item.cc

Recipients.addAsync método

Recipients.getAsync método

Recipients.setAsync método		 Limite para os destinatários especificados em cada propriedade ou método. Para saber mais sobre os limites de destinatários de um cliente específico do Outlook, veja a documentação da API para a propriedade ou método.
Nome de exibição 255 caracteres Propriedade EmailAddressDetails.displayName objeto

Recipients propriedade

Propriedade Item.requiredAttendees

Propriedade Item.optionalAttendees

propriedade Item.to

propriedade Item.cc		 Limite de tamanho de um nome de exibição em um compromisso ou uma mensagem.
Definir o assunto 255 caracteres DisplayedSubject.setAsync (pré-visualização)

Método Mailbox.displayNewAppointmentForm

Método Subject.setAsync		 Limite para o assunto no formulário do novo compromisso ou para definir o assunto de um compromisso ou uma mensagem.
Definir o local 255 caracteres Método Location.setAsync Limite para definir o local de um compromisso ou solicitação de reunião.
Corpo em um novo formulário de compromisso 32 KB número de caracteres Método Mailbox.displayNewAppointmentForm Limite do corpo em um formulário de novo compromisso.
Apresentar o corpo de um item existente 32 KB número de caracteres Mailbox.displayAppointmentForm method (Método Mailbox.displayAppointmentForm )

Mailbox.displayMessageForm method (Método Mailbox.displayMessageForm )		 Para Outlook na Web, dispositivos móveis e novo Outlook no Windows: limite para o corpo num formulário de compromisso ou mensagem existente.
Definir o corpo 1 MB número de caracteres Método Body.prependAsync método

Body.setAsync

Método Body.setSelectedDataAsync

DisplayedBody.setAsync (pré-visualização)		 Limite para configurar o corpo de um item de compromisso ou de mensagem.
Definir a assinatura 30 000 carateres Body.setSignatureAsync method (Método Body.setSignatureAsync ) Limite para o comprimento de uma assinatura num compromisso ou mensagem.
Número de anexos 499 ficheiros no Outlook na Web e no novo Outlook no Windows Item.addFileAttachmentAsync method (Método Item.addFileAttachmentAsync ) Limite do número de arquivos que podem ser anexados a um item para envio. Outlook na Web e o novo Outlook no Windows limitam geralmente a anexação de até 499 ficheiros através da interface e addFileAttachmentAsync do método do utilizador. O Outlook no Windows (clássico) e no Mac não limita especificamente o número de anexos de ficheiros. No entanto, todos os clientes do Outlook observam o limite do tamanho dos anexos (veja a linha "Tamanho dos anexos" nesta tabela).
Tamanho dos anexos Dependente de Exchange Server no Outlook clássico no Windows e outlook no Mac

25 MB no Outlook na Web e no novo Outlook no Windows		 Item.addFileAttachmentAsync method (Método Item.addFileAttachmentAsync ) Limite para o tamanho de todos os anexos adicionados a um item de correio. No Outlook clássico no Windows e no Outlook no Mac, o limite é configurado por um administrador na Exchange Server da caixa de correio do utilizador. Nestes clientes, isto também limita o número de anexos de um item. Para Outlook na Web e o novo Outlook no Windows, o menor dos dois limites (o número de anexos e o tamanho de todos os anexos) restringe os anexos reais de um item.
Nome do arquivo anexo 255 caracteres Item.addFileAttachmentAsync method (Método Item.addFileAttachmentAsync ) Limite para o comprimento do nome de arquivo de um anexo a ser adicionado a um item.
URI do anexo 2,048 caracteres Item.addFileAttachmentAsync method (Método Item.addFileAttachmentAsync )

Item.addFileAttachmentFromBase64Async method (Método Item.addFileAttachmentFromBase64Async )		 Limite do URI do nome de arquivo a ser adicionado como um anexo a um item.
Cadeia codificada com base64 de um anexo 27 892 122 carateres (cerca de 25 MB) Item.addFileAttachmentFromBase64Async method (Método Item.addFileAttachmentFromBase64Async ) Limite da cadeia codificada com Base64 a adicionar como anexo a um item.
ID do anexo 100 caracteres Item.addItemAttachmentAsync method (Método Item.addItemAttachmentAsync )

Item.removeAttachmentAsync method (Método Item.removeAttachmentAsync )		 Limite para o tamanho da ID do anexo a ser adicionado ou removido de um item.
Chamadas assíncronas 3 chamadas Item.addFileAttachmentAsync method (Método Item.addFileAttachmentAsync )

Item.addItemAttachmentAsync method (Método Item.addItemAttachmentAsync )

Item.removeAttachmentAsync method (Método Item.removeAttachmentAsync )

Body.getTypeAsync método

Body.prependAsync método

Body.setSelectedDataAsync método

CustomProperties.saveAsync método

Item.LoadCustomPropertiesAsync method (Método Item.LoadCustomPropertiesAsync )

Location.getAsync método

Location.setAsync método

Mailbox.getCallbackTokenAsync method (Método Mailbox.getCallbackTokenAsync )

Mailbox.getUserIdentityTokenAsync method (Método Mailbox.getUserIdentityTokenAsync )

Mailbox.makeEwsRequestAsync method (Método Mailbox.makeEwsRequestAsync )

Recipients.addAsync método

Recipients.getAsync método

Recipients.setAsync método

RoamingSettings.saveAsync método

Subject.getAsync método

Subject.setAsync método

Time.getAsync método

Método Time.setAsync		 Para Outlook na Web e em dispositivos móveis, e o novo Outlook no Windows: limite do número de chamadas assíncronas simultâneas em qualquer altura, uma vez que os browsers permitem apenas um número limitado de chamadas assíncronas aos servidores.
Acrescentar no envio 5000 carateres Body.appendOnSendAsync method (Método Body.appendOnSendAsync ) Limite do conteúdo a acrescentar a uma mensagem ou corpo de compromisso durante o envio.
Pré-end-on-send 5000 carateres Body.prependOnSendAsync method (Método Body.prependOnSendAsync ) Limite do conteúdo a ser anexado a uma mensagem ou corpo de compromisso durante o envio.

Limites das regras de ativação para suplementos contextuais do Outlook

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.

Siga estas diretrizes ao conceber regras de ativação para suplementos contextuais do Outlook.

  • Limite o tamanho do manifesto a 256 KB. Não pode instalar o suplemento do Outlook para uma caixa de correio do Exchange se exceder esse limite.

    Observação

    As funcionalidades de suplemento do Outlook que dependem de regras de ativação não são suportadas quando o suplemento utiliza um manifesto de aplicação unificado para o Microsoft 365.

  • Especifique até 15 regras de ativação para o suplemento. Não pode instalar o suplemento se exceder esse limite.

  • Quando utiliza expressões regulares na regra ItemHasRegularExpressionMatch , tenha em atenção os seguintes limites e diretrizes que geralmente se aplicam a qualquer aplicação do Outlook e às descritas nas tabelas das secções com êxito que diferem consoante a aplicação.

    • Especifique até cinco expressões regulares nas regras de ativação num suplemento. Não pode instalar um suplemento se exceder esse limite.
    • Especifique expressões regulares de modo a que os resultados previstos sejam devolvidos pela chamada de getRegExMatches método nas primeiras 50 correspondências.
    • Importante: o texto é realçado com base em cadeias que resultam da correspondência da expressão regular. No entanto, as ocorrências realçadas podem não corresponder exatamente ao que deve resultar de asserções de expressões regulares reais, como olhar para a frente (?!text)negativo, look-behind (?<=text)e look-behind (?<!text)negativo. Por exemplo, se utilizar a expressão under(?!score) regular em "Like under, under score, and underscore", a cadeia "under" é realçada para todas as ocorrências em vez de apenas para as duas primeiras.

Diferenças no suporte para expressões regulares

A tabela seguinte lista os limites e descreve as diferenças no suporte para expressões regulares em clientes do Outlook. O suporte independe de qualquer tipo específico de dispositivo e de corpo de item.

Outlook na Web, num novo cliente Windows e em dispositivos móveis Outlook no Windows (clássico) e no Mac
Os clientes utilizam uma avaliação de expressão regular que faz parte do JavaScript. É fornecido pelo browser e suporta um superconjunto de ECMAScript 5. Os clientes utilizam o motor de expressão regular C++ fornecido como parte da biblioteca de modelos padrão do Visual Studio. Esse mecanismo é compatível com as normas ECMAScript 5.
Deve testar cada regex cuidadosamente em cada cliente do Outlook. Se um regex devolver resultados diferentes, reescreva o regex. Devido aos diferentes motores regex, um regex que inclui uma classe de carateres personalizada com base em classes de carateres predefinidas pode devolver resultados diferentes no Outlook no Windows (clássico) e no Mac versus no Outlook na Web, em dispositivos móveis e no novo Outlook no Windows.

Por exemplo, o regex [\s\S]{0,100} corresponde a qualquer número, entre 0 e 100, de carateres únicos que é um espaço em branco ou um espaço em branco. Este regex devolve resultados diferentes consoante o seu cliente do Outlook.

Como solução, deve reescrever o regex como (\s\|\S){0,100}. Este regex corresponde a qualquer número, entre 0 e 100, de espaço em branco ou espaço não branco.

Deve testar cada regex cuidadosamente em cada cliente do Outlook. Se um regex devolver resultados diferentes, reescreva o regex.
As definições de monitorização e registo de recursos suportadas no Outlook no Windows (clássico) e no Mac não são suportadas no Outlook na Web, em dispositivos móveis e no novo Outlook no Windows. No entanto, os suplementos com expressões regulares que exigem uma quantidade excessiva de tempo de avaliação no Outlook no Windows (clássico) e no Mac estão desativados para a mesma caixa de correio em todos os clientes do Outlook. Por predefinição, a avaliação de todas as expressões regulares de um suplemento está limitada a um segundo. Exceder este limite causa uma reavaliação de até três vezes. Para além do limite de reavaliação, o Outlook no Windows (clássico) e no Mac impedem que o suplemento seja executado para a mesma caixa de correio em qualquer um dos clientes do Outlook.

Os administradores podem substituir estes limites de avaliação com as OutlookActivationAlertThreshold chaves de registo e OutlookActivationManagerRetryLimit .

Limites do tamanho do corpo do item avaliado

A tabela seguinte lista os limites e descreve as diferenças na parte do corpo do item a que cada cliente do Outlook aplica uma expressão regular. Alguns desses limites dependem do tipo de dispositivo e do corpo do item se a expressão regular é aplicada no corpo do item.

Outlook na Web e no novo cliente Windows Outlook no Windows (clássico) e no Mac Outlook em dispositivos móveis
Fator forma Qualquer dispositivo suportado que não seja smartphones Android, iPad e iPhone. Qualquer dispositivo suportado. Smartphones Android, iPad ou iPhone.
Corpo do item de texto sem formatação Ativa o suplemento apenas se o corpo < tiver 500 000 carateres. Aplica a regex no primeiro 1 MB de dados do corpo, mas não no restante do corpo acima desse limite. Ativa o suplemento apenas se o corpo < tiver 16 000 carateres.
Corpo do item HTML Ativa o suplemento apenas se o corpo < tiver 500 000 carateres. Aplica a regex nos primeiros 512 KB de dados do corpo, mas não no restante do corpo acima desse limite. (O número real de caracteres depende da codificação, que pode variar de 1 a 4 bytes por caractere.) Aplica a regex nos primeiros 64.000 KB de dados do corpo (incluindo caracteres de marca HTML), mas não no restante do corpo acima desse limite.

Limites das correspondências devolvidas

A tabela seguinte lista os limites e descreve as diferenças nas correspondências que cada cliente do Outlook devolve após avaliar uma expressão regular. O suporte independe de um tipo de dispositivo específico, mas pode depender do tipo do corpo do item se a expressão regular é aplicada ao corpo do item.

Outlook na Web, num novo cliente Windows e em dispositivos móveis Outlook no Windows (clássico) e no Mac
Ordem das correspondências retornadas Suponha que o getRegExMatches método devolve correspondências diferentes para a mesma expressão regular aplicada no mesmo item de correio no Outlook no Windows (clássico) e no Mac versus no Outlook na Web, em dispositivos móveis e no novo Outlook no Windows. Suponha que o getRegExMatches método devolve correspondências diferentes para a mesma expressão regular aplicada no mesmo item de correio no Outlook no Windows (clássico) e no Mac versus no Outlook na Web, em dispositivos móveis e no novo Outlook no Windows.
Corpo do item de texto sem formatação getRegExMatches devolve quaisquer correspondências que sejam até 3072 (3 KB) carateres, para um máximo de 50 correspondências. O getRegExMatches método devolve quaisquer correspondências que sejam até 1.536 (1,5 KB), para um máximo de 50 correspondências.

Nota: getRegExMatches não devolve correspondências em nenhuma ordem específica na matriz devolvida. Em geral, suponha que a ordem das correspondências para a mesma expressão regular aplicada no mesmo item de correio no Outlook no Windows (clássico) e no Mac é diferente da dos Outlook na Web, em dispositivos móveis e no novo Outlook no Windows.
Corpo do item HTML getRegExMatches devolve quaisquer correspondências que sejam até 3072 (3 KB) carateres, para um máximo de 50 correspondências. getRegExMatches devolve quaisquer correspondências que sejam até 3072 (3 KB) carateres, para um máximo de 50 correspondências.

Nota: getRegExMatches não devolve correspondências em nenhuma ordem específica na matriz devolvida. Em geral, suponha que a ordem das correspondências para a mesma expressão regular aplicada no mesmo item de correio no Outlook no Windows (clássico) e no Mac é diferente da dos Outlook na Web, em dispositivos móveis e no novo Outlook no Windows.

Confira também