Model danych i elementy projektu

Tabele w projekcie często mają wspólne nazwy kolumn: Period, Org, Account. Element projektu opisuje jedną z takich nazw raz, dla całego projektu. Każda tabela z kolumną o tej nazwie pokazuje wtedy ten sam opis, maskę i wymiar, więc nie musisz już wpisywać tej samej notatki w dziesiątkach tabel.

Strona Model danych w Project Home wymienia elementy projektu, pokazuje, które tabele współdzielą każdy z nich, i wskazuje miejsca, w których tabele się różnią.

Co zawiera element

Ustawienie	Działanie
Nazwa	Nazwa kolumny, którą opisuje element, zapisana dokładnie tak, jak mają ją kolumny.
Opis	Informacja o tym, co zawiera kolumna. Kolumny bez własnej notatki pokazują ten opis.
Typ	Typ danych, jakiego projekt oczekuje dla tej kolumny. Jest sprawdzany, a nie stosowany. Zobacz Konflikty typów.
Maska	Maska liczbowa. Kolumny bez własnej maski używają tej.
Wymiar	Wymiar, z którego pochodzą wartości kolumny. Kolumny bez własnego wymiaru używają tego.
Aliasy	Inne nazwy kolumn o tym samym znaczeniu.

Jak kolumna otrzymuje element

Kolumna jest powiązana z elementem, gdy jej identyfikator jest taki sam jak nazwa elementu lub jeden z jego aliasów. Dopasowanie jest dokładne: period i Period to różne nazwy, więc jeśli chcesz obsłużyć obie, dodaj period jako alias elementu Period.

Dodaj lub usuń element, a każda pasująca kolumna podąży za tą zmianą.

Co kolumna przejmuje od swojego elementu

Powiązana kolumna przejmuje Opis, Maska i Wymiar elementu wszędzie tam, gdzie jej własna wartość jest pusta. Wartość ustawiona w samej kolumnie zawsze ma pierwszeństwo. Element nigdy nie zmienia tego, co jest zapisane w tabeli: po jego usunięciu każda kolumna wraca dokładnie do tego, co miała.

Typ nie jest przejmowany od elementu.

Otwieranie strony Model danych

Otwórz projekt, a następnie wybierz Model danych na szynie w Project Home. Znacznik na szynie pokazuje, ile elementów ma projekt. Stronę możesz też otworzyć z poziomu kolumny:

W Eksploratorze tabel włącz Właściwości kolumny i zaznacz kolumnę. Wiersz Element pokazuje element kolumny albo, jeśli kolumna go nie ma, a Ty możesz edytować projekt, Zrób z tego element. Kliknij go, aby otworzyć stronę Model danych na tym elemencie lub na nowym elemencie, który zaczyna od własnego opisu, maski i wymiaru kolumny.
Na liście obiektów używających danego wymiaru wiersz o nazwie Element projektu otwiera stronę Model danych.

Stronę widzi każdy, kto może otworzyć projekt. Aby tworzyć, zmieniać lub usuwać elementy, potrzebujesz dostępu do zapisu w projekcie, a projekt nie może być zablokowany. W przeciwnym razie strona pokazuje komunikat „Możesz tutaj przeglądać model danych, ale nie możesz go zmieniać.”

Tworzenie elementu

Na stronie Model danych kliknij Nowy element.
Wpisz Nazwę. W razie potrzeby uzupełnij Opis, Typ, Maska i Wymiar. Pozostaw w polu Typ wartość Dowolny typ, aby akceptować dowolny typ.
W polu Aliasy wpisz inne nazwy kolumn o tym samym znaczeniu, po jednej w wierszu.
Kliknij Zapisz.

Element nie może przyjąć nazwy ani aliasu, który ma już inny element. Aby zmienić element, kliknij ołówek (Edytuj element) obok niego. Jeśli zmienisz jego nazwę, stara nazwa pozostaje aliasem, dzięki czemu jego kolumny zachowują element.

Aby usunąć element, otwórz go i kliknij Usuń, a następnie potwierdź przyciskiem Usuń element. Potwierdzenie podaje, z iloma tabelami jest powiązany element. Nic zapisanego w tych tabelach się nie zmienia.

Sugerowane elementy

W sekcji Sugerowane strona wymienia nazwy kolumn, które warto zamienić na elementy:

Nazwa, która nie jest jeszcze elementem ani aliasem i występuje w co najmniej dwóch tabelach, gdy typ kolumny może być kluczem złączenia (nieznany typ się liczy), pokazana jako „nazwa znajduje się w n tabel”. Kliknij Utwórz element, aby ją utworzyć.
Nazwa zgodna z nazwą lub aliasem elementu po pominięciu wielkości liter i podkreśleń, nawet jeśli występuje tylko w jednej tabeli, pokazana jako „nazwa wygląda jak element (n tabel)”. Kliknij Dodaj alias, aby powiązać jej kolumny z tym elementem.

Odczytywanie modelu danych

Przełącznik Graf i Macierz nad kanwą pokazuje te same tabele i elementy na dwa sposoby.

Graf. Każdy element jest węzłem, a każda tabela to karta połączona z elementami, dla których ma kolumnę. Cyfra 1 na linii oznacza kolumnę będącą jedynym kluczem tabeli. Tabela z kluczem złożonym z kilku kolumn nie jest oznaczana. Strona otwiera się na jednym elemencie i jego tabelach. Kliknij element, aby się na nim skupić, kliknij tabelę, aby skupić się na niej, lub kliknij tabelę dwukrotnie, aby ją otworzyć. Chipy obok Ukryj elementy ukrywają lub pokazują elementy, których nie chcesz widzieć na rysunku.
Macierz. Jeden wiersz na tabelę i jedna kolumna na element. Użyj Filtruj według nazwy tabeli, aby zawęzić wiersze.

Konflikty typów

Tabela, której kolumna ma inny typ niż pozostałe, jest oznaczana pod elementem: „kolumna ma typ typ w tabela, co różni się od pozostałych tabel.” Typy są porównywane według rodziny, więc liczba całkowita i liczba dziesiętna nie powodują konfliktu. Jeśli element ma Typ, pozostałe tabele są porównywane z jego rodziną. Jeśli nie, są porównywane z rodziną używaną przez większość kolumn, a gdy dwie rodziny mają tyle samo kolumn, wybierana jest ta, która jest pierwsza w kolejności alfabetycznej. Konflikt jest tylko ostrzeżeniem i niczego nie zmienia.

Tabela, której nie można odczytać, jest pomijana i liczona na stronie, zamiast zatrzymywać jej działanie.

Gdzie widać elementy

Elementy są pokazywane jako plakietka z nazwą elementu:

Eksplorator tabel. Lista kolumn ma kolumnę Oznaczenia z plakietką, obok plakietek Wymiar i Dostęp do wierszy. Najedź na plakietkę, aby zobaczyć element, jego opis i wymiar.
Właściwości kolumny. Wiersz Element otwiera element. Gdy Opis, Maska lub Wymiar jest pusty, pole pokazuje jako podpowiedź „Z elementu nazwa: wartość”. Podpowiedź nie jest zapisywana w kolumnie.
Karta Data Mapping kroku. Kolumny źródłowe i docelowe należące do elementu pokazują jego plakietkę po nazwie kolumny.

Korzystanie z elementów w REST API i MCP

REST API odczytuje i zmienia elementy pod adresem /rest/v1/analyze/projects/{project_id}/elements:

Żądanie	Działanie
`GET`	Zwraca `elements` oraz `index`, który mapuje nazwę każdej powiązanej kolumny na nazwę jej elementu.
`PUT`	Tworzy lub zastępuje element na podstawie `name`, `memo`, `dtype`, `mask`, `dimension` i `aliases`. Dodaj `rename_from`, aby zmienić nazwę elementu.
`DELETE` z `?name=`	Usuwa element o podanej nazwie.
`GET` `/graph`	Zwraca to, co pokazuje strona Model danych: każdy element z liczbą tabel i konfliktami typów, powiązane kolumny każdej tabeli oraz sugestie.

Metadane tabeli zwracają wartości zapisane w każdej kolumnie, a nie wartości, które kolumna przejmuje od elementu. Aby sprawdzić, od którego elementu kolumna przejmuje wartości, wyszukaj jej nazwę w index zwracanym przez GET elements.

Asystent połączony przez MCP używa element_find, element_upsert i element_delete. Jego opisy tabel pokazują notatkę każdej kolumny z uzupełnioną wartością elementu tam, gdzie kolumna jej nie ma.