Wartości danych odniesienia w zestawie są zwykle identyfikowane za pomocą unikalnego kodu. Jednak może być konieczne zidentyfikowanie danych przy użyciu więcej niż jednej kolumny. Klucz złożony jest kombinacją kolumny kodu i maksymalnie 5 kolumn niestandardowych w zestawie danych odniesienia. Następnie klucz złożony jest używany do jednoznacznego identyfikowania każdej wartości danych odniesienia.

Wymagane uprawnienia Aby tworzyć, edytować lub usuwać zestawy danych odniesienia, użytkownik musi mieć uprawnienie użytkownika:

• Artefakty zarządzania dostępem

Dodatkowo należy mieć jedną z tych ról współpracowników kategorii w kategorii podstawowej dla zestawu danych odniesienia:

• Admin
• Właściciel
• Edytor
• Niestandardowa rola z uprawnieniem do tworzenia zbiorów danych odniesienia.

Klucz złożony jest używany do jednoznacznego identyfikowania każdej wartości danych odniesienia. W przypadku klucza złożonego wartości w kolumnie kodu nie muszą być już unikalne. Unikalność jest gwarantowana tylko wtedy, gdy wartości wszystkich podanych kolumn są łączone-wartości w poszczególnych kolumnach nie muszą być unikalne.

Podczas definiowania klucza złożonego dla zestawu, każda wartość danych odniesienia w takim zestawie jest identyfikowana w systemie przez fizyczną reprezentację klucza złożonego, która jest konkatenacją kolumny kodowej i kolumn niestandardowych klucza złożonego w kolejności określonej podczas początkowego tworzenia zestawu. Wartości są rozdzielane znakiem |, na przykład: CODE|CC1|CC2|CC3. Ta reprezentacja fizyczna jest używana do identyfikowania referencyjnych wartości danych w systemie (na przykład w celu śledzenia relacji) i nie można jej zmienić.

W przypadku kolumn niestandardowych używanych do tworzenia klucza złożonego obowiązują następujące ograniczenia:

• Kolumny klucza złożonego mogą być dodawane tylko do nowych lub pustych zestawów danych odniesienia. Jeśli zestaw ma już dodane wartości danych odniesienia, nie można zdefiniować klucza złożonego.
• Kolumny niestandardowe, które mają zostać sprawdzone, muszą być typu Tekst.
• Do kolumny Kod może znajdować się maksymalnie 5 kolumn niestandardowych, które mają zawierać klucz złożony. Kolumna kodowa jest zawsze pierwsza.
• Jeśli kolumna niestandardowa jest częścią klucza złożonego, musi ona być ustawiona jako obowiązkowa.
• Gdy wartości danych odniesienia są dodawane do zestawu, klucz złożony nie może być już modyfikowany. Jeśli zmiana jest potrzebna, należy utworzyć nowy zestaw danych odniesienia.
• Kolumna klucza złożonego może mieć długość do 200 znaków. Kolumny niestandardowe, które nie są częścią klucza złożonego, mają limit ustawiony na wartość 2000.
• Znaki | i UNIT SEPARATOR (kod ASCII 0x31) nie mogą być używane w kolumnie kodu ani w kolumnach niestandardowych używanych do tworzenia klucza złożonego. Znak ten jest używany do oddzielania wartości klucza złożonego podczas tworzenia fizycznej reprezentacji klucza złożonego w bazie danych. To ograniczenie ma zastosowanie tylko do interfejsu API v4.

Aby utworzyć odwołanie do zestawu danych za pomocą klucza złożonego przy użyciu pliku CSV z wartościami:

1. Wybierz opcję Zarządzanie > Dane odniesienia, a następnie kliknij opcję Dodaj odwołanie do zestawu danych.

2. Kliknij opcję Nowy zestaw danych odniesienia , a następnie w panelu Szczegóły określ następujące informacje:

   1. Prześlij plik CSV.
   2. Podaj nazwę dla referencyjnego zestawu danych.
   3. Określ typ wartości: Tekst, Liczba lub Data.
   4. Wybierz kategorię, w której ma zostać utworzony zestaw danych odniesienia.
   5. Opcjonalnie podaj opis.

3. Na panelu Odwzorowywać kolumny odwzoruj kolumny z pliku CSV na kolumny docelowe:

   1. Określ, czy pierwszy wiersz w pliku CSV powinien być używany jako nagłówek kolumny, a nie jako pierwsza wartość danych odniesienia.

   2. Odwzoruj kolumny na jeden według jednego z nich. Zostanie wyświetlony podgląd przesłanej kolumny. Jeśli predefiniowane kolumny nie spełniają Twoich potrzeb, wybierz opcję Nowa kolumna niestandardowa.

   3. Dla każdej kolumny niestandardowej należy określić:

      • Nazwa: Nazwa kolumny musi być unikalna w ramach danego zbioru danych odniesienia.
      • Typ: Tekst, Liczba lub Data.
      • Opis: opcjonalny.
      • Maksymalna liczba znaków, która ma być używana dla rekordu w kolumnie. Limit dla kolumny klucza złożonego wynosi 200. W przypadku pozostałych kolumn limit wynosi 2000. Ten limit może zostać zmieniony tylko wtedy, gdy zestaw danych odniesienia jest pusty. Po dodaniu wartości w zestawie można zwiększyć tylko limit.
      • Opcjonalnie wybierz zestaw danych odniesienia, który ma być używany do sprawdzania poprawności-wartości w kolumnie będą sprawdzane pod względem kolumny CODE w wybranym zestawie danych odniesienia. Jeśli wartość kolumny niestandardowej jest niepoprawna z jakiegokolwiek powodu, wartość danych odniesienia nie zostanie utworzona ani zaimportowana, a do raportu zostanie dodane ostrzeżenie.

      Uwaga:

      • Nie można usunąć referencyjnego zestawu danych, który ma być analizatorem poprawności, chyba że zostanie usunięte sprawdzenie poprawności dla tego zestawu.
      • Analizator poprawności dla kolumny może być ustawiany lub modyfikowany tylko wtedy, gdy zestaw danych odniesienia jest pusty.
      • Poprawność kolumn typu Text można sprawdzić tylko dlatego, że kolumna CODE, dla której sprawdzana jest poprawność, jest zawsze tego typu.

   4. Jeśli chcesz, aby kolumna niestandardowa była częścią klucza złożonego, wybierz opcję Część klucza złożonego. Kolumna jest wtedy automatycznie oznaczana jako Obowiązkowa, co oznacza, że wartości nie mogą być puste.

4. Gdy wszystkie kolumny są odwzorowane, przejrzyj informacje w panelu Przegląd . Należy pamiętać, że w tym momencie można zmienić kolejność kolumn klucza złożonego w celu dopasowania ich do wymagań. Kolejność kolumn ustawiona w tym panelu wpływa na sposób, w jaki reprezentacja fizyczna klucza złożonego jest tworzona w systemie. Na przykład, jeśli kolumny w tym panelu są wymienione w następującej kolejności:

   • kolumna niestandardowa 1
   • kolumna niestandardowa 2
   • kolumna niestandardowa 3

   Następnie fizyczna reprezentacja klucza złożonego dla tych wartości danych odniesienia jest tworzona jako CODE|CC1|CC2|CC3. Po dodaniu wartości do zestawu danych odniesienia zamówienie nie może być już zmieniane. Istnieje możliwość zmiany kolejności kolumn w interfejsie użytkownika podczas wyświetlania zestawu, ale nie ma ona wpływu na rzeczywisty skład klucza złożonego. Porównaj kolejność kolumn z kolejką określoną w pliku CSV i zmodyfikuj ją w razie potrzeby.

5. Kliknij makro Create. Zestaw danych odniesienia jest zapisywany jako wersja robocza.

Uwaga: Podczas pracy z plikami CSV z wartościami danych odniesienia należy się upewnić, że relacja nadrzędna między wartościami jest reprezentowana jako konkatenacja wartości kolumn CODE i klucza złożonego oddzielonych znakiem |. Kod zawsze idzie najpierw, a następnie wartości kolumny klucza złożonego. Upewnij się, że kolejność tych kolumn jest taka sama w pliku CSV, jak i w panelu podsumowania kreatora tworzenia lub importowania.

Po zakończeniu, zdecyduj, czy:

• Zamknij nowy zestaw danych odniesienia w jego wersji roboczej.
• Kliknij opcję Usuń wersję roboczą , aby usunąć nowy zestaw danych odniesienia.
• W zależności od definicji przepływu pracy kliknij opcję Publikuj lub Wyślij do zatwierdzenia , aby przetworzyć zestaw danych odniesienia.