Partilhar via

Códigos de erro comuns da API do Office

  • Artigo

Este artigo documenta as mensagens de erro que poderá encontrar ao utilizar o modelo de API Comum. Estes códigos de erro não se aplicam a APIs específicas da aplicação, como a API JavaScript do Excel ou a API JavaScript do Word.

Veja Modelos de API para saber mais sobre as diferenças entre a API Comum e os modelos de API específicos da aplicação.

Códigos de erro

A tabela a seguir lista os códigos de erro, nomes e mensagens exibidas e as condições que indicam.

Error.code Error.name Error.message Condition
1000 Tipo inválido de coerção O tipo de coerção especificado não tem suporte O tipo de coação não é suportado na aplicação do Office. (Por exemplo, não há suporte para os tipos de coerção OOXML e HTML no Excel.)
1001 Erro de Leitura de Dados A seleção atual não tem suporte. Não há suporte para a seleção atual do usuário (ou seja, é algo diferente dos tipos de coerção com suporte).
1002 Tipo inválido de coerção O tipo de coerção especificado não é compatível com este tipo de associação. O desenvolvedor da solução forneceu uma combinação incompatível de tipo de coerção e tipo de associação.
1003 Erro de Leitura de Dados Os valores rowCount ou columnCount especificados são inválidos. O usuário fornece contagens inválidas de coluna ou de linha.
1004 Erro de Leitura de Dados A seleção atual não tem suporte para o tipo de coerção especificado. A seleção atual não é compatível com o tipo de coerção especificado por este aplicativo.
1005 Erro de Leitura de Dados Os valores startRow ou startColumn especificados são inválidos. O usuário fornece valores inválidos de startRow ou startCol.
1006 Erro de Leitura de Dados Os parâmetros de coordenadas não podem ser usados com o tipo de coerção “Table” quando a tabela contiver células mescladas. O usuário tenta obter dados parciais de uma tabela não uniforme (ou seja, uma tabela que possui células mescladas).
1007 Erro de Leitura de Dados O tamanho do documento é muito grande. O usuário tentar obter um documento maior do que o tamanho compatível no momento.
1008 Erro de Leitura de Dados O conjunto de dados solicitado é muito grande. O utilizador pede para ler dados para além dos limites de dados definidos pela aplicação do Office.
1009 Erro de Leitura de Dados O tipo de arquivo especificado não tem suporte. O usuário envia um tipo de arquivo inválido.
2000 Erro de Gravação de Dados Não há suporte para o tipo de objeto de dados fornecido. Um objeto de dados sem suporte foi fornecido.
2001 Erro de Gravação de Dados Não é possível gravar na seleção atual. Não há suporte para a seleção atual do usuário para uma operação de gravação. (Por exemplo, quando o usuário seleciona uma imagem.)
2002 Erro de Gravação de Dados O objeto de dados fornecido não é compatível com a forma ou com as dimensões da seleção atual. Várias células são selecionadas (e a forma de seleção não corresponde à forma dos dados). Várias células são selecionadas (e as dimensões da seleção não correspondem às dimensões dos dados).
2003 Erro de Gravação de Dados A operação de definição falhou porque o objeto de dados fornecido substituirá os dados. Uma única célula está selecionada e o objeto de dados fornecido substitui os dados na planilha.
2004 Erro de Gravação de Dados O objeto de dados fornecido não corresponde ao tamanho da seleção atual. O usuário fornece um objeto maior do que o tamanho da seleção atual.
2005 Erro de Gravação de Dados Os valores startRow ou startColumn especificados são inválidos. O usuário fornece valores inválidos de startRow ou startCol.
2006 Erro de formato inválido O formato do objeto de dados especificado não é válido. O desenvolvedor de solução fornece uma cadeia de caracteres HTML ou OOXML inválida, uma cadeia de caracteres HTML mal formada ou uma cadeia de caracteres OOXML inválida.
2007 Objeto de dados inválido O tipo do objeto de dados especificado não é compatível com a seleção atual. O desenvolvedor da solução fornece um objeto de dados incompatível com o tipo de coerção especificado.
2008 Erro de Gravação de Dados TBD TBD
2009 Erro de Gravação de Dados O objeto de dados especificado é muito grande. O utilizador tenta definir dados para além dos limites de dados definidos pela aplicação do Office.
2010 Erro de Gravação de Dados Os parâmetros de coordenadas não podem ser usados com o tipo de coerção Table quando a tabela contiver células mescladas. O usuário tenta definir dados parciais de uma tabela não uniforme (ou seja, uma tabela que possui células mescladas).
3000 Erro de Criação de Associação Não é possível associar à seleção atual. Não há suporte para a associação da seleção do usuário. (Por exemplo, o usuário está selecionando uma imagem ou outro objeto sem suporte.)
3001 Erro de Criação de Associação TBD TBD
3002 Erro de Associação Inválida A ligação especificada não existe. O desenvolvedor tenta associar a uma associação não existente ou removida.
3003 Erro de Criação de Associação Não há suporte para várias seleções não contíguas. O usuário está fazendo várias seleções.
3004 Erro de Criação de Associação Não é possível criar uma ligação com a seleção atual e o tipo de ligação especificada. Há várias condições em que isso pode acontecer. Confira a seção "Condições de erro de criação de associação" posteriormente neste artigo.
3005 Operação de Associação Inválida Operação sem suporte neste tipo de associação. O programador envia uma operação adicionar linha ou adicionar coluna num tipo de enlace que não é do tipo tablede coação .
3006 Erro de Criação de Associação O item nomeado não existe. Não foi possível encontrar o item nomeado. Não existe um controle de conteúdo ou uma tabela com esse nome.
3007 Erro de Criação de Associação Foram encontrados vários objetos com o mesmo nome. Erro de colisão: existe mais do que um controlo de conteúdo com o mesmo nome e a colisão pós-falha está definida como true.
3008 Erro de Criação de Associação O tipo de associação especificado não é compatível com o item nomeado fornecido. O item nomeado não pode ser vinculado ao tipo. Por exemplo, um controlo de conteúdo contém texto, mas o programador tentou vincular-se utilizando o tipo tablede coação .
3009 Operação de Associação Inválida Não há suporte para o tipo de vinculação. Usado para fins de compatibilidade com versões anteriores.
3010 Operação de Associação Inválida O conteúdo selecionado precisa estar em formato de tabela. Formate os dados como uma tabela e tente novamente. O programador está a tentar utilizar o addRowsAsync método ou deleteAllDataValuesAsync do TableBinding objeto em dados do tipo matrixde coação .
4000 Erro de leitura de configurações O nome de configuração especificado não existe. Um nome de configuração inexistente foi fornecido.
4001 Salvar erro de configurações Não foi possível salvar as configurações. Não foi possível salvar as configurações.
4002 Erro de configurações obsoletos Não foi possível salvar as configurações porque elas estão obsoletas. As configurações estão obsoletas e o desenvolvedor indicou que não devem ser substituídas.
5000 Erro de configurações obsoletos Não há suporte para a operação. A operação não é suportada na aplicação atual do Office. Por exemplo, document.getSelectionAsync é chamado a partir do Outlook.
5001 Erro interno Ocorreu um erro interno. Refere-se a uma condição de erro interna, que pode ocorrer por qualquer um dos seguintes motivos.
Um suplemento que está sendo usado por outro usuário que compartilha a pasta de trabalho criada com uma associação aproximadamente no mesmo momento, e seu suplemento precisa tentar realizar a associação novamente.
Ocorreu um erro desconhecido.
Falha na operação.
O acesso foi negado porque o usuário não é um membro de uma função autorizada.
O acesso foi negado porque é necessária a comunicação segura e criptografada.
Os dados estão obsoletos, e o usuário precisa confirmar permitindo que as consultas os atualizem.
A cota de CPU do conjunto de sites foi excedida.
A cota de memória do conjunto de sites foi excedida.
A cota de memória da sessão foi excedida.
A pasta de trabalho está em um estado inválido, e a operação não pode ser executada.
A sessão expirou devido a inatividade, e o usuário precisa recarregar a pasta de trabalho.
A quantidade máxima de sessões permitida por usuário foi excedida.
A operação foi cancelada pelo usuário.
Não foi possível concluir a operação porque ela está demorando muito.
Não foi possível concluir a solicitação, e ela deve ser repetida.
O período de avaliação do produto expirou.
A sessão expirou devido a inatividade.
O usuário não tem permissão para executar a operação no intervalo especificado.
As configurações regionais do usuário não correspondem às da sessão atual de colaboração.
O usuário não está mais conectado e deve atualizar ou abrir novamente a pasta de trabalho.
O intervalo solicitado não existe na planilha.
O usuário não tem permissão para editar a pasta de trabalho.
Não foi possível editar a pasta de trabalho porque ela está bloqueada.
A sessão não pode salvar a pasta de trabalho automaticamente.
A sessão não pode atualizar seu bloqueio no arquivo de pasta de trabalho.
Não foi possível processar a solicitação, e ela deve ser repetida.
Não foi possível verificar as informações de entrada do usuário , e elas precisam ser inseridas novamente.
O usuário teve o acesso negado.
A pasta de trabalho compartilhada precisa ser atualizada.
5002 Permissão negada A operação solicitada não é permitida no modo de documento atual. O desenvolvedor da solução envia uma operação de definição, mas o documento está em um modo que não permite alterações, como “Restringir Edição”.
5003 Erro de registro de eventos Não há suporte para o tipo de evento especificado pelo objeto atual. O desenvolvedor da solução tenta registrar ou cancelar o registro de um manipulador para um evento que não existe.
5004 Chamada de API inválida Chamada à API inválida no contexto atual. É efetuada uma chamada inválida para o contexto, por exemplo, ao tentar utilizar um CustomXMLPart objeto no Excel.
5005 Dados obsoletos Falha na operação devido aos dados estarem obsoletos no servidor. Os dados no servidor precisam ser atualizados.
5006 Tempo Limite da Sessão O tempo limite da sessão do documento esgotou-se. Recarregue o documento. A sessão expirou.
5007 Chamada de API inválida Não há suporte à enumeração no contexto atual. Não há suporte à enumeração no contexto atual.
5009 Permissão negada Acesso negado O suplemento não tem permissão para chamar a API específica.
5012 Sessão inválida ou esgotada A sua sessão do browser do Office expirou ou é inválida. Para continuar, atualize a página. A sessão entre o cliente do Office e o servidor expirou, ou então a data, hora ou fuso horário estão incorretos em seu computador.
6000 Nó inválido O nó especificado não foi encontrado. O CustomXmlPart nó não foi encontrado.
6100 Erro no XML personalizado Erro no XML personalizado Chamada de API inválida.
7000 ID inválida A ID especificada não existe. ID inválida.
7001 Navegação inválida O objeto está localizado em um local em onde a navegação não é suportada. O usuário pode encontrar o objeto, mas não é possível navegar até ele. (Por exemplo, no Word, a associação ocorre com o cabeçalho, rodapé ou um comentário.)
7002 Navegação inválida O objeto está bloqueado ou protegido. O usuário está tentando navegar até um intervalo bloqueado ou protegido.
7004 Navegação inválida A operação falhou porque o índice está fora do intervalo. O usuário está tentando navegar até um índice fora do intervalo.
8000 Parâmetro Ausente Não foi possível formatar a célula da tabela porque faltam alguns valores de parâmetro. Verifique os parâmetros e tente novamente. Faltam alguns parâmetros no método cellFormat. Por exemplo, faltam células, formatações ou parâmetros de tableOptions.
8010 Valor inválido Um ou mais parâmetros de célula têm valores que não são permitidos. Verifique os valores e tente novamente. A enumeração de referência de células comuns não está definida. Por exemplo, Todos, Dados, Cabeçalhos.
8011 Valor inválido Um ou mais parâmetros tableOptions possuem valores que não são permitidos. Verifique os valores e tente novamente. Um dos valores em tableOptions é inválido.
8012 Valor inválido Um ou mais parâmetros de formato possuem valores que não são permitidos. Verifique os valores e tente novamente. Um dos valores no formato é inválido.
8020 Fora do intervalo O valor de índice de linha está fora do intervalo permitido. Use um valor positivo (0 ou maior) que seja menor do que o número de linhas. O índice de linha é superior ao maior índice de linha da tabela ou menor do que 0.
8021 Fora do intervalo O valor de índice de coluna está fora do intervalo permitido. Use um valor positivo (0 ou maior) que seja menor do que o número de colunas. O índice de coluna é superior ao maior índice de coluna da tabela ou menor do que 0.
8022 Fora do intervalo O valor está fora do intervalo permitido. Alguns dos valores no formato estão fora dos intervalos suportados.
9016 Permissão negada Permissão negada Acesso negado.
9020 Erro de Resposta Genérico Ocorreu um erro interno. Refere-se a uma condição de erro interna, que pode ocorrer por vários motivos.
9021 Erro ao Guardar Ocorreu um erro de ligação ao tentar guardar o item no servidor. Não foi possível guardar o item. Tal pode dever-se a um erro de ligação do servidor se estiver a utilizar o Modo Online no Ambiente de Trabalho do Outlook ou devido a uma tentativa de guardar novamente um item de rascunho que foi eliminado do servidor Exchange.
9022 Mensagem no Erro de Arquivo Diferente Não é possível obter o ID do EWS porque a mensagem está guardada noutro arquivo. Não foi possível obter o ID do EWS da mensagem atual porque a mensagem pode ter sido movida ou a caixa de correio de envio pode ter sido alterada.
9041 Erro de rede O usuário não está mais conectado à rede. Verifique sua conexão de rede e tente novamente. O utilizador já não tem acesso à rede ou à Internet.
9043 Tipo de Anexo Não Suportado O tipo de anexo não é suportado. A API não suporta o tipo de anexo. Por exemplo, item.getAttachmentContentAsync gera este erro se o anexo for uma imagem incorporada no Formato RTF ou se for um tipo de item diferente de um item de e-mail ou calendário (como um contacto ou item de tarefa).
9057 Limite de Tamanho Excedido Está disponível um máximo de 32 KB para as definições de cada suplemento. Ao atualizar as definições de roaming através de Office.context.roamingSettings.set, o tamanho não pode exceder os 32 KB. Consulte a interface Office.RoamingSettings.
12002 Não aplicável Não aplicável Uma destas opções:
- Não existe uma página na URL transmitida para displayDialogAsync.
- A página transmitida para displayDialogAsync foi carregada, mas a caixa de diálogo foi direcionada para uma página que ela não consegue localizar nem carregar ou foi direcionada para uma URL com sintaxe inválida. Lançado dentro da caixa de diálogo e dispara um evento DialogEventReceived na página de host.
12003 Não aplicável Não aplicável A caixa de diálogo foi direcionada para uma URL com o protocolo HTTP. HTTPS é necessário. Lançado dentro da caixa de diálogo e dispara um evento DialogEventReceived na página de host.
12004 Não aplicável Não aplicável O domínio que a URL transmitiu para displayDialogAsync não é confiável. O domínio deve ser o mesmo domínio que o da página de host (incluindo o protocolo e o número da porta). Lançada por chamada de displayDialogAsync.
12005 Não aplicável Não aplicável A URL passada para displayDialogAsync usa o protocolo HTTP. HTTPS é necessário. Lançada por chamada de displayDialogAsync. (Em algumas versões do Office, a mensagem de erro retornada com 12005 é a mesma retornada para 12004.)
12006 Não aplicável Não aplicável A caixa de diálogo foi fechada, geralmente pelo usuário ter escolhido o botão X. Lançado dentro da caixa de diálogo e dispara um evento DialogEventReceived na página de host.
12007 Não aplicável Não aplicável Uma caixa de diálogo já está aberta na janela do host. Uma janela do host, como um painel de tarefas, só pode ter uma caixa de diálogo aberta por vez. Lançada por chamada de displayDialogAsync.
12009 Não aplicável Não aplicável O usuário opta por ignorar a caixa de diálogo. Este erro pode ocorrer em versões online do Office, em que os usuários podem optar por não permitir que um suplemento apresente uma caixa de diálogo. Lançada por chamada de displayDialogAsync.
12011 Não aplicável Não aplicável O browser do utilizador é configurado de uma forma que bloqueia pop-ups. Este erro pode ocorrer no Office na Web se o browser for o Safari e estiver configurado para bloquear pop-ups ou se o browser for Legado do Edge e o domínio do suplemento estiver numa zona de segurança diferente do domínio que a caixa de diálogo está a tentar abrir. Lançada por chamada de displayDialogAsync.
13nnn Não aplicável Não aplicável Veja Causas e processamento de erros de getAccessToken.

Condições do erro de criação de associação

Quando uma associação for criada na API, indique o tipo de associação que deseja usar. A tabela a seguir lista os tipos de associação e os comportamentos de associação resultantes esperados.

Comportamento no Excel

A tabela a seguir resume o comportamento de associação no Excel.

Tipo de associação especificado Seleção real Comportamento
Matriz Intervalo de células (incluindo dentro de uma tabela e uma única célula) É criado um enlace do tipo matrix nas células selecionadas. Nenhuma modificação no documento é esperada.
Matriz Texto selecionado na célula É criado um enlace do tipo matrix em toda a célula. Nenhuma modificação no documento é esperada.
Matriz Várias seleções/seleção inválida (por exemplo, o usuário seleciona uma imagem, objeto ou WordArt.) Não é possível criar a associação.
Tabela Intervalo de células (inclui uma única célula) Não é possível criar a associação.
Tabela Intervalo de células dentro de uma tabela (inclui uma única célula dentro de uma tabela, ou a tabela inteira ou texto dentro de uma célula em uma tabela) Uma associação é criada na tabela inteira.
Tabela Metade da seleção em uma tabela e metade da seleção fora da tabela Não é possível criar a associação.
Tabela Texto selecionado na célula (não na tabela). Não é possível criar a associação.
Tabela Várias seleções/seleção inválida (por exemplo, o usuário seleciona uma imagem, objeto, WordArt etc.) Não é possível criar a associação.
Texto Intervalo de células Não é possível criar a associação.
Texto Intervalo de células dentro de uma tabela Não é possível criar a associação.
Texto Célula única É criado um enlace do tipo text .
Texto Célula única dentro de uma tabela É criado um enlace do tipo text .
Texto Texto selecionado na célula É criado um enlace do tipo text em toda a célula.

Comportamento no Word

A tabela a seguir resume o comportamento de associação no Word.

Tipo de associação especificado Seleção real Comportamento
Matriz Texto Não é possível criar a associação.
Matriz Tabela inteira É criado um enlace do tipo matrix . O documento é alterado e um controlo de conteúdo tem de moldar a tabela.
Matriz Intervalo dentro de uma tabela Não é possível criar a associação.
Matriz Seleção inválida (por exemplo, múltiplos objetos, objetos inválidos etc.) Não é possível criar a associação.
Tabela Texto Não é possível criar a associação.
Tabela Tabela inteira É criado um enlace do tipo text .
Tabela Intervalo dentro de uma tabela Não é possível criar a associação.
Tabela Seleção inválida (por exemplo, múltiplos objetos, objetos inválidos etc.) Não é possível criar a associação.
Texto Tabela inteira É criado um enlace do tipo text .
Texto Intervalo dentro de uma tabela Não é possível criar a associação.
Texto Seleção múltipla A última seleção será envolvida com um controle de conteúdo e uma associação a esse controle. É criado um controlo de conteúdo do tipo text .
Texto Seleção inválida (por exemplo, múltiplos objetos, objetos inválidos etc.) Não é possível criar a associação.

Confira também