Compartilhar via


Recursos da Web do Silverlight (XAP)

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Importante

Recursos da Web Microsoft Silverlight permanecem com suporte no Microsoft Dynamics 365 (online e local) para compatibilidade inversa. Para os componentes que podem ser apresentados em todos os clientes, recomendamos usar recursos da Web HTML com HTML5 em vez de Silverlight.

HTML5 é a tecnologia do cliente preferida para a Web, por plug-ins da Web como Silverlight e Flash. O HTML5 pode ser consumido de qualquer dispositivo (PC, tablet, smartphone e mais) e usa Javascript (e várias bibliotecas Javascript avançadas, como o jQuery) e CSS.

O Microsoft Dynamics 365 (online e local) suporta a adição dos recursos Web do Silverlight 4.0 recursos para formulários de entidade. Você pode exibir recursos Web do Silverlight 5.0 dentro de um recurso Web HTML usando um elemento <object> hospedado configurado para essa versão.

Observação

  • Os recursos da Web do Microsoft Silverlight não poderão ser exibidos na versão de 64 bits do Microsoft Office Outlook.

  • Para exibir um recurso da Web Silverlight fora de um gráfico ou formulário de entidade, crie um recurso da Web HTML para ser a página host do recurso da Web Silverlight. Em seguida, use a diretiva $webresource: para abrir o recurso da Web HTML.

Neste tópico

Criar recursos da Web do Silverlight

Acessando contexto de dados

Transmitindo dados de um formulário para um recurso da Web do Silverlight integrado

Gravando e testando recursos da Web do Silverlight

Depurando recursos da Web do Silverlight

Criar recursos da Web do Silverlight

Os recursos da Web do Silverlight são criados facilidade usando o formulário de recurso da Web inserindo um nome, um nome de exibição, selecionando Silverlight (XAP) como tipo, e carregando o arquivo .xap. O recurso da Web deve ser publicado antes de poder usá-lo. Entretanto, como os recursos da Web do Silverlight normalmente fornecem alguma interação com dados contextuais no Microsoft Dynamics 365, você deve planejar como criar os recursos da Web.

Acessando contexto de dados

Quando você usa o botão Visualizar no formulário de recursos da Web ou apenas navegar para a URL fornecida, o aplicativo Silverlight é hospedado em uma página HTML geral sem informações de contexto. Se o aplicativo Silverlight não exige as informações contextuais, você pode usar essa URL para exibir seu recurso da Web do Silverlight.

Se você precisa de informações contextuais, deve:

  1. Adicionar o recurso da Web do Silverlight para um formulário de entidade.

  2. Exibir o recurso da Web do Silverlight usando um recurso da Web HTML configurado para fornecer informações de contexto.

Se o recurso da Web do Silverlight foi criado para ser exibido em um formulário de entidade, o formulário tem um objeto Xrm.Page.context que você pode usar para acessar informações contextuais. Para obter mais informações, consulte Contexto do cliente (referência do cliente)

Se você precisar que seu aplicativo Silverlight apareça fora do contexto do formulário, deve configurar um recurso da Web HTML para fornecer essas informações de contexto adicionando uma referência à página ClientGlobalContext.js.aspx. Depois que essa referência for adicionada, seu aplicativo Silverlight pode acessar informações contextuais da mesma forma que pode em um formulário de entidade. O exemplo a seguir mostra como chamar a função getClientUrl do objeto Xrm.Page.context.

private string clientUrl = "";
ScriptObject xrm = (ScriptObject)HtmlPage.Window.GetProperty("Xrm");
ScriptObject page = (ScriptObject)xrm.GetProperty("Page");
ScriptObject pageContext = (ScriptObject)page.GetProperty("context");
clientUrl = (string)pageContext.Invoke("getClientUrl");

Transmitindo dados de um formulário para um recurso da Web do Silverlight integrado

Ao adicionar um recurso da Web do Silverlight para um formulário, é possível selecionar a opção Passar o código do tipo de objeto de registro e identificador exclusivo como parâmetros. Você também tem a opção de inserir texto como um parâmetro personalizado.

Esses valores são passados para o controle do Silverlight como um InitParams, um dicionário dos pares de chave/valor.

Os valores passados são descritos na tabela a seguir.

Chave

Descrição

id

O identificador exclusivo do registro.

tipo

O código do tipo de entidade. Para entidades personalizadas, isso pode variar entre organizações.

typename

O nome lógico da entidade.

orgname

O nome da organização.

userlcid

O código de idioma que representa a preferência de idioma do usuário.

orglcid

O código de idioma que representa o idioma base da organização.

Dados do

O valor de texto inserido como um parâmetro personalizado.

Esses valores podem ser acessados no tempo de execução usando a sintaxe no exemplo a seguir:

string entityTypeName = App.Current.Host.InitParams["typename"];

Gravando e testando recursos da Web do Silverlight

Se o recurso da Web do Silverlight for independente de qualquer dado contextual do Microsoft Dynamics 365, você pode gravar e testar seu aplicativo Silverlight como normalmente faria. Depois de criar um novo recurso da Web carregando seu arquivo .xap, você pode testar usando o botão Visualizar no formulário do recurso da Web depois de salvar e publicar o recurso da Web.

Entretanto, é mais provável que o aplicativo Silverlight tem dependências de dados contextuais que não podem ser simuladas totalmente fora do Microsoft Dynamics 365.

O processo de criação de um recurso da Web do Silverlight que inclui dependências de formulário ou de contexto é o seguinte:

  1. Crie seu projeto de aplicativo Silverlight.

    Selecione para criar um aplicativo Web com seu projeto.

  2. Gravar e testar o máximo de aplicativos possível sem exigir dados contextuais do Microsoft Dynamics 365.

  3. Criar recursos da Web carregando os arquivos .htm e .xap como recursos da Web Silverlight e HTML.

  4. Escreva código do projeto de aplicativo do Silverlight.

  5. Compile seu projeto de aplicativo Silverlight.

  6. Carregue a versão de compilação do arquivo .xap pelo pasta ClientBin do projeto do aplicativo Web para atualizar o recurso da Web do Silverlight criado na etapa 3.

  7. Teste seu recurso da Web do Silverlight através de:

    • Exibição usando o botão Visualizar do recurso da Web HTML do host criado.

    • Exibindo no contexto de um formulário de entidade adicionado.

      Use essa opção se seu aplicativo Silverlight tiver dependências nos elementos Form ou nas informações de contexto.

  8. Repita as etapas 4 a 7 até concluir.

Observação

Quando você desejar mostrar um recurso da Web do Silverlight fora de um formulário de entidade, por exemplo, na estrutura principal do aplicativo editando o Mapa do Site, é necessário fornecer um recurso da Web da página da Web (HTML) para atuar como o host do recurso da Web do Silverlight.

Importante

Nunca edite o código-fonte HTML para uma página que hospeda um recurso da Web do Silverlight usando o editor de texto fornecido no aplicativo. O editor de texto modifica o HTML e quebra a definição do elemento <object> necessária para hospedar o recurso da Web SilverlightXAP. Para obter mais informações, consulte bba8645a-a725-4c4d-a393-bab8ca692482#BKMK_UsingTextEditor.

Se você deve usar o editor de texto, omita o parâmetro data="data:application/x-silverlight-2," no elemento <object>. Embora isso deve evitar a quebra do recurso da Web do Silverlight, o editor de texto ainda poderá apresentar outras alterações indesejadas.

Depurando recursos da Web do Silverlight

Os recursos da Web do Silverlight que não são baseados em dados contextuais do Microsoft Dynamics 365 podem ser depurados no Microsoft Visual Studio. Entretanto, se o recurso da Web do Silverlight exige dados contextuais para realizar as funções, você precisará usar um procedimento diferente.

  1. Compile seu aplicativo Silverlight.

  2. Carregar a versão de compilação do arquivo .xap na pasta ClientBin do projeto do aplicativo Web.

  3. Exibir seu aplicativo Silverlight no contexto que pode ser usado.

  4. No seu projeto de aplicativo do Silverlight, no menu do Visual Studio, selecione Depurar e Anexar ao Processo.

  5. Na caixa de diálogo Anexar ao Processo, encontre um processo iexplore.exe onde o valor da coluna Tipo é Silverlight, x86.

  6. Selecione esse processo e pressione Anexar para fechar a caixa de diálogo e iniciar a depuração.

  7. No projeto de aplicativo do Silverlight, defina um ponto de interrupção.

  8. Atualize a janela do navegador ou, no aplicativo Silverlight, realize a ação que você precisa para testar o código.

Confira Também

Criar recursos da Web acessíveis
Recursos da Web do Microsoft Dynamics 365
Recursos da Web de página da Web (HTML)
Recursos da Web da CSS
Recursos da Web de script (JScript)
Recursos web de dados (XML)
Recursos de imagem da web (JPG, PNG, GIF, ICO)
Recursos da Web da folha de estilos (XSL)

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais