Manter seu Suplemento do Office

  • Artigo

Depois de publicar o seu suplemento, deve mantê-lo atualizado com quaisquer alterações importantes das bibliotecas a montante. A aplicação de patches a problemas de segurança é fundamental para a criação da confiança do cliente. Uma vez que estas alterações não têm qualquer efeito no manifesto publicado, os seus clientes não precisarão de efetuar quaisquer ações para obter as versões mais recentes do seu suplemento.

Alterações interruptivas no Office.js

A Plataforma para Programadores do Microsoft 365 está empenhada em garantir a compatibilidade do seu suplemento. Esforçamo-nos por evitar fazer alterações interruptivas à superfície e comportamento da API. No entanto, há casos em que precisamos de fazer atualizações interruptivas por uma questão de segurança ou fiabilidade. Nesses casos raros, são seguidos os seguintes passos para garantir que os utilizadores do seu suplemento não são afetados.

Política de preterição

As APIs ou ferramentas com alternativas melhores podem ser preteridas. A Microsoft tem um melhor esforço para declarar algo como preterido, pelo menos, 24 meses antes de o extinguir. Da mesma forma, para APIs individuais que geralmente estão disponíveis (GA), a Microsoft declara uma API como preterida com antecedência de pelo menos 24 meses antes de removê-la da versão de GA.

A descontinuação não significa necessariamente que a funcionalidade ou a API serão removidas e inutilizáveis pelos programadores. Mostra que, após o período de 24 meses, a Microsoft deixará de suportar a API ou funcionalidade.

Quando uma API é marcada como preterida, é altamente recomendável que você migre para a versão mais recente assim que possível. Em alguns casos, iremos anunciar que as novas aplicações têm de começar a utilizar as novas APIs pouco tempo depois de as APIs originais terem sido preteridas. Nesses casos, apenas os aplicativos ativos que usam atualmente as APIs preteridas podem continuar a usá-las.

Importante

O período de descontinuação de 24 meses será acelerado se esperar tanto tempo representar um risco de segurança para o seu suplemento ou para a Microsoft.

Garantia de Aplicativo

O serviço App Assure da Microsoft cumpre a promessa da Microsoft de compatibilidade de aplicações: as suas aplicações funcionarão no Windows e no Microsoft 365 Apps. Os engenheiros do App Assure estão disponíveis para ajudar a resolver quaisquer problemas que possa ter sem custos adicionais.

Se encontrar um problema de compatibilidade de aplicações, os engenheiros do App Assure trabalharão consigo para o ajudar a resolver o problema. Os nossos especialistas irão:

  • Ajude-o a resolver problemas e a identificar uma causa raiz.
  • Forneça orientações para o ajudar a remediar o problema de compatibilidade da aplicação.
  • Contacte os fornecedores independentes de software (ISVs) em seu nome para remediar parte da respetiva aplicação, para que esteja funcional na versão mais moderna dos nossos produtos.
  • Trabalhe com equipas de engenharia de produtos da Microsoft para corrigir erros nos produtos.

Para saber mais sobre o App Assure, veja Trazer as suas aplicações para o Microsoft Edge com o App Assure: sugestões e truques. Para submeter o seu pedido de compatibilidade de aplicações com o App Assure, preencha o formulário de Registo do Microsoft FastTrack ou envie um e-mail para achelp@microsoft.com.

Alterações a modelos Yeoman e dependências Web

Os Suplementos Yeoman Generator para Office dependem de várias bibliotecas da Microsoft e de outras. Estas bibliotecas são atualizadas independentemente de qualquer atividade do Microsoft 365. Todos os projetos criados com o gerador devem ser mantidos atualizados à medida que desenvolve, publica e mantém o seu suplemento. As ferramentas seguintes podem ajudar a garantir que o seu projeto está a utilizar versões seguras de quaisquer bibliotecas dependentes.

Esta orientação também se aplica a cópias de exemplos obtidas a partir de exemplos de código do Suplemento do Office e de outras origens.

office.js pacote NPM

O pacote NPM do office-js é uma cópia do que está alojado na rede de entrega de conteúdos (CDN)Office.js. Destina-se a cenários em que o acesso direto à CDN não é possível. O pacote NPM não se destina a fornecer referências com versões para office.js. Recomendamos vivamente que utilize sempre a CDN para garantir que está a utilizar a versão mais recente das APIs javaScript do Office.

Melhores práticas atuais

Embora nos esforcemos por manter a retrocompatibilidade, os padrões e práticas que recomendamos evoluem continuamente. A nossa documentação esforça-se por apresentar as melhores práticas atuais. Para se manter informado sobre as novas funcionalidades que podem melhorar a sua funcionalidade existente, adira à nossa Chamada de Comunidade mensal de Suplementos do Office.

Atualizar o suplemento

Ao atualizar o suplemento, existem duas partes a considerar: a aplicação Web e o manifesto. As atualizações à sua aplicação Web não requerem qualquer ação por parte dos seus utilizadores. Esses utilizadores têm apenas o manifesto na respetiva aplicação do Office. As alterações ao manifesto requerem que os utilizadores atualizem. Se tiver publicado o suplemento no AppSource, terá de atualizar a sua submissão. Pode encontrar mais informações sobre esse processo no artigo Atualizar uma oferta existente.

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

Se o suplemento for implementado por um ou mais administradores nas respetivas organizações, algumas alterações de manifesto requerem que o administrador consoante as atualizações. Os utilizadores são bloqueados do suplemento até que o consentimento seja concedido. As seguintes alterações de manifesto requerem que o administrador consinta novamente.

Cativação da comunidade

À medida que as atualizações são propostas para a Plataforma para Programadores do Microsoft 365, iremos escutar os seus comentários. Comunique preocupações, potenciais consequências ou outras perguntas aos canais listados nos Suplementos do Office de recursos adicionais.