Recursos da Web de página da Web (HTML)

  • Artigo

 

Publicado: janeiro de 2017

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

Use os recursos da Web da página da Web (HTML) para criar elementos da interface do usuário para extensões de cliente.

Neste tópico

Recursos dos recursos da Web de HTML

Limitações dos recursos da Web de HTML

Use o editor de texto de recursos da Web HTML

Evitar a edição de recursos da Web para soluções gerenciadas

Fazer referência a outros recursos da Web de um recurso da Web HTML

Transmitir parâmetros para os recursos da Web em HTML

Recursos dos recursos da Web de HTML

Como um recurso da Web HTML é transmitido somente para o navegador do usuário, ele pode incluir qualquer conteúdo que é processado no navegador do usuário.

Limitações dos recursos da Web de HTML

  • Um recurso da web do HTML não pode ter nenhum código de deve ser executado no servidor. As páginas ASP.NET não podem ser atualizadas como recursos da web do HTML.

  • Os recursos da Web HTML só podem aceitar um número limitado de parâmetros da cadeia de caracteres de consulta.Para obter mais informações:Transmitir parâmetros para os recursos da Web em HTML

Use o editor de texto de recursos da Web HTML

O editor de texto fornecido no formulário do recurso da Web é projetado para uso com edição muito simples de HTML. Para obter mais documentos HTML sofisticados, você deve editar o código em um editor externo e usar o botão Navegar para carregar os conteúdos do arquivo.

Por exemplo, uma página HTML mais complexa que requer que o script renderize o conteúdo da página será iniciada como o exemplo a seguir.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
 <title></title>
 <script src="Script/Script.js" type="text/javascript"></script>
 <link href="CSS/Styles.css" rel="stylesheet" type="text/css" />
</head>
<body onload="SDK.ImportWebResources.showData()">
 <div id="results" />
</body>
</html>

Depois que o documento é aberto no editor de texto e salvo, o HTML será alterado para isto.

<HTML><HEAD><TITLE></TITLE>
<META charset=utf-8></HEAD>
<BODY contentEditable=true onload=SDK.ImportWebResources.showData()>
<SCRIPT type=text/javascript src="Script/Script.js"></SCRIPT>
 <LINK rel=stylesheet type=text/css href="CSS/Styles.css">
<DIV id=results></DIV></BODY></HTML>

Evitar a edição de recursos da Web para soluções gerenciadas

Devido à capacidade do HTML nos recursos da Web para ser alterado usando o editor de texto, é recomendado que você use as propriedades gerenciadas para definir recursos da Web HTML complexos como não personalizável de soluções gerenciadas. Ao exibir os recursos da web na janela de soluções, abra a caixa de diálogo Propriedades Gerenciadas para definir a propriedade Personalizável a false.

Fazer referência a outros recursos da Web de um recurso da Web HTML

Você pode criar um conjunto de arquivos relacionados fora do Microsoft Dynamics 365 que usa qualquer tipo de arquivo de recurso da Web. Se você tiver cuidado para sempre utilizar caminhos relativos e importar cada recurso da Web com uma convenção de nomenclatura consistente que reflita a estrutura de pastas do seu site, você verá que o recurso da Web HTML manterá os links para CSS, XML, JScript relacionados, imagem e arquivos Silverlight que foram importados como os recursos da Web.

Por exemplo, se você criar um projeto do aplicativo web que usa a seguinte estrutura de arquivos/[pasta]:

  • page.htm

  • [Styles]

    • style.css

  • [Scripts]

    • script.js

Quando você importa esses arquivos como recursos da Web, você pode nomear onde o prefixo de personalização do publicador da solução é “novo” da seguinte forma:

  • new_/page.htm

  • new_/Styles/style.css

  • new_/Scripts/script.js

Quando você acompanha este padrão, seu recurso da Web new_/page.htmHTML pode fazer referência a outros arquivos da maneira mais comum usando caminhos relativos, como mostrado no exemplo a seguir.

<script src="Scripts/script.js" type="text/javascript"></script>
<link href="Styles/style.css" rel="stylesheet" type="text/css" />

O prefixo de personalização do publicador da solução torna-se uma pasta de raiz virtual para todos os recursos da web em sua solução. Se você alterar o prefixo de personalização, os caminhos relacionados nos recursos da Web HTML não serão alterados.

Observação

  • Um recurso da Web HTML adicionado a um formulário não pode usar objetos globais definidos pela biblioteca JavaScript carregados no formulário. Um recurso da Web HTML pode interagir com os objetos Xrm.Page ou Xrm.Utility no formulário usando parent.Xrm.Page ou parent.Xrm.Utility, mas objetos globais definidos por scripts de formulário não poderão ser acessados usando o principal. Você deve carregar todas as bibliotecas de que um recurso da Web HTML precisa no recurso da Web HTML de forma que eles não fiquem tão dependentes de scripts carregados no formulário.

  • As referências incluídas no código entre os recursos da Web não são acompanhadas como dependências da solução.

Como os recursos da Web também são baixados para usuários de Microsoft Dynamics 365 para Microsoft Office Outlook com Acesso Offline, os usuários terão acesso ao conteúdo do recurso da Web enquanto trabalham off-line.

Transmitir parâmetros para os recursos da Web em HTML

Um recurso da Web HTML pode conter somente os parâmetros na tabela a seguir.

Parâmetro

Nome

Descrição

typename

Nome da Entidade

O nome da entidade.

type

Código do tipo de entidade

Um inteiro que identifica unicamente a entidade em uma organização específica.

id

GUID do objeto

O GUID que representa um registro.

orgname

Nome da Organização

O nome exclusivo da organização.

userlcid

Código do idioma do usuário

O identificador do código de idioma sendo usado pelo usuário atual.

orglcid

Código do idioma da organização

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

data

Parâmetro de dados opcional

Um valor opcional que pode ser passado.

formid

Identificação de formulário

O GUID que representa a ID de um formulário.

entrypoint

Ponto de entrada

Um valor de cadeia de caracteres. Esse parâmetro deve ser passado como um valor opcional de recursos da Web aberto como conteúdo de ajuda personalizado para uma entidade. Quando habilitada, a URL da ajuda personalizada incluirá um valor "form" ou "hierarchychart".Para obter mais informações:Adicionar conteúdo de ajuda personalizado

pagemode

Somente para uso interno.

security

Somente para uso interno.

tabSet

Somente para uso interno.

Para passar mais de um valor no parâmetro de dados, você deve codificar parâmetros no valor do parâmetro de dados e depois incluir a lógica para descodificar vários parâmetros usando o script no seu recurso da Web HTML. O tópico Amostra: Transmitir vários valores para um recurso Web através do parâmetro de dados demonstra uma abordagem para solucionar passar vários valores de parâmetros.

Confira Também

Recursos da Web do Microsoft Dynamics 365
Criar recursos da Web acessíveis
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 do Silverlight (XAP)
Recursos da Web da folha de estilos (XSL)

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais