Criando conjuntos de dados de referência com chaves compostas

Os valores de dados de referência em um conjunto geralmente são identificados por um código exclusivo. No entanto, pode ser necessário identificar os dados usando mais de uma coluna Uma chave composta é uma combinação da coluna de códigos e de até 5 colunas customizadas em um conjunto de dados de referência A chave composta é então usada para identificar exclusivamente cada valor de dados de referência.

Permissões necessárias Para criar, editar ou excluir conjuntos de dados de referência, é necessário ter essa permissão de usuário:

  • Acessar artefatos de controle

Além disso, deve-se ter uma destas funções de colaborador de categoria na categoria primária para o conjunto de dados de referência:

  • Administrador
  • Proprietário
  • Editor
  • Uma função customizada com a permissão para criar conjuntos de dados de referência.

Uma chave composta é usada para identificar exclusivamente cada valor de dados de referência. Com uma chave composta, os valores na coluna de código não precisam mais ser exclusivos A exclusividade é garantida apenas quando os valores de todas as colunas especificadas são combinados-os valores em colunas individuais não são, necessariamente exclusivos

Quando você define uma chave composta para o conjunto, cada valor de dados de referência em tal conjunto é identificado no sistema por uma representação física da chave composta, que é uma concatenação da coluna de código e as colunas customizadas da chave composta na ordem especificada quando o conjunto foi criado inicialmente. Os valores são delimitados por |, por exemplo: CODE|CC1|CC2|CC3.. Essa representação física é usada para identificar valores de dados de referência no sistema (por exemplo, para controlar relacionamentos) e não pode ser alterada.

As restrições a seguir se aplicam para as colunas customizadas que são usadas para criar uma chave composta:

  • Colunas de chaves compostas podem ser incluídas apenas em conjuntos de dados de referência novos ou vazios. Se um conjunto já tiver valores de dados de referência incluídos, não será possível definir uma chave composta
  • As colunas customizadas que você deseja validar devem ser do tipo Texto
  • Pode haver até 5 colunas customizadas incluídas na coluna Código para incluir uma chave composta. A coluna de código é sempre primeiro.
  • Se a coluna customizada fizer parte da chave composta, ela deverá ser configurada como obrigatória
  • Quando os valores de dados de referência são incluídos no conjunto, a chave composta não pode mais ser modificada Se a mudança for necessária, deve-se criar um novo conjunto de dados de referência
  • A coluna de chave composta pode ter até 200 caracteres. As colunas customizadas que não fazem parte da chave composta têm o limite configurado como 2000
  • Os caracteres | e UNIT SEPARATOR (código ASCII 0x31) não devem ser usados na coluna de código ou nas colunas customizadas usadas para criar a chave composta.. Esse caractere é usado para separar os valores de chave composta ao criar uma representação física da chave composta no banco de dados Essa restrição aplica-se apenas à API v4

Para criar um conjunto de dados de referência com uma chave composta usando um arquivo ` CSV ` com valores:

  1. Selecione Governança > Todos os artefatos. No painel esquerdo, selecione “Dados de referência ” e, em seguida, clique em “Adicionar conjunto de dados de referência ”.

  2. Clique em Novo conjunto de dados de referência e especifique o seguinte no painel Detalhes:

    1. Fazer upload do arquivo CSV.
    2. Forneça um nome para o conjunto de dados de referência
    3. Especifique o tipo dos valores: Texto, Número ou Data
    4. Selecione a categoria para criar o conjunto de dados de referência.
    5. Opcionalmente, forneça uma descrição.

  3. No painel "Map columns ", mapeie as colunas do seu arquivo ` CSV ` para as colunas de destino:

    1. Especifique se a primeira linha de um arquivo do tipo “ CSV ” deve ser usada como cabeçalho de coluna, em vez do primeiro valor de referência.

    2. Mapeie as colunas do arquivo uma por uma. A visualização da coluna carregada é exibida. Se as colunas predefinidas não atenderem suas necessidades, selecione Nova coluna customizada.

    3. Para cada coluna customizada, especifique:

      • Nome: O nome da coluna deve ser exclusivo em um determinado conjunto de dados de referência.
      • Tipo: Texto, Número, ou Data.
      • Descrição: opcional.
      • O número máximo de caracteres para usar para um registro em uma coluna. O limite para uma coluna de chave composta é 200. Para quaisquer outras colunas o limite é 2000. Esse limite pode ser alterado apenas quando o conjunto de dados de referência estiver vazio Quando os valores são incluídos no conjunto, é possível aumentar o limite apenas.
      • Opcionalmente, selecione o conjunto de dados de referência que você deseja usar para validação-os valores na coluna serão validados com relação à coluna CODE no conjunto de dados de referência selecionado Se um valor de coluna customizada for inválido por qualquer motivo, o valor de dados de referência não será criado ou importado e um aviso será incluído no relatório...

      Nota:

      • O conjunto de dados de referência escolhido para ser um validador não pode mais ser removido, a menos que a validação com relação a esse conjunto seja removida.
      • O validador para uma coluna pode ser configurado ou modificado apenas se o conjunto de dados de referência estiver vazio
      • É possível validar apenas as colunas do tipo Texto, porque a coluna CODE que você está validando é sempre desse tipo.

    4. Se você desejar que a coluna customizada faça parte da chave composta, selecione Parte da chave composta A coluna é, então, marcada automaticamente como Obrigatório, o que significa que os valores não podem estar vazios

  4. Quando todas as colunas forem mapeadas, revise as informações no painel Revisar Observe que, neste ponto, é possível reordenar as colunas de chaves compostas para corresponder aos seus requisitos. A ordem das colunas definidas neste painel influencia como a representação física da chave composta é formada no sistema. Por exemplo, se as colunas neste painel estiverem listadas nesta ordem:

    • coluna customizada 1
    • coluna customizada 2
    • coluna customizada 3

    Em seguida, a representação física da chave composta para esses valores de dados de referência é formada como CODE|CC1|CC2|CC3 Ao incluir valores no conjunto de dados de referência, essa ordem não poderá mais ser alterada. É possível reorganizar as colunas na IU ao visualizar o conjunto, mas isso não influencia a composição real da chave composta Compare a ordem das colunas com a ordem especificada no arquivo ` CSV ` e modifique-a, se necessário.

  5. Clique em Criar. O conjunto de dados de referência é salvo como rascunho..

Observação: Ao trabalhar com os arquivos ` CSV ` que contêm valores de dados de referência, certifique-se de que a relação de hierarquia entre os valores seja representada como uma concatenação dos valores das colunas `CODE` e das colunas de chave composta personalizadas, delimitados por |. O código deve sempre vir primeiro, seguido pelos valores das colunas de chave composta. Certifique-se de que a ordem dessas colunas seja a mesma no arquivo ` CSV ` e no painel de resumo do assistente de criação ou importação.

Quando tiver concluído, decida se deve:

  • Fechar os novos dados de referência estabelecidos em sua proposta de estado.
  • Clique em Excluir rascunho para excluir o novo conjunto de dados de referência.
  • Dependendo da definição de seu fluxo de trabalho, clique em Publicar ou Enviar para aprovação para processar o conjunto de dados de referência.

Saiba Mais