Oc

Aus OrgaMon Wiki
Zur Navigation springen Zur Suche springen

Oc steht für Orientation Convert. Es ist ein Open-Source Tool, das Daten in horizontaler Ausrichtung (z.B. ein Text) in vertikale Spalten ausrichtet. Auch die Übertragung von einzelnen xls Spalten in andere ist möglich. ".txt", ".csv" und ".xls" wird nativ unterstützt.

Download

Die Open-Source Anwendung incl. Quelltexte kann man hier downloaden:

http://cargobay.orgamon.de/Oc.html

.txt nach .xls Konverter

Quelle ".txt": Trenner ist hier " - "

.xls nach .xml Konverter

ohne Vorlage.ml

in diesem Modus wird aus einem Auftrag (EXPORT*.xml) und einer Ergebnis xls-Datei eine xml-Datei erzeugt.

mit Vorlage.ml

das XML-Gerüst wird in der Vorlage.ml gespeichert. Mit 

~VariablenName~[ { "!" ["Komma", "Boolean", "Null8", "Zeit", "^Y"] }

können Werte in dieses Gerüst eingesetzt werden. Der Wert für VariablenName wird aus der Spaltenüberschrift "VaraiblenName" entnommen.

  • !1 nur der erste Teil einer ","-speparierten Liste
  • !Komma eine Zahl wird immer als ISO-Kommazahl ausgegeben (mit "." als Komma Symbol)
  • !EchtesKomma eine Zahl wird immer als deutsche Kommazahl ausgegeben (mit "," als Komma Symbol)
  • !Boolean eines aus 'xXyYjJ1' wird in true umgesetzt, Rest in false
  • !Null8 Zahl wird immer 8 stellig ausgegebn, ggf wird mit führenden '0'en aufgefüllt
  • !Zeit Zeitangabe wird als HH:MM:SS ausgegeben
  • !ZeitDefault wie Zeit, jedoch wenn keine Zeit angegeben ist wird 12:00:00 ausgegeben
  • !^Y Zeile wird gelöscht sobald der Variablenwert leer ist


Eine Datei Schema.xsd kann zur Schema-Prüfung bereitgestellte werden.

.xls nach .csv Konverter

Die Quelle ist dabei eine ".xls"-Datei. Dieser Modus wird über das Kontextmenü im Windows Explorer angesprochen, sobald man die Menü-Option "speichern als csv" auswählt. csv ist eine Semikolon (in USA "comma separated values") separierte Textdatei und in der Weiterverarbeitung (automatisierter Import) usw. leicht zu handhaben.

Fixed-Formats.ini

  • Durch die Konfigurationsdatei "Fixed-Formats.ini" kann Oc gezwungen werden, einzelne Spalten vor Ausgabe in die csv-Datei in ein Sonderformat zu konvertieren. Im Moment sind folgende Sonderformate konfiguriert:

Parameter

// Legt das Trennungszeichen fest, das in der 
// Datei verwendet wird.
//
// default = ;
Separator=|   

// Kann die Ausgabe der ersten Zeile (oft Kopfzeile) verhindern
// 
// default = NEIN
NoHeader=JA

// Kann die Ausgabe ab einer bestimmten Spalte stoppen
//
// default = Unbegrenzt
MaxColumn=76

Feld-Formatierungen

  • Ausgabe mit 5 Nachkommastellen und "." als Komma

 <Feldname1>=#.#####
 <Feldname2>=#.#####

  • Ausgabe mit führenden Nullen auffüllen

// n gibt als Ganzzahl die Gesamtlänge an
<Feldname1>=0n


  • Datum in ein gewisses Format zwingen

<Feldname1>=TTMMJJ

  • Länge eines Feldes beschränken

 "Max"<Feldname1>=4

  • Wert aus einer anderen Spalte holen, falls eigener Inhalt leer

"Alternative_"<Feldname1>=<Feldname2>

Beispiel

ZaehlerStandNeu=#.#####
ZaehlerStandAlt=#.#####

Feld-Konstanten

Unabhängig vom Quell-Wert kann direkt eine Konstante in eine Spalte ausgegeben werden. Vor die Konstante muss das Zeichen "'" gesetzt werden.

FeldName='0815


Feld-Filter

  • damit können unerwünschte Zeichen aus Feldinhalten entfernt werden ("+" Filter).

FeldName=+G-

  • alternativ können Feldinhalte auf einen genau bezeichneten Zeichvorrat beschränkt werden ("-" Filter).

FeldName=-0123456789


Felder zusammenfügen

  • Verbinden von benachbarten Spalten
  • Durch Angabe einer Spaltennummer kann der Feldtrenner, der die beiden Benachbarten Spalten trennt unterdrückt werden. Dadurch werden benachbarte Spalten zu einer Spalte zusammengefügt
  • Die Angabe der Spaltennummern, die verbunden werden sollen muss 3 stellig erfolgen, die erste Spalte hat Nummer 000
  • ACHTUNG: Pro Nummer werden 2 Spalten zusammengefügt
  • ACHTUNG: Es verschiebt sich nach hinten nichts, also immer die Spaltennummern aus Sicht der Original-Datei vergeben

JoinColumn=NNN,NNN,NNN ...

xls Umsetzer mit Vorlage.xls

Oc kann dazu dienen einzelne Datenspalten aus einer XLS Quelle in eine neues XLS-Dokument zu kopieren. Dabei kann Oc folgende Operationen ausführen:

  • es können XLS Spalten in eine andere Reihenfolge gebracht werden
  • es können Spalten weggelassen werden
  • es können andere oder keine Spaltenüberschriften verwendet werden
  • es können mehrzeilige Spaltenüberschriften verwendet werden

Funktionsweise

Die Quelldatei "Namen.xls" muss Spaltenüberschriften in der ersten Zeile haben. Diese Spaltenüberschriften haben eine zentrale Funktion in der Vorlage.xls. Die Vorlage.xls beschreibt Reihenfolge und Umfang aller einzelnen Spalten.

  • In der ersten Zeile der Vorlage werden die zukünftigen Spaltenüberschriften angegeben, diese können völlig anders lauten als die der Quelldatei. Diese Zeile kann auch entfallen.
  • Die 2. Zeile ist eine Beispielzeile in der für jede Zelle eine passendes Format eingerichtet werden sollte. Das Format jeder einzelnen Zelle wird in die Datenspalte der Ausgabe übernommen.
  • Die 3. Zeile enthält nun die Spaltenüberschriften der Quell-Datei. Dadurch können Sie per Querverweis angeben welche Datenspalte an diese Stelle eingesetzt werden soll. Neben der 1:1 Übernahme von Spalten können auch z.B. feste Werte übernommen werden.


Es folgen die Möglichkeiten im Einzelnen:

Spalte an dieser Stelle wird der Wert von Spalte übernommen.
>externe Spalte verwende die referenzierte Spalte aus einem Nachschlagewerk.
"Text oder \Text in jede Zelle wird der konstante Wert Text übernommen.
.1.Spalte ersten Teil der Spalte bis zum ersten Leerzeichen (" ") bzw. Zeitstempeltrenner (" - ").
.2.Spalte zweiten Teil der Spalte nach dem ersten Leerzeichen (" ") bzw. Zeitstempeltrenner (" - ").
.+.Spalte1.Spalte2 Werte aus beiden Spalten.
.*.Spalte1.Spalte2 Entweder Spalte A wenn B = X ist.
.j X wird in j, leer wird in n umgesetzt.
.ja X wird in ja, leer wird in nein umgesetzt.
.J echte JA/NEIN umsetzung.
.t (Transaktionen) mit bisher 2 Funktionen: ISL1 und ISL2.
.l. (Logik) "(".Spalte.["und"|"oder"|"nicht"].Spalte.")"
.komma. Die Zahl wird immer mit einer Nachkommastelle angegeben
.zeit. Die Uhrzeit wird immer im Format HH:MM angegeben

Möglichkeiten bei Spaltenangaben

Spalte1 = SpaltenName | "Konstanter Wert | \Konstanter Wert | !SpaltenName
!Spaltenname : Es wird kein Leerschritt dazwischen gemacht!

Nachschlagewerk

  • xls Umsetzter mit Zaehlerdaten_Referenz.csv
  • Anker ist hier die Spalte, die in beiden Dateien (Zaehlerdaten_Referenz & Quelldatei) vorhanden ist.

Anwendung

  • Im Windows Explorer einen rechten Mausklick auf die zu konvertierende Datei machen. Es öffnet sich das Kontextmenü.
  • Den Menüeintrag "Konvertieren mit Oc" auswählen.
  • Im gleichen Verzeichnis wie die Quelldatei ist nun das Konvertierungsergebnis entstanden.

automatisierte Anwendung

Oc ist als Konsolen-Anwendung Batch-Fähig. Geben Sie dazu in der Kommandozeile den Dateinamen einfach in Anführunszeichen (") an, auf den Sie einen rechten Mausklick machen würden. Die Integration in einen Transaktions-Server ist problemlos möglich. Die Ergebnis Datei (Diagnose.txt) kann fehlerbestimmend ausgewertet werden. kompilierte Linux - Version auf Anfrage. 

C:\Programme\Oc\Oc.exe "C:\MeinPfad\Meine zu verarbeitende Datei.xls"

Abgerufen von „https://wiki.orgamon.org/index.php?title=Oc&oldid=22292“