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

Artigo
07/19/2024

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 o 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 (pré-visualização) 1 MB de carateres em versões anteriores do Outlook no Windows 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 o Outlook na Web, dispositivos móveis e o novo Outlook no Windows (pré-visualização): 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 (pré-visualização)	Item.addFileAttachmentAsync method (Método Item.addFileAttachmentAsync )	Limite do número de arquivos que podem ser anexados a um item para envio. O Outlook na Web e o novo Outlook no Windows (pré-visualização) limitam geralmente a anexação de até 499 ficheiros através da interface e `addFileAttachmentAsync` do método do utilizador. O Outlook no Windows 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 do Exchange Server no Outlook clássico no Windows e outlook no Mac 25 MB no Outlook na Web e o novo Outlook no Windows (pré-visualização)	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 no Exchange Server da caixa de correio do utilizador. Nestes clientes, isto também limita o número de anexos de um item. Para o Outlook na Web e o novo Outlook no Windows (pré-visualização), 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 o Outlook na Web e em dispositivos móveis, e o novo Outlook no Windows (pré-visualização): limite do número de chamadas assíncronas em simultâneo 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, em dispositivos móveis e em novo cliente Windows (pré-visualização)	Outlook no Windows 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 e no Mac em comparação com o Outlook na Web, em dispositivos móveis e no novo Outlook no Windows (pré-visualização). 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 e no Mac não são suportadas no Outlook na Web, em dispositivos móveis e no novo Outlook no Windows (pré-visualização). No entanto, os suplementos com expressões regulares que exigem uma quantidade excessiva de tempo de avaliação no Outlook no Windows 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 e no Mac impede 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 (pré-visualização)	Outlook no cliente 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, em dispositivos móveis e em novo cliente Windows (pré-visualização)	Outlook no cliente 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 e no Mac versus no Outlook na Web, em dispositivos móveis e no novo Outlook no Windows (pré-visualização).	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 e no Mac versus no Outlook na Web, em dispositivos móveis e no novo Outlook no Windows (pré-visualização).
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 e no Mac é diferente da do Outlook na Web, em dispositivos móveis e no novo Outlook no Windows (pré-visualização).
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 e no Mac é diferente da do Outlook na Web, em dispositivos móveis e no novo Outlook no Windows (pré-visualização).

Partilhar via