Elemento de tempo de execução

Configura o suplemento para usar um tempo de execução compartilhado do JavaScript, de modo que vários componentes sejam executados no mesmo tempo de execução. Filho do elemento Runtimes .

Tipo de suplemento:: Documento, Email, Apresentação, Painel de tarefas, Pasta de trabalho

Válido somente nestes esquemas VersionOverrides:

  • Painel de tarefas 1.0
  • Email 1.1

Para obter mais informações, consulte Substituições de versão no manifesto somente do suplemento.

Associado a estes conjuntos de requisitos:

Importante

  • Para o runtime compartilhado do JavaScript, esse elemento permite que a faixa de opções, o painel de tarefas e outros componentes com suporte usem o mesmo runtime. No entanto, o conjunto de requisitos SharedRuntime só está disponível em alguns aplicativos do Office. Para obter mais informações, confira Conjuntos de requisitos de tempo de execução compartilhados.
  • Para ativação baseada em eventos, esse elemento permite que o suplemento seja executado na composição de um novo item, por exemplo. Para clientes com suporte e outras informações, consulte Ativar suplementos com eventos.
  • Para relatórios de spam integrados, esse elemento permite que o suplemento processe mensagens não solicitadas. Para saber mais sobre como implementar o recurso integrado de relatório de spam em seu suplemento, consulte Implementar um suplemento integrado de relatório de spam.

Observe que a ativação baseada em eventos e os recursos integrados de geração de relatórios de spam devem usar o mesmo tempo de execução. Atualmente, não há suporte para vários tempos de execução no Outlook.

Sintaxe

<Runtimes>
    <Runtime resid="ContosoAddin.Url" lifetime="long" />
</Runtimes>

Contido em

Elementos filho

Elemento Obrigatório Descrição
Override Não Especifica o local da URL do arquivo JavaScript que o Office no Windows requer para o ponto de extensão LaunchEvent e os manipuladores do ponto de extensão ReportPhishingCommandSurface . Importante: no momento, você só pode definir um <elemento de substituição> e ele deve ser do tipo javascript.

Atributos

Atributo Obrigatório Descrição
resid Sim Especifica o local da URL da página HTML do suplemento. Não resid pode ter mais de 32 caracteres e deve corresponder a um id atributo de um Url elemento no Resources elemento.

Importante: ao especificar um LaunchEvent ponto de extensão ou um ReportPhishingCustomization elemento em seu manifesto, certifique-se de que o resid<atributo do elemento filho SourceLocation> corresponda ao resid valor do <elemento Runtime> . Por exemplo, se o seu tempo de execução for definido como <Runtime resid="WebViewRuntime.Url">, especifique <SourceLocation resid="WebViewRuntime.Url"/>.
tempo de vida Não O valor padrão para lifetime é short e não precisa ser especificado. Os suplementos de ativação baseada em eventos e de geração de relatórios de spam usam apenas o short valor. Se você quiser usar um tempo de execução compartilhado em um suplemento do Excel, defina explicitamente o valor como long.

atributo de tempo de vida

Opcional. Representa o período de tempo que o suplemento pode ser executado.

Valores disponíveis

short: Padrão. Usado somente para suplementos de ativação baseada em eventos e relatórios de spam. Depois que o suplemento for ativado, ele será executado por um período máximo de tempo, conforme especificado pela plataforma. Atualmente, são cerca de 5 minutos. Esse é o único valor compatível com a ativação baseada em eventos.

long: Usado somente ao configurar um tempo de execução JavaScript compartilhado. O suplemento pode iniciar com o documento aberto e ser executado indefinidamente. Por exemplo, o código do painel de tarefas continuará sendo executado mesmo quando o usuário fechar o painel de tarefas. Esse é o único valor com suporte do runtime compartilhado.

Confira também

  • Last updated on