Przetwarzanie Generic XML Data Exchange (Przetwarzanie Generic Exchange Data XML)
Przetwarzanie „Uniwersalna wymiana danych w formacie XML” jest przeznaczona do ładowania i rozładowywania danych do pliku z dowolnej konfiguracji zaimplementowanej na platformie 1C:Enterprise 8.
Tryb pracy
W przypadku korzystania z formularza zarządzanego przetwarzanie ma dwa tryby działania:
1. Na kliencie. Podczas korzystania z tego trybu reguły i przesyłane pliki danych są przesyłane z klienta na serwer, a przesyłany plik danych jest przesyłany z serwera do klienta. Ścieżki do tych plików znajdujących się na kliencie muszą być określone w oknie dialogowym bezpośrednio przed wykonaniem akcji.
2. Na serwerze. W tym trybie pliki nie są przesyłane do klienta, a ścieżki do nich muszą być określone na serwerze.
Uwaga: Zewnętrzny plik przetwarzania i pliki protokołu wymiany muszą zawsze znajdować się na serwerze, niezależnie od trybu pracy.
Pobierz Universal Data Exchange w formacie XML- Tylko zarejestrowany użytkownik może pobierać pliki! 
Przetwarzanie ma cztery zakładki
Przesyłanie danych
Aby wgrać dane należy podać nazwę pliku, do którego dane będą wgrywane oraz wybrać plik reguł wymiany. Reguły wymiany dla dowolnych konfiguracji można skonfigurować w konfiguracji specjalistycznej „Konwersja danych, edycja 2”.
Aby przesłać dokumenty i zapisy niezależnych okresowych rejestrów informacyjnych, należy określić okres - „Data rozpoczęcia” i „Data zakończenia”. Otrzymany plik z przesłanymi danymi można skompresować.
Na zakładce „Reguły przesyłania danych” możesz wybrać typy obiektów, które mają być wczytane, skonfigurować filtry wyboru obiektów lub określić węzeł wymiany danych, dla którego dane mają być wgrywane.
Na karcie „Opcje przesyłania” możesz określić Dodatkowe opcje przesyłanie danych.
W zakładce „Komentarz” możesz napisać dowolny komentarz tekstowy, który zostanie dołączony do pliku wymiany.
Istnieje możliwość skonfigurowania ładowania danych w transakcjach. W tym celu zaznacz pole "Użyj transakcji" i podczas ładowania określ ilość elementów w jednej transakcji.
„Pobierz dane w trybie wymiany (DataExchange.Loading = True)” – jeżeli flaga jest ustawiona, to ładowanie obiektów będzie wykonywane z ustawionym znakiem ładowania. Oznacza to, że podczas zapisywania obiektów do bazy danych wszystkie kontrole platformy i aplikacji zostaną wyłączone. Wyjątkiem są dokumenty, które są rejestrowane w trybie księgowania lub anulowania księgowania. Księgowanie i odksięgowywanie dokumentu odbywa się zawsze bez ustawiania trybu ładowania, tj. zostaną przeprowadzone kontrole.
Dodatkowe ustawienia
Zakładka jest przeznaczona dla szczegółowe ustawienia przesyłanie i pobieranie danych.
„Tryb debugowania” – flaga do ustawienia trybu debugowania giełdy. Jeśli ta flaga jest ustawiona, to proces komunikacji nie zostanie zatrzymany w przypadku wystąpienia błędu. Wymiana zakończy się do końca wraz z wysłaniem komunikatów debugowania do pliku protokołu wymiany. Ten tryb jest zalecany do debugowania reguł wymiany.
„Wyprowadzaj komunikaty informacyjne w oknie komunikatu” – jeżeli flaga jest ustawiona, to w oknie komunikatu zostanie wyświetlony protokół procesu wymiany danych.
„Liczba przetworzonych obiektów do aktualizacji statusu” - parametr służy do określenia ilości przetworzonych elementów przed zmianą wiersza statusu załadunku/rozładunku
„Ustawienia wgrywania danych” – pozwala określić ilość elementów przetwarzanych w jednej transakcji podczas wgrywania danych, wgrywać i przetwarzać tylko te obiekty, do których posiadasz prawa dostępu, konfigurować rodzaj zmiany rejestracji dla wgrywanych obiektów poprzez plany giełdowe.
„Użyj zoptymalizowanego formatu wymiany danych (V8 - V8, wersja przetwarzania nie niższa niż 2.0.18)” – zoptymalizowany format komunikatu wymiany zakłada obecność w nagłówku komunikatu „InformationFromDataTypes”, w którym znajdują się informacje o typach danych jest rozładowany. Przyspiesza to proces ładowania danych.
„Użyj transakcji podczas przesyłania dla planów giełdowych” – flaga określa tryb wykorzystania transakcji podczas przesyłania danych podczas pobierania zmian na węzłach planu giełdowego. Jeżeli flaga jest ustawiona, to ładowanie danych zostanie wykonane w transakcji.
„Ilość elementów w transakcji” – określa maksymalny numer elementy danych, które są umieszczane w komunikacie w ramach pojedynczej transakcji bazy danych. Jeżeli wartość parametru wynosi 0 (wartość domyślna), to wszystkie dane są umieszczane w ramach jednej transakcji. Ten tryb jest zalecany, ponieważ gwarantuje spójność danych umieszczonych w wiadomości. Jednak podczas tworzenia wiadomości w trybie wielu użytkowników mogą wystąpić konflikty blokad między transakcją, która umieszcza dane w wiadomości, a transakcjami wykonywanymi przez innych użytkowników. Aby zmniejszyć prawdopodobieństwo wystąpienia takich konfliktów, możesz ustawić ten parametr na wartość inną niż wartość domyślna. Im niższa wartość parametru, tym mniejsza szansa na konflikty blokad, ale większa szansa na umieszczenie niespójnych danych w wiadomości.
„Wyładuj obiekty, dla których istnieją prawa dostępu” – jeżeli flaga jest ustawiona, to wybór obiektów infobazy będzie wykonywany z uwzględnieniem praw dostępu bieżącego użytkownika aplikacji. Wiąże się to z użyciem literału „DOZWOLONE” w treści zapytania do pobrania danych.
„Automatycznie usuwaj nieprawidłowe znaki z ciągów do zapisu do XML” – w przypadku ustawienia flagi nieprawidłowe znaki będą usuwane podczas zapisu danych w komunikacie giełdowym. Znaki są sprawdzane zgodnie z zaleceniem XML 1.0.
„Zmiany rejestracji dla węzłów giełdowych po rozładunku” – pole określa tryb pracy z rejestracją zmian danych po zakończeniu rozładunku danych. Możliwa wartość:
Nie usuwaj rejestracji - po wyładowaniu danych rejestracja zmian na węźle nie zostanie usunięta.
Całkowicie usuń rejestrację dla węzła wymiany - po wgraniu danych rejestracja zmian na węźle zostanie całkowicie usunięta.
Usuń rejestrację tylko dla wgranych metadanych – po wgraniu danych, rejestracja zmian na węźle zostanie usunięta tylko dla obiektów metadanych, które zostały wskazane do wgrania.
"Protokół wymiany" - pozwala skonfigurować wyświetlanie komunikatów informacyjnych w oknie wiadomości, utrzymywanie i rejestrowanie w oddzielny plik protokół wymiany.
„Nazwa pliku, protokół wymiany” – nazwa pliku do wyprowadzenia protokołu procesu wymiany danych.
„Protokół obciążenia (dla połączenia COM)” – nazwa pliku do wyświetlenia protokołu procesu wymiany danych w bazie odbiorczej przy wymianie przez połączenie COM. Ważne: ścieżka do pliku musi być dostępna z komputera, na którym zainstalowana jest baza docelowa.
„Dołącz dane do protokołu wymiany” – jeżeli ustawiona jest flaga, to zawartość pliku protokołu wymiany jest zapisywana, jeśli plik protokołu już istnieje.
„Wyprowadzaj komunikaty informacyjne do protokołu” – jeżeli flaga jest ustawiona, to poza komunikatami o błędach wymiany będą wysyłane komunikaty informacyjne do protokołu wymiany.
„Otwórz pliki protokołów wymiany po wykonaniu operacji” – jeżeli pole jest zaznaczone, to po zakończeniu wymiany danych pliki protokołów wymiany zostaną automatycznie otwarte do przeglądania.
Usuwanie danych
Zakładka jest potrzebna tylko twórcom reguł giełdowych. Umożliwia usuwanie dowolnych obiektów z infobazy.
Debugowanie przesyłania i pobierania danych
Przetwarzanie umożliwia debugowanie programów obsługi zdarzeń i generowanie modułu debugowania z pliku reguł lub pliku danych.
Tryb debugowania procedury obsługi wyładowania jest włączany na karcie „Przesyłanie danych”, ustawiając pole wyboru „Tryb debugowania procedury obsługi wyładowania”. W związku z tym na karcie „Ładowanie danych” tryb debugowania ładowania jest włączany przez ustawienie pola wyboru „Tryb debugowania programów obsługi ładowania”.
Po ustawieniu trybu debugowania programów obsługi przycisk ustawień debugowania stanie się dostępny. Kliknięcie tego przycisku otworzy okno ustawień.
Konfigurowanie debugowania obsługi odbywa się w czterech krokach:
Krok 1: Wybór trybu debugowania algorytmu
W pierwszym kroku musisz zdecydować się na tryb debugowania algorytmu:
Bez algorytmów debugowania
Algorytmy wywołania jako procedury
Zastąp kod algorytmów w miejscu wywołania
Pierwszy tryb jest wygodny w użyciu, gdy wiemy na pewno, że błąd w obsłudze nie jest związany z kodem żadnego algorytmu. W tym trybie kod algorytmu nie jest przesyłany do modułu debugowania. Algorytmy są wykonywane w kontekście operatora „Execute()”, a ich kod nie jest dostępny do debugowania.
Drugi tryb należy stosować w przypadkach, gdy błąd tkwi w kodzie algorytmu. Po ustawieniu tego trybu algorytmy będą rozładowywane jako oddzielne procedury. W momencie wywołania algorytmu z dowolnego modułu obsługi wywoływana jest odpowiednia procedura przetwarzania. Ten tryb jest wygodny w użyciu, gdy zmienna globalna „Parametry” jest używana do przekazywania parametrów do algorytmów. Ograniczeniem korzystania z tego trybu jest to, że podczas debugowania algorytmu zmienne lokalne procedury obsługi, z której jest on wywoływany, nie są dostępne.
Trzeci tryb debugowania jest używany, podobnie jak w drugim przypadku, podczas debugowania kodu algorytmów oraz w przypadkach, w których drugi tryb debugowania nie jest odpowiedni. Gdy ten tryb jest ustawiony, algorytmy będą rozładowywane jako zintegrowany kod w programach obsługi. Tych. zamiast operatora wywołania algorytmu wstawiany jest pełny kod algorytmu z uwzględnieniem algorytmów zagnieżdżonych. W tym trybie nie ma ograniczeń dotyczących używania lokalnych zmiennych obsługi, ale istnieje ograniczenie podczas debugowania algorytmów z wywołaniem rekurencyjnym.
Krok 2: Budowanie modułu debugowania
W drugim kroku konieczne jest wyładowanie modułów obsługi poprzez kliknięcie przycisku „Generuj moduł debugowania rozładowania (ładowania)”. Wygenerowane procedury obsługi i algorytmy zostaną wyświetlone w osobnym oknie do przeglądania. Zawartość modułu debugowania należy skopiować do schowka, klikając przycisk „Kopiuj do schowka”.
Krok 3: Tworzenie zewnętrznego przetwarzania
Na tym etapie musisz uruchomić konfigurator i utworzyć nową obróbkę zewnętrzną. Wklej zawartość schowka (modułu debugowania) do modułu przetwarzania i zapisz przetwarzanie pod dowolną nazwą.
Krok 4: Podłączanie przetwarzania zewnętrznego
W czwartym i ostatnim kroku musisz określić nazwę pliku przetwarzania zewnętrznego w polu wejściowym. W takim przypadku program sprawdza czas utworzenia (aktualizacji) pliku przetwarzania. Jeśli przetwarzanie ma więcej niż wczesna wersja niż wersja pliku modułu debugowania, zostanie wyświetlone ostrzeżenie i formularz konfiguracyjny nie zostanie zamknięty.
Uwaga: możliwość debugowania globalnej procedury obsługi konwersji „Po załadowaniu reguł giełdy” nie jest obsługiwana.
Przetwarzanie „Uniwersalna wymiana danych w formacie XML” jest przeznaczona do ładowania i rozładowywania danych do pliku z dowolnej konfiguracji zaimplementowanej na platformie 1C:Enterprise 8.
Procedura operacyjna
W przypadku korzystania z formularza zarządzanego przetwarzanie ma dwa przepływy pracy:
1. Na kliencie. Po zastosowaniu tego trybu reguły i przesyłane pliki danych zostaną przeniesione z klienta na serwer, a przesyłany plik danych zostanie przesłany z serwera do klienta. Ścieżki do tych plików znajdujących się na kliencie muszą być ustawione w oknie, które otwiera się tuż przed wykonaniem akcji.
2. Na serwerze. W tej opcji pliki nie będą przesyłane do klienta, a ścieżki do nich muszą być ustawione na serwerze.
Uwaga: Zewnętrzny plik przetwarzania i pliki protokołu wymiany muszą zawsze znajdować się na serwerze, niezależnie od trybu pracy.
Przetwarzanie ma cztery zakładki
Przesyłanie danych
Aby wgrać dane, należy zdefiniować nazwę pliku, do którego będą wgrywane dane oraz określić plik reguł wymiany. Reguły wymiany dla dowolnych konfiguracji można skonfigurować w specjalnej konfiguracji „Konwersja danych, edycja 2”.
Do załadowania dokumentów i zapisów niezależnych okresowych rejestrów informacyjnych wymagane jest określenie odstępu
- „Data rozpoczęcia” i „Data zakończenia”. Otrzymany plik z przesłanymi danymi ma możliwość kompresji.
W panelu „Reguły przesyłania danych” możesz określić typy obiektów, które należy przesłać, skonfigurować filtry wyboru obiektów lub zdefiniować węzeł wymiany danych, dla którego chcesz przesłać dane.
W panelu „Szczegóły przesyłania” istnieje możliwość zdefiniowania dodatkowych szczegółów przesyłania danych.
W panelu „Komentarz” dozwolone jest wpisanie dowolnego komentarza tekstowego, który ma być zawarty w pliku wymiany.
Aby wczytać dane, należy zdefiniować nazwę pliku, z którego będą ładowane dane.
Istnieje możliwość skonfigurowania ładowania danych w transakcjach. W tym celu należy podczas ładowania zaznaczyć flagę „Użyj transakcji” i określić liczbę elementów w jednej transakcji.
„Załaduj dane w wariancie wymiany (DataExchange.Loading = True)” – jeżeli checkbox jest zaznaczony, ładowanie obiektów zostanie wykonane z określonym znakiem obciążenia. Oznacza to, że podczas zapisywania obiektów do bazy danych wszystkie kontrole platformy i aplikacji zostaną wyłączone. Wyjątkiem są dokumenty, które są ustalone w opcji zatrzymania lub anulowania gospodarstwa. Księgowanie i anulowanie księgowania dokumentu odbywa się zawsze bez przypisywania trybu załadunku, tj. kontrole zostaną wykonane.
Dodatkowe ustawienia
Panel jest przeznaczony do szczegółowych ustawień przesyłania i pobierania danych.
„Zlecenie debugowania” – pole wyboru do ustawienia trybu debugowania giełdy. Jeżeli to pole jest zaznaczone, to mechanizm wymiany danych nie zostanie zatrzymany w przypadku wystąpienia błędu. Wymiana zakończy się do końca wraz z wysłaniem komunikatów debugowania do pliku protokołu wymiany. Ten porzadek zaleca się używać go podczas debugowania reguł wymiany.
„Wyprowadzaj komunikaty informacyjne w oknie komunikatu” – jeżeli pole jest zaznaczone, w oknie komunikatu zostanie wyświetlony protokół procesu wymiany danych.
"Liczba przetworzonych obiektów do aktualizacji statusu" - atrybut służy do obliczania ilości przetworzonych elementów przed edycją stanu załadunku/rozładunku linii
„Ustawienia wgrywania danych” - pozwalają ustawić ilość elementów przetwarzanych w jednej transakcji podczas wgrywania danych, wgrywać i przetwarzać tylko te obiekty, do których masz uprawnienia dostępu, ustawić rodzaj edycji poprawek dla wgrywanych obiektów poprzez plany wymiany.
„Użyj zoptymalizowanego formatu wymiany danych (V8 - V8, wersja przetwarzania nie niższa niż 2.0.18)” – zoptymalizowany format komunikatu wymiany zakłada obecność w nagłówku komunikatu „InformationFromDataTypes”, w którym znajdują się informacje o typach danych jest rozładowany. Pozwala to przyspieszyć mechanizm ładowania danych.
„Użyj transakcji przy wgrywaniu dla planów giełdowych” – checkbox określa kolejność stosowania transakcji przy wgrywaniu danych przy wyborze korekt na węzłach planu giełdowego. Jeżeli checkbox jest zaznaczony, to dane zostaną rozładowane w transakcji.
„Liczba elementów w transakcji” - określa maksymalną liczbę elementów danych, które mogą być umieszczone w komunikacie w granicach jednej transakcji bazy danych. Jeżeli zawartość parametru jest identyczna z wartością 0 (zawartość domyślna), to wszystkie dane znajdują się w granicach jednej transakcji. Ta kolejność jest zalecana, ponieważ gwarantuje spójność danych umieszczonych w wiadomości. Jednak przy tworzeniu komunikatu w wariancie wieloużytkownikowym mogą wystąpić konflikty blokad pomiędzy transakcją, w której dane są umieszczane w komunikacie, a transakcjami wykonywanymi przez innych użytkowników. Aby zmniejszyć możliwość takich konfliktów, dopuszczalne jest określenie wartości tego parametru innej niż wartość domyślna. Im mniejsza zawartość parametru, tym mniejsze prawdopodobieństwo wystąpienia konfliktów blokad, ale tym większe prawdopodobieństwo, że w komunikacie zostaną umieszczone niespójne dane.
„Wyładuj obiekty dla których istnieją prawa dostępu” – jeżeli checkbox jest zaznaczony, to wybór obiektów infobazy będzie dokonywany z uwzględnieniem praw dostępu ten użytkownik programy. Wiąże się to z użyciem literału „DOZWOLONE” w treści zapytania w celu pobrania danych.
„Automatycznie usuwaj nieprawidłowe znaki z ciągów do zapisu do XML” – zaznaczenie checkboxa spowoduje usunięcie nieprawidłowych znaków podczas zapisu danych do wiadomości wymiany. Znaki są analizowane zgodnie z zaleceniem XML 1.0.
„Edytuj poprawki dla węzłów wymiany po rozładowaniu” – pole określa procedurę pracy z rejestracją korekt danych po zakończeniu rozładowania danych. Prawidłowe wartości:
* Nie usuwaj rejestracji - po wgraniu danych naprawione poprawki na węźle nie zostaną usunięte.
* Całkowicie usuń rejestrację dla węzła wymiany - po wgraniu danych naprawianie korekt na węźle zostanie całkowicie usunięte.
* Usuń rejestrację tylko dla wgranych metadanych – po wgraniu danych naprawione poprawki na węźle zostaną usunięte tylko dla obiektów metadanych, które zostały ustawione do wgrania.
„Protokół wymiany” – pozwala skonfigurować wyświetlanie komunikatów informacyjnych w oknie komunikatów, obsługę i zapis w osobnym pliku protokołu wymiany.
„Nazwa pliku, protokół wymiany” - nazwa pliku do wyświetlenia protokołu procesu wymiany danych.
„Protokół pobierania (dla połączenia COM)” – nazwa pliku do wyświetlenia protokołu procesu wymiany danych w bazie odbiorczej przy wymianie przez połączenie COM. Uwaga: ścieżka do pliku musi być dostępna z komputera, na którym zdefiniowana jest baza docelowa.
„Dołącz dane do protokołu wymiany” – jeżeli pole jest zaznaczone, to zawartość pliku protokołu wymiany jest zapisywana, jeśli plik protokołu już istnieje.
„Wyślij komunikaty informacyjne do protokołu” – jeżeli pole jest zaznaczone, to w protokole wymiany będą wyświetlane komunikaty informacyjne, z wyjątkiem komunikatów o błędach wymiany.
„Otwórz pliki protokołów wymiany po wykonaniu operacji” – jeżeli pole jest zaznaczone, to po zakończeniu wymiany danych pliki protokołów wymiany zostaną automatycznie otwarte do odczytu.
Usuwanie danych
Panel potrzebny jest tylko twórcom reguł giełdowych. Umożliwia usuwanie dowolnych obiektów z infobazy.
Debugowanie przesyłania i pobierania danych
Przetwarzanie umożliwia debugowanie programów obsługi zdarzeń i generowanie modułu debugowania z pliku reguł lub pliku danych.
Tryb debugowania procedury obsługi wyładowania jest włączany w panelu „Wyładowanie danych” przez ustawienie flagi „Kolejność debugowania procedury obsługi wyładowania”. W związku z tym w panelu „Ładowanie danych” włączenie trybu debugowania ładowania odbywa się poprzez ustawienie flagi „Kolejność debugowania programów obsługi ładowania”.
Po przypisaniu trybu debugowania programów obsługi przycisk ustawień debugowania stanie się dostępny. Po kliknięciu tego przycisku pojawi się okno ustawień.
Konfigurowanie debugowania obsługi odbywa się w czterech krokach:
Krok 1: Wybór trybu debugowania algorytmu
W pierwszym kroku musisz zdecydować się na tryb debugowania algorytmu:
* Bez algorytmów debugowania
* Mechanizmy połączeń jako procedury
* Zastąp kod algorytmów w miejscu wywołania
Pierwsza kolejność jest wygodna w użyciu, gdy wiemy na pewno, że błąd w obsłudze nie jest związany z kodem żadnego algorytmu. W tym wariancie kod algorytmu nie jest wczytywany do modułu debugowania. Mechanizmy są tworzone w kontekście operatora „Execute()”, a ich kod nie jest dostępny do debugowania.
Druga kolejność musi być stosowana w sytuacjach, w których błąd znajduje się w kodzie algorytmu. Gdy ten tryb jest ustawiony, mechanizmy będą rozładowywane zgodnie z określonymi procedurami. W momencie wywołania algorytmu z dowolnego handlera następuje odwołanie do odpowiedniej procedury przetwarzania. Ta kolejność jest wygodna w użyciu, gdy zmienna globalna „Atrybuty” służy do przekazywania atrybutów do mechanizmów. Ograniczeniem korzystania z tego trybu jest to, że podczas debugowania zmienne lokalne procedury obsługi, z której jest on otwierany, nie są dostępne w algorytmie.
Trzecia kolejność debugowania jest używana, podobnie jak w drugim przypadku, podczas debugowania kodu algorytmów oraz w sytuacjach, w których druga kolejność debugowania nie jest odpowiednia. Gdy ten tryb jest ustawiony, mechanizmy zostaną rozładowane jako zintegrowany kod w procedurach obsługi. Tych. zamiast operatora wywołania algorytmu wstawiany jest pełny kod algorytmu z uwzględnieniem algorytmów zagnieżdżonych. W tej opcji nie ma ograniczeń dotyczących używania zmiennych lokalnych procedury obsługi, natomiast istnieje ograniczenie podczas debugowania algorytmów z wywołaniem rekurencyjnym.
Krok 2: Utwórz moduł debugowania
W drugim kroku musisz zwolnić programy obsługi, klikając przycisk „Generuj moduł debugowania rozładowywania (ładowania)”. Wygenerowane handlery i mechanizmy zostaną wyświetlone w osobnym oknie do czytania. Zawartość modułu debugowania należy skopiować do schowka, klikając przycisk „Kopiuj do schowka”.
Krok 3: Tworzenie zewnętrznego przetwarzania
Na tym etapie należy uruchomić konfigurator i dokonać nowo utworzonego przetwarzania zewnętrznego. W module przetwarzania należy wkleić zawartość schowka (moduł debugowania) i zapisać przetwarzanie pod dowolną nazwą.
Krok 4: Podłączanie przetwarzania zewnętrznego
W czwartym i ostatnim kroku musisz zdefiniować nazwę zewnętrznego pliku przetwarzania w polu wejściowym. Jednocześnie 1s sprawdza czas utworzenia (aktualizacji) przetwarzanego pliku. Jeśli przetwarzanie ma wcześniejszą wersję niż wersja pliku modułu debugowania, zostanie wyświetlone ostrzeżenie, a formularz konfiguracji nie zostanie zamknięty.
Uwaga: możliwość debugowania globalnej procedury obsługi konwersji „Po załadowaniu reguł giełdy” nie jest obsługiwana.
Dowolna konfiguracja zaimplementowana na platformie 1C:Enterprise 8.
Procedura operacyjna
W przypadku korzystania z formularza zarządzanego przetwarzanie ma dwa przepływy pracy:
1. Na kliencie. Po zastosowaniu tego trybu reguły i przesyłane pliki danych zostaną przeniesione z klienta na serwer, a przesyłany plik danych zostanie przesłany z serwera do klienta. Ścieżki do tych plików znajdujących się na kliencie muszą być ustawione w oknie, które otwiera się tuż przed wykonaniem akcji.
2. Na serwerze. W tej opcji pliki nie będą przesyłane do klienta, a ścieżki do nich muszą być ustawione na serwerze.
Uwaga: Zewnętrzny plik przetwarzania i pliki protokołu wymiany muszą zawsze znajdować się na serwerze, niezależnie od trybu pracy.
Przetwarzanie ma cztery zakładki
Przesyłanie danych
Aby wgrać dane, należy zdefiniować nazwę pliku, do którego będą wgrywane dane oraz określić plik reguł wymiany. Reguły wymiany dla dowolnych konfiguracji można skonfigurować w specjalnej konfiguracji „Konwersja danych, edycja 2”.
Do załadowania dokumentów i zapisów niezależnych okresowych rejestrów informacyjnych wymagane jest określenie odstępu
- „Data rozpoczęcia” i „Data zakończenia”. Otrzymany plik z przesłanymi danymi ma możliwość kompresji.
W panelu „Reguły przesyłania danych” możesz określić typy obiektów, które należy przesłać, skonfigurować filtry wyboru obiektów lub zdefiniować węzeł wymiany danych, dla którego chcesz przesłać dane.
W panelu „Szczegóły przesyłania” istnieje możliwość zdefiniowania dodatkowych szczegółów przesyłania danych.
W panelu „Komentarz” dozwolone jest wpisanie dowolnego komentarza tekstowego, który ma być zawarty w pliku wymiany.
Aby wczytać dane, należy zdefiniować nazwę pliku, z którego będą ładowane dane.
Istnieje możliwość skonfigurowania ładowania danych w transakcjach. W tym celu należy podczas ładowania zaznaczyć flagę „Użyj transakcji” i określić liczbę elementów w jednej transakcji.
„Załaduj dane w wariancie wymiany (DataExchange.Loading = True)” – jeżeli checkbox jest zaznaczony, ładowanie obiektów zostanie wykonane z określonym znakiem obciążenia. Oznacza to, że podczas zapisywania obiektów do bazy danych wszystkie kontrole platformy i aplikacji zostaną wyłączone. Wyjątkiem są dokumenty, które są ustalone w opcji zatrzymania lub anulowania gospodarstwa. Księgowanie i anulowanie księgowania dokumentu odbywa się zawsze bez przypisywania trybu załadunku, tj. kontrole zostaną wykonane.
Dodatkowe ustawienia
Panel jest przeznaczony do szczegółowych ustawień przesyłania i pobierania danych.
„Zlecenie debugowania” – pole wyboru do ustawienia trybu debugowania giełdy. Jeżeli to pole jest zaznaczone, to mechanizm wymiany danych nie zostanie zatrzymany w przypadku wystąpienia błędu. Wymiana zakończy się do końca wraz z wysłaniem komunikatów debugowania do pliku protokołu wymiany. Ta kolejność jest zalecana do debugowania reguł wymiany.
„Wyprowadzaj komunikaty informacyjne w oknie komunikatu” – jeżeli pole jest zaznaczone, w oknie komunikatu zostanie wyświetlony protokół procesu wymiany danych.
"Liczba przetworzonych obiektów do aktualizacji statusu" - atrybut służy do obliczania ilości przetworzonych elementów przed edycją stanu załadunku/rozładunku linii
„Ustawienia wgrywania danych” - pozwalają ustawić ilość elementów przetwarzanych w jednej transakcji podczas wgrywania danych, wgrywać i przetwarzać tylko te obiekty, do których masz uprawnienia dostępu, ustawić rodzaj edycji poprawek dla wgrywanych obiektów poprzez plany wymiany.
„Użyj zoptymalizowanego formatu wymiany danych (V8 - V8, wersja przetwarzania nie niższa niż 2.0.18)” – zoptymalizowany format komunikatu wymiany zakłada obecność w nagłówku komunikatu „InformationFromDataTypes”, w którym znajdują się informacje o typach danych jest rozładowany. Pozwala to przyspieszyć mechanizm ładowania danych.
„Użyj transakcji przy wgrywaniu dla planów giełdowych” – checkbox określa kolejność stosowania transakcji przy wgrywaniu danych przy wyborze korekt na węzłach planu giełdowego. Jeżeli checkbox jest zaznaczony, to dane zostaną rozładowane w transakcji.
„Liczba elementów w transakcji” - określa maksymalną liczbę elementów danych, które mogą być umieszczone w komunikacie w granicach jednej transakcji bazy danych. Jeżeli zawartość parametru jest identyczna z wartością 0 (zawartość domyślna), to wszystkie dane znajdują się w granicach jednej transakcji. Ta kolejność jest zalecana, ponieważ gwarantuje spójność danych umieszczonych w wiadomości. Jednak przy tworzeniu komunikatu w wariancie wieloużytkownikowym mogą wystąpić konflikty blokad pomiędzy transakcją, w której dane są umieszczane w komunikacie, a transakcjami wykonywanymi przez innych użytkowników. Aby zmniejszyć możliwość takich konfliktów, dopuszczalne jest określenie wartości tego parametru innej niż wartość domyślna. Im mniejsza zawartość parametru, tym mniejsze prawdopodobieństwo wystąpienia konfliktów blokad, ale tym większe prawdopodobieństwo, że w komunikacie zostaną umieszczone niespójne dane.
„Wyładuj obiekty, dla których istnieją prawa dostępu” – jeżeli checkbox jest zaznaczony, to wybór obiektów infobazy będzie wykonywany z uwzględnieniem praw dostępu danego użytkownika aplikacji. Wiąże się to z użyciem literału „DOZWOLONE” w treści zapytania w celu pobrania danych.
„Automatycznie usuwaj nieprawidłowe znaki z ciągów do zapisu do XML” – zaznaczenie checkboxa spowoduje usunięcie nieprawidłowych znaków podczas zapisu danych do wiadomości wymiany. Znaki są analizowane zgodnie z zaleceniem XML 1.0.
„Edytuj poprawki dla węzłów wymiany po rozładowaniu” – pole określa procedurę pracy z rejestracją korekt danych po zakończeniu rozładowania danych. Prawidłowe wartości:
* Nie usuwaj rejestracji - po wgraniu danych naprawione poprawki na węźle nie zostaną usunięte.
* Całkowicie usuń rejestrację dla węzła wymiany - po wgraniu danych naprawianie korekt na węźle zostanie całkowicie usunięte.
* Usuń rejestrację tylko dla wgranych metadanych – po wgraniu danych naprawione poprawki na węźle zostaną usunięte tylko dla obiektów metadanych, które zostały ustawione do wgrania.
„Protokół wymiany” – pozwala skonfigurować wyświetlanie komunikatów informacyjnych w oknie komunikatów, obsługę i zapis w osobnym pliku protokołu wymiany.
„Nazwa pliku, protokół wymiany” - nazwa pliku do wyświetlenia protokołu procesu wymiany danych.
„Protokół pobierania (dla połączenia COM)” – nazwa pliku do wyświetlenia protokołu procesu wymiany danych w bazie odbiorczej przy wymianie przez połączenie COM. Uwaga: ścieżka do pliku musi być dostępna z komputera, na którym zdefiniowana jest baza docelowa.
„Dołącz dane do protokołu wymiany” – jeżeli pole jest zaznaczone, to zawartość pliku protokołu wymiany jest zapisywana, jeśli plik protokołu już istnieje.
„Wyślij komunikaty informacyjne do protokołu” – jeżeli pole jest zaznaczone, to w protokole wymiany będą wyświetlane komunikaty informacyjne, z wyjątkiem komunikatów o błędach wymiany.
„Otwórz pliki protokołów wymiany po wykonaniu operacji” – jeżeli pole jest zaznaczone, to po zakończeniu wymiany danych pliki protokołów wymiany zostaną automatycznie otwarte do odczytu.
Usuwanie danych
Panel potrzebny jest tylko twórcom reguł giełdowych. Umożliwia usuwanie dowolnych obiektów z infobazy.
Debugowanie przesyłania i pobierania danych
Przetwarzanie umożliwia debugowanie programów obsługi zdarzeń i generowanie modułu debugowania z pliku reguł lub pliku danych.
Tryb debugowania procedury obsługi wyładowania jest włączany w panelu „Wyładowanie danych” przez ustawienie flagi „Kolejność debugowania procedury obsługi wyładowania”. W związku z tym w panelu „Ładowanie danych” włączenie trybu debugowania ładowania odbywa się poprzez ustawienie flagi „Kolejność debugowania programów obsługi ładowania”.
Po przypisaniu trybu debugowania programów obsługi przycisk ustawień debugowania stanie się dostępny. Po kliknięciu tego przycisku pojawi się okno ustawień.
Konfigurowanie debugowania obsługi odbywa się w czterech krokach:
Krok 1: Wybór trybu debugowania algorytmu
W pierwszym kroku musisz zdecydować się na tryb debugowania algorytmu:
* Bez algorytmów debugowania
* Mechanizmy połączeń jako procedury
* Zastąp kod algorytmów w miejscu wywołania
Pierwsza kolejność jest wygodna w użyciu, gdy wiemy na pewno, że błąd w obsłudze nie jest związany z kodem żadnego algorytmu. W tym wariancie kod algorytmu nie jest wczytywany do modułu debugowania. Mechanizmy są tworzone w kontekście operatora „Execute()”, a ich kod nie jest dostępny do debugowania.
Druga kolejność musi być stosowana w sytuacjach, w których błąd znajduje się w kodzie algorytmu. Gdy ten tryb jest ustawiony, mechanizmy będą rozładowywane zgodnie z określonymi procedurami. W momencie wywołania algorytmu z dowolnego handlera następuje odwołanie do odpowiedniej procedury przetwarzania. Ta kolejność jest wygodna w użyciu, gdy zmienna globalna „Atrybuty” służy do przekazywania atrybutów do mechanizmów. Ograniczeniem korzystania z tego trybu jest to, że podczas debugowania zmienne lokalne procedury obsługi, z której jest on otwierany, nie są dostępne w algorytmie.
Trzecia kolejność debugowania jest używana, podobnie jak w drugim przypadku, podczas debugowania kodu algorytmów oraz w sytuacjach, w których druga kolejność debugowania nie jest odpowiednia. Gdy ten tryb jest ustawiony, mechanizmy zostaną rozładowane jako zintegrowany kod w procedurach obsługi. Tych. zamiast operatora wywołania algorytmu wstawiany jest pełny kod algorytmu z uwzględnieniem algorytmów zagnieżdżonych. W tej opcji nie ma ograniczeń dotyczących używania zmiennych lokalnych procedury obsługi, natomiast istnieje ograniczenie podczas debugowania algorytmów z wywołaniem rekurencyjnym.
Krok 2: Utwórz moduł debugowania
W drugim kroku musisz zwolnić programy obsługi, klikając przycisk „Generuj moduł debugowania rozładowywania (ładowania)”. Wygenerowane handlery i mechanizmy zostaną wyświetlone w osobnym oknie do czytania. Zawartość modułu debugowania należy skopiować do schowka, klikając przycisk „Kopiuj do schowka”.
Krok 3: Tworzenie zewnętrznego przetwarzania
Na tym etapie należy uruchomić konfigurator i dokonać nowo utworzonego przetwarzania zewnętrznego. W module przetwarzania należy wkleić zawartość schowka (moduł debugowania) i zapisać przetwarzanie pod dowolną nazwą.
Krok 4: Podłączanie przetwarzania zewnętrznego
W czwartym i ostatnim kroku musisz zdefiniować nazwę zewnętrznego pliku przetwarzania w polu wejściowym. Jednocześnie 1s sprawdza czas utworzenia (aktualizacji) przetwarzanego pliku. Jeśli przetwarzanie ma wcześniejszą wersję niż wersja pliku modułu debugowania, zostanie wyświetlone ostrzeżenie, a formularz konfiguracji nie zostanie zamknięty.
Uwaga: możliwość debugowania globalnej procedury obsługi konwersji „Po załadowaniu reguł giełdy” nie jest obsługiwana.
Przetwarzanie „Uniwersalna wymiana danych w formacie XML” służy do ładowania i rozładowywania danych do pliku z dowolnej konfiguracji zaimplementowanej na platformie 1C:Enterprise 8
Przetwarzanie ma cztery zakładki
Przesyłanie danych
Aby wgrać dane należy podać nazwę pliku, do którego dane będą wgrywane oraz wybrać plik reguł wymiany. Reguły wymiany dla dowolnych konfiguracji można skonfigurować w konfiguracji specjalistycznej „Konwersja danych, edycja 2”.
Aby przesłać dokumenty i zapisy niezależnych okresowych rejestrów informacyjnych, należy określić okres - „Data rozpoczęcia” i „Data zakończenia”. Otrzymany plik z przesłanymi danymi można skompresować.
Na zakładce „Reguły przesyłania danych” możesz wybrać typy obiektów, które mają być wczytane, skonfigurować filtry wyboru obiektów lub określić węzeł wymiany danych, dla którego dane mają być wgrywane.
Na karcie „Opcje przesyłania” możesz określić dodatkowe opcje przesyłania danych.
W zakładce „Komentarz” możesz napisać dowolny komentarz tekstowy, który zostanie dołączony do pliku wymiany.
Aby wczytać dane, należy podać nazwę pliku, z którego zostaną wczytane dane.
Istnieje możliwość skonfigurowania ładowania danych w transakcjach. W tym celu zaznacz pole "Użyj transakcji" i podczas ładowania określ ilość elementów w jednej transakcji.
Dodatkowe ustawienia
Zakładka jest przeznaczona dla strojenie przesyłanie i pobieranie danych.
„Tryb debugowania” – pole wyboru określa tryb rozładowywania i ładowania danych
„Liczba przetworzonych obiektów do aktualizacji statusu” - parametr służy do określenia ilości przetworzonych elementów przed zmianą linii statusu załadunku/rozładunku
„Ustawienia wgrywania danych” - pozwalają określić ilość elementów przetwarzanych w jednej transakcji podczas wgrywania danych, wgrywania i przetwarzania tylko tych obiektów, do których posiadasz prawa dostępu, konfiguruje rodzaj zmiany rejestracji dla wgrywanych obiektów poprzez plany giełdowe
„Protokół wymiany” – pozwala skonfigurować wyświetlanie komunikatów informacyjnych w oknie komunikatów, obsługę i zapis w osobnym pliku protokołu wymiany.
Usuwanie danych
Zakładka jest potrzebna tylko twórcom reguł giełdowych. Umożliwia usuwanie dowolnych obiektów z infobazy.
Debugowanie przesyłania i pobierania danych
Przetwarzanie umożliwia debugowanie programów obsługi zdarzeń i generowanie modułu debugowania z pliku reguł lub pliku danych.
Tryb debugowania procedury obsługi wyładowania jest włączany na karcie „Przesyłanie danych”, ustawiając pole wyboru „Tryb debugowania procedury obsługi wyładowania”. W związku z tym na karcie „Ładowanie danych” tryb debugowania ładowania jest włączany przez ustawienie pola wyboru „Tryb debugowania programów obsługi ładowania”.
Po ustawieniu trybu debugowania programów obsługi przycisk ustawień debugowania stanie się dostępny. Kliknięcie tego przycisku otworzy okno ustawień.
Konfigurowanie debugowania obsługi odbywa się w czterech krokach:
Krok 1: Wybór trybu debugowania algorytmu
W pierwszym kroku musisz zdecydować się na tryb debugowania algorytmu:
Bez algorytmy debugowania
Algorytmy wywołania jako procedury
Zastąp kod algorytmów w miejscu wywołania
Pierwszy tryb jest wygodny w użyciu, gdy wiemy na pewno, że błąd w obsłudze nie jest związany z kodem żadnego algorytmu. W tym trybie kod algorytmu nie jest przesyłany do modułu debugowania. Algorytmy są wykonywane w kontekście operatora „Execute()”, a ich kod nie jest dostępny do debugowania.
Drugi tryb należy stosować w przypadkach, gdy błąd tkwi w kodzie algorytmu. Po ustawieniu tego trybu algorytmy będą rozładowywane jako oddzielne procedury. W momencie wywołania algorytmu z dowolnego modułu obsługi wywoływana jest odpowiednia procedura przetwarzania. Ten tryb jest wygodny w użyciu, gdy zmienna globalna „Parametry” jest używana do przekazywania parametrów do algorytmów. Ograniczeniem korzystania z tego trybu jest to, że podczas debugowania algorytmu zmienne lokalne procedury obsługi, z której jest on wywoływany, nie są dostępne.
Trzeci tryb debugowania jest używany, podobnie jak w drugim przypadku, podczas debugowania kodu algorytmów oraz w przypadkach, w których drugi tryb debugowania nie jest odpowiedni. Gdy ten tryb jest ustawiony, algorytmy będą rozładowywane jako zintegrowany kod w programach obsługi. Tych. zamiast operatora wywołania algorytmu wstawiany jest pełny kod algorytmu z uwzględnieniem algorytmów zagnieżdżonych. W tym trybie nie ma ograniczeń dotyczących używania lokalnych zmiennych obsługi, ale istnieje ograniczenie podczas debugowania algorytmów z wywołaniem rekurencyjnym.
Krok 2: Budowanie modułu debugowania
W drugim kroku konieczne jest wyładowanie modułów obsługi poprzez kliknięcie przycisku „Generuj moduł debugowania rozładowania (ładowania)”. Wygenerowane procedury obsługi i algorytmy zostaną wyświetlone w osobnym oknie do przeglądania. Zawartość modułu debugowania należy skopiować do schowka, klikając przycisk „Kopiuj do schowka”.
Krok 3: Tworzenie zewnętrznego przetwarzania
Na tym etapie musisz uruchomić konfigurator i utworzyć nową obróbkę zewnętrzną. Wklej zawartość schowka (modułu debugowania) do modułu przetwarzania i zapisz przetwarzanie pod dowolną nazwą.
Krok 4: Podłączanie przetwarzania zewnętrznego
W czwartym i ostatnim kroku musisz określić nazwę pliku przetwarzania zewnętrznego w polu wejściowym. W takim przypadku program sprawdza czas utworzenia (aktualizacji) pliku przetwarzania. Jeśli przetwarzanie ma wcześniejszą wersję niż wersja pliku modułu debugowania, zostanie wyświetlone ostrzeżenie, a formularz konfiguracji nie zostanie zamknięty.
Uwaga: możliwość debugowania globalnej procedury obsługi konwersji „Po załadowaniu reguł giełdy” nie jest obsługiwana.
