Crear y trabajar con campos personalizados
Aunque hay un amplio conjunto de campos disponibles de inmediato para gestionar una amplia gama de procesos empresariales, algunas veces es necesaria una empresa que realice un seguimiento de la información adicional en el sistema. Aunque puede encargar a programadores que agreguen esos campos como extensiones en las herramientas para desarrolladores, la característica de campos personalizados permite agregar campos directamente desde la interfaz de usuario, lo que le permite personalizar la aplicación a su empresa a través de un explorador web.
Solo los usuarios con permisos especiales tienen acceso a esta función.
Este vídeo muestra lo sencillo que es agregar un campo personalizado a una página: Agregar campos personalizados.
Crear campos personalizados
Una vez identificada la información adicional para seguir en la aplicación, puede crear el campo personalizado en la tabla apropiada y exponer ese campo nuevo en una página.
Los siguientes pasos describen el proceso para crear un campo personalizado y colocar ese campo en una página.
Vaya a la página en la que es necesario el nuevo campo.
Puesto que el objetivo final es exponer el campo personalizado en un formulario, el punto de entrada para crear campos personalizados existe dentro de la experiencia de personalización. Abra la barra de herramientas de personalización seleccionando Opciones y, a continuación, Personalizar este formulario.
Haga click en Insertar y, a continuación, en Campo.
Seleccione la región del formulario en la que desea exponer el nuevo campo. Tras la selección, el cuadro de diálogo Insertar campos mostrará una lista de campos existentes que se pueden insertar en la región seleccionada de la página.
Confirme que el campo en el que está interesado no existe en la lista. Si existe, simplemente puede seleccionar ese campo en la lista y hacer clic en Insertar.
Haga clic en el botón Crear nuevo campo encima de la lista para iniciar el proceso de crear un campo personalizado. Se abrirá el cuadro de diálogo Crear nuevo campo.
Si no ve el botón Crear nuevo campo, no dispone de los permisos necesarios para usar esta función.
En el cuadro de diálogo Crear nuevo campo, especifique la siguiente información.
Seleccione la tabla de la base de datos si debe agregarse este campo. Tenga en cuenta que solo aparecerán las tablas personalizadas compatibles en la lista desplegable. Consulte la siguiente sección para obtener detalles técnicos sobre las tablas compatibles.
Seleccione el tipo de datos para el nuevo campo. Los tipos de datos disponibles son casilla de verificación, fecha, fecha y hora, decimal, número, lista de selección y texto.
- Si elige el tipo de datos del texto, también puede especificar la longitud máxima del texto que se puede especificar en este campo.
- Si elige el tipo de datos de la lista de selección, también puede seleccionar el conjunto de valores válidos para el campo.
Proporcione un nombre, una etiqueta y un texto de ayuda para el campo. El nombre corresponde al nombre de campo físico en la base de datos, mientras que la etiqueta y el texto de ayuda son el texto utilizado para representar este campo en la interfaz de usuario.
Si este es el único campo que necesita crear para esta página, haga clic en Guardar. Si necesita crear campos adicionales, haga clic en Guardar y nuevo y vuelva al paso 7.
Nota
Actualmente, hay un límite de 20 campos personalizados por tabla.
- Dejar el cuadro de diálogo Crear nuevo campo le devolverá al cuadro de diálogo Insertar campos . Cualquier campo personalizado recién agreado se marcará automáticamente en la lista de campos que se insertará en la página.
- Haga clic en Insertar para insertar los campos marcados en la región seleccionada de la página.
- Opcional: habilite el modo Mover desde la barra de herramientas de personalización para mover los nuevos campos a la ubicación deseada en la región seleccionada. Consulte Personalizar la experiencia del usuario para obtener más información sobre cómo usar las diversas capacidades de personalización para optimizar un formulario para su uso personal.
Advertencia
La capacidad de introducir valores en un campo personalizado agregado a una página depende de si la tabla asociada con el campo personalizado es editable o de solo lectura. Cuando la tabla asociada es de solo lectura, todos los campos vinculados a esa tabla, incluidos los campos personalizados, también serán de solo lectura.
Compartir campos personalizados con otros usuarios
Después de crear un campo personalizado y exponerlo en una página, puede que desee proporcionar esta vista de página actualizada que incluye el nuevo campo a otros usuarios en el sistema. Esto se puede realizar de dos formas distintas mediante las capacidades de personalización de producto:
- La ruta recomendada es publicar una vista guardada con el campo personalizado agregado a la página para el conjunto apropiado de usuarios. Si la función de vistas guardadas no está habilitada, el administrador del sistema puede aplicar la personalización a los usuarios deseados desde la página Personalización. Para más información, consulte Personalizar la experiencia del usuario.
- Como alternativa, puede exportar los cambios (llamados personalizaciones), enviarlos a uno o varios usuarios y hacer que cada uno de estos usuarios importe los cambios. La opción Gestionar en la barra de herramientas de personalización le permite exportar e importar personalizaciones.
Gestionar campos personalizados
La gestión de todos los campos personalizados se puede lograr a través de la página Campos personalizados en el módulo de administración del sistema. Esta página permite a los usuarios acceder muchas capacidades, entre las que se incluyen:
- Ver una lista de todos los campos personalizados en el sistema.
- Edición limitada de campos personalizados existentes.
- Eliminar campos personalizados.
- Exponer campos personalizados en entidades de datos.
- Proporcionar traducciones de etiquetas de campo personalizadas y texto de ayuda.
Ver todos los campos personalizados
La página Campos personalizados proporciona visibilidad a todos los campos personalizados que se han definido en el sistema. Seleccione la tabla que le interese, y la página se actualizará para mostrar una lista de los campos personalizados asociados a esa tabla. Elegir un campo personalizado de la lista le permitirá ver todos los detalles sobre el campo.
Editar campos personalizados
Una vez creado un campo personalizado, solo se pueden modificar determinados fragmentos de información sobre el campo personalizado en la página Campos personalizados .
Puede modificar estos atributos:
- Etiqueta
- Texto de ayuda
- Longitud, para Campos de texto
No puede editar los siguientes atributos:
- Nombre de campo
- Tipo de datos
Además, para los campos de la lista de selección, se puede reordenar el conjunto de valores válidos para el campo personalizado, y se pueden agregar nuevos valores; sin embargo, los valores existentes para el campo de la lista de selección no se pueden eliminar. Haga clic en Aplicar cambios cuando termine de editar campos para una tabla determinada para que se guarden los cambios.
Exponer campos personalizados en entidades de datos
También puede ser importante permitir que los campos personalizados estén visibles en entidades de datos. Las entidades de datos se utilizan en la característica Visión general de la integración en Office y para los escenarios de importación/exportación de datos.
Siga estos tres pasos para exponer un campo personalizado en una entidad de datos:
- Seleccione el campo personalizado en la página Campos personalizados .
- Expanda la sección Entidades para ver el conjunto de entidades relevantes.
- Haga clic en el botón Editar.
- Modifique el campo Habilitado que se va a seleccionar para cada entidad que debe exponer este campo.
- Haga clic en Aplicar cambios para guardar sus selecciones.
Permitir que los campos personalizados se muestren en otros idiomas
Dado que es posible que los usuarios necesiten acceder a una variedad de idiomas, la página Campos personalizados proporciona un mecanismo para permitir la etiqueta y el texto de ayuda para que un campo personalizado se traduzca a otros idiomas.
Los siguientes pasos describen el proceso para traducir campos personalizados en otros idiomas:
Seleccione el campo personalizado en la página Campos personalizados .
Seleccione el botón Traducciones en el panel de acciones. Se abrirá un menú desplegable con las traducciones existentes para este campo.
El menú desplegable Idioma muestra el conjunto de idiomas para los que ya se han proporcionado traducciones.
Si desea editar una traducción existente, seleccione el idioma desde el menú y modifique los valores para la etiqueta y el texto de ayuda.
De lo contrario, haga clic en el botón Agregar idioma, seleccione el idioma deseado desde el menú y, a continuación, proporcione valores traducidos para la etiqueta y el texto de ayuda.
Cuando haya terminado, haga clic en Aceptar.
Eliminar campos personalizados
Si decide que un campo personalizado ya no es necesario, un administrador del sistema puede optar por eliminar el campo de la página Campos personalizados. Para eliminar un campo personalizado, seleccione el campo para eliminar, haga clic en Eliminar, haga clic en Sí para confirmar la eliminación y finalmente haga clic en Aplicar cambios.
Nota
Esta acción no se puede deshacer y dará lugar a los datos asociados al campo que se eliminará permanentemente de la base de datos.
Apéndice
¿Por qué no puedo introducir un valor en mi campo personalizado?
Si no puede escribir un valor en el campo personalizado cuando la página está en modo de edición, esto puede deberse a que la tabla a la que se agregó el campo es actualmente de solo lectura. Todos los campos de una tabla se vuelven de solo lectura si la tabla de respaldo está configurada actualmente como de solo lectura en la página.
¿Quién puede crear campos personalizados?
Solo los administradores del sistema pueden crear campos personalizados de forma predeterminada. Sin embargo, estos usuarios avanzados que la organización considera necesario pueden obtener derechos para crear campos personalizados por un administrador del sistema mediante el rol de seguridad Usuario avanzado de personalización de tiempo de ejecución. Los usuarios sin este rol de seguridad no podrán crear campos personalizados, pero si podrán ver e interactuar con los campos personalizados agregados por otros usuarios en el sistema.
¿Qué tablas admiten campos personalizados?
Por motivos rendimiento y técnicos, solo las tablas que cumplen las siguientes condiciones permiten actualmente que se agreguen campos personalizados.
La tabla debe etiquetarse como uno de estos grupos:
- Grupo
- WorksheetHeader
- Principal
- Varios
- Parámetro
- Referencia
- TransactionHeader
La tabla no puede extenderse a otra tabla.
La tabla no puede marcarse como una tabla del sistema.
La tabla no puede ser una tabla temporal.
¿Puedo hacer referencia a campos personalizados desde las herramientas para desarrolladores?
Los campos personalizados solo se pueden administrar a través de la interfaz de usuario. No es posible hacer referencia a estos campos en el código.
¿Puedo transferir el campo personalizado a la tabla como un campo de extensión manteniendo los valores?
Los datos de los campos personalizados se pueden transferir a la tabla como campos de extensión. Para usar los guiones X++ personalizados para obtener y asignar los datos correspondientes de un campo personalizado, siga estos pasos:
- Obtenga el nombre del campo personalizado.
- Utilice el método
.getFieldValue(_fieldName)para obtener un valor en la tabla de origen.
Puede usar el administrador de extensiones TableExtensionManagerFactory::CreateExtensionManager() para crear el objeto de construcción de extensión .GetRuntimeExtension(_tableName, SysCustomFieldConstants::ExtensionName) en la biblioteca Microsoft.Dynamics.Ax.Xpp.Extensiones de metadatos para obtener más información sobre el tipo/metadatos del campo de extensión.
Billete
Excluya registros con valores predeterminados de su consulta al transferir datos de todos los registros entre un campo personalizado y un nuevo campo de extensión. Utilice la instrucción de actualización del marco SysDa para un mejor rendimiento.
¿Cómo puedo mover campos personalizados entre entornos?
La recomendación actual para mover campos personalizados entre entornos es volver a crear manualmente los campos personalizados en el entorno de destino. Para ver la lista completa de campos personalizados en una tabla en particular:
- Vaya a la página Campos personalizados, seleccione esa tabla del menú desplegable.
- En el entorno de destino, siga el proceso descrito anteriormente en este artículo para volver a crear cada campo.
- Una vez que se hayan creado todos los campos, haga clic en Aplicar cambios.
- Mueva todas las personalizaciones que contengan campos personalizados exportándolas desde el entorno original e importándolas al entorno de destino.