Partilhar via


Limites e requisitos da plataforma com Scripts do Office

Existem algumas limitações de plataforma das quais deve estar ciente ao desenvolver Scripts do Office. Este artigo detalha o suporte do browser e os limites de dados para Scripts do Office para Excel.

Suporte à plataforma

Para utilizar os Scripts do Office, você precisará do seguinte.

  1. Excel na Web, Excel para Windows (Versão 2210 ou superior) ou Excel para Mac.
  2. OneDrive for Business.
  3. Qualquer uma das seguintes licenças de subscrição do Microsoft 365:
    • Office 365 Business
    • Office 365 Business Premium
    • Office 365 ProPlus
    • Office 365 ProPlus para dispositivos
    • Office 365 A3
    • Office 365 A5
    • Office 365 Enterprise E1
    • Office 365 Enterprise E3
    • Office 365 Enterprise E5
    • Office 365 F3
  4. Conectividade à Internet com experiências ligadas ativadas.

Observação

Se você atender aos requisitos e ainda não estiver vendo a guia Automatizar, é possível que o seu administrador tenha desabilitado o recurso ou que haja outro problema em seu ambiente. Siga as etapas em Guia Automatizar não aparecem ou Scripts do Office não disponíveis para começar a usar os Scripts do Office.

Importante

Para utilizar scripts do Office no Power Automate, tem de ter uma licença empresarial do Microsoft 365. As licenças Office 365 Enterprise E1 e Office 365 F3 podem utilizar Scripts com o Power Automate, mas não têm integrações do Power Automate diretamente no Excel.

Limites de dados

Existem limites para a quantidade de dados do Excel que podem ser transferidos ao mesmo tempo e quantas transações individuais do Power Automate podem ser realizadas.

Excel

Excel na Web tem as seguintes limitações ao fazer chamadas para o livro através de um script.

  • Os pedidos e as respostas estão limitados a 5 MB.
  • Um intervalo está limitado a cinco milhões de células.

Quando excede um dos limites de dados do Excel, recebe esta mensagem de erro: "O tamanho do payload da resposta excedeu o limite".

Se encontrar erros ao lidar com grandes conjuntos de dados, experimente utilizar vários intervalos mais pequenos em vez de intervalos maiores. Por exemplo, veja o exemplo Escrever um grande conjunto de dados . Também pode utilizar APIs como Range.getSpecialCells para direcionar células específicas em vez de intervalos grandes.

Os limites do Excel que não são específicos dos Scripts do Office podem ser encontrados no artigo Especificações e limites do Excel.

Power Automate

As seguintes limitações com a plataforma do Power Automate são as que tem mais probabilidades de encontrar.

Pode encontrar limitações adicionais de utilização da plataforma do Power Automate nos seguintes artigos.

Restrições específicas do Power Automate

Existem algumas diferenças importantes entre executar um script na aplicação Excel e executar um script como parte de um fluxo do Power Automate.

Não existem chamadas externas de um script

As chamadas à API externa falham quando um script é executado através do Power Automate. Uma fetch chamada dará a mensagem de erro "Erro de runtime: Linha X: a obtenção não está definida". Certifique-se de que marcar os scripts para essas referências antes de os criar num fluxo.

Terá de utilizar HTTP com Azure AD ou outras ações equivalentes para extrair dados ou enviá-lo para um serviço externo.

Aviso

As chamadas externas efetuadas através do conector do Excel Online do Power Automate falham para ajudar a manter as políticas de prevenção de perda de dados existentes. No entanto, os scripts executados através do Power Automate são feitos fora da sua organização e fora das firewalls da sua organização. Para proteção adicional contra utilizadores maliciosos neste ambiente externo, o seu administrador pode controlar a utilização de Scripts do Office. O seu administrador pode desativar o conector do Excel Online no Power Automate ou desativar os Scripts do Office para Excel através dos controlos de administrador de Scripts do Office.

Diferenças de comportamento da API

Algumas APIs comportam-se de forma diferente quando são executadas com o Power Automate. Outros falham devido à dependência da IU do Excel. As listas completas encontram-se em Resolver Problemas de Scripts do Office em execução no Power Automate.

Os livros Open XML rígidos iso não são suportados

A ação Executar script do conector Do Excel Business (Online) não suporta livros com a versão estrita ISO do formato de ficheiro livro do Excel. Os fluxos com este tipo de livro devolvem um erro "BadGateway" ao tentar executar um script. Isto deve-se a restrições de cocriação. Guarde livros como o formato padrão do Livro do Excel para utilização com o Power Automate.

Suporte do Teams

Importante

Ao utilizar o Excel com o Teams, os Scripts do Office só são suportados no Teams na Web (não no Teams para Windows, Mac, iOS ou Android).

Suporte de nuvem do Governo

Os Scripts do Office não são suportados no GCC High ou superior. As chamadas externas de scripts podem ser afetadas pelas definições da firewall noutras clouds governamentais.

Cookies de terceiros para Excel na Web

O seu browser precisa de cookies de terceiros ativados para mostrar o separador Automatizar no Excel na Web. Verifique as definições do browser se o separador não estiver a ser apresentado. Se estiver a utilizar uma sessão de browser privado, poderá ter de voltar a ativar esta definição de cada vez.

Observação

Alguns browsers referem-se a esta definição como "todos os cookies", em vez de "cookies de terceiros".

Acesso Condicional

As políticas de Acesso Condicional restringem o acesso ao SharePoint e ao OneDrive para dispositivos não geridos. Se o seu dispositivo não for gerido pelo inquilino, poderá não ter acesso a scripts específicos ou só poderá aceder aos mesmos através do browser.

Se o script for bloqueado pelas políticas de Acesso Condicional, receberá uma de duas mensagens de erro. Estas mensagens também aparecem no Power Automate se o fluxo for executado a partir de um dispositivo não gerido.

  • "Devido às políticas organizacionais, não pode aceder a este recurso a partir deste dispositivo não fidedigno."
  • "Não conseguimos encontrar este script. Pode ter sido eliminado por outro utilizador." (Se a sua versão do Excel for mais antiga.)

Importante

Os administradores devem considerar bloquear todo o acesso ao Power Automate a partir de dispositivos não geridos. Este processo é detalhado na publicação de blogue Control Access to Power Apps and Power Automate with Azure AD Conditional Access Policies (Controlar o Acesso ao Power Apps e ao Power Automate com políticas de acesso condicional Azure AD).

Suporte de API em versões mais antigas do Excel

Algumas APIs de Scripts do Office podem não ser suportadas pelo Excel para Windows ou Excel para Mac, especialmente compilações mais antigas. Estas incluem APIs e APIs mais recentes para funcionalidades apenas na Web. Se um script contiver APIs não suportadas, o código Editor apresenta um aviso. Se tentar executar um script deste tipo, este não será executado. Em vez disso, o painel de tarefas Estado da Execução de Script apresenta uma mensagem de aviso a indicar " Este script tem de ser executado atualmente no Excel para a Web. Abra o livro no browser e, em seguida, tente novamente ou contacte o proprietário do script para obter ajuda."

A utilização de uma versão mais antiga do Excel para abrir livros com scripts partilhados não tem qualquer efeito no próprio script.

Confira também