Handel - Objekty predefiniowane > IORec - obiekt predefiniowany | | Drukuj |
Jest to definicja obiektu przeznaczonego do przechowywania danych podczas wykonywania raportów. Obiekt składa się z sekcji i pól. Sekcje mogą być zagnieżdżone, tzn. dopuszczalne jest tworzenie sekcji wewnątrz innych sekcji. Pole zawsze znajduje się wewnątrz pewnej sekcji i może zawierać dowolną wartość typu String. Sekcje i pola identyfikowane są poprzez nazwę. Zdefiniowany został zbiór metod tworzących interfejs pozwalający na operowanie na sekcjach i polach obiektu. Definicja interfejsu przedstawiona jest poniżej.
Korzystając z dostępnego interfejsu można używać obiektu IORec do przechowywania dowolnych danych. Nie ma ograniczeń jego wielkości (w granicach określonych przez system operacyjny).
Atrybuty
Brak stałych atrybutów. Struktura przechowywanych danych jest definiowana dla każdego przypadku użycia.
Metody
Tworzy sekcję o podanej nazwie i ustawia ją jako bieżącą.
Składnia BeginSection (String nazwa)
Argumenty
|
Kończy bieżącą sekcję. Sekcją bieżącą zostaje sekcja bezpośrednio nadrzędna względem zakończonej.
Składnia EndSection( )
Argumenty Brak. |
Ustawia jako bieżącą kolejną sekcję (lub podsekcję). Zwraca 1 po ustawieniu kolejnej sekcji lub 0, jeżeli nie ma kolejnej sekcji.
Składnia Long NextSection( )
Argumenty Brak. |
Zwraca nazwę bieżącej sekcji.
Składnia String GetSectionName( )
Argumenty Brak. |
Ustawia jako bieżącą pierwszą znalezioną sekcję o podanej jako argument nazwie. Przeszukiwanie rozpoczyna od sekcji głównej. Zwraca 1 po znalezieniu sekcji lub 0, jeżeli nie ma (nie znaleziono) sekcji o takiej nazwie.
Składnia Long SetAtSection (String nazwa)
Argumenty
|
Nadaje polu nazwa_p w bieżącej sekcji wartość wartosc_p. Jeżeli pole nie istnieje to jest tworzone.
Składnia SetField (String nazwa_p, String wartosc_p)
Argumenty |
Oczytuje wartość pola nazwa_p w bieżącej sekcji. Jeżeli pole nie istnieje zwraca pusty string.
Składnia GetField (String nazwa_p)
Argumenty
|
Ustawia następne pole w sekcji jako bieżące. Zwraca 1 po ustawieniu kolejnego pola lub 0, jeżeli nie ma kolejnego pola.
Składnia Long NextField( )
Argumenty Brak. |
Odczytuje nazwę bieżącego pola.
Składnia String GetFieldName( )
Argumenty Brak. |
Odczytuje wartość bieżącego pola.
Składnia String GetFieldValue( )
Argumenty Brak. |
Usuwa wszystkie dane sekcji i pól obiektu.
Składnia Clear( )
Argumenty Brak. |
Ustawia sekcję główną jako bieżącą.
Składnia SetAtFirst( )
Argumenty Brak. |
Odczytuje poziom zagnieżdżenia bieżącej sekcji, tzn. ilość sekcji nadrzędnych znajdujących się nad nią. 0 oznacza poziom sekcji głównej.
Składnia Long GetLevel( )
Argumenty Brak. |
Obiekt posiada również dodatkowe metody wykorzystywane do importu dokumentów:
Tworzy dokument magazynowy, którego dane zawarte są w objekcie IORec. Zwraca identyfikator utworzonego dokumentu lub 0, jeżeli dokument nie został utworzony.
Składnia Long ImportMG( )
Argumenty Brak. |
Tworzy dokument sprzedaży, którego dane zawarte są w objekcie IORec. Zwraca identyfikator utworzonego dokumentu lub 0, jeżeli dokument nie został utworzony.
Składnia Long ImportSP( )
Argumenty Brak. |
Tworzy dokument zakupu, którego dane zawarte są w objekcie IORec. Zwraca identyfikator utworzonego dokumentu lub 0, jeżeli dokument nie został utworzony.
Składnia Long ImportZK( )
Argumenty Brak. |
Tworzy dokument zamówienia obcego, którego dane zawarte są w objekcie IORec. Zwraca identyfikator utworzonego dokumentu lub 0, jeżeli dokument nie został utworzony.
Składnia Long ImportZO( )
Argumenty Brak. |
Tworzy dokument zamówienia własnego, którego dane zawarte są w objekcie IORec. Zwraca identyfikator utworzonego dokumentu lub 0, jeżeli dokument nie został utworzony.
Składnia Long ImportZW( )
Argumenty Brak. |