Recursos da Web do Microsoft Dynamics 365

 

Publicado: janeiro de 2017

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

Os recursos da Web são arquivos virtuais armazenados no banco de dados do Microsoft Dynamics 365 e que podem ser recuperados por um endereço de URL exclusivo.

Neste tópico

Recursos dos recursos da Web

Tipos de recursos da Web

Fazer referência aos recursos da Web

Recursos dos recursos da Web

Os recursos da Web representam os arquivos que podem ser usados para estender o aplicativo Web do Microsoft Dynamics 365, como arquivos html, JavaScript e aplicativos do Silverlight. É possível usar os recursos da Web nas personalizações de formulário, em SiteMap ou na faixa de opções do aplicativo, pois podem ser referenciados com a sintaxe da URL.

A sintaxe da URL dos recursos da Web permite referências de caminho relativo. Com as ferramentas de desenvolvimento, é possível criar um grupo de arquivos interdependentes em um servidor de desenvolvimento, usando tipos de arquivos compatíveis com os recursos da Web. Assim, se você usar uma convenção de nomenclatura consistente e referências de caminho relativo, o site funcionará após o carregamento de todos os arquivos no Microsoft Dynamics 365.

Como os recursos da Web são armazenados no Microsoft Dynamics 365 e são componentes da solução, eles podem ser facilmente exportados e instalados nas implantações locais do Microsoft Dynamics 365 ou do Microsoft Dynamics 365 (online). Os recursos da Web também estão disponíveis para os usuários do Microsoft Dynamics 365 para Microsoft Office Outlook com Acesso Offline quando estiverem offline, já que estão sincronizados com os dados do usuário.

É possível usar o editor de formulários para adicionar e configurar recursos da Web habilitados nos formulários de entidade.

Como os recursos da Web são armazenados como registros no banco de dados, eles podem ser gerenciados de forma programática com técnicas padrão para criar, recuperar e atualizar registros. Os recursos da Web baseados em texto (JScript, CSS, XML, XSL, and HTML) podem ser editados e salvos no aplicativo.

Limitações dos recursos da Web

Não há nenhum tipo de recurso da Web que ofereça suporte aos recursos de uma página (.aspx) doASP.NET para a execução do código no servidor. Os recursos da Web são limitados a arquivos estáticos ou arquivos que são processados no navegador. Um recurso da Web pode conter um código que seja processado no navegador para a execução de chamadas de serviços Web para interagir com os dados do Microsoft Dynamics 365. Para obter mais informações, consulte Trabalhar com dados de Dynamics 365 usando recursos da Web,

Os recursos da Web estão disponíveis somente com o contexto de segurança do aplicativo Web do Microsoft Dynamics 365. Somente os usuários licenciados do Microsoft Dynamics 365 com os privilégios necessários podem acessá-los.

Limitações de tamanho

O tamanho máximo de arquivos que podem ser carregados é determinado pela propriedade Organization.MaxUploadFileSize. Essa propriedade é definida na guia Email das Configurações do Sistema do aplicativo Dynamics 365. Essa configuração limita o tamanho dos arquivos que podem ser anexados às mensagens de email, às anotações e aos recursos da Web. A configuração padrão é 5 MB.

Tipos de recursos da Web

É possível usar dez formatos de arquivo para criar recursos da Web. A tabela a seguir lista cada formato de arquivo, as extensões de arquivo permitidas e o valor de tipo que pode ser usado para cada um deles.

Arquivo	Extensões de arquivo	Tipo
Página da Web (HTML)	.htm, .html	1
Folha de estilos (CSS)	.css	2
Script (JScript)	.js	3
Dados (XML)	.xml	4
Imagem (PNG)	.png	5
Imagem (JPG)	.jpg	6
Imagem (GIF)	.gif	7
Silverlight (XAP)	.xap	8
StyleSheet (XSL)	.xsl, .xslt	9
Imagem (ICO)	.ico	10

Fazer referência aos recursos da Web

Existem vários métodos que podem ser usados para fazer referência aos recursos da Web.

Observação

• Quando possível, use a diretiva $webresource. Somente as referências que usam a diretiva $webresource em seu mapa do site ou nos comandos da faixa de opções estabelecerão dependências. As dependências não são criadas quando os recursos da Web fizerem referência entre si.

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

Diretiva $webresource

Sempre use a diretiva $webresource ao fazer referência de um recurso da Web a partir de um controle da faixa de opções ou a partir de uma subárea de SiteMap. Use a diretiva $webresource sempre que o XML permitir um valor da URL. O exemplo a seguir mostra como usá-la.

$webresource:<name of Web Resource>

Observação

Ao usar a diretiva $webresource, o Microsoft Dynamics 365 criará ou atualizará as dependências da solução.

Xrm.Utility.openWebResource

A função Xrm.Utility.openWebResource abrirá um recurso da Web em HTML uma nova janela com parâmetros que transmitirão o nome do recurso da Web, todos os dados de cadeia de caracteres da consulta que devem ser transmitidos no parâmetro de dados, além de informações sobre a altura e a largura da janela.

A URL gerada inclui o token exclusivo do GUID para que o recurso da Web armazenado em cache seja carregado.

URL Relativa

Ao fazer referência a um recurso da Web das áreas que não têm suporte com a diretiva $webresource:, uma URL relativa pode ser usada. Para habilitar este recurso, é recomendável usar uma convenção de nomenclatura consistente para os recursos da Web que reflitam a estrutura de um arquivo virtual. O prefixo de personalização do fornecedor de soluções será sempre incluído como prefixo no nome do recurso da Web. Isso pode representar uma pasta virtual “raiz” para todos os recursos da Web adicionados pelo fornecedor. É possível usar o caractere de barra (/) para simular uma estrutura de pastas que será honrada pelo servidor Web.

Para outro recurso da Web, sempre use a URLs relativa para fazer referência entre si. Por exemplo, para o recurso da Web na página da Web new_/content/contentpage.htm fazer referência ao CSS do recurso da Web new_/Styles/styles.css, crie o link da seguinte forma:

<link rel="stylesheet" type="text/css" href="../styles/styles.css" />

Para o recurso da Web na página da Web new_/content/contentpage.htm abrir um recurso da Web na página da Web isv_/foldername/dialogpage.htm, crie o link da seguinte forma:

<a href="../../isv_/foldername/dialogpage.htm">Dialog Page</a>

Observação

Não use uma URL relativa com a pasta WebResources como o caminho raiz para a URL. Por exemplo, não use o seguinte: /WebResources/<name of web resource>. Quando um usuário pertence a mais de uma organização em um servidor, esse caminho sempre se referirá à organização padrão do usuário. Se o usuário não estiver usando a organização padrão e o recurso da Web esperado não estiver incluído na organização padrão do usuário, um erro “Arquivo não encontrado” será exibido, mesmo que o recurso da Web ocorra na organização que o usuário trabalha.

URL completa

O exemplo a seguir mostra o estilo da URL que pode ser usado para exibir recursos da Web.

<Microsoft CRM URL>/WebResources/<name of web resource>

O aplicativo processará esta URL e retornará o arquivo que contém a versão mais recente do recurso da Web. Esta URL terá uma aparência semelhante a:

<Microsoft CRM URL>/%7B<GUID value>%7D/WebResources/<name of web resource>

Ao publicar personalizações, o valor de GUID é atualizado e garante que o navegador use a versão mais recente armazenada em cache do recurso da Web. Por esse motivo, use um caminho relativo a um recurso da Web, a função Xrm.Utility.openWebResource ou Diretiva $webresource (quando possível), pois o valor de GUID será incluído automaticamente. Para recursos da Web extensos como os recursos da Web do Silverlight, pode haver significativas implicações de desempenho se a versão armazenada em cache do arquivo não for usada.

O exemplo a seguir mostra uma URL para o Microsoft Dynamics 365 (online), onde MyOrganization é o nome da organização e new_/test/test.htm é o nome do recurso da Web:

https://MyOrganization.crm.dynamics.com/WebResources/new_/test/test.htm

Observação

Incluir o caractere “/” e a extensão de nome do arquivo no nome do recurso da Web é uma prática recomendada opcional.

O exemplo a seguir mostra uma URL para o Microsoft Dynamics 365 local, onde myServer é o nome do servidor:

http://myServer/MyOrganization/WebResources/new_/test/test.htm

Ao escrever o código para fazer referência a um recurso da Web que precise funcionar no Microsoft Dynamics 365 (online) ou no Microsoft Dynamics 365 local, use a função getClientUrl.

Confira Também

Estender o Microsoft Dynamics 365 no cliente
Bibliotecas JavaScript para Microsoft Dynamics 365
Criar recursos da Web acessíveis
Recursos da Web de página da Web (HTML)
Recursos da Web do Silverlight (XAP)
Recursos da Web de script (JScript)
Recursos de imagem da web (JPG, PNG, GIF, ICO)
Recursos da Web da folha de estilos (XSL)
Recursos web de dados (XML)
Recursos da Web da CSS
Mensagens e métodos da entidade WebResource
Amostra: Transmitir vários valores para um recurso Web através do parâmetro de dados
Exemplo: utilitário de recurso da Web
Exemplo: Importar arquivos como recursos da Web
Trabalhar com dados de Dynamics 365 usando recursos da Web

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais