Criar um suplemento de conteúdo do Excel

Neste artigo, irá percorrer o processo de criação de um suplemento de conteúdos do Excel com o Visual Studio.

Pré-requisitos

• Visual Studio 2019 ou posterior com a carga de trabalho Desenvolvimento Office/SharePoint instalada.

  Observação

  Se você já instalou o Visual Studio, use o Instalador do Visual Studio para garantir que a carga de trabalho de desenvolvimento do Office/SharePoint esteja instalada.

• Office conectado a uma assinatura Microsoft 365 (incluindo o Office na web).

Criar o projeto do suplemento

1. No Visual Studio, escolha Criar um novo projeto.

2. Usando a caixa de pesquisa, insira suplemento. Escolha suplemento do Excel Web , em seguida, selecione Próximo.

3. Nomeie seu projeto ExcelWebAddIn1e selecione Criar.

4. Na janela de diálogo Criar Suplemento do Office , selecione o tipo de suplemento Inserir conteúdo em folhas de cálculo do Excel e, em seguida, selecione Seguinte.

5. Selecione o modelo de suplemento Suplemento Básico ou Visualização de Documentos e, em seguida, selecione Concluir para criar o projeto.

6. O Visual Studio cria uma solução, e os dois projetos dele aparecem no Gerenciador de Soluções. O arquivo Home.html é aberto no Visual Studio.

Explorar a solução do Visual Studio

Ao concluir o assistente, o Visual Studio cria uma solução que contém dois projetos.

Atualizar o manifesto

1. No Gerenciador de Soluções, vá para o projeto de suplemento ExcelWebAddIn1e abra o diretório ExcelWebAddIn1Manifest. Este diretório contém seu arquivo de manifesto, ExcelWebAddIn1.xml. O ficheiro de manifesto define as definições e capacidades do suplemento. Consulte a seção anterior Explorar a solução Visual Studio para obter mais informações sobre os dois projetos criados por sua solução Visual Studio.

2. O elemento ProviderName tem um valor de espaço reservado. Substitua-o com seu nome.

3. O atributo DefaultValue do elemento DisplayName tem um espaço reservado. Substitua-o pelo suplementos do My Office.

4. O atributo DefaultValue do elemento Description tem um espaço reservado. Substitua-o por um suplemento de conteúdo para o Excel..

5. Salve o arquivo. As linhas atualizadas devem ter um aspeto semelhante ao seguinte exemplo de código.

   ...
   <ProviderName>John Doe</ProviderName>
   <DefaultLocale>en-US</DefaultLocale>
   <!-- The display name of your add-in. Used on the store and various places of the Office UI such as the add-ins dialog. -->
   <DisplayName DefaultValue="My Office Add-in" />
   <Description DefaultValue="A content add-in for Excel."/>
   ...
   

Experimente

1. Com o Visual Studio, teste o suplemento do Excel recentemente criado ao premir F5 ou ao selecionar o botão Iniciar para iniciar o Excel com o suplemento de conteúdo apresentado na folha de cálculo.

2. Certifique-se de que existe texto na folha de cálculo e, em seguida, selecione qualquer intervalo de células que contenha texto na folha de cálculo.

3. Selecione o separador do modelo que escolheu e, em seguida, siga as instruções.

   • Suplemento Básico
   • Suplemento visualização de documentos

   • No suplemento de conteúdo, selecione o botão Obter dados da seleção para obter o texto do intervalo selecionado.

     

Próximas etapas

Parabéns, criou com êxito um suplemento de conteúdos do Excel! Em seguida, saiba mais sobre como desenvolver suplementos do Office com o Visual Studio.

Solução de problemas

• Certifique-se de que o seu ambiente está pronto para o desenvolvimento do Office ao seguir as instruções em Configurar o seu ambiente de desenvolvimento.

• Alguns dos códigos de exemplo utilizam JavaScript ES6. Isto não é compatível com versões mais antigas do Office que utilizam o motor de browser Trident (Internet Explorer 11). Para obter informações sobre como suportar essas plataformas no seu suplemento, consulte Suportar webviews mais antigos da Microsoft e versões do Office. Se ainda não tiver uma subscrição do Microsoft 365 para utilizar para desenvolvimento, poderá qualificar-se para uma subscrição de programador Microsoft 365 E5 através do Programa para Programadores do Microsoft 365. Para obter detalhes, consulte as FAQ. Em alternativa, pode inscrever-se numa avaliação gratuita de um mês ou comprar um plano do Microsoft 365.

• Se o suplemento mostrar um erro (por exemplo, "Não foi possível iniciar este suplemento. Feche esta caixa de diálogo para ignorar o problema ou clique em "Reiniciar" para tentar novamente.") quando prime F5 ou seleciona Depurar>Iniciar Depuração no Visual Studio, consulte Depurar Suplementos do Office no Visual Studio para obter outras opções de depuração.

Exemplos de código

• Suplemento de Conteúdo do Excel – Humongous Insurance

Confira também

• Visão geral da plataforma Suplementos do Office
• Desenvolver Suplementos do Office
• Modelo de objeto JavaScript do Excel em Suplementos do Office
• Exemplos de código do suplemento do Excel
• Referência da API JavaScript do Excel
• Usando o Visual Studio Code para publicar