Opções de listagem do AppSource para o seu suplemento do Outlook baseado em eventos
Os suplementos têm de ser implementados pelos administradores de uma organização para que os utilizadores finais acedam à funcionalidade de ativação baseada em eventos . A ativação baseada em eventos é restrita se o utilizador final tiver adquirido o suplemento diretamente no AppSource. Por exemplo, se o suplemento Contoso incluir uma função baseada em eventos, a invocação automática do suplemento só ocorrerá se o suplemento tiver sido instalado para o utilizador final pelo administrador da organização. Caso contrário, a invocação automática do suplemento é bloqueada.
Um utilizador final ou administrador pode adquirir suplementos através do AppSource ou da loja Microsoft 365 e Copilot na aplicação. Se o principal cenário ou fluxo de trabalho do suplemento exigir a ativação baseada em eventos, poderá querer restringir o suplemento apenas à implementação de administrador. Para ativar essa restrição, podemos fornecer URLs de código de voo para suplementos no AppSource. Graças aos códigos de voo, apenas os utilizadores finais com estes URLs especiais podem aceder à listagem. Segue-se um URL de exemplo.
https://appsource.microsoft.com/product/office/WA200002862?flightCodes=EventBasedTest1
Os utilizadores e administradores não podem procurar explicitamente um suplemento pelo respetivo nome no AppSource ou na loja Microsoft 365 e Copilot na aplicação quando um código de voo está ativado para o mesmo. Como criador do suplemento, pode partilhar em privado estes códigos de voo com os administradores da organização para implementação de suplementos.
Observação
Embora os utilizadores finais possam instalar o suplemento com um código de voo, o suplemento não incluirá a ativação baseada em eventos.
Importante
Os suplementos que utilizam a funcionalidade Alertas Inteligentes só podem ser publicados no AppSource se a propriedade modo de envio do manifesto estiver definida para a opção de pedido de utilizador ou de bloco suave . Se a propriedade de modo de envio de um suplemento estiver definida para bloquear, só pode ser implementada pelo administrador de uma organização, uma vez que irá falhar a validação do AppSource.
Especificar um código de voo
Para especificar o código de voo do seu suplemento, partilhe o código nas Notas para certificação quando publicar o seu suplemento. Importante: os códigos de voo são sensíveis às maiúsculas e minúsculas.
Implementar o suplemento com código piloto
Depois de definir os códigos de voo, receberá o URL da equipa de certificação de aplicações. Em seguida, pode partilhar o URL com administradores em privado.
Observação
Assim que o suplemento estiver certificado, poderá demorar até 24 horas para que os códigos de voo entrem em vigor e que o AppSource oculte a listagem existente dos resultados da pesquisa.
Para implementar o suplemento, o administrador pode utilizar os seguintes passos.
- Inicie sessão no admin.microsoft.com ou AppSource.com com a sua conta de administrador do Microsoft 365. Se o suplemento tiver o início de sessão único (SSO) ativado, são necessárias credenciais de administrador global.
- Abra o URL do código de voo num browser.
- Na página de listagem de suplementos, selecione Obter agora. Deve ser redirecionado para o portal da aplicação integrado.
Listagem do AppSource sem restrições
Se o seu suplemento não utilizar a ativação baseada em eventos para cenários críticos (ou seja, o suplemento funciona bem sem invocação automática), considere listar o suplemento no AppSource sem códigos de voo especiais. Se um utilizador final obtiver o seu suplemento a partir do AppSource, a ativação automática não ocorrerá para o utilizador. No entanto, podem utilizar outros componentes do seu suplemento, como um painel de tarefas ou um comando de função.
Importante
Esta é uma restrição temporária. No futuro, planeamos ativar o suplemento baseado em eventos para os utilizadores finais que adquirem diretamente o seu suplemento.
Atualizar os suplementos existentes para incluir a ativação baseada em eventos
Pode atualizar o suplemento existente para incluir a ativação baseada em eventos e, em seguida, submetê-lo novamente para validação e decidir se pretende uma listagem restrita ou sem restrições do AppSource.
Após a aprovação do suplemento atualizado, os administradores da organização que tenham implementado anteriormente o suplemento receberão uma mensagem de atualização na secção Aplicações integradas do centro de administração. A mensagem informa o administrador sobre as alterações de ativação baseadas em eventos. Depois de o administrador aceitar as alterações, a atualização será implementada para os utilizadores finais. Para saber mais sobre o processo de consentimento do administrador, veja Administração consentimento para instalar suplementos baseados em eventos.
Para os utilizadores finais que instalaram o suplemento por conta própria, a funcionalidade de ativação baseada em eventos não funcionará mesmo depois de o suplemento ter sido atualizado.
Administração consentimento para instalar suplementos baseados em eventos
Sempre que um suplemento baseado em eventos é implementado a partir do ecrã Aplicações Integradas , o administrador obtém detalhes sobre as capacidades de ativação baseadas em eventos do suplemento no assistente de implementação. Os detalhes são apresentados na secção Permissões e Capacidades da Aplicação . O administrador deve ver todos os eventos em que o suplemento pode ser ativado automaticamente.
Da mesma forma, quando um suplemento existente é atualizado para a funcionalidade baseada em eventos, o administrador vê uma status "Atualização Pendente" no suplemento. O suplemento atualizado só é implementado se o administrador consentir com as alterações indicadas na secção Permissões e Capacidades da Aplicação , incluindo o conjunto de eventos em que o suplemento pode ser ativado automaticamente.
Sempre que adicionar qualquer nova função de ativação baseada em eventos ao seu suplemento, os administradores verão o fluxo de atualização no portal de administração e terão de dar consentimento para eventos adicionais. Para saber mais sobre o processo de atualização e consentimento, veja Gerir aplicações no portal aplicações integradas.
