Limites e requisitos da plataforma com Scripts do Office

Existem algumas limitações de plataforma das quais você deve estar ciente ao desenvolver Scripts do Office. Este artigo detalha o suporte ao navegador, os limites de dados e as mensagens de erro que você pode encontrar ao usar os Scripts do Office.

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 assinatura 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 com a Internet com experiências conectadas habilitadas.

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 usar os Scripts do Office no Power Automate, você deve ter uma licença comercial do Microsoft 365. As licenças do Office 365 Enterprise E1 e do Office 365 F3 podem usar Scripts com o Power Automate, mas não têm integrações com o Power Automate diretamente no Excel.

Limites de dados

Há limites para quantos dados do Excel podem ser transferidos de uma só vez e quantas transações individuais do Power Automate podem ser realizadas.

Excel

O Excel na Web tem as seguintes limitações ao fazer chamadas para a pasta de trabalho por meio de um script.

  • Solicitações e respostas são limitadas a 5 MB.
  • Um intervalo é limitado a cinco milhões de células.

Ao exceder um dos limites de dados do Excel, você receberá esta mensagem de erro: "O tamanho da carga de resposta excedeu o limite".

Se você estiver encontrando erros ao lidar com conjuntos de dados grandes, tente usar vários intervalos menores em vez de intervalos maiores. Para obter um exemplo, consulte o exemplo Gravar um conjunto de dados grande . Você também pode usar 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 para os Scripts do Office podem ser encontrados no artigo Especificações e limites do Excel.

Power Automate

As seguintes limitações com a plataforma Power Automate são aquelas que você provavelmente encontrará.

Limitações adicionais de uso da plataforma Power Automate podem ser encontradas nos artigos a seguir.

Restrições específicas do Power Automate

Existem algumas diferenças importantes entre executar um script no aplicativo Excel e executar um script como parte de um fluxo do Power Automate.

Nenhuma chamada externa de um script

As chamadas à API externa falham quando um script é executado por meio do Power Automate. Uma fetch chamada fornecerá a mensagem de erro "Erro de tempo de execução: Linha X: a busca não está definida". Certifique-se de marcar seus scripts para essas referências antes de criá-los em um fluxo.

Você precisará usar HTTP com o Azure AD ou outras ações equivalentes para extrair dados de um serviço externo ou enviá-los por push para um serviço externo.

Aviso

As chamadas externas feitas por meio do conector do Excel Online do Power Automate falham para ajudar a manter as políticas de prevenção contra perda de dados existentes. No entanto, os scripts executados por meio do Power Automate são feitos fora da sua organização e fora dos firewalls da sua organização. Para obter proteção adicional contra usuários mal-intencionados neste ambiente externo, o administrador pode controlar o uso dos Scripts do Office. O administrador pode desabilitar o conector do Excel Online no Power Automate ou desativar os Scripts do Office para Excel por meio dos controles de administrador de Scripts do Office.

Diferenças de comportamento da API

Algumas APIs se comportam de maneira diferente quando executadas com o Power Automate. Outros falham devido à sua dependência da interface do usuário do Excel. As listas completas são encontradas em Solucionar Problemas de Scripts do Office em execução no Power Automate.

Não há suporte para pastas de trabalho Open XML estritas de ISO

A ação Executar script do conector do Excel Business (Online) não dá suporte a pastas de trabalho com a versão estrita ISO do formato de arquivo de pasta de trabalho do Excel. Fluxos com esse tipo de pasta de trabalho retornam um erro "BadGateway" ao tentar executar um script. Isso ocorre devido a restrições de coautoria. Salve as pastas de trabalho como o formato padrão de pasta de trabalho do Excel para uso com o Power Automate.

Suporte do Teams

Importante

Ao usar o Excel com o Teams, os Scripts do Office têm suporte apenas 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 têm suporte no GCC High ou superior. Chamadas externas de scripts podem ser afetadas por configurações de firewall em outras nuvens governamentais.

Cookies de terceiros para o Excel na Web

Seu navegador precisa dos cookies de terceiros habilitados para mostrar a guia Automatizar no Excel na Web. Verifique as configurações do navegador se a guia não estiver sendo exibida. Se você estiver usando uma sessão de navegador privado, talvez seja necessário reabilitar essa configuração todas as vezes.

Observação

Alguns navegadores se referem a essa configuraçã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 gerenciados. Se o dispositivo não for gerenciado pelo locatário, talvez você não tenha acesso a scripts específicos ou só consiga acessá-los por meio do navegador.

Os locatários que adicionaram configurações de contexto de autenticação com o Acesso Condicional não dão suporte aos Scripts do Office no Excel na Web. Se o locatário tiver uma configuração de contexto de autenticação e você encontrar um erro ao tentar criar, gravar ou executar um Script do Office no Excel na Web, use o Excel para Windows ou o Excel para Mac.

Se o script for bloqueado por políticas de Acesso Condicional, você receberá uma das duas mensagens de erro. Essas mensagens também aparecem no Power Automate se o fluxo for executado de um dispositivo não gerenciado.

  • "Devido a políticas organizacionais, você não pode acessar esse recurso por meio desse dispositivo não confiável."
  • "Não conseguimos encontrar este script. Ele pode ter sido excluído por outro usuário." (Se sua versão do Excel for mais antiga.)

Importante

Os administradores devem considerar bloquear todo o acesso ao Power Automate de dispositivos não gerenciados. Esse processo é detalhado na postagem do blog Controle o Acesso ao Power Apps e Power Automate com as Políticas de Acesso Condicional do Azure AD.

Suporte à API em versões mais antigas do Excel

Algumas APIs de Scripts do Office podem não ter suporte no Excel para Windows ou no Excel para Mac, especialmente em builds mais antigos. Isso inclui APIs mais recentes e APIs para recursos somente da Web. Se um script contiver APIs sem suporte, o Editor de Códigos exibirá um aviso. Se você tentar executar esse script, ele não será executado. Em vez disso, o painel de tarefas Status de Execução do Script exibe uma mensagem de aviso que diz: "No momento, este script deve ser executado no Excel para a Web. Abra a pasta de trabalho no navegador e tente novamente ou entre em contato com o proprietário do script para obter ajuda."

Usar uma versão mais antiga do Excel para abrir pastas de trabalho com scripts compartilhados nelas não tem efeito sobre o script em si.

Confira também

  • Last updated on