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: Painel de tarefas, Correio
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:
- SharedRuntime 1.1 (Apenas quando utilizado num suplemento do painel de tarefas.)
- Caixa de correio 1.10 e posterior (quando utilizada num suplemento do Outlook que implementa a ativação baseada em eventos.)
- Pré-visualização da caixa de correio (Quando utilizado num suplemento do Outlook que implementa a funcionalidade de relatórios de spam integrados (pré-visualização ).)
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.
Outlook
- 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 Configurar o seu suplemento do Outlook para ativação baseada em eventos.
- Para relatórios de spam integrados (pré-visualização), 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 (pré-visualização).
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 |
Outlook: especifica a localização do URL do ficheiro JavaScript de que o Outlook no Windows necessita para o ponto de extensão LaunchEvent e os processadores de ponto de extensão ReportPhishingCommandSurface (pré-visualização ).
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 do Outlook 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 suplementos de relatórios de spam e ativação baseada em eventos do Outlook. 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 pelo Outlook.
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.