Compartilhar via


Opções de listagem do AppSource para seu suplemento do Outlook baseado em evento

Os suplementos devem ser implantados pelos administradores de uma organização para que os usuários finais acessem o recurso de ativação baseado em eventos . A ativação baseada em eventos será restrita se o usuário final adquiriu o suplemento diretamente do 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 for instalado para o usuário final pelo administrador de sua organização. Caso contrário, a invocação automática do suplemento será bloqueada.

Um usuário final ou administrador pode adquirir suplementos por meio do AppSource ou do microsoft 365 no aplicativo e do repositório Copilot. Se o cenário ou o fluxo de trabalho primário do suplemento exigir ativação baseada em eventos, talvez você queira restringir seu suplemento apenas à implantação de administrador. Para habilitar essa restrição, podemos fornecer URLs de código de voo para suplementos no AppSource. Graças aos códigos de voo, somente os usuários finais com essas URLs especiais podem acessar a listagem. A seguir está uma URL de exemplo.

https://appsource.microsoft.com/product/office/WA200002862?flightCodes=EventBasedTest1

Usuários e administradores não podem pesquisar explicitamente um suplemento por seu nome no AppSource ou no microsoft 365 no aplicativo e no repositório Copilot quando um código de voo está habilitado para ele. Como criador do suplemento, você pode compartilhar esses códigos de voo privadamente com administradores da organização para implantação de suplementos.

Observação

Embora os usuários finais possam instalar o suplemento usando um código de voo, o suplemento não incluirá ativação baseada em evento.

Importante

Os suplementos que usam o recurso Alertas Inteligentes só poderão ser publicados no AppSource se a propriedade de modo de envio do manifesto estiver definida como a opção prompt user ou soft block . Se a propriedade de modo de envio de um suplemento estiver definida como bloqueada, ela só poderá ser implantada pelo administrador de uma organização, pois falhará na validação do AppSource.

Especificar um código de voo

Para especificar o código de voo para seu suplemento, compartilhe o código nas Anotações para certificação ao publicar seu suplemento. Importante: os códigos de voo são sensíveis a maiúsculas de minúsculas.

Uma solicitação de exemplo para código de voo em Notas para a tela de certificação durante o processo de publicação.

Implantar o suplemento com código de voo

Depois que os códigos de voo forem definidos, você receberá a URL da equipe de certificação do aplicativo. Em seguida, você pode compartilhar a URL com administradores em particular.

Para implantar o suplemento, o administrador pode usar as etapas a seguir.

  • Entre em admin.microsoft.com ou AppSource.com com sua conta de administrador do Microsoft 365. Se o suplemento tiver o SSO (logon único) habilitado, serão necessárias credenciais de administrador global.
  • Abra a URL do código de voo em um navegador da Web.
  • Na página de listagem de suplementos, selecione Obtê-lo agora. Você deve ser redirecionado para o portal de aplicativos integrado.

Listagem irrestrita do AppSource

Se o suplemento não usar ativação baseada em eventos para cenários críticos (ou seja, seu suplemento funciona bem sem invocação automática), considere listar seu suplemento no AppSource sem códigos de voo especiais. Se um usuário final receber seu suplemento do AppSource, a ativação automática não acontecerá para o usuário. No entanto, eles podem usar outros componentes do seu suplemento, como um painel de tarefas ou um comando de função.

Importante

Essa é uma restrição temporária. No futuro, planejamos habilitar a ativação de suplemento baseada em eventos para usuários finais que adquirem diretamente seu suplemento.

Atualizar os suplementos existentes para incluir a ativação baseada em eventos

Você pode atualizar seu suplemento existente para incluir a ativação baseada em evento e reenvia-la para validação e decidir se deseja uma listagem restrita ou irrestrita do AppSource.

Depois que o suplemento atualizado for aprovado, os administradores da organização que implantaram o suplemento receberão uma mensagem de atualização na seção Aplicativos integrados do centro de administração. A mensagem aconselha o administrador sobre as alterações de ativação baseadas em eventos. Depois que o administrador aceitar as alterações, a atualização será implantada para usuários finais. Para saber mais sobre o processo de consentimento do administrador, consulte Administração consentimento para instalar suplementos baseados em evento.

Notificações de atualização de aplicativo na tela

Para usuários finais que instalaram o suplemento por conta própria, o recurso de ativação baseado em eventos não funcionará mesmo após a atualização do suplemento.

Sempre que um suplemento baseado em evento é implantado na tela Aplicativos Integrados , o administrador obtém detalhes sobre os recursos de ativação baseados em eventos do suplemento no assistente de implantação. Os detalhes aparecem na seção Permissões e Recursos do Aplicativo . O administrador deve ver todos os eventos em que o suplemento pode ser ativado automaticamente.

A tela

Da mesma forma, quando um suplemento existente é atualizado para a funcionalidade baseada em eventos, o administrador vê um status "Atualizar Pendente" no suplemento. O suplemento atualizado será implantado somente se o administrador consentir com as alterações anotadas na seção Permissões e Recursos do Aplicativo , incluindo o conjunto de eventos em que o suplemento pode ser ativado automaticamente.

Sempre que você adicionar qualquer nova função de ativação baseada em evento ao seu suplemento, os administradores verão o fluxo de atualização no portal de administração e precisarão fornecer consentimento para eventos adicionais. Para saber mais sobre o processo de atualização e consentimento, consulte Gerenciar aplicativos no portal de aplicativos integrados.

O fluxo

Confira também