Recursos de página (HTML) da Web

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

Funcionalidades de recursos Web HTML

Como um recurso da Web HTML é transmitido para o navegador do usuário, ele pode incluir qualquer conteúdo renderizado pelo navegador.

Limitações dos recursos Web HTML

  • Um recurso web HTML não pode conter nenhum código que deve ser executado no servidor. Você não pode carregar ASP.NET páginas como recursos da Web HTML.
  • Os recursos da Web HTML podem aceitar apenas um número limitado de parâmetros de cadeia de caracteres de consulta. Passar parâmetros para recursos da Web HTML
  • O runtime do formulário pode recarregar recursos da Web HTML inseridos como controles em um formulário para melhorar o desempenho. Por exemplo, o runtime do formulário pode destruir e reinicializar o controle durante a navegação de tabulação.

Usar o editor de texto para recursos Web HTML

O editor de texto no formulário de recurso da Web foi projetado para edição HTML simples. Para documentos HTML mais complexos, edite o código em um editor externo e use o botão Procurar para carregar seu arquivo.

Por exemplo, uma página HTML mais complexa que requer script para renderizar o conteúdo da página começa como o exemplo a seguir.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<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>

Por exemplo, uma página HTML mais complexa que requer script para renderizar o conteúdo da página começa como o exemplo anterior. Depois de abrir o documento no editor de texto e salvá-lo, o HTML será alterado para o seguinte exemplo:

<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>

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

Como qualquer pessoa pode alterar o HTML nos recursos da Web usando o editor de texto, use propriedades gerenciadas para definir recursos web HTML complexos como não personalizáveis para soluções gerenciadas. Ao exibir recursos da Web na janela de soluções, abra a caixa de diálogo Propriedades Gerenciadas para definir a propriedade Personalizável como false.

Referenciar outros recursos Web de um recurso Web HTML

Você pode criar um conjunto de arquivos relacionados fora de aplicativos controlados por modelos que usam qualquer um dos tipos de arquivo de recurso da Web. Se você tiver o cuidado de sempre usar caminhos relativos e importar cada recurso da Web com uma convenção de nomenclatura consistente que reflita a estrutura de pastas do seu site, o recurso web HTML manterá links para CSS, XML, JScript e arquivos de imagem relacionados que você importa como recursos da Web.

Por exemplo, se você criar um projeto de aplicativo Web que use a seguinte pasta e estrutura de arquivos:

  • page.htm

  • [Styles]

    • style.css

  • [Scripts]

    • script.js

Ao importar esses arquivos como recursos da Web, você pode nomear onde o prefixo de personalização do editor de soluções está new da seguinte maneira:

  • new_/page.htm
  • new_/Styles/style.css
  • new_/Scripts/script.js

Quando você segue esse padrão, o new_/page.htm recurso da Web HTML pode referenciar os outros arquivos da maneira mais comum usando caminhos relativos, conforme 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 fornecedor de soluções torna-se uma pasta raiz virtual para todos os recursos Web em sua solução. Se você alterar o prefixo de personalização, os caminhos relativos em seus recursos da Web HTML não serão alterados.

Note

  • Um recurso da Web HTML adicionado a um formulário não pode usar objetos globais definidos pela biblioteca JavaScript carregada no formulário. Um recurso da Web HTML pode interagir com os Xrm.Page objetos ou Xrm.Utility objetos dentro do formulário usando parent.Xrm.Page ou parent.Xrm.Utility, mas objetos globais definidos por scripts de formulário não são acessíveis usando o pai. Você deve carregar todas as bibliotecas que um recurso da Web HTML precisa dentro do recurso Web HTML para que elas não dependam de scripts carregados no formulário.
  • As referências incluídas no código entre recursos da Web não são controladas como dependências de solução.

Aplicativos cliente que dão suporte ao trabalho offline podem baixar recursos da Web.

Transmitir parâmetros para os recursos Web HTML

Um recurso Web HTML pode aceitar apenas os parâmetros na tabela a seguir.

Parâmetro Nome Description
typename Nome da Tabela O nome da tabela.
type Código de tipo de tabela Um inteiro que identifica exclusivamente a tabela 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 de idioma do usuário O identificador de código de idioma que está sendo usado pelo usuário atual.
orglcid Código de idioma da organização O identificador de 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 ID do formulário O GUID que representa uma ID de formulário.
entrypoint Ponto de Entrada Um valor da cadeia de caracteres. Esse parâmetro deve ser passado como um valor opcional para recursos da Web abertos como conteúdo de ajuda personalizado para uma tabela. Quando habilitada, a URL de ajuda personalizada inclui um valor igual form ou hierarchychartigual a .
pagemode Somente para uso interno.
security Somente para uso interno.
tabSet Somente para uso interno.

Se você passar vários valores no parâmetro de dados, eles serão codificados automaticamente. Você deve incluir a lógica para decodificar os vários parâmetros usando o script em seu recurso Web HTML. O exemplo: passar vários valores para um recurso da Web por meio do artigo de parâmetro de dados demonstra uma abordagem para abordar a passagem de vários valores de parâmetro.

Note

Todos os caracteres incluídos na cadeia de caracteres de consulta passam pela validação para garantir a validade dos parâmetros passados. Se o processo de validação encontrar quaisquer parâmetros que não sejam válidos, a solicitação falhará. Por exemplo, passar valores de texto entre colchetes angulares é um tipo de parâmetro inválido.

Consulte também

Recursos da Web
Criar recursos da Web acessíveis
Usando recursos da Web CSS (Folha de Estilos)
Usando recursos Web JavaScript
Usando recursos da Web de dados (XML)
Usando recursos web de imagem (JPG, PNG, GIF)
Usando recursos da Web de Folha de Estilos (XSL)

  • Last updated on