Carregar o ambiente do DOM e do runtime

  • Artigo

Antes de executar a sua própria lógica personalizada, um suplemento tem de garantir que o ambiente de runtime do DOM e dos Suplementos do Office são carregados.

Inicialização de um suplemento de conteúdo ou de painel de tarefas

A figura a seguir mostra o fluxo de eventos envolvidos na inicialização de um suplemento de conteúdo ou de painel de tarefas no Excel, no PowerPoint, no Project ou no Word.

Fluxo de eventos ao iniciar um suplemento de conteúdo ou painel de tarefas.

Os seguintes eventos ocorrem quando um suplemento de conteúdo ou painel de tarefas é iniciado.

  1. O usuário abre um documento que já contém um suplemento ou insere um suplemento no documento.

  2. A aplicação cliente do Office lê o manifesto do suplemento a partir do AppSource, de um catálogo de aplicações no SharePoint ou do catálogo de pastas partilhadas do qual provém.

  3. A aplicação cliente do Office abre a página HTML do suplemento num controlo de webview.

    As próximas duas etapas, as etapas 4 e 5, ocorrem de forma assíncrona e em paralelo. Por esse motivo, o código do suplemento deve garantir que o DOM e o ambiente do tempo de execução do suplemento tenham terminado de carregar antes de prosseguir.

  4. O controlo webview carrega o corpo DOM e HTML e chama o processador de eventos para o window.onload evento.

  5. A aplicação cliente do Office carrega o ambiente de runtime, que transfere e coloca em cache os ficheiros da biblioteca da API JavaScript do Office a partir do servidor da rede de distribuição de conteúdos (CDN) e, em seguida, chama o processador de eventos do suplemento para o evento de inicialização do objeto do Office , se tiver sido atribuído um processador ao mesmo. Neste momento, também verifica se alguma chamada de retorno (ou método em then() cadeia) foi transmitida (ou encadeada) ao Office.onReady processador. Para obter mais informações sobre a distinção entre Office.initialize e Office.onReady, consulte Inicializar o seu suplemento.

  6. Quando o corpo de HTML e DOM terminar de carregar e o suplemento finalizar a inicialização, a função principal do suplemento poderá prosseguir.

Inicialização de um suplemento do Outlook

A figura a seguir mostra o fluxo de eventos envolvidos na inicialização de um suplemento do Outlook em execução no desktop, tablet ou smartphone.

Fluxo de eventos ao iniciar o suplemento do Outlook.

Os seguintes eventos ocorrem quando um suplemento do Outlook é iniciado.

  1. Quando o Outlook é iniciado, o Outlook lê os manifestos dos suplementos do Outlook que foram instalados para a conta de e-mail do utilizador.

  2. O usuário seleciona um item no Outlook.

  3. Se o item selecionado satisfizer as condições de ativação de um suplemento do Outlook, o Outlook ativará o suplemento e tornará seu botão visíveis na interface de usuário.

  4. Se o utilizador clicar no botão para iniciar o suplemento do Outlook, o Outlook abre a página HTML num controlo de webview. As próximas duas etapas, as etapas 5 e 6, ocorrerem em paralelo.

  5. O controlo webview carrega o corpo DOM e HTML e chama o processador de eventos para o onload evento.

  6. O Outlook carrega o ambiente de tempo de execução, que baixa e armazena em cache a API do JavaScript para arquivos da biblioteca a partir do servidor da rede de distribuição de conteúdo (CDN) e chama manipulador de eventos para o evento initialize do objeto do suplemento do Office. Neste momento, também verifica se alguma chamada de retorno (ou métodos em then() cadeia) foi transmitida (ou encadeada) ao Office.onReady processador. Para obter mais informações sobre a distinção entre Office.initialize e Office.onReady, consulte Inicializar o seu suplemento.

  7. Quando o corpo de HTML e DOM terminar de carregar e o suplemento finalizar a inicialização, a função principal do suplemento poderá prosseguir.

Confira também