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

Artigo
03/05/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. Essas diretrizes existem para que um suplemento individual não possa exigir que Exchange Server ou Outlook gastem um período extraordinariamente longo de tempo para processar suas regras de ativação ou chamadas para a API JavaScript do Office, afetando a experiência geral do usuário para o Outlook e outros suplementos. Esses limites se aplicam à criação de regras de ativação no manifesto de suplemento e ao usar propriedades personalizadas, configurações de roaming, destinatários, solicitações e respostas do Exchange Web Services (EWS) e chamadas assíncronas.

Observação

Você também deve verificar se o suplemento é executado dentro de determinados limites de uso de recursos de runtime. Para obter mais informações, consulte Runtimes em 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, confira a seção "Itens de caixa de correio disponíveis para suplementos" da visã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 a seguir.

Recurso	Limite	API relacionada	Descrição
Propriedades personalizadas	2.500 caracteres	Objeto CustomProperties método Método Item.loadCustomPropertiesAsync	Limite de todas as propriedades personalizadas para um item de compromisso ou mensagem. Todos os clientes do Outlook retornam um erro se o tamanho total de todas as propriedades personalizadas de um suplemento exceder esse 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 retornarão um erro se suas configurações excederem esse limite.
Cabeçalhos de Internet	256 KB por mensagem em Exchange Online Limite de tamanho do cabeçalho determinado pelos administradores da organização no Exchange local	Método InternetHeaders.setAsync	O limite total de tamanho dos cabeçalhos que podem ser aplicados a uma mensagem.
Extrair entidades conhecidas	2000 número de caracteres	Método Item.getEntities Método Item.getEntitiesByType Método Item.getFilteredEntitiesByName	Limite para o Exchange Server extrair entidades conhecidas no corpo do item. O Exchange Server ignora entidades além desse limite. Observe que esse limite é independente de o suplemento usar uma `ItemHasKnownEntity` regra.
Serviços de Web do Exchange	Número de 5 MB de caracteres no Outlook na Web, no Windows (começando na versão 2303 (Build 16225.10000)), no Mac (começando na versão 16.73 (23042601)) e no novo Outlook no Windows (versão prévia) 1 MB de caracteres em versões anteriores do Outlook no Windows e no Mac	Método Mailbox.makeEwsRequestAsync	Limite para uma solicitação ou resposta a uma `Mailbox.makeEwsRequestAsync` chamada.
Várias seleções de item	100 mensagens	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 do destinatário para um cliente específico do Outlook, consulte 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 (versão prévia) 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.
Exibir o corpo de um item existente	32 KB número de caracteres	Método Mailbox.displayAppointmentForm Método Mailbox.displayMessageForm	Para Outlook na Web, dispositivos móveis e novo Outlook no Windows (versão prévia): limite para o corpo em um 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 (versão prévia)	Limite para configurar o corpo de um item de compromisso ou de mensagem.
Definir a assinatura	30.000 caracteres	Método Body.setSignatureAsync	Limite para o comprimento de uma assinatura em um compromisso ou mensagem.
Número de anexos	499 arquivos em Outlook na Web, em dispositivos móveis e no novo Outlook no Windows (versão prévia)	Método Item.addFileAttachmentAsync	Limite do número de arquivos que podem ser anexados a um item para envio. Outlook na Web e em dispositivos móveis e o novo Outlook no Windows (versão prévia) geralmente limitam a anexação de até 499 arquivos por meio da interface do usuário e `addFileAttachmentAsync` do método. O Outlook no Windows e no Mac não limita especificamente o número de anexos de arquivo. No entanto, todos os clientes do Outlook observam o limite para o tamanho dos anexos determinados pelo Exchange Server do usuário (consulte a linha "Tamanho dos anexos" nesta tabela).
Tamanho dos anexos	Depende do Exchange Server	Método Item.addFileAttachmentAsync	Há um limite no tamanho de todos os anexos de um item de email, que um administrador pode configurar na Exchange Server da caixa de correio do usuário. Para o Outlook no Windows e no Mac, isso limita o número de anexos para um item. Para Outlook na Web e em dispositivos móveis e novo Outlook no Windows (versão prévia), 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	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	Método Item.addFileAttachmentAsync Método Item.addFileAttachmentFromBase64Async	Limite do URI do nome de arquivo a ser adicionado como um anexo a um item.
Cadeia de caracteres codificada com base64 de um anexo	27.892.122 caracteres (cerca de 25 MB)	Método Item.addFileAttachmentFromBase64Async	Limite da cadeia de caracteres codificada base64 a ser adicionada como um anexo a um item.
ID do anexo	100 caracteres	Método Item.addItemAttachmentAsync 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	Método Item.addFileAttachmentAsync Método Item.addItemAttachmentAsync Método Item.removeAttachmentAsync Body.getTypeAsync método Body.prependAsync método Body.setSelectedDataAsync método CustomProperties.saveAsync método Método Item.LoadCustomPropertiesAsync Location.getAsync método Location.setAsync método Método Mailbox.getCallbackTokenAsync Método Mailbox.getUserIdentityTokenAsync 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 novo Outlook no Windows (versão prévia): limite do número de chamadas assíncronas simultâneas ao mesmo tempo, pois os navegadores permitem apenas um número limitado de chamadas assíncronas para servidores.
Anexar-em-enviar	5.000 caracteres	Método Body.appendOnSendAsync	Limite do conteúdo a ser acrescentado a um corpo de mensagem ou compromisso no envio.
Prepend-on-send	5.000 caracteres	Método Body.prependOnSendAsync	Limite do conteúdo a ser pré-acrescentado a um corpo de mensagem ou compromisso no envio.

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

Importante

Os suplementos contextuais do Outlook baseados em entidade serão desativados no segundo trimestre de 2024. O trabalho para aposentar esse recurso começará em maio e continuará até o final de junho. Após junho, os suplementos contextuais não poderão mais detectar entidades em itens de email para executar tarefas neles. As APIs a seguir também serão retiradas.

Para ajudar a minimizar possíveis interrupções, o seguinte ainda será suportado depois que os suplementos contextuais baseados em entidade forem retirados.

Uma implementação alternativa do botão Ingressar Reunião , que é ativado por suplementos de reunião online, está sendo desenvolvida. Depois que o suporte para suplementos contextuais baseados em entidade terminar, os suplementos de reunião online farão a transição automática para a implementação alternativa para ativar o botão Ingressar Reunião .
As regras de expressão regular continuarão a ser suportadas depois que os suplementos contextuais baseados em entidade forem retirados. Recomendamos atualizar seu suplemento contextual para usar regras de expressão regulares como uma solução alternativa. Para obter diretrizes sobre como implementar essas regras, consulte Usar regras regulares de ativação de expressão para mostrar um suplemento do Outlook.

Para obter mais informações, consulte Aposentadoria de suplementos contextuais do Outlook baseados em entidade.

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

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

Observação

Não há suporte para recursos de suplemento do Outlook que dependem de regras de ativação quando o suplemento usa um manifesto unificado para o Microsoft 365.
Especifique até 15 regras de ativação para o suplemento. Você não poderá instalar o suplemento se exceder esse limite.
No Outlook no Windows e no Mac, se você usar uma regra ItemHasKnownEntity no corpo do item selecionado, espere que a regra seja aplicada somente aos primeiros 1 MB do corpo e não ao restante do corpo acima desse limite. Seu suplemento não será ativado se as correspondências existirem somente após o primeiro MB do corpo. Se você espera que esse seja um cenário provável, redesenho suas condições para ativação.
Se você usar expressões regulares nas ItemHasKnownEntity regras ItemHasRegularExpressionMatch , esteja ciente dos seguintes limites e diretrizes que geralmente se aplicam a qualquer aplicativo do Outlook e aqueles descritos nas tabelas das seções bem-sucedidas que diferem dependendo do aplicativo.
- Especifique até cinco expressões regulares em regras de ativação em um suplemento. Você não poderá instalar um suplemento se exceder esse limite.
- Especifique expressões regulares de modo que os resultados previstos sejam retornados pela chamada de getRegExMatches método nas primeiras 50 correspondências.
- Importante: o texto é realçado com base em cadeias de caracteres resultantes da correspondência da expressão regular. No entanto, as ocorrências realçadas podem não corresponder exatamente ao que deve resultar de declarações de expressão regular reais, como olhar negativo para frente (?!text), olhar para trás (?<=text)e olhar negativo para trás (?<!text). Por exemplo, se você usar a expressão under(?!score) regular em "Como em, em pontuação e sublinhado", a cadeia de caracteres "under" será realçada para todas as ocorrências em vez de apenas as duas primeiras.

Diferenças no suporte para expressões regulares

A tabela a seguir lista os limites e descreve as diferenças no suporte para expressões regulares entre 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 (versão prévia)	Outlook no Windows e no Mac
Os clientes usam uma avaliação de expressão regular que faz parte do JavaScript. Ele é fornecido pelo navegador e dá suporte a um superconjunto de ECMAScript 5.	Os clientes usam o mecanismo 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.
Você deve testar cada regex completamente em cada cliente do Outlook. Se um regex retornar resultados diferentes, reescreva o regex.	Devido aos diferentes mecanismos regex, um regex que inclui uma classe de caractere personalizada baseada em classes de caracteres predefinidas pode retornar resultados diferentes no Outlook no Windows e no Mac versus em Outlook na Web, em dispositivos móveis e no novo Outlook no Windows (versão prévia). Como exemplo, o regex `[\s\S]{0,100}` corresponde a qualquer número, entre 0 e 100, de caracteres únicos que é um whitespace ou um não whitespace. Esse regex retorna resultados diferentes dependendo do cliente do Outlook. Como solução alternativa, você deve reescrever o regex como `(\s\\|\S){0,100}`. Esse regex corresponde a qualquer número, entre 0 e 100, de espaço em branco ou não branco. Você deve testar cada regex completamente em cada cliente do Outlook. Se um regex retornar resultados diferentes, reescreva o regex.
As configurações de monitoramento e registro de recursos com suporte no Outlook no Windows e no Mac não têm suporte em Outlook na Web, em dispositivos móveis e no novo Outlook no Windows (versão prévia). No entanto, suplementos com expressões regulares que exigem um tempo excessivo de avaliação no Outlook no Windows e no Mac são desabilitados para a mesma caixa de correio em todos os clientes do Outlook.	Por padrão, a avaliação de todas as expressões regulares para um suplemento é limitada a um segundo. Exceder esse limite causa reavaliação de até três vezes. 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 esses limites de avaliação usando as chaves e `OutlookActivationManagerRetryLimit` do `OutlookActivationAlertThreshold` registro.

Limites no tamanho do corpo do item avaliado

A tabela a seguir lista os limites e descreve as diferenças na parte do corpo do item à qual 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 (versão prévia)	Outlook no cliente clássico do Windows e no Mac	Outlook em dispositivos móveis
Fator forma	Qualquer dispositivo com suporte diferente de smartphones Android, iPad e iPhone.	Qualquer dispositivo com suporte.	Smartphones Android, iPad ou iPhone.
Corpo do item de texto sem formatação	Ativa o suplemento somente se o corpo < tiver 500.000 caracteres.	Aplica a regex no primeiro 1 MB de dados do corpo, mas não no restante do corpo acima desse limite.	Ativa o suplemento somente se o corpo < tiver 16.000 caracteres.
Corpo do item HTML	Ativa o suplemento somente se o corpo < tiver 500.000 caracteres.	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 retornadas

A tabela a seguir lista os limites e descreve as diferenças nas correspondências que cada cliente do Outlook retorna 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 (versão prévia)	Outlook no cliente clássico do Windows e no Mac
Ordem das correspondências retornadas	Suponha que o `getRegExMatches` método retorne correspondências diferentes para a mesma expressão regular aplicada no mesmo item de email no Outlook no Windows e no Mac versus em Outlook na Web, em dispositivos móveis e no novo Outlook no Windows (versão prévia).	Suponha que o `getRegExMatches` método retorne correspondências diferentes para a mesma expressão regular aplicada no mesmo item de email no Outlook no Windows e no Mac versus em Outlook na Web, em dispositivos móveis e no novo Outlook no Windows (versão prévia).
Corpo do item de texto sem formatação	`getRegExMatches` retorna todas as correspondências com até 3.072 caracteres (3 KB), para um máximo de 50 correspondências.	O `getRegExMatches` método retorna todas as correspondências com até 1.536 caracteres (1,5 KB), para um máximo de 50 correspondências. Observação: `getRegExMatches` não retorna correspondências em nenhuma ordem específica na matriz retornada. Em geral, suponha que a ordem das correspondências para a mesma expressão regular aplicada no mesmo item de email no Outlook no Windows e no Mac seja diferente daquela em Outlook na Web, em dispositivos móveis e no novo Outlook no Windows (versão prévia).
Corpo do item HTML	`getRegExMatches` retorna todas as correspondências com até 3.072 caracteres (3 KB), para um máximo de 50 correspondências.	`getRegExMatches` retorna todas as correspondências com até 3.072 caracteres (3 KB), para um máximo de 50 correspondências. Observação: `getRegExMatches` não retorna correspondências em nenhuma ordem específica na matriz retornada. Em geral, suponha que a ordem das correspondências para a mesma expressão regular aplicada no mesmo item de email no Outlook no Windows e no Mac seja diferente daquela em Outlook na Web, em dispositivos móveis e no novo Outlook no Windows (versão prévia).