# Integracje słowników · Ustawienia pól · Portal administratora

Importuj wartości i wzorce z CSV do istniejącego słownika, określając kolumny klucza, wartości i kolejności.

Canonical: https://docs.mintsd.com/pl/docs/mint-service-desk-pl/admin-portal-dictionaries-integrations
Language: pl-PL
Revision: 26e268481a7bf0562015daca73819bbb3c207d15411df75c383f3c5e47b8254e

<a id="element-01a14f06-e9a7-7d60-8cee-da665d93b1f0"></a>

Integracja importuje z CSV wartości słowników oraz ich wzorce, zamiast wymagać ręcznego wpisywania danych.

<a id="element-01a14f06-e9a7-7634-9e1b-06e9492c7c48"></a>

W systemie musi istnieć słownik docelowy. Utworzysz go w sekcji Ustawienia pól → Słowniki.

<a id="element-01a14f06-e9a7-7991-bda2-405cc2b58990"></a>

Otwórz Ustawienia pól → Integracje słowników. Główny widok przedstawia tabelę konfiguracji z kolumnami:

<a id="element-01a14f06-e9a7-7c73-b804-966280d1ac35"></a>

![Integracje słowników: Otwórz Ustawienia pól → Integracje słowników. Główny widok przedstawia tabelę konfiguracji z kolumnami:](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image1264.png?v=70671e41e57f78dc89ebd949462fc5691d8f97e87fe60a717182aa8f94691690)

<a id="element-01a14f06-e9a7-74cc-8001-4d81951b9222"></a>

<a id="element-01a14f06-e9a7-784e-ac5a-f7d00b0b2a35"></a>

<a id="element-01a14f06-e9a7-7451-9194-90372c1e2a8e"></a>

- **Nazwa**: nazwa konfiguracji.
- **Nazwa definicji**: krótka nazwa typu wybranego podczas tworzenia.
- **Typ definicji**: opis wybranego typu konfiguracji.
- **Działanie**: przyciski ![Edit](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image89.png?v=702adcf46ea452d46f158b0c91e923f5b40ae6f37d95ca5764e20654a2855c4c#element-01a14f06-e9a7-74cc-8001-4d81951b9222) i ![Delete](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image202.png?v=1ae492635a6fc6619d5b242c62eff118e37d8d48440153360fc4ec4913f5ed3a#element-01a14f06-e9a7-784e-ac5a-f7d00b0b2a35).

<a id="element-01a14f06-e9a7-71a5-9453-f8dad3c40d43"></a>

<a id="element-01a14f06-e9a7-7a2d-8ee6-a905271dbc3e"></a>

Aby utworzyć konfigurację, kliknij przycisk ![Dodaj](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image3.png?v=50654a0321a77a3b2271140f1b6a5080d18fbef92f3639b9b83ad57f0fd5735d#element-01a14f06-e9a7-71a5-9453-f8dad3c40d43) w prawym górnym rogu.

<a id="element-01a14f06-e9a7-7e8c-8495-997ee56c01b6"></a>

W formularzu tworzenia integracji wpisz nazwę i wybierz typ konfiguracji w polu definicji.

<a id="element-01a14f06-e9a7-738b-bc4c-27486ccd24fb"></a>

![Integracje słowników: W formularzu tworzenia integracji wpisz nazwę i wybierz typ konfiguracji w polu definicji.](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image1265.png?v=2895da869edfd793f2293c286139f06b352b834418aa88a55aa711f7078bf844)

<a id="element-01a14f06-e9a7-7f55-bc8d-9659d2ffed04"></a>

Po zapisaniu danych otworzą się ustawienia konfiguracji.

<a id="element-01a14f06-e9a7-72a8-9aad-d4e2a9b04951"></a>

Zacznij od **sekcji konfiguracji słownika**.

<a id="element-01a14f06-e9a7-708d-8eb0-cf08dd3c1b0e"></a>

![Integracje słowników: Zacznij od sekcji konfiguracji słownika.](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image1266.png?v=8b68d2f6fc887dead58abb191ae5954d0c57bb37f3471e4ef8a568036e38c41f)

<a id="element-01a14f06-e9a7-76e5-817d-1ce2bfac4d53"></a>

W polu słownika do aktualizacji wybierz istniejący słownik docelowy.

<a id="element-01a14f06-e9a7-7d91-89f7-025d7c3508e4"></a>

Następnie uzupełnij pola:

<a id="element-01a14f06-e9a7-7be8-9ed2-a92165755e3c"></a>

- **Typ klucza słownika**: kolumna bazy danych służąca do rozpoznawania, czy wartość już istnieje. Dostępne opcje: DictionaryValueId, Value i Pattern.
- **Nazwa kolumny klucza**: nazwa kolumny pliku odpowiadającej wybranemu kluczowi w bazie.
- **Nazwa kolumny wartości**: kolumna pliku, której dane trafią do kolumny Value w bazie.
- **Nazwa kolumny kolejności wartości**: kolumna pliku odpowiadająca PositionOrder w bazie.

<a id="element-01a14f06-e9a7-7bbe-b173-1aecd77f7f9d"></a>

Jeżeli słownik nie ma wzorców, w sekcji konfiguracji wzorców pojawi się komunikat informujący o ich braku.

<a id="element-01a14f06-e9a7-7cbf-81a9-1169d29bb1e6"></a>

![Integracje słowników: Jeżeli słownik nie ma wzorców, w sekcji konfiguracji wzorców pojawi się komunikat informujący o ich braku.](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image1272.png?v=37a58f3f0e2dc0418bc2bf02259302799fc26a2e96e9eb0c0ec4cd039d487964)

<a id="element-01a14f06-e9a7-7d53-8fed-6244f2a1a938"></a>

## Przykład konfiguracji i wykonania integracji

<a id="element-01a14f06-e9a7-7713-9be7-090224519fff"></a>

W Mint Service Desk istnieje pusty słownik **HARDWARE**.

<a id="element-01a14f06-e9a7-7243-b949-0a8b43ac9358"></a>

![Integracje słowników: W Mint Service Desk istnieje pusty słownik HARDWARE.](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image1278.png?v=7ac30a1754c73d3ab1da1d897a32a508d2721e3903f1834b3943474b3d17b532)

<a id="element-01a14f06-e9a7-7f98-a4fc-d0e646139e63"></a>

Chcemy zaimportować trzy wartości: *computer, laptop, smartphone*, dokładnie w tej kolejności. Wiemy, że wartości w kolumnie Value są unikalne i mogą służyć jako klucz.

<a id="element-01a14f06-e9a7-7e95-9743-fbf8389f71e5"></a>

Najpierw przygotuj plik CSV. W pierwszym wierszu określ nazwy kolumn:

<a id="element-01a14f06-e9a7-7cec-8fc8-e85857754582"></a>

- **Kolumna klucza**: dane odpowiadające kolumnie bazy wybranej jako typ klucza słownika.
- **Kolumna wartości**: dane odpowiadające kolumnie value w bazie.
- **Kolumna kolejności wartości**: dane odpowiadające kolumnie PositionOrder w bazie.

<a id="element-01a14f06-e9a7-7247-84e4-b4b64f440c11"></a>

Nazwy rozdziel ustalonym separatorem. W przykładzie używamy średnika.

<a id="element-01a14f06-e9a7-78d5-83e2-e5ab3de22942"></a>

Przykładowy pierwszy wiersz pliku:

<a id="element-01a14f06-e9a7-7c06-935c-18fda3e80d59"></a>

key;value;positionOrder

<a id="element-01a14f06-e9a7-7561-a3f0-8fa812b362b8"></a>

W kolejnych wierszach wpisz dane do kolumn określonych w nagłówku.

<a id="element-01a14f06-e9a7-7dce-a983-6c5f8eeb2eed"></a>

Dla słownika **HARDWARE** plik ma postać:

<a id="element-01a14f06-e9a7-75c8-ada0-30c7dbc54abe"></a>

- Wiersz 1: key;value;positionOrder
- Wiersz 2: computer;computer;1
- Wiersz 3: laptop;laptop;2
- Wiersz 4: smartphone;smartphone;3

<a id="element-01a14f06-e9a7-7c91-b971-d081aa689e00"></a>

Przykładowy plik powinien wyglądać jak poniżej:

<a id="element-01a14f06-e9a7-7633-83ba-e982121c027f"></a>

![Integracje słowników: Przykładowy plik powinien wyglądać jak poniżej:](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image1274.png?v=d24b07144332e99ccfde33ddea24373635a77e7608bc4b3b11788536d8ed8a0b)

<a id="element-01a14f06-e9a7-7c34-8133-b0ee8a94464e"></a>

Po przygotowaniu pliku przejdź do konfiguracji słownika i wybierz:

<a id="element-01a14f06-e9a7-75ad-8bda-f669184f2a1d"></a>

- Typ klucza słownika: Value, ponieważ wartości są unikalne i nie będą się powtarzać.

<a id="element-01a14f06-e9a7-70cf-8daf-ebcf6c1b7d5e"></a>

![Integracje słowników: - Typ klucza słownika: Value, ponieważ wartości są unikalne i nie będą się powtarzać.](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image1273.png?v=27cc0be00c89aa4a672d6e4b474ff7efa01f3f99a95a358548ddd059f555b6e3)

<a id="element-01a14f06-e9a7-74c2-ad76-2b62decb0474"></a>

Uzupełnij nazwy zgodnie z pierwszym wierszem pliku:

<a id="element-01a14f06-e9a7-740f-bdc5-e7c070d92e30"></a>

- Nazwa kolumny klucza: key
- Nazwa kolumny wartości: value
- Nazwa kolumny kolejności wartości: positionOrder

<a id="element-01a14f06-e9a7-76dd-bebb-91691ca508e9"></a>

![Integracje słowników: - Nazwa kolumny klucza: key - Nazwa kolumny wartości: value - Nazwa kolumny kolejności wartości: positionOrder](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image1275.png?v=66019cbd973d0792fd95bf961862cfa819c2621ff3e24db0762cea17bd873e6c)

<a id="element-01a14f06-e9a7-7357-ab79-918849eabd19"></a>

W sekcji separatora pliku ustaw znak rozdzielający dane CSV. Domyślnie jest to średnik.

<a id="element-01a14f06-e9a7-714d-becf-b39c2982e8e7"></a>

![Integracje słowników: W sekcji separatora pliku ustaw znak rozdzielający dane CSV. Domyślnie jest to średnik.](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image1276.png?v=bfb0922237bec3f735cb2945eb1e21d1e11bb380784e315c0bf843c946ea78e9)

<a id="element-01a14f06-e9a7-7161-8dd8-83f565600601"></a>

Kliknij „Aktualizuj”, aby zapisać konfigurację.

<a id="element-01a14f06-e9a7-7f49-9f9b-a3fb002bef79"></a>

![Integracje słowników: Kliknij „Aktualizuj”, aby zapisać konfigurację.](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image1277.png?v=6e941f7342e7d61ce08b6f341aa1497f6241c8097cab62220dd9cf841d4bedeb)

<a id="element-01a14f06-e9a7-7979-9b1e-4d75473ddcd6"></a>

Następnie kliknij „Wybierz plik” i dołącz CSV. Synchronizacja rozpocznie się automatycznie.

<a id="element-01a14f06-e9a7-7620-938a-d67a8dc7d9ad"></a>

![Integracje słowników: Następnie kliknij „Wybierz plik” i dołącz CSV. Synchronizacja rozpocznie się automatycznie.](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image1284.png?v=cc6a22e5abe0e60995e57ebafe4a19698b20fceeb12e9d7613d3f162c41bba6e)

<a id="element-01a14f06-e9a7-7d8e-9428-f45ef2f81245"></a>

Postęp pobierania wartości można śledzić na bieżąco. Kliknięcie synchronizacji otwiera szczegóły z informacjami o przebiegu i ewentualnych błędach.

<a id="element-01a14f06-e9a7-721a-8fa2-19a78e73b6a8"></a>

![Integracje słowników: Postęp pobierania wartości można śledzić na bieżąco. Kliknięcie synchronizacji otwiera szczegóły z informacjami o przebiegu i ewentualnych błędach.](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image1285.png?v=6041f695e46306c5b8f69a8a517c7332c6d3d81d6308fc27de84c74e02490d66)

<a id="element-01a14f06-e9a7-7339-88cf-938335fafdf2"></a>

![Integracje słowników: Postęp pobierania wartości można śledzić na bieżąco. Kliknięcie synchronizacji otwiera szczegóły z informacjami o przebiegu i ewentualnych błędach.](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image1286.png?v=e2bc3da371e29c9e2432571e4f6c9853bc6936457c4b83d936c2b7dee3b94cde)

<a id="element-01a14f06-e9a7-75ab-b50d-74fce1eb528b"></a>

Po poprawnym zakończeniu synchronizacji słownik zawiera nowe wartości z pliku CSV.

<a id="element-01a14f06-e9a7-7724-ba08-1767971e9b67"></a>

![Integracje słowników: Po poprawnym zakończeniu synchronizacji słownik zawiera nowe wartości z pliku CSV.](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image1287.png?v=9b6307b1fa5746db025e59eeb1d031c37e46ebff5ee0ff1e6a4f1e1585e52a60)

<a id="element-01a14f06-e9a7-7083-8c44-77eb68cb380e"></a>

## WZORCE

<a id="element-01a14f06-e9a7-7c29-9e70-0cae5493ba14"></a>

<a id="element-01a14f06-e9a7-7e4d-9349-6157de56fe8f"></a>

Jeśli słownik zawiera wzorce, w sekcji ich konfiguracji pojawia się przycisk ![Dodaj](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image3.png?v=50654a0321a77a3b2271140f1b6a5080d18fbef92f3639b9b83ad57f0fd5735d#element-01a14f06-e9a7-7c29-9e70-0cae5493ba14).

<a id="element-01a14f06-e9a7-7b02-acea-e547ac7fb997"></a>

![Integracje słowników: Jeśli słownik zawiera wzorce, w sekcji ich konfiguracji pojawia się wskazany przycisk.](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image1279.png?v=cb6591747a9a1149531aaacecd5e084aed694e6b865cdfaf449c9ae2c40aa532)

<a id="element-01a14f06-e9a7-729c-88dc-4e6820e58763"></a>

Kliknięcie dodaje wiersz z kluczem wzorca i nazwą kolumny jego wartości. W pierwszym polu wybierz nazwę wzorca ze słownika, a w drugim podaj kolumnę pliku zawierającą importowane wartości wzorca.

<a id="element-01a14f06-e9a7-7674-adad-4ddb54cd69cb"></a>

![Integracje słowników: Kliknięcie dodaje wiersz z kluczem wzorca i nazwą kolumny jego wartości. W pierwszym polu wybierz nazwę wzorca ze słownika, a w drugim podaj kolumnę pliku zawierającą importowane wartości wzorca.](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image1280.png?v=6cecf88cfe8e0982d52b2ba5b6833592ea8319c452054ee2769d3060bee4cba8)

<a id="element-01a14f06-e9a7-7c0c-af60-6fba69e4632d"></a>

Przykładowo do słownika **HARDWARE** dodajemy wzorzec TEST PATTERN.

<a id="element-01a14f06-e9a7-7219-9b94-c8a538795bb3"></a>

![Integracje słowników: Przykładowo do słownika HARDWARE dodajemy wzorzec TEST PATTERN.](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image1289.png?v=69007fc83e6e7a75b5d4e6eae2714e741a308e15b28911b67147c8c2e6c02e08)

<a id="element-01a14f06-e9a7-72ee-b2ec-60e517a759c7"></a>

Plik CSV musi zawierać dodatkową kolumnę. Jego pierwszy wiersz może wyglądać tak:

<a id="element-01a14f06-e9a7-794e-8e01-65176cbe5cbd"></a>

key;value;positionOrder;columnPattern1

<a id="element-01a14f06-e9a7-7f11-bf75-b61ad582dc0e"></a>

Kolejne wiersze uzupełniamy jak wcześniej, dodając dane w columnPattern1. Przykładowy plik:

<a id="element-01a14f06-e9a7-77c1-b638-ca28b270a31a"></a>

- Wiersz 1: key;value;positionOrder;columnPattern1
- Wiersz 2: computer;computer;1;Pattern 1
- Wiersz 3: laptop;laptop;2;Pattern 2
- Wiersz 4: smartphone;smartphone;3;Pattern 3

<a id="element-01a14f06-e9a7-7037-93c1-0768e8301df0"></a>

Przykładowy plik powinien wyglądać jak poniżej:

<a id="element-01a14f06-e9a7-7932-8ea1-0a1b15b70d39"></a>

![Integracje słowników: Przykładowy plik powinien wyglądać jak poniżej:](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image1281.png?v=be3931d9e9417cb5948cac281301052f76596d2cc599b465b88b033cdf30517e)

<a id="element-01a14f06-e9a7-725f-8e40-fb9582929f9b"></a>

Konfiguracja powinna wyglądać następująco:

<a id="element-01a14f06-e9a7-75b1-bcf7-56fe7b2c091f"></a>

![Integracje słowników: Konfiguracja powinna wyglądać następująco:](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image1282.png?v=6b7a25f3886adf779b40f404537b4c364f8316132fe7bbef3ef8d7cbeeef9cb6)

<a id="element-01a14f06-e9a7-7bd8-a926-26907db31f27"></a>

Ustaw średnik jako separator i kliknij „Aktualizuj”, aby zapisać konfigurację.

<a id="element-01a14f06-e9a7-7120-9118-05d59e519e44"></a>

![Integracje słowników: Ustaw średnik jako separator i kliknij „Aktualizuj”, aby zapisać konfigurację.](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image1283.png?v=116875e13a5ada78f141be3441422eed9c63e433a0bb0a065017f484cf5f25c0)

<a id="element-01a14f06-e9a7-7376-90b4-8943f2ef7a20"></a>

Kliknij „Wybierz plik” i dołącz odpowiedni CSV. Synchronizacja rozpocznie się automatycznie.

<a id="element-01a14f06-e9a7-7e1f-a6e7-7031fcaeccd1"></a>

![Integracje słowników: Kliknij „Wybierz plik” i dołącz odpowiedni CSV. Synchronizacja rozpocznie się automatycznie.](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image1284.png?v=cc6a22e5abe0e60995e57ebafe4a19698b20fceeb12e9d7613d3f162c41bba6e)

<a id="element-01a14f06-e9a7-709b-becc-e43c858faddb"></a>

Postęp pobierania wartości można śledzić na bieżąco. Kliknięcie synchronizacji otwiera szczegóły przebiegu i ewentualnych błędów.

<a id="element-01a14f06-e9a7-70d5-a120-acdab66caa6a"></a>

![Integracje słowników: Postęp pobierania wartości można śledzić na bieżąco. Kliknięcie synchronizacji otwiera szczegóły przebiegu i ewentualnych błędów.](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image1285.png?v=6041f695e46306c5b8f69a8a517c7332c6d3d81d6308fc27de84c74e02490d66)

<a id="element-01a14f06-e9a7-7f3d-a5c2-3dc2ef3d10b2"></a>

![Integracje słowników: Postęp pobierania wartości można śledzić na bieżąco. Kliknięcie synchronizacji otwiera szczegóły przebiegu i ewentualnych błędów.](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image1286.png?v=e2bc3da371e29c9e2432571e4f6c9853bc6936457c4b83d936c2b7dee3b94cde)

<a id="element-01a14f06-e9a7-7a0a-98ce-89aa92c35750"></a>

Po poprawnym zakończeniu słownik zostanie zaktualizowany danymi z CSV, a pola wzorców otrzymają nowe wartości.

<a id="element-01a14f06-e9a7-78e3-a620-fb7493d7772a"></a>

![Integracje słowników: Po poprawnym zakończeniu słownik zostanie zaktualizowany danymi z CSV, a pola wzorców otrzymają nowe wartości.](https://docs.mintsd.com/pl/api/reader/assets/assets/images/image1288.png?v=a3c4f57a3a9462541951af29a2bf689187a6706aeef9d550e17bbcf12e919ecf)

