Criar ou editar recursos da Web para estender um aplicativo

Este tópico se aplica a Dynamics 365 Customer Engagement (on-premises). Para a versão Power Apps deste tópico, consulte: Criar ou editar recursos da Web de aplicativos baseados em modelo para estender um aplicativo

Os recursos da Web são normalmente usados por desenvolvedores para estender um aplicativo usando os arquivos utilizados no desenvolvimento da Web. Os usuários do aplicativo talvez precisem gerenciar os recursos da Web fornecidos por um desenvolvedor ou designer.

Gorjeta

Para obter uma discussão detalhada sobre recursos da Web, consulte Recursos da Web para o Customer Engagement.

O que são recursos da Web?

Os recursos da Web são arquivos virtuais armazenados no sistema. Cada recurso da Web tem um nome exclusivo que pode ser usado em uma URL para recuperar o arquivo. Pense neles desta forma: Se você tiver acesso ao servidor da Web real que executa o aplicativo da Web, é possível copiar os arquivos nesse site. Mas na maioria de serviços online, não é possível fazer isso. Em vez disso, você pode usar recursos da Web para carregar arquivos para o sistema e referenciá-los pelo nome, como faria se tivesse copiado os mesmos como arquivos para o servidor da Web.

Por exemplo, se você criar uma página HTML como um recurso da Web chamado "new_myWebResource.htm", você pode abrir essa página em um navegador usando uma URL como essa:

<Dynamics 365 Customer Engagement (on-premises) URL>/WebResources/new_myWebResource.htm

onde <URL do aplicativo> é a URL que você normalmente usa para abrir o aplicativo. Como o recurso da Web são dados no sistema, somente os usuários licenciados da organização podem acessar dessa maneira. Geralmente, os recursos da Web são incluídos em formulários em vez de referenciá-los diretamente. O uso mais comum é fornecer bibliotecas do JavaScript para scripts de formulário.

Como os recursos da Web são dados no sistema e apresentam reconhecimento de solução, você pode movê-los para organizações diferentes exportando como parte de uma solução e importando a solução em uma organização diferente.

Criar e editar recursos da Web

1. Abra o gerenciador de soluções e selecione Recursos da Web.

2. Em Componentes, escolha Recursos da Web.

3. Para criar um recurso da Web selecione Novo.

   Para editar um recurso da Web clique duas vezes no recurso da Web que você deseja editar.

4. O formulário do recurso da Web tem os seguintes campos e recursos:

   Etiqueta	Descrição
   Nome	Necessário. Este é o nome exclusivo deste recurso da Web. Você não pode alterar após salvar o recurso da Web. Este nome pode incluir somente letras, números, pontos e barras ("/") não consecutivas. O prefixo de personalização do fornecedor de soluções será anexado ao nome do recurso da Web.
   Nome para Exibição	O nome exibido se você visualizar uma lista de recursos da Web.
   Descrição	Uma descrição do recurso da Web.
   Tipo	Necessário. Este é o tipo do recurso da Web. Você não pode alterar após salvar o recurso da Web.
   Editor de Texto	Quando o tipo de recurso da Web representa um tipo de arquivo de texto, selecione este botão para abrir uma página para editar o conteúdo usando o editor de texto.
   Idioma	Permite a seleção de um idioma. Essa opção somente marca o registro que armazena os dados do recurso da Web. Não altera o comportamento do recurso da Web.
   Carregar Arquivo	Selecione o botão Procurar… para escolher um arquivo a ser carregado como um recurso da Web. Você poderá carregar um arquivo ao criar um novo recurso da Web ou substituir um recurso da Web existente. O nome da extensão do arquivo deverá coincidir com as extensões permitidas. Por padrão, o tamanho máximo do arquivo que pode ser carregados como um recurso da Web é de 5MB. Esse valor pode ser modificado no Dynamics 365 Customer Engagement (on-premises) por meio da configuração Configurações do Sistema> guia Email >Definir limite de tamanho de arquivos anexos. Mais informações: Caixa de diálogo Configurações do Sistema - guia E-mail
   URL	Depois de salvar o recurso da Web, a URL para o recurso da Web será exibida aqui. Selecione este link para exibir o recurso da Web no navegador.

5. Depois de adicionar suas alterações, escolha Salvar e Publicar.

Nota

Publicar personalizações podem interferir nas operações normais do sistema. É recomendável que você publique personalizações quando isso for menos prejudicial aos usuários.

Use o editor de texto adequadamente

O editor de texto fornecido no aplicativo para recursos da Web deve ser usado apenas para edições simples de arquivos de texto. Você poderá usá-lo para criar e editar recursos da Web HTML, mas só deve editar os recursos da Web HTML criados usando o editor de texto. O editor de texto é criado para conteúdo HTML muito simples. Se o conteúdo de um recurso da Web HTML não tiver sido criado com o editor de texto, não use o editor de texto para editar.

O editor de texto usa um controle de modifica o código-fonte HTML de forma que permite ser editado. Essas alterações podem fazer a página comportar-se diferente no navegador e pode fazer com que códigos mais sofisticados parem de funcionar. Abrir um recurso da Web HTML com o editor de texto e salvar sem fazer alterações podem fragmentar alguns recursos da Web HTML.

É recomendável usar um editor externo para editar arquivos de texto e salvar localmente antes de carregar com o botão Carregar Arquivo. Dessa forma, é possível preservar uma cópia do recurso da Web se precisar voltar para uma versão anterior. Você pode usar um editor simples como o Bloco de Notas, mas um editor de texto com recursos mais avançados é altamente recomendável. O Visual Studio Express é gratuito e fornece recursos avançados para editar os arquivos usados pelos recursos da Web baseados em texto.

Criar ou editar um recurso da Web em um formulário

Você pode adicionar ou editar recursos da Web em um formulário para torná-lo mais atraente ou útil para os usuários. Verifique se você tem direito de acesso de Administrador do Sistema ou privilégios equivalentes.

Nota

Não é possível incluir um recurso da Web no cabeçalho ou rodapé de um formulário.

1. Abra o gerenciador de soluções.

2. Em Componentes, expanda Entidades e expanda a entidade com a qual você deseja trabalhar.

3. Escolha Formulários, na lista, localize um formulário do tipo Principal e clique ou toque duas vezes na entrada para abrir e editar o formulário.

4. Para adicionar um recurso da Web existente, selecione a guia (por exemplo, Geral ou Anotações) onde deseja inseri-lo e, depois, na guia Inserir, selecione Recurso da Web.
   -OU-
   Para editar um recurso da Web, selecione uma guia do formulário e o recurso da Web a ser editado e, na guia Início, selecione Alterar Propriedades.

5. Na caixa de diálogo Adicionar Recurso da Web ou Propriedades do Recurso da Web, na guia Geral, insira as informações corretas nos campos obrigatórios. Em particular, observe o seguinte:

   • Na caixa Recurso da Web, selecione a imagem, HTML ou recurso da Web do Silverlight que deseja usar.

     Nota

     Após especificar um recurso da Web, a seção Propriedades do Recurso da Web é exibida na parte inferior desta guia, incluindo as opções que podem variar dependendo do tipo de recurso da Web que você está adicionando. Essas opções incluem especificar parâmetros personalizados, analisar um código de tipo de objeto de registro como parâmetro ou especificar um texto alternativo que descreve o recurso ou, para imagens, que torna a imagem mais acessível a todos os usuários. Veja a seguir algumas propriedades importantes. Para obter uma lista completa, consulte: Propriedades do recurso da Web. - Na caixa Nome, insira um nome exclusivo para o campo. O nome pode conter somente caracteres alfanuméricos e sublinhados.

   • O campo Rótulo é preenchido automaticamente com uma variação do nome especificado, mas certifique-se de que o rótulo proposto atenda suas necessidades ou atualize-o adequadamente.

6. Na guia Formatação, as opções exibidas variam com base no tipo de recurso da Web inserido. Essas opções incluem especificar a exibição do número de colunas e linhas, se uma borda é exibida e o comportamento de rolagem.

7. Se a guia Dependências for exibida na caixa de diálogo Adicionar Recurso da Web ou Propriedades do Recurso da Web, da lista Campos disponíveis, selecione os campos obrigatórios pelo recurso da Web, clique no botão Adicionar Registros Selecionados para mover os campos selecionados para a lista Campos dependentes e selecione em OK.

8. Ao terminar de editar o formulário, na guia Início, selecione Salvar e Fechar para fechar o formulário. Para visualizar a aparência do formulário principal e o funcionamento dos eventos:

   • Na guia Início, clique em Visualizar e selecione Criar Formulário, Atualizar Formulário ou Formulário Somente Leitura.
   • Para fechar o formulário Visualizar, no menu Arquivo, selecione Fechar.

9. Quando suas personalizações estiverem concluídas, publique-as:

   • Para publicar personalizações somente para o componente que você está editando atualmente, no painel de navegação, clique na entidade na qual você trabalha e clique em Publicar.
   • Para publicar personalizações de todos os componentes não publicados de uma vez, no painel de navegação, clique em Entidades e, na barra de ferramentas Ações, clique em Publicar Todas as Personalizações.

Adicionar ou editar um recurso da Web de imagem

Recursos da Web são arquivos virtuais em vários formatos, como arquivos html, JavaScript e aplicativos Silverlight que são armazenados no sistema e podem ser recuperados usando um endereço de URL exclusivo.

1. Abra o gerenciador de soluções.

2. Para criar um novo recurso da Web, escolha Componentes>Recursos da Web e, na barra de ferramentas Ações, escolha Novo.

3. Insira ou modifique informações nas caixas de seleção.

   • O nome inserido na caixa de texto Nome, além da extensão do arquivo, se tornarão o nome de arquivo.

   • O nome inserido na caixa de texto de Nome de Exibição será exibido em Nome de Exibição.

   • Na caixa suspensa Tipo, selecione o tipo de arquivo desejado.

4. Escolha Procurar para selecionar e carregar o arquivo do computador local.

   • Para visualizar um recurso da Web de imagem carregado: escolha Recurso da Web>Visualizar.

   • Para editar um recurso da Web de texto: escolha Editor de Texto.

   • Para visualizar um recurso da Web de texto: escolha Recurso da Web>Visualizar.

5. Quando você estiver pronto para salvar seus dados, escolha Salvar e Fechar.

6. Publique sua personalização.

   • Somente para o componente editados: escolha Salvar>Publicar em Início.

   • Para todos os componentes não publicados de uma vez, escolha Publicar Todas as Personalizações.

Nota

A instalação de uma solução ou a publicação de personalizações pode interferir na operação normal do sistema. É recomendável que você agende uma importação de solução quando isso for menos prejudicial aos usuários.

Confira também

Propriedades do recurso da Web
Criar e projetar formulários
Introdução à personalização
Recursos da Web do Customer Engagement