Como abrir um formulário de utilizador a partir de um projecto PEX?

Os Formulários do Utilizador (FDU) correspondem a formulários desenvolvidos no âmbito dos projetos de extensibilidade e permitem a extensão da solução PRIMAVERA de uma forma mais integrada, na medida em que estes formulários são apresentados diretamente dentro da Sheel (MDI), apresentam o mesmo aspeto dos formulários nativos do ERP e também disponibilizam o acesso direto ao contexto da aplicação (Módulos e Plataforma).

Para saber como criar um formulário de utilizador consulte o artigo "Como criar formulários do utilizador com Visual Studio?".

Se até à versão 10 estes formulários estavam apenas acessíveis através dos menus da aplicação (através do conceito de Menus do Utilizador),  a partir do Navegador (criando atalhos para os menus da aplicação) ou a partir do projeto VBA usando os objetos disponibilizados pela Plataforma PRIMAVERA.

Com a versão 10 passa também a ser possível chamá-los diretamente a partir do código da aplicação, bastando para isso instanciar o formulário de utilizador a partir do método CreateCustomFormInstance.

using Primavera.Extensibility.Base.Editors;
using Primavera.Extensibility.BusinessEntities.ExtensibilityService.EventArgs;
using Primavera.Extensibility.Extensions;

namespace ExtensibilitySample.Base
{
    public class UiFichaArtigos : FichaArtigos
    {
        public override void TeclaPressionada(int KeyCode, int Shift, ExtensibilityEventArgs e)
        {
            base.TeclaPressionada(KeyCode, Shift, e);

            using (var instance = this.BSO.Extensibility.CreateCustomFormInstance(typeof(MyUserForm)))
            {
                if (instance.IsSuccess())
                {
                    (instance.Result as MyUserForm).Show();
                }
            }
        }
    }
}