Compartilhar via

Preparar um Suplemento do Office no Microsoft Azure com o Visual Studio

  • Artigo

O Suplemento do Office mais simples é composto por um ficheiro de manifesto e uma página HTML. O ficheiro de manifesto descreve as características do suplemento, como o respetivo nome, os clientes de ambiente de trabalho do Office em que pode ser executado e o URL da página HTML do suplemento. A página HTML está contida em um aplicativo Web com o qual os usuários interagem quando instalam e executam seu suplemento dentro de um aplicativo cliente do Office. Você pode hospedar o aplicativo Web de um suplemento do Office em qualquer plataforma de hospedagem Web, incluindo o Azure.

Este artigo descreve como implantar o aplicativo Web de um suplemento no Azure e realizar sideload do suplemento para teste em um aplicativo cliente do Office.

Importante

O processo descrito neste artigo não se aplica aos suplementos do Outlook. Para obter instruções sobre como testar suplementos para o Outlook no Azure, veja Preparar um Suplemento do Outlook no Microsoft Azure com o Visual Studio.

Pré-requisitos

  1. Instale o Visual Studio 2022 e opte por incluir a carga de trabalho de desenvolvimento do Azure .

    Observação

    Se já instalou o Visual Studio 2022, utilize o Instalador do Visual Studio para garantir que a carga de trabalho de desenvolvimento do Azure está instalada.

  2. Instalar o Office.

    Observação

    Se você ainda não tem o Office, registre-se para fazer uma avaliação gratuita de um mês.

  3. Obtenha uma assinatura do Azure.

    Observação

    Se você ainda não tem uma assinatura do Azure, pode obter uma como parte da sua assinatura do Visual Studio ou registrar-se para uma avaliação gratuita.

Passo 1: criar uma pasta partilhada para alojar o ficheiro de manifesto do suplemento

  1. Abra o Explorador de Arquivos em seu computador de desenvolvimento.

  2. Clique com o botão direito do rato (ou selecione sem soltar) na unidade C:\ e, em seguida,selecioneNova> Pasta.

  3. Nomeie a nova pasta AddinManifests.

  4. Clique com o botão direito do rato (ou selecione sem soltar) na pasta AddinManifests e, em seguida, selecione Partilhar com>Pessoas específicas.

  5. Em Compartilhamento de Arquivos, selecione a seta suspensa e escolha Todos>Adicionar>Compartilhar.

Observação

Nestas instruções, está a utilizar uma partilha de ficheiros local como um catálogo fidedigno onde irá armazenar o ficheiro de manifesto do suplemento. Num cenário real, pode optar por implementar o ficheiro de manifesto num catálogo do SharePoint ou publicar o suplemento no AppSource.

Etapa 2:Adicionar o compartilhamento de arquivos ao catálogo de Suplementos Confiáveis

  1. Inicie o Word e crie um documento.

    Observação

    Embora este exemplo utilize Word, pode utilizar qualquer aplicação do Office que suporte Suplementos do Office, como o Excel, o PowerPoint ou o Project.

  2. Escolha Arquivo>Opções.

  3. Na caixa de diálogo Opções do Word, escolha Central de Confiabilidade, depois Configurações da Central de Confiabilidade.

  4. Na caixa de diálogo Centro de Confiança , selecione Catálogos de Suplementos Fidedignos. Introduza o caminho UNC (Universal Naming Convention) para a partilha de ficheiros que criou anteriormente como URL do Catálogo (por exemplo, \\YourMachineName\AddinManifests) e, em seguida, selecione Adicionar catálogo.

  5. Marque a caixa de seleção Mostrar no Menu.

    Observação

    Quando armazena um ficheiro de manifesto de suplemento numa partilha especificada como um catálogo de suplementos Web fidedigno, o suplemento é apresentado em Pasta Partilhada na caixa de diálogo Suplementos do Office que é iniciada a partir dos>Suplementos> BaseObter Suplementos.

  6. Feche o Word.

Passo 3: Criar um Suplemento do Office no Visual Studio

  1. Inicie o Visual Studio como um administrador.

  2. Escolha Criar um novo projeto.

  3. Usando a caixa de pesquisa, insira suplemento.

  4. Escolha Suplemento da Web do Word como o tipo de projeto e, em seguida, escolha Avançar para aceitar as configurações padrão.

O Visual Studio cria um suplemento básico do Word que você pode publicar como está, sem fazer alterações no projeto da Web. Para criar um suplemento para uma aplicação do Office diferente, como o Excel, repita os passos e escolha um tipo de projeto com a aplicação do Office pretendida.

Passo 4: publicar a sua aplicação Web do Suplemento do Office no Azure

  1. Com o projeto de suplemento aberto no Visual Studio, clique com o botão direito do rato (ou selecione sem soltar) no projeto Web e, em seguida, selecione Publicar.

  2. Siga as instruções em Publicar a sua aplicação Web. Ignore as secções do artigo que precedem Publicar a aplicação Web, mas certifique-se de que o botão Visual Studio está selecionado na parte superior da página.

    O Visual Studio publica o projeto Web do seu Suplemento do Office na sua aplicação Web do Azure. Quando o Visual Studio terminar de publicar o projeto Web, o browser é aberto e mostra uma página Web com o texto "A sua aplicação Web está em execução e à espera do seu conteúdo". Esta é a página predefinida atual da aplicação Web.

  3. Copie o URL de raiz (por exemplo: https://YourDomain.azurewebsites.net); irá precisar dele quando editar o ficheiro de manifesto do suplemento mais à frente neste artigo.

Passo 5: Editar e implementar o ficheiro de manifesto do suplemento

  1. No Visual Studio, com o suplemento do Office de exemplo aberto no Gerenciador de Soluções, expanda a solução para que ambos os projetos sejam exibidos.

  2. Expanda o projeto suplemento do Office (por exemplo, WordWebAddIn), clique com o botão direito do rato (ou selecione sem soltar) na pasta de manifesto e, em seguida, selecione Abrir. O ficheiro de manifesto do suplemento é aberto.

  3. No ficheiro de manifesto, localize e substitua todas as instâncias de "~remoteAppUrl" pelo URL de raiz da aplicação Web do suplemento no Azure. Este é o URL que copiou anteriormente depois de publicar a aplicação Web do suplemento no Azure (por exemplo: https://YourDomain.azurewebsites.net).

  4. Escolha Arquivo e Salvar tudo. Em seguida, copie o ficheiro de manifesto do suplemento (por exemplo, WordWebAddIn.xml).

  5. Usando o programa Gerenciador de Arquivos, navegue até o compartilhamento de arquivos de rede que você criou na Etapa 1: criar uma pasta compartilhada e cole o arquivo de manifesto na pasta.

Passo 6: Inserir e executar o suplemento na aplicação cliente do Office

  1. Inicie o Word e crie um documento.

  2. SelecioneSuplementos Base e, em seguida, selecione Obter Suplementos.>

  3. Na caixa de diálogo Suplementos do Office, escolha PASTA COMPARTILHADA. O Word examina a pasta listada como um catálogo de suplementos confiáveis (na Etapa 2: adicionar o compartilhamento de arquivos ao catálogo de suplementos confiáveis) e mostre os suplementos na caixa de diálogo. Você deve ver um ícone de seu suplemento de exemplo.

  4. Escolha o ícone para seu suplemento e escolha Adicionar. Um botão Mostrar Painel de Tarefas para seu suplemento é adicionado à faixa de opções.

  5. Na faixa de opções da guia Página Inicial, escolha o botão Mostrar Painel de Tarefas. O suplemento é aberto em um painel de tarefas à direita do documento atual.

  6. Para verificar se o suplemento funciona, selecione algum texto no documento e escolha o botão Realçar! no painel de tarefas.

Implantar atualizações

Irá implementar atualizações na sua aplicação Web da mesma forma descrita anteriormente. As alterações ao manifesto requerem a redistribuição do manifesto para os utilizadores. O processo para o fazer depende do método de publicação. Para obter mais informações sobre como atualizar o seu suplemento, consulte Manter o seu Suplemento do Office.

Confira também