Partilhar via

Recursos da Web para o Customer Engagement

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.

Capacidades dos recursos da Web

Os recursos da Web representam arquivos que podem ser usados para estender o aplicativo Web Dynamics 365 Customer Engagement (local), como arquivos html, JavaScript e CSS, além de vários formatos de imagem. Você pode usar recursos da Web em personalizações de formulário, no SiteMap, ou na faixa de opções do aplicativo porque 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 relativas, 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 for Microsoft Office Outlook com Acesso Offline quando off-line porque são sincronizados com os dados do usuário.

Você pode usar o editor de formulários para adicionar e configurar recursos da 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 da 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 suporte os recursos de uma página ASP.NET(.aspx) para executar 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 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 Customer Engagement (local). Somente usuários licenciados do Dynamics 365 Customer Engagement (local) que tenham 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.

Ficheiro Extensões dos ficheiros Tipo
Página 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
Folha de estilo (XSL) .xsl, .xslt 9
Imagem (ICO) .ico 10
Formato vetorial (SVG) .svg 11
String (RESX) .resx 12

Recursos Web de referência

Há vários métodos que você pode usar para fazer referência a recursos da Web.

Observação

  • Sempre que possível, utilize a $webresource diretiva. Somente as referências que usam a $webresource diretiva no 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 fazem referência uns aos outros.
    • Para exibir um recurso da Web do Silverlight fora de um formulário ou gráfico de entidade, crie um recurso da Web HTML para ser a página de host do recurso da Web do Silverlight. Em seguida, use a diretiva $webresource: para abrir o recurso da Web HTML.

$webresource diretiva

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

$webresource:<name of Web Resource>

Observação

Ao usar a diretiva, o Dynamics 365 Customer Engagement (local) criará ou atualizará dependências da $webresource solução.

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 data e informações sobre altura e largura da janela.

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

URL relativo

Ao fazer referência a um recurso da Web de áreas que não suportam o 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 da solução sempre será incluído como um prefixo para o nome do recurso da 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á honrada pelo servidor Web.

A partir de outro recurso da Web, você deve sempre usar URLs relativos para fazer referência uns aos outros. 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 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>

Observação

Não use uma URL relativa usando a pasta WebResources como o caminho raiz para a URL. Por exemplo, não utilize isto: /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 dos usuários. Se o usuário não estiver usando sua organização padrão e o recurso da Web esperado não estiver incluído na organização padrão do usuário, ocorrerá um erro "Arquivo não encontrado" mesmo que o recurso da Web ocorra na organização em que o usuário está trabalhando no momento.

URL completo

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 da Web. Este 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 em cache mais recente 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 grandes recursos da Web, pode haver implicações significativas de desempenho se você não usar a versão em cache do arquivo.

O exemplo a seguir mostra uma URL do Dynamics 365 for Customer Engagement, onde MyOrganization é 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

Observação

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

O exemplo a seguir mostra uma URL para o Dynamics 365 Customer Engagement local (local), onde myServer é 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.

Nome da ferramenta Mais informações
WebResourceManager https://github.com/gotdibbs/WebResourceManager
XrmToolkit https://xrmtoolkit.com/Home/Features
Gestor de Recursos Web https://www.xrmtoolbox.com/plugins/MsCrmTools.WebResourcesManager/

Observação

As ferramentas da comunidade não são um produto do Microsoft Dynamics e a Microsoft não estende o suporte às ferramentas da comunidade. Se você tiver dúvidas relacionadas a uma ferramenta, entre em contato com o editor da ferramenta.

Consulte também

Escrever extensões de aplicativo cliente para o Dynamics 365 Customer Engagement
Criar recursos da Web acessíveis
Recursos da Web da página da Web (HTML)
Recursos da Web do Silverlight (XAP)
Recursos da Web de script (JScript)
Recursos da Web de imagem
Recursos da Web de folha de estilo (XSL)
Recursos Web de dados (XML)
Recursos da Web de folha de estilos (CSS)
Mensagens e métodos de recursos da Web
Exemplo: Passando vários valores para um recurso da Web por meio do parâmetro Data
Exemplo: Importando arquivos como recursos da Web
Usar dados de serviço Web em recursos da Web
Agilize o desenvolvimento de recursos da Web usando o Fiddler AutoResponder

  • Last updated on