Los valores de datos de referencia de un conjunto normalmente se identifican mediante un código exclusivo. Sin embargo, es posible que tenga que identificar los datos utilizando más de una columna. Una clave compuesta es una combinación de la columna de código y hasta 5 columnas personalizadas en un conjunto de datos de referencia. A continuación, se utiliza la clave compuesta para identificar de forma exclusiva cada valor de datos de referencia.

Permisos necesarios Para crear, editar o suprimir conjuntos de datos de referencia, debe tener este permiso de usuario:

• Acceso a artefactos de gobernabilidad

Adicionalmente, debe tener uno de estos roles de colaborador de categoría en la categoría principal para el conjunto de datos de referencia:

• admin
• Propietario
• Editor
• Un rol personalizado con el permiso para crear conjuntos de datos de referencia.

Se utiliza una clave compuesta para identificar de forma exclusiva cada valor de datos de referencia. Con una clave compuesta, ya no es necesario que los valores de la columna de código sean exclusivos. La exclusividad sólo se garantiza cuando se combinan los valores de todas las columnas especificadas; los valores de las columnas individuales no son necesariamente exclusivos.

Cuando se define una clave compuesta para el conjunto, cada valor de datos de referencia de dicho conjunto se identifica en el sistema mediante una representación física de la clave compuesta, que es una concatenación de la columna de código y las columnas personalizadas de clave compuesta en el orden que se especificó cuando se creó inicialmente el conjunto. Los valores están delimitados por |, por ejemplo: CODE|CC1|CC2|CC3. Esta representación física se utiliza para identificar valores de datos de referencia en el sistema (por ejemplo, para realizar un seguimiento de las relaciones) y no se puede cambiar.

Las restricciones siguientes se aplican a las columnas personalizadas que se utilizan para crear una clave compuesta:

• Las columnas de clave compuesta sólo se pueden añadir a conjuntos de datos de referencia nuevos o vacíos. Si un conjunto ya tiene valores de datos de referencia añadidos, no puede definir una clave compuesta.
• Las columnas personalizadas que desea validar deben ser de tipo Texto.
• Puede haber hasta 5 columnas personalizadas añadidas a la columna Código para formar una clave compuesta. La columna de código siempre es la primera.
• Si la columna personalizada forma parte de la clave compuesta, debe establecerse como obligatoria.
• Cuando se añaden valores de datos de referencia al conjunto, la clave compuesta ya no se puede modificar. Si es necesario realizar un cambio, debe crear un nuevo conjunto de datos de referencia.
• La columna de clave compuesta puede tener una longitud máxima de 200 caracteres. Las columnas personalizadas que no forman parte de la clave compuesta tienen el límite establecido en 2000.
• Los caracteres | y UNIT SEPARATOR (código ASCII 0x31) no deben utilizarse en la columna de código o en las columnas personalizadas utilizadas para crear la clave compuesta. Este carácter se utiliza para separar valores de clave compuesta al crear una representación física de la clave compuesta en la base de datos. Esta restricción sólo se aplica a la API v4.

Para crear un conjunto de datos de referencia con una clave compuesta utilizando un archivo CSV con valores:

1. Elija Gobierno > Datos de referencia y, a continuación, pulse Añadir conjunto de datos de referencia.

2. Pulse Nuevo conjunto de datos de referencia y especifique lo siguiente en el panel Detalles:

   1. Cargue el archivo CSV.
   2. Proporcione un nombre para el conjunto de datos de referencia.
   3. Especifique el tipo de los valores: Texto, Número o Fecha.
   4. Seleccione la categoría en la que crear el conjunto de datos de referencia.
   5. Opcionalmente, puede proporcionar una descripción.

3. En el panel Correlacionar columnas , correlacione las columnas del archivo CSV con las columnas de destino:

   1. Especifique si la primera fila de un archivo CSV debe utilizarse como cabecera de columna en lugar del primer valor de datos de referencia.

   2. Correlacione las columnas del archivo una por una. Se muestra la vista previa de la columna cargada. Si las columnas predefinidas no satisfacen sus necesidades, seleccione Nueva columna personalizada.

   3. Para cada columna personalizada, especifique:

      • Nombre: El nombre de columna debe ser exclusivo dentro de un conjunto de datos de referencia determinado.
      • Tipo: Texto, Número o Fecha.
      • Descripción: opcional.
      • El número máximo de caracteres que se deben utilizar para un registro en una columna. El límite para una columna de clave compuesta es 200. Para cualquier otra columna, el límite es 2000. Este límite sólo se puede cambiar cuando el conjunto de datos de referencia está vacío. Cuando se añaden valores en el conjunto, sólo puede aumentar el límite.
      • Opcionalmente, seleccione el conjunto de datos de referencia que desea utilizar para la validación: los valores de la columna se validarán con respecto a la columna CODE del conjunto de datos de referencia seleccionado. Si un valor de columna personalizado no es válido por cualquier motivo, el valor de datos de referencia no se crea ni se importa y se añade un aviso al informe.

      Nota:

      • El conjunto de datos de referencia que elija para ser un validador ya no se puede eliminar a menos que se elimine la validación con respecto a este conjunto.
      • El validador de una columna sólo se puede establecer o modificar si el conjunto de datos de referencia está vacío.
      • Sólo puede validar las columnas de tipo Texto, porque la columna CODE que está validando siempre es de este tipo.

   4. Si desea que la columna personalizada forme parte de la clave compuesta, seleccione Parte de clave compuesta. A continuación, la columna se marca automáticamente como Obligatorio, lo que significa que los valores no pueden estar vacíos.

4. Cuando se correlacionen todas las columnas, revise la información en el panel Revisar . Tenga en cuenta que en este punto puede reordenar las columnas de clave compuesta para que se ajusten a sus requisitos. El orden de las columnas establecidas en este panel influye en cómo se forma la representación física de la clave compuesta en el sistema. Por ejemplo, si las columnas de este panel se listan en este orden:

   • columna personalizada 1
   • columna personalizada 2
   • columna personalizada 3

   A continuación, la representación física de la clave compuesta para estos valores de datos de referencia se forma como CODE|CC1|CC2|CC3. Cuando añade valores al conjunto de datos de referencia, este orden ya no se puede cambiar. Puede reorganizar las columnas en la interfaz de usuario al visualizar el conjunto, pero no influye en la composición real de la clave compuesta. Compare el orden de las columnas con el orden especificado en el archivo CSV y modifíquelo si es necesario.

5. Pulse Crear. El conjunto de datos de referencia se guarda como borrador.

Nota: Al trabajar con los archivos CSV con valores de datos de referencia, asegúrese de que la relación padre entre los valores se representa como concatenación de CODE y valores de columna personalizada de clave compuesta delimitados por |. El código siempre va primero, a continuación, los valores de columna de clave compuesta. Asegúrese de que el orden de estas columnas sea el mismo en el archivo CSV y en el panel de resumen del asistente de creación o importación.

Cuando haya terminado, decida si:

• Cierre el nuevo conjunto de datos de referencia en su estado de borrador.
• Pulse Suprimir borrador para suprimir el nuevo conjunto de datos de referencia.
• En función de la definición de flujo de trabajo , pulse Publicar o Enviar para aprobación para procesar el conjunto de datos de referencia.