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.

Dica

Para obter uma discussão aprofundada 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:

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

onde <URL> do aplicativo é o 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 deseja editar.

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

   Etiqueta	Descrição
   Nome	Obrigató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 de Exibição	O nome exibido se você visualizar uma lista de recursos da Web.
   Descrição	Uma descrição do recurso da Web.
   Tipo	Obrigató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.
   Linguagem	Permite a seleção de um idioma. Essa opção apenas 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 para carregar como um recurso da web. Você pode carregar um arquivo ao criar um novo recurso da Web ou substituir um recurso da Web existente. A extensão do nome do arquivo deve corresponder às extensões permitidas. Por padrão, o tamanho máximo do arquivo que pode ser carregado como um recurso da Web é de 5 MB. Esse valor pode ser modificado no Dynamics 365 Customer Engagement (on-premises) usando a guia Configurações do Sistema>Email>definição de limite de tamanho de arquivo para 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 as alterações, escolha Salvar e Publicar.

Observação

A publicação de personalizações pode interferir nas operações normais do sistema. Recomendamos que você publique personalizações quando for menos perturbador para os 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 por recursos da Web baseados em texto.

Criar e 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. Certifique-se de que você tenha a função de segurança Administrador do Sistema ou privilégios equivalentes.

Observação

Você não pode incluir um recurso da Web em um cabeçalho ou rodapé de formulário.

1. Abra o gerenciador de soluções.

2. Em Componentes, expanda Entidades e, em seguida, 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, selecione a guia (por exemplo, Geral ou Anotações) na qual deseja inseri-lo e, na guia Inserir , selecione Recurso da Web.
   -OU-
   Para editar um recurso da Web, selecione uma guia de formulário e o recurso da Web que você deseja editar e, na guia Página Inicial , 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 apropriadas nos campos obrigatórios. Em particular, observe o seguinte:

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

     Observação

     Depois de especificar um recurso da Web, a seção Propriedades do Recurso da Web aparece na parte inferior dessa guia, fornecendo opções que variam de acordo com o tipo de recurso da Web que você está adicionando. Essas opções incluem especificar parâmetros personalizados, passar um código de tipo de objeto de registro como um parâmetro ou especificar um texto alternativo que descreva o recurso ou, para imagens, que torne a imagem mais acessível a todos os usuários. Aqui estão algumas propriedades importantes. Para obter uma listagem completa, consulte: Propriedades de recursos 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 às suas necessidades ou atualize-o adequadamente.

6. Na guia Formatação , as opções exibidas variam de acordo com o tipo de recurso da Web inserido. Essas opções incluem especificar o número de colunas e linhas exibidas, 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 , na lista Campos disponíveis , selecione os campos exigidos pelo recurso da Web, selecione o botão Adicionar Registros Selecionados para mover os campos selecionados para a lista Campos dependentes e selecione OK para fechar a caixa de diálogo.

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 apenas para o componente que você está editando no momento, no painel de navegação, selecione a entidade na qual você está trabalhando e, em seguida, selecione 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

Os 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 , mais a extensão do arquivo, se tornará o nome do arquivo.

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

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

4. Escolha Procurar para selecionar e carregar o arquivo de sua máquina local.

   • Para visualizar um recurso da Web de imagem carregado: Escolha Recurso da Web>Visualização.

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

   • Para visualizar um recurso da Web de texto: Escolha Visualização de Recurso> da Web.

5. Quando estiver pronto para salvar seus dados, escolha Salvar e fechar.

6. Publique sua personalização.

   • Somente para o componente editado: escolha Salvar>publicação na página inicial.

   • Para todos os componentes não publicados de uma só vez, escolha Publicar todas as personalizações.

Observação

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.

Consulte também

Propriedades do recurso da Web
Criar e projetar formulários
Comece a personalizar
Recursos Web para o Customer Engagement