Criar e trabalhar com campos personalizados

Embora exista um vasto conjunto de campos prontos a utilizar para gerir uma ampla gama de processos de negócio, por vezes há a necessidade de uma empresa monitorizar informações adicionais no sistema. Embora os programadores possam ser utilizados para adicionar esses campos como extensões nas ferramentas de programação, a funcionalidade de campos personalizados permite que os campos sejam adicionados diretamente da interface do utilizador, permitindo assim adaptar a aplicação ao seu negócio usando o seu browser web.

Apenas utilizadores com permissões especiais têm acesso a esta funcionalidade.

Este vídeo mostra como é fácil adicionar um campo personalizado a uma página: Adicionar campos personalizados.

Criar campos personalizados

Depois de identificar informações adicionais para monitorizar na aplicação, pode criar o campo personalizado na tabela apropriada e expor esse novo campo numa página.

Os passos seguintes descrevem o processo de criação de um campo personalizado e a colocação desse campo numa página.

1. Navegue para a página onde o novo campo é necessário.

2. Como o objetivo final é expor o campo personalizado num formulário, o ponto de entrada para a criação de campos personalizados existe dentro da experiência de personalização. Abra a barra de ferramentas de personalização selecionando Opções e, em seguida, Personalizar este formulário.

3. Clique em Inserir e, em seguida, Campo.

4. Selecione a região do formulário onde pretende expor o novo campo. Após a seleção, a caixa de diálogo Inserir campos apresentará uma lista de campos existentes que podem ser inseridos na região selecionada da página.

5. Confirme que o campo em que está interessado já não existe na lista. Se existir, pode simplesmente selecionar o campo da lista e clicar em Inserir.

6. Clique no botão Criar novo campo acima da lista para iniciar o processo de criação de um campo personalizado. Isto abrirá a caixa de diálogo Criar novo campo.

   Se não vir o botão Criar novo campo, não tem as permissões necessárias para utilizar esta funcionalidade.

7. Na caixa de diálogo Criar novo campo, introduza as seguintes informações.

   1. Selecione a tabela da base de dados onde este campo deve ser adicionado. Note que apenas as tabelas que suportam campos personalizados aparecerão na lista pendente. Consulte a secção abaixo para obter detalhes técnicos sobre as tabelas suportadas.

   2. Selecione o tipo de dados para o novo campo. Os tipos de dados disponíveis são caixa de verificação, data, data e hora, decimal, número, lista de seleção e texto.

      • Se escolher o tipo de dados de texto, também pode especificar o comprimento máximo do texto que pode ser introduzido neste campo.
      • Se escolher o tipo de dados de lista de seleção, também pode selecionar o conjunto de valores válidos para o campo.

   3. Forneça um nome, etiqueta e texto de ajuda para o campo. O nome corresponde ao nome do campo físico na base de dados, enquanto o texto de ajuda e da etiqueta é o texto utilizado para representar este campo na interface do utilizador.

8. Se este for o único campo que precisa de criar para esta página, clique em Guardar. Se precisar de criar campos adicionais, clique em Guardar e novo e volte ao passo 7.

9. Quando sai da caixa de diálogo Criar novo campo regressa à caixa de diálogo Inserir campos. Quaisquer campos personalizados que tenham sido adicionados serão automaticamente marcados na lista de campos para serem inseridos na página.
10. Clique em Inserir para inserir os campos marcados na região selecionada da página.
11. Opcional: Habilite o modo Mover da barra de ferramentas de personalização para mover os novos campos para o local desejado na região selecionada. Consulte Personalizar a experiência do utilizador para obter mais informações sobre como utilizar as várias capacidades de personalização para otimizar um formulário para a sua utilização pessoal.

Partilha de campos personalizados com outros utilizadores

Depois de ter criado um campo personalizado e tê-lo exposto numa página, poderá querer disponibilizar esta vista de página atualizada que inclui o novo campo a outros utilizadores do sistema. Isto pode ser realizado de duas maneiras diferentes usando as capacidades de personalização do produto:

• A rota recomendada é publicar uma vista guardada com o campo personalizado adicionado à página para o conjunto apropriado de utilizadores. Se a funcionalidade de vistas guardadas não estiver ativada, o administrador do sistema pode aplicar a personalização aos utilizadores pretendidos a partir do formulário Personalização. Para mais informações, consulte Personalizar a experiência do utilizador.
• Em alternativa, pode exportar as suas alterações (chamadas personalizações), enviá-las para um ou mais utilizadores e fazer com que cada um desses utilizadores importe as suas alterações. A opção Gerir na barra de ferramentas de personalização permite-lhe exportar e importar personalizações.

Gerir campos personalizados

A gestão de todos os campos personalizados pode ser realizada através da página Campos personalizados no módulo de administração do Sistema. Esta página permite aos utilizadores o acesso a muitas capacidades, incluindo:

• Visualizar uma lista de todos os campos personalizados do sistema.
• Edição limitada de campos personalizados existentes.
• Eliminar campos personalizados.
• Expor campos personalizados em entidades de dados.
• Fornecer traduções de texto de ajuda e da etiqueta de campos personalizados.

Visualização de todos os campos personalizados

A página Campos personalizados proporciona visibilidade a todos os campos personalizados que foram definidos no sistema. Selecione a tabela em que está interessado, e a página irá atualizar para mostrar uma lista dos campos personalizados associados a essa tabela. A escolha de um campo personalizado da lista permitir-lhe-á visualizar todos os detalhes sobre o campo.

Editar campos personalizados

Depois de ter sido criado um campo personalizado, apenas certas informações sobre o campo personalizado podem ser modificadas na página Campos personalizados.

Pode modificar estes atributos:

• Etiqueta
• Texto de ajuda
• Comprimento, para campos de texto

Não é possível editar os seguintes atributos:

• Nome do campo
• Tipo de dados

Além disso, para os campos de lista de seleção, o conjunto de valores válidos para o campo personalizado pode ser reordenado, e novos valores podem ser adicionados; no entanto, os valores existentes para o campo de lista de seleção não podem ser removidos. Clique em Aplicar alterações quando terminar de editar campos de uma determinada tabela para que as alterações sejam guardadas.

Expor campos personalizados em entidades de dados

Pode também ser importante permitir que os campos personalizados sejam visíveis nas entidades de dados. As entidades de dados são utilizadas na funcionalidade Visão geral da integração do Office, bem como para cenários de importação/exportação de dados.

Siga estes passos para expor um campo personalizado numa entidade de dados:

1. Selecione o campo personalizado na página Campos personalizados.
2. Expanda a secção Entidades para ver o conjunto de entidades relevantes.
3. Clique no botão Editar.
4. Modifique o campo Ativado a selecionar para cada entidade que deve expor este campo.
5. Clique em Aplicar alterações para guardar as suas seleções.

Permitir que os campos personalizados sejam exibidos noutros idiomas

Como os campos personalizados podem ter de ser acedidos pelos utilizadores numa variedade de idiomas, a página campos personalizados fornece um mecanismo para permitir que o texto de ajuda e da etiqueta de um campo personalizado seja traduzido para outras línguas.

Os seguintes passos descrevem o processo de tradução de campos personalizados noutras línguas:

1. Selecione o campo personalizado na página Campos personalizados.

2. Selecione o botão Traduções no painel de ação. Isto abrirá um menu pendente com traduções existentes para este campo.

3. O menu pendente Idioma mostra o conjunto de idiomas para os quais já foram fornecidas traduções.

   Se pretender editar uma tradução existente, selecione o idioma do menu e modifique os valores para o texto de ajuda e da etiqueta.

   Caso contrário, clique no botão Adicionar idioma, selecione o idioma desejado no menu e, em seguida, forneça valores traduzidos para o texto de ajuda e da etiqueta.

4. Clique em OK quando terminar.

Eliminar campos personalizados

Quando decidir que um campo personalizado já não é necessário, um administrador de sistema pode optar por eliminar o campo da página campos Personalizados. Para eliminar um campo personalizado, selecione o campo a eliminar, clique em Eliminar, clique em Sim para confirmar a eliminação e clique finalmente em Aplicar alterações.

Anexo

Por que não posso inserir um valor no meu campo personalizado?

Se não é possível digitar um valor no campo personalizado quando a página está no modo Editar, isto pode ser porque a tabela a que o campo foi adicionado é atualmente apenas de leitura. Todos os campos numa tabela passam a ser apenas de leitura se a tabela de apoio estiver configurada como apenas de leitura na página.

Quem pode criar campos personalizados?

Apenas os administradores de sistema podem criar campos personalizados por predefinição. No entanto, um administrador do sistema pode atribuir aos utilizadores avançados que a organização considerar necessários direitos para criar campos personalizados utilizando a função de segurança Utilizador avançado da personalização de runtime. Os utilizadores sem esta função de segurança não poderão criar campos personalizados, mas ainda assim poderão ver e interagir com campos personalizados adicionados por outros utilizadores do sistema.

Que tabelas suportam campos personalizados?

Por razões técnicas e de desempenho, apenas as tabelas que satisfaçam as seguintes condições permitem atualmente a adição de campos personalizados.

• A tabela deve ser marcada como um destes grupos:

  • Grupo
  • WorksheetHeader
  • Principal
  • Diversos
  • Parâmetro
  • Consulta
  • TransactionHeader

• A tabela não pode expandir outra tabela.

• A tabela não pode ser marcada como uma tabela do sistema.

• A tabela não pode ser uma tabela temporária.

Posso fazer referência aos campos personalizados a partir das ferramentas de programação?

Os campos personalizados só podem ser geridos através da interface do utilizador e não podem ser referenciados por código.

Posso transferir o campo personalizado para a tabela como um campo de extensão, mantendo os valores?

Os dados dos campos personalizados podem ser transferidos para a tabela como campos de extensão. Para utilizar os scripts X++ personalizados para obter e mapear os dados correspondentes de um campo personalizado, siga estes passos:

1. Obtenha o nome do campo personalizado.
2. Utilizar o método .getFieldValue(_fieldName) para obter um valor na tabela de origem.

Pode utilizar o gestor de extensões TableExtensionManagerFactory::CreateExtensionManager() para criar o objeto de construção de extensões .GetRuntimeExtension(_tableName, SysCustomFieldConstants::ExtensionName) na biblioteca Microsoft.Dynamics.Ax.Xpp.MetadataExtensions para obter mais informações sobre o tipo/metadados do campo de extensão.

Como posso mover campos personalizados entre ambientes?

A recomendação atual para mover campos personalizados entre ambientes é recriar manualmente os campos personalizados no ambiente de destino. Para ver a lista completa de campos personalizados numa determinada tabela:

1. Vá para a página Campos personalizados, selecione essa tabela no menu pendente.
2. No ambiente de destino, siga o processo descrito anteriormente neste artigo para recriar cada campo.
3. Quando todos os campos tiverem sido criados, clique em Aplicar alterações.
4. Mova todas as personalizações que contêm campos personalizados exportando essas personalizações do ambiente original e importando-as para o ambiente de destino.