Konwerter składni komend TABLES i IGRAPH

Jeśli użytkownik posiada pliki składni komend zawierające składnię TABLES, które mają zostać konwertowane na składnię CTABLES, i/lub IGRAPH, które mają zostać konwertowane na składnię GGRAPH, proste program narzędziowy pomaga rozpocząć proces konwersji. Istnieją jednak znaczne różnice funkcjonalne pomiędzy składniami TABLES i CTABLES oraz IGRAPH i GGRAPH. Możliwe jest, że program narzędziowy nie będzie mógł konwertować niektórych zadań składni TABLES i IGRAPH lub może wygenerować składnię CTABLES i GGRAPH, która sprawia, że tabele i wykresy nie przypominają dokładnie oryginalnych elementów wygenerowanych za pomocą komend TABLES i IGRAPH. W przypadku większości tabel można edytować skonwertowaną składnię, aby utworzyć tabelę, która przypomina oryginał.

Program narzędziowy jest przeznaczony do następujących celów:

  • Tworzenie nowego pliku składni z istniejącego pliku składni. Oryginalny plik składni nie zostaje zmieniony.
  • Konwertowanie tylko komend TABLES i IGRAPH w pliku składni. Inne komendy w pliku nie zostają zmienione.
  • Zachowanie oryginalnej składni TABLES i IGRAPH w postaci skomentowanej.
  • Oznaczanie początku i końca każdego bloku konwersji za pomocą komentarzy.
  • Oznaczanie składni komend TABLES i IGRAPH, których nie udało się skonwertować.
  • Konwertowanie plików składni komend, które są zgodne z regułami składniowymi w trybie interaktywnym lub produkcyjnym.

To narzędzie nie może dokonać konwersji komend, które zawierają błędy. Obowiązują również następujące ograniczenia.

Ograniczenia komend TABLES

Program narzędziowy może w niektórych sytuacjach skonwertować komendy TABLES nieprawidłowo; obejmuje to komendy TABLES, które zawierają:

  • Nazwy zmiennych umieszczone w nawiasach, rozpoczynające się literami "sta" lub "lab" w opcji komendy TABLES, jeśli sama zmienna jest umieszczona w nawiasie — na przykład var1 by (statvar) by (labvar). Takie nazwy zmiennych zostaną zinterpretowane jako słowa kluczowe (STATISTICS) i (LABELS).
  • Opcje komend SORT, wykorzystujące skróty A lub D w celu oznaczenia rosnącego lub malejącego porządku sortowania. Będą one interpretowane jako nazwy zmiennych.

Program narzędziowy nie może skonwertować komend TABLES, które zawierają:

  • Błędy składniowe.
  • Opcje komend OBSERVATION, które odwołują się do zakresu zmiennych wykorzystujących słowo kluczowe TO (na przykład var01 TO var05).
  • Literały łańcuchowe podzielone na segmenty rozdzielone znakiem plus (na przykład TITLE "My" + "Title").
  • Wywołań makr, które w razie braku rozwinięcia makra byłyby nieprawidłową składnią TABLES. Ponieważ konwerter nie rozwija wywołań makro, traktuje je tak, jakby były po prostu częścią standardowej składni TABLES.

Program narzędziowy nie konwertuje komend TABLES zawartych w makrach. Proces konwersji nie wpływa na żadne makra.

Ograniczenia komend IGRAPH

IGRAPH uległ istotnym zmianom w wydaniu 16. Z uwagi na te zmiany niektóre podkomendy i słowa kluczowe w składni IGRAPH utworzone przed tym wydaniem mogą nie być honorowane.

Program narzędziowy do konwersji może generować dodatkową składnię, którą przechowuje w słowie kluczowym INLINETEMPLATE w składni GGRAPH . Słowo kluczowe jest tworzone przez program konwersji. Jego składnia nie jest przeznaczona do edycji przez użytkownika.

Używanie programu narzędziowego do konwersji

Program narzędziowy do konwersji, SyntaxConverter.exe, można znaleźć w katalogu instalacyjnym. Należy go uruchamiać w wierszu komend (po znaku zachęty). Ogólna postać komendy to:


syntaxconverter.exe [path]/inputfilename.sps [path]/outputfilename.sps

Należy uruchomić tę komendę z katalogu instalacyjnego.

Jeśli nazwy katalogów zawierają spacje, należy całą ścieżkę i nazwę pliku ująć w cudzysłów, np.


syntaxconverter.exe /myfiles/oldfile.sps "/new files/newfile.sps"

Reguły składni komend w trybie interaktywnym i produkcyjnym

Program narzędziowy do konwersji może przekształcać pliki komend, które wykorzystują reguły składniowe trybu interaktywnego lub produkcyjnego.

Interaktywne. Reguły składniowe trybu interaktywnego są następujące:

  • Każda komenda zaczyna się w nowym wierszu.
  • Każda komenda kończy się kropką (.).

Tryb produkcyjny. Program Production Facility i komendy w plikach, do których dostęp jest uzyskiwany za pomocą komendy INCLUDE w innym pliku komendy, wykorzystują reguły składniowe trybu produkcyjnego:

  • Każda komenda musi się rozpoczynać w pierwszej kolumnie nowego wiersza.
  • Wiersze kontynuacji muszą być wcięte na co najmniej jedną spację.
  • Zakończenie komendy kropką jest opcjonalne.

Jeśli w używanych plikach komend stosowane są reguły składni trybu produkcyjnego i na końcu komendy nie występuje kropka, należy użyć przełącznika -b (lub /b) wiersza komend podczas uruchamiania programu SyntaxConverter.exe, np.:


syntaxconverter.exe -b /myfiles/oldfile.sps /myfiles/newfile.sps

Skrypt SyntaxConverter (tylko w systemie Windows)

W systemie Windows konwerter składni można także uruchomić za pomocą skryptu SyntaxConverter.wwd, który znajduje się w katalogu Samples w katalogu instalacyjnym.

  1. Z menu wybierz:

    Narzędzia > Uruchom skrypt ...

  2. Należy w tym celu przejść do katalogu Samples i wybrać plik SyntaxConverter.wwd.

Spowoduje to otwarcie prostego okna dialogowego, w którym można określić nazwy oraz lokalizacje starych i nowych plików składni komend.