Partilhar via

Hospedar um Suplemento do Office no Microsoft Azure

  • Artigo

Os Suplementos do Office mais simples contêm um arquivo de manifesto XML e uma página HTML. O ficheiro de manifesto XML 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.

Pré-requisitos

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

    Observação

    Se você tiver instalado o Visual Studio 2019 anteriormente, use o Instalador do Visual Studio para garantir que a carga de trabalho de desenvolvimento do Azure esteja 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.

Etapa 1: criar uma pasta compartilhada para hospedar o arquivo de manifesto XML 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

Nesta explicação passo a passo, você está usando um compartilhamento de arquivos local como um catálogo confiável onde armazenará o arquivo de manifesto XML do suplemento. Em um cenário real, em vez disso, é possível optar por implantar o arquivo de manifesto XML a um 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 use o Word, é possível usar qualquer aplicativo do Office que dê suporte a Suplementos do Office, como Excel, Outlook, PowerPoint ou 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 XML 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.

Etapa 3: Criar um aplicativo Web no Azure usando o portal do Azure

Para criar o aplicativo Web usando o portal do Azure, realize as etapas a seguir.

  1. Faça logon no portal do Azure usando suas credenciais do Azure.

  2. Em Serviços do Azure, selecione Aplicativos Web.

  3. Na página Serviço de Aplicativo, selecione Adicionar. Forneça estas informações:

    • Escolha a Assinatura a ser usada para criar esse site.

    • Escolha o Grupo de Recursos para seu site. Se você criar um novo grupo, também precisará dar um nome a ele.

    • Insira um Nome de aplicativo exclusivo para seu site. O Azure verifica se o nome do site é exclusivo em todo o domínio azureweb apps.net.

    • Escolha se deseja publicar usando um código ou um contêiner do docker.

    • Especificar uma Pilha de tempo de execução.

    • Escolha o SO para seu site.

    • Escolha uma Região.

    • Escolha o Plano do Serviço de Aplicativo a ser usado para criar esse site.

    • Escolha Criar.

  4. A próxima página informa que a implantação está em andamento e quando ela é concluída. Quando estiver concluída, selecione Ir ao recurso.

  5. Na seção Visão geral, escolha a URL exibida em URL. O navegador será aberto e exibirá uma página da Web com a mensagem “Seu aplicativo de Serviço de Aplicativo está funcionando”.

    Importante

    Embora não seja estritamente obrigatório em todos os cenários de suplemento, é altamente recomendável o uso do ponto de extremidade do HTTPS para o suplemento. Os suplementos que não estiverem protegidos por SSL (HTTPS) geram erros e avisos de conteúdo não seguro durante o uso. Se planeia executar o seu suplemento no Office na Web ou publicar o seu suplemento no AppSource, este tem de estar protegido por SSL. Se o suplemento acessar serviços e dados externos, ele deve estar protegido por SSL para proteger os dados em trânsito. Certificados autoassinados podem ser usados para desenvolvimento e teste, desde que sejam aceitos como confiáveis no computador local. Os sites do Azure fornecem automaticamente um ponto de extremidade HTTPS.

Etapa 4: 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.

Etapa 5: publicar seu aplicativo Web do suplemento do Office no Azure

  1. Com seu projeto de suplemento aberto no Visual Studio, expanda o nó da solução no Gerenciador de Soluções, em seguida, selecione Serviço de Aplicativo.

  2. Clique com o botão direito do rato (ou selecione sem soltar) no projeto Web e, em seguida, selecione Publicar. O projeto da Web contém arquivos do aplicativo Web do suplemento do Office, portanto, esse é o projeto que você publica no Azure.

  3. Na guia Publicar:

    • Escolha Serviço de Aplicativo do Microsoft Azure.

    • Escolha Selecionar Existentes.

    • Escolha Publicar.

  4. 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 do Serviço de Aplicações foi criada". Esta é a página predefinida atual da aplicação Web.

  5. 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.

Etapa 6: Editar e implantar o arquivo de manifesto XML 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 arquivo de manifesto XML do suplemento é aberto.

  3. No arquivo de manifesto XML, localize e substitua todas as instâncias de "~remoteAppUrl" pela URL raiz do aplicativo 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 arquivo do manifesto XML (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.

Etapa 7: Inserir e executar o suplemento no aplicativo 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

Quando adiciona funcionalidades ou corrige erros no suplemento, terá de implementar as atualizações. Se o suplemento for implementado por um ou mais administradores nas respetivas organizações, algumas alterações de manifesto exigirão que o administrador consoante as atualizações. Os utilizadores serão bloqueados do suplemento até que o consentimento seja concedido. As seguintes alterações de manifesto exigirão que o administrador consinta novamente.

Observação

Sempre que fizer uma alteração ao manifesto, tem de aumentar o número da versão do manifesto.

Confira também