Open Source Dokumentenmanagement
Dokumentation

Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht

Navigation: Dokumentationen agorum core > agorum core JavaScript-API


JavaScript-Bibliothek common/csv

Diese JavaScript-Bibliothek bietet Funktionen zum Parsen von CSV-Dateien.

Verwendung


Binden Sie die Bibliothek stets am Anfang eines Skripts ein:

let csv = require('common/csv');

let options = {
  delimiter: ';',
  quote: '"',
  encoding: 'ISO-8859-15',
  header: true
};

let csvList = csv.read(obj-csv-File, options);

Return


Sie erhalten eine Map, die Sie in JavaScript lesen können.

Beispiel mit Header

value;text
Bericht;Bericht
Besuch;Besuch
Arzt;Arzt


Ergebnis

[
  {
    "text": "Bericht",
    "value": "Bericht"
  },
  {
    "text": "Besuch",
    "value": "Besuch"
  },
  {
    "text": "Arzt",
    "value": "Arzt"
  }
]

Beispiel ohne Header

Bericht;Bericht
Besuch;Besuch
Arzt;Arzt


Ergebnis

[
  [
    "Bericht",
    "Bericht"
  ],
  [
    "Besuch",
    "Besuch"
  ],
  [
    "Arzt",
    "Arzt"
  ]
]

Eine CSV-Datei mit Header auslesen


Beispiel einer CSV-Datei

value;text
100;Baustelle
200;Fahrzeug
300;agorum

Hinweis: Sollten sich Leerzeichen zwischen dem Trenner ; und dem Text befinden, liest das System sie mit aus, führt jedoch kein trim durch.

Skript zum Auslesen der Werte über alle Zeilen (mit einem Header)

/* global Packages, sessionController */

let objects = require('common/objects'),
    beans = require('common/beans'),
    csv = require('common/csv');

let options = {
  delimiter: ';',
  quote: '"',
  encoding: 'ISO-8859-15',
  header: true
};

// csv parsen
let csvList = csv.read(objects.find(id-to-csv), options);

// Die CSV-Datei über alle Zeilen auslesen und value und text verarbeiten
csvList.forEach(function(entry) {
  let text = entry.text;
  let value = entry.value;
  verarbeiten(value, text);
});

// Werte für jede Zeile verarbeiten
function verarbeiten(value, text) {
  ...
  ...
}

Eine CSV-Datei ohne Header auslesen


Beispiel CSV-Datei ohne Header

100;Baustelle
200;Fahrzeug
300;agorum

Skript zum Auslesen der Werte über alle Zeilen (ohne Header)

/* global Packages, sessionController */

let objects = require('common/objects'),
    beans = require('common/beans'),
    csv = require('common/csv');

let options = {
  delimiter: ';',
  quote: '"',
  encoding: 'ISO-8859-15',
  header: false
};

// csv parsen
let csvList = csv.read(objects.find(id-to-csv), options);

// Die CSV-Datei über alle Zeilen auslesen und value und text verarbeiten
csvList.forEach(function(entry) {
  let value = entry[0]; // Spalte 1
  let text = entry[1]; // Spalte 2
  verarbeiten(value, text);
});

// Werte für jede Zeile verarbeiten
function verarbeiten(value, text) {
  ...
  ...
}