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 arquivo de manifesto XML descreve as características do suplemento, como seu nome, quais clientes da área de trabalho do Office ele pode executar e a URL para a 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 mouse na unidade C:\ e escolha Novo>Pasta.

  3. Nomeie a nova pasta AddinManifests.

  4. Clique com o botão direito do mouse na pasta AddinManifests e escolha Compartilhar 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 Central de Confiança , escolha Catálogos de Suplementos Confiáveis. Insira o caminho da UNC (convenção de nomenclatura universal) para o compartilhamento de arquivos que você criou anteriormente como a URL do Catálogo (por exemplo, \\YourMachineName\AddinManifests) e escolha Adicionar catálogo.

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

    Observação

    Quando você armazena um arquivo de manifesto XML de suplemento em um compartilhamento especificado como um catálogo de suplementos da Web confiável, o suplemento é exibido em Pasta Compartilhada na caixa de diálogo Suplementos do Office que é iniciadoem Suplementos Domésticos>>Obter 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 você planeja executar seu suplemento no Office na Web ou publicar seu suplemento no AppSource, ele deve 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 fazer um suplemento para um aplicativo do Office diferente, como o Excel, repita as etapas e escolha um tipo de projeto com o aplicativo do Office desejado.

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 botão direito do mouse no projeto da Web e escolha 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 suplemento do Office no aplicativo Web do Azure. Quando o Visual Studio termina de publicar o projeto Web, seu navegador abre e mostra uma página da Web com o texto "Seu aplicativo Serviço de Aplicativo foi criado". Esta é a página padrão atual do aplicativo Web.

  5. Copie a URL raiz (por exemplo: https://YourDomain.azurewebsites.net); você precisará dela quando editar o arquivo de manifesto de suplemento posteriormente 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 do Suplemento do Office (por exemplo, WordWebAddIn), clique com o botão direito do mouse na pasta do manifesto e escolha 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. Essa é a URL que você copiou anteriormente depois que publicou o aplicativo Web de 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 Domésticos 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

Ao adicionar recursos ou corrigir bugs no suplemento, você precisará implantar as atualizações. Se o suplemento for implantado por um ou mais administradores em suas organizações, algumas alterações de manifesto exigirão que o administrador consenta com as atualizações. Os usuários serão bloqueados do suplemento até que o consentimento seja concedido. As alterações de manifesto a seguir exigirão que o administrador consenta novamente.

Observação

Sempre que você fizer uma alteração no manifesto, você deve aumentar o número de versão do manifesto.

Confira também