Recursos da Web para o Customer Engagement

Os recursos da Web são arquivos virtuais armazenados no banco de dados do Dynamics 365 Customer Engagement (local) e que você pode recuperar usando um endereço de URL exclusivo.

Recursos de recursos da Web

Os recursos da Web representam arquivos que podem ser usados para estender o aplicativo Web do Dynamics 365 Customer Engagement (local), como arquivos html, JavaScript e CSS e vários formatos de imagem. Você pode usar recursos da Web em personalizações de formulário, na SiteMapfaixa de opções ou na faixa de opções do aplicativo, pois eles podem ser referenciados usando a sintaxe de URL.

A sintaxe de URL para recursos da Web permite referências de caminho relativo. Com suas ferramentas de desenvolvimento, você pode criar um grupo de arquivos interdependentes em um servidor de desenvolvimento usando tipos de arquivo compatíveis com recursos da Web. Em seguida, se você usar uma convenção de nomenclatura consistente e referências de caminho relativo, o site funcionará depois que você carregar todos os arquivos no Dynamics 365 Customer Engagement (local).

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

Você pode usar o editor de formulários para adicionar e configurar recursos Web habilitados para formulários em seus formulários de entidade.

Como os recursos da Web são armazenados como registros no banco de dados, eles podem ser gerenciados programaticamente usando as técnicas padrão para criar, recuperar e atualizar registros. Recursos Web baseados em texto (JScript, CSS, XML, XSL, RESX e HTML) podem ser editados e salvos no aplicativo.

Limitações dos recursos da Web

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

Os recursos da Web só estão disponíveis usando o contexto de segurança do aplicativo Web do Dynamics 365 (local). Somente usuários licenciados do Dynamics 365 Customer Engagement (local) que têm os privilégios necessários podem acessá-los.

Limitações de tamanho

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

Tipos de recursos da Web

Você pode 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 você usa para cada um.

Referenciar recursos da Web

Há vários métodos que você pode usar para referenciar recursos da Web.

diretiva $webresource

Você sempre deve usar a $webresource diretiva ao referenciar um recurso da Web de um controle de faixa de opções ou de uma SiteMap subárea. Use a $webresource diretiva em qualquer lugar em que o XML permita um valor de URL. O exemplo a seguir mostra como usá-lo.

$webresource:<name of Web Resource>  

Xrm.Navigation.openWebResource

O Xrm.Navigation. A função openWebResource abrirá um recurso da Web HTML em uma nova janela com parâmetros para passar o nome do recurso da Web, quaisquer dados de cadeia de caracteres de consulta a serem passados no parâmetro de dados e informações sobre altura e largura da janela.

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

URL relativa

Ao referenciar um recurso da Web de áreas que não dão suporte ao uso da $webresource: diretiva, uma URL relativa pode ser usada. Para habilitar isso, recomendamos que você use uma convenção de nomenclatura consistente para os recursos da Web que refletem uma estrutura de arquivo virtual. O prefixo de personalização do editor de soluções sempre será incluído como um prefixo para o nome do recurso web. Isso pode representar uma pasta "raiz" virtual para todos os recursos da Web adicionados por esse editor. Em seguida, você pode usar o caractere de barra (/) para simular uma estrutura de pastas que será respeitada pelo servidor Web.

Em outro recurso da Web, você sempre deve usar URLs relativas para fazer referência umas às outras. Por exemplo, para que o recurso new_/content/contentpage.htm da Web da página da Web faça referência ao recurso new_/Styles/styles.cssda Web do CSS, crie o link da seguinte maneira:

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

Para que o recurso new_/content/contentpage.htm da Web da página da Web abra o recurso isv_/foldername/dialogpage.htmda Web da página da Web, crie o link da seguinte maneira:

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

URL completa

O exemplo a seguir mostra o estilo de URL que você pode usar para exibir recursos da Web.

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

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

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

O valor da versão é atualizado quando você publica personalizações e garante que o navegador use a versão mais recente armazenada em cache do recurso da Web. Por isso, use um caminho relativo para um recurso da Web, o Xrm.Navigation. função openWebResource ou a diretiva $webresource (quando possível) porque o valor da versão será incluído automaticamente. Para recursos web grandes, pode haver implicações significativas de desempenho se você não usar a versão armazenada em cache do arquivo.

O exemplo a seguir mostra uma URL do Dynamics 365 para Customer Engagement, onde MyOrganization está o nome da sua organização e new_/test/test.htm é o nome do recurso da Web:

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

O exemplo a seguir mostra uma URL para o Dynamics 365 Customer Engagement local (local), onde myServer está o nome do servidor:

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

Ao escrever código para fazer referência a um recurso da Web que precisará funcionar para o Dynamics 365 for Customer Engagement ou para o Dynamics 365 Customer Engagement local (local), você deve usar a função getClientUrl .

Ferramentas da comunidade

Aqui estão algumas das ferramentas da comunidade que funcionam com recursos da Web.

Consulte também

Escrever extensões de aplicativo cliente para o Dynamics 365 Customer Engagement
Criar recursos da Web acessíveis
Recursos da Web (HTML)
Recursos Web do Silverlight (XAP)
Recursos web de script (JScript)
Recursos da Web de imagem
Recursos da Web de Folha de Estilos (XSL)
Recursos web de dados (XML)
Recursos da Web da Folha de Estilos (CSS)
Métodos e mensagens de recurso da Web
Exemplo: passando vários valores para um recurso da Web por meio do parâmetro de dados
Exemplo: importando arquivos como recursos da Web
Usar dados do serviço Web em recursos da Web
Simplificar o desenvolvimento de recursos da Web usando o Fiddler AutoResponder