Elemento Runtime

Artigo
06/07/2024

Configura o suplemento para usar um runtime do JavaScript compartilhado para que vários componentes sejam executados no mesmo runtime. Filho do elemento Runtimes .

Tipo de suplemento: Painel de tarefas, Email

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.

Associado a esses conjuntos de requisitos:

SharedRuntime 1.1 (somente quando usado em um suplemento do painel de tarefas.)
Caixa de correio 1.10 e posterior (Quando usado em um suplemento do Outlook que implementa a ativação baseada em eventos.)
Visualização da caixa de correio (Quando usado em um suplemento do Outlook que implementa o recurso de relatório de spam integrado (versão prévia ).

Importante

Para o runtime do JavaScript compartilhado, 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.

Outlook

Para ativação baseada em eventos, esse elemento permite que seu suplemento seja executado na composição de um novo item, por exemplo. Para obter clientes com suporte e outras informações, consulte Configurar o suplemento do Outlook para ativação baseada em eventos.
Para relatórios de spam integrados (versão prévia), esse elemento permite que seu suplemento processe mensagens não solicitadas. Para saber mais sobre como implementar o recurso de relatório de spam integrado em seu suplemento, confira Implementar um suplemento de relatório de spam integrado (versão prévia).

Observe que a ativação baseada em evento e os recursos de relatório de spam integrados devem usar o mesmo runtime. No momento, não há suporte para vários runtimes no Outlook.

Sintaxe

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

Contido em

Runtimes

Elementos filho

Elemento	Obrigatório	Descrição
Override	Não	Outlook: especifica o local da URL do arquivo JavaScript que o Outlook no Windows exige para manipuladores de ponto de extensão LaunchEvent e ponto de extensão ReportPhishingCommandSurface (versão prévia ). 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 para seu suplemento. O `resid` não pode ter mais de 32 caracteres e deve corresponder a um `id` atributo de um `Url` elemento no `Resources` elemento.
Vida	Não	O valor padrão para `lifetime` é `short` e não precisa ser especificado. A ativação baseada em eventos do Outlook e os suplementos de relatório de spam usam apenas o `short` valor. Se você quiser usar um runtime compartilhado em um suplemento do Excel, defina explicitamente o valor como `long`.

atributo lifetime

Opcional. Representa o tempo que o suplemento pode ser executado.

Valores disponíveis

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

long: usado somente ao configurar um runtime do JavaScript compartilhado. 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 usuário fechar o painel de tarefas. Esse é o único valor suportado pelo runtime compartilhado.

Compartilhar via