Compartilhar via


Elemento runtime

Configura o suplemento para utilizar um runtime javaScript partilhado para que vários componentes todos executem no mesmo runtime. Subordinado do elemento Runtimes .

Tipo de suplemento:: Documento, Correio, Apresentação, Painel de tarefas, Livro

Válido apenas nestes esquemas VersionOverrides:

  • Painel de tarefas 1.0
  • Email 1.1

Para obter mais informações, veja Substituições de versões no manifesto apenas do suplemento.

Associados a estes conjuntos de requisitos:

Importante

  • Para o runtime de JavaScript partilhado, este elemento permite que o friso, o painel de tarefas e outros componentes suportados utilizem o mesmo runtime. No entanto, o conjunto de requisitos SharedRuntime só está disponível em algumas aplicações do Office. Para obter mais informações, confira Conjuntos de requisitos de tempo de execução compartilhados.
  • Para a ativação baseada em eventos, este elemento permite que o suplemento seja executado na composição de um novo item, por exemplo. Para obter clientes suportados e outras informações, veja Ativar suplementos com eventos.
  • Para relatórios de spam integrados, este elemento permite que o suplemento processe mensagens não solicitadas. Para saber mais sobre como implementar a funcionalidade de relatórios de spam integrados no seu suplemento, veja Implementar um suplemento integrado de relatórios de spam.

Tenha em atenção que a ativação baseada em eventos e as funcionalidades de relatórios de spam integrados têm de utilizar o mesmo runtime. Atualmente, não são suportados vários runtimes no Outlook.

Sintaxe

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

Contido em

Elementos filho

Elemento Obrigatório Descrição
Override Não Especifica a localização do URL do ficheiro JavaScript de que o Office no Windows necessita para o ponto de extensão LaunchEvent e os processadores de ponto de extensão ReportPhishingCommandSurface . Importante: atualmente, só pode definir um <elemento Substituição> e tem de ser do tipo javascript.

Atributos

Atributo Obrigatório Descrição
resid Sim Especifica a localização do URL da página HTML do seu suplemento. O resid não pode ter mais de 32 carateres e tem de corresponder a um id atributo de um Url elemento no Resources elemento.
duração Não O valor predefinido para lifetime é short e não precisa de ser especificado. A ativação baseada em eventos e os suplementos de relatórios de spam utilizam apenas o short valor. Se quiser utilizar um runtime partilhado num suplemento do Excel, defina explicitamente o valor como long.

atributo lifetime

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

Valores disponíveis

short: Predefinição. Utilizado apenas para a ativação baseada em eventos e suplementos de relatórios de spam. Após a ativação do suplemento, este será executado durante um período máximo de tempo, conforme especificado pela plataforma. Atualmente, são cerca de 5 minutos. Este é o único valor suportado com a ativação baseada em eventos.

long: utilizado apenas ao configurar um runtime javaScript partilhado. O suplemento pode começar no documento aberto e executado indefinidamente. Por exemplo, o código do painel de tarefas continuará em execução mesmo quando o utilizador fechar o painel de tarefas. Este é o único valor suportado pelo runtime partilhado.

Confira também