Bestandsysteem: dataset
Met deze actie kunt u een dataset geheugenveld vullen met een bestandenlijst van bestanden en/of mappen welke zich op het bestandsysteem in een bepaalde map bevinden.
Voorbeeld
Stel, u heeft het volgende bestand klaar staan:
D:\Documents\Import\Factuur 20135377.CSV
De dataset bevat dan de volgende velden:
Veldnaam |
Betekenis |
FileType |
Bestandstype, de mogelijke waarden zijn D(irectory) en F(ile) |
FilePath |
Bestandspad, bijvoorbeeld 'D:\Documents\Import\Factuur 20135377.CSV' |
Drive |
De stationsletter, bijvoorbeeld 'D:' |
Folder |
De volledige directory, bijvoorbeeld 'D:\Documents\Import\' |
SubFolder |
De hoogste directory, bijvoorbeeld 'Import' |
FileName |
De bestandsnaam met extensie, bijvoorbeeld 'Factuur 20135377.CSV' |
FileNameWithoutExtension |
De bestandsnaam zonder extensie, bijvoorbeeld 'Factuur 20135377' |
Extension |
De extensie, bijvoorbeeld 'CSV' |
SizeInBytes |
Bestandsgrootte in Bytes als een geheel getal, bijvoorbeeld 3 |
SizeInKb |
Bestandsgrootte in Kilobytes als een decimaal getal, bijvoorbeeld 1.53 |
SizeInMB |
Bestandsgrootte in Megabytes als een decimaal getal, bijvoorbeeld 4.12 |
DateCreated |
De datum/tijd van aanmaak |
DateModified |
De datum/tijd van wijziging |
Beschrijving algemene parameters
Omschrijving (optioneel)
Uitleg voor deze parameter vind u hier.
Standaard map
Hier kunt u een map opgeven welke moet worden gebruikt voor de bij parameter Filter te betrekken bestanden en/of mappen opgegeven filters zonder mapaanduiding.
Voorbeeld
In bovenstaand voorbeeld is de standaard map ingesteld op:
D:\Documents\Import
In de filter ziet u op de eerste regel staan:
Facturen*.CSV
Aangezien deze filter geen mapaanduiding bevat, zal de standaard map hiervoor worden gebruikt. De uit te voeren filter luidt dan:
D:\Documents\Import\Facturen*.CSV
Indien een filter wel een map aanduiding bevat, dan zal de standaard map niet gebruikt worden. Dit geldt voor de filter op de tweede regel in het voorbeeld:
D:\Documenten\*.CSV
Bij deze filter zal gezocht worden in de map D:\Documenten en dus niet in de standaard map.
Filter te betrekken bestanden en/of mappen
Hier geeft u een één of meerdere filters op voor bestanden en/of mappen welke betrokken moeten worden in de lijst met bestanden/mappen.
Elke filter voert u in op een nieuwe regel. U kunt dus niet meerdere filters op een regel invoeren.
U kunt een bestand direct aanwijzen via een bestandspad, zoals bijvoorbeeld D:\Documenten\Archief\Import.XML, maar u kunt desgewenst ook werken met wildcards (* en ?), zoals bijvoorbeeld D:\Documenten\Archief\*.XML.
Indien u alleen een map opgeeft, zoals bijvoorbeeld D:\Documenten\Archief, worden alle bestanden in die map meegenomen. Dit wordt dan gezien als D:\Documenten\Archief\*.*.
Indien u een filter opgeeft zonder mapaanduiding, zoals bijvoorbeeld Facturen*.CSV, dan zal deze toegepast worden in de opgegeven standaard map (parameter Standaard map).
NB: Indien u verwijst naar bestanden op andere servers, dan kunt u het beste UNC-paden gebruiken.
Filter uit te sluiten bestanden en/of mappen
Hier geeft u één of meerdere filters op voor bestanden en/of mappen welke uitgesloten moeten worden in de lijst met bestanden/mappen.
Elke filter voert u in op een nieuwe regel. U kunt dus niet meerdere filters op een regel invoeren.
U kunt een bestand direct aanwijzen via een bestandspad, zoals bijvoorbeeld D:\Documents\Verwerkt\Import.XML, maar u kunt desgewenst ook werken met wildcards (* en ?), zoals bijvoorbeeld D:\Documents\Verwerkt\*.*.
Indien u alleen een map opgeeft, zoals bijvoorbeeld D:\Documents\Verwerkt, worden alle bestanden in die map meegenomen. Dit wordt dan gezien als D:\Documents\Verwerkt\*.*.
Indien u een filter opgeeft zonder mapaanduiding, zoals bijvoorbeeld Inkoop*.CSV, dan zal deze toegepast worden in de opgegeven standaard map (parameter Standaard map).
NB: Indien u verwijst naar bestanden op andere servers, dan kunt u het beste UNC-paden gebruiken.
Neem bestanden op in resultaat/Neem mappen op in resultaat
De opgegeven filters kunnen bestanden en/of (sub)mappen opleveren. Via deze twee opties kunt u bepalen welk type u in de door de lus gebruikte lijst wilt laten opnemen.
Voorbeeld
Indien u beide opties aanvinkt kan de lijst een mix van bestanden en mappen opleveren, zoals bijvoorbeeld:
D:\Import\Facturen\Facturen 2013-03-06.CSV
D:\Documenten\Order 2013-03-04.CSV
D:\Documenten\Archief\
Let op: indien u bij 'Filter uit te sluiten bestanden en/of mappen' een mapaanduiding invult, dan worden niet deze mappen uitgesloten, maar alleen de bestanden die in deze mappen aanwezig zijn.
Verborgen bestanden meenemen/Systeem bestanden meenemen
Met deze opties kunt u aangeven of ook verborgen en/of systeembestanden meegenomen moeten worden.
Systeembestanden zijn bestanden van Windows. Verborgen bestanden zijn bestanden welke het kenmerk Verborgen hebben; dit kunt u opvragen via de eigenschappen van het bestand in de Windows Verkenner, zoals bijvoorbeeld:
Doorloop submappen
Indien deze optie niet wordt aangezet en u bijvoorbeeld de map D:\Documents opgeeft, zullen alleen de bestanden in die map worden meegenomen, maar niet de bestanden in eventuele submappen, zoals bijvoorbeeld D:\Documents\Verwerkt\.
Indien u deze optie wel aanzet, zullen ook alle submappen (en ook eventuele submappen daarvan; aantal niveaus diep is ongelimiteerd) in de opgegeven map worden meegenomen.
Genereer fout indien een bron bestand niet bestaat
Indien een bij de filters opgegeven bestandspad of map niet bestaat, zal er een fout worden gegenereerd indien deze optie aan is gezet. Indien u deze optie niet aanzet en het opgegeven bestandspad of map bestaat niet, dan zal deze zonder fout (of waarschuwing) worden overgeslagen.
Plaats resultaat in dit geheugenveld
Dit is het geheugenveld van het type dataset, waarin u het resultaat wilt laten zetten.
Actie bij fout
Uitleg voor deze parameter vind u hier.
Beschrijving parameters in tabblad "Datum filters"
In dit tabblad kunt u filters invoeren voor de datum laatst gewijzigd van bestanden en mappen.
Vanaf datum/Tot en met datum
Hier kunt u een datum/tijd-waarde opgeven. Zoals u in het voorbeeld kunt zien kunt u desgewenst ook op tijd selecteren.
Ouderdom in dagen hoger dan/Ouderdom in dagen lager dan
Hier kunt u aangeven dat het bestand, of de map, een ouderdom in dagen moet hebben welke hoger of lager is dan het getal wat u hier opgeeft.
Voorbeelden berekening ouderdom in dagen
Stel huidige datum/tijd is: 13-03-2016 14:15.
Op 13-03-2016 14:15 is de ouderdom in dagen: 0.
Op 13-03-2016 12:00 is de ouderdom in dagen: 0,1.
Op 13-03-2016 02:15 is de ouderdom in dagen: 0,5.
Op 12-03-2016 14:15 is de ouderdom in dagen: 1.
Op 11-03-2016 14:15 is de ouderdom in dagen: 2.
Ouderdom in uren hoger dan / Ouderdom in uren lager dan
Hier kunt u aangeven dat het bestand, of de map, een ouderdom in uren moet hebben welke hoger of lager is dan het getal wat u hier opgeeft.
Voorbeelden berekening ouderdom in uren
Stel huidige datum/tijd is: 13-03-2016 14:15.
Op 13-03-2016 14:15 is de ouderdom in uren: 0.
Op 13-03-2016 12:00 is de ouderdom in uren: 2,25.
Op 13-03-2016 02:15 is de ouderdom in uren: 12.
Ouderdom in minuten hoger dan / Ouderdom in minuten lager dan
Hier kunt u aangeven dat het bestand, of de map, een ouderdom in minuten moet hebben welke hoger of lager is dan het getal wat u hier opgeeft.
Voorbeelden berekening ouderdom in minuten
Stel huidige datum/tijd is: 13-03-2013 14:15.
Op 13-03-2016 14:15 is de ouderdom in minuten: 0.
Op 13-03-2016 12:00 is de ouderdom in uren: 135.
Beschrijving parameters in tabblad "Inhoud filters"
In dit tabblad kunt u tekstbestanden (TXT, CSV, XML, etc.) filteren op hun inhoud.
Voorbeeld
Deze filtermogelijkheid kan bijvoorbeeld van nut zijn bij importbestanden. Het kan namelijk voorkomen dat bepaalde bestanden geen inhoud hebben (bestandsgrootte 0) of dat deze niet de inhoud hebben die u verwacht of nodig hebt.
Stel u wilt een bestandenlijst hebben van CSV-bestanden waarin verkoopfactuur mutaties staan. In de map C:\Import staan de volgende twee bestanden klaar:
D:\Import\Facturen 2013-03-16.CSV
D:\Import\Facturen 2013-03-18.CSV
Nu blijkt dat, door een fout bij degene die dit bestand heeft aangemaakt en klaargezet, het eerste bestand (Facturen 2013-03-16) geen verkoopfactuur boeking bevat, maar in plaats daarvan een memoriaal boeking. Dit is een type boeking dat de betreffende taak niet verwacht en zeer waarschijnlijk op zal stuklopen.
Dit kunnen we oplossen door een filter op de inhoud toe te passen. We weten bijvoorbeeld dat een verkoopfactuur boeking altijd minimaal een kopregel bevat dat begint met:
0;V;
De V staat hier voor dagboek Verkoop. We kunnen dus een inhoudfilter toepassen die controleert of de inhoud van het bestand deze tekst bevat. Indien dat niet zo is, zoals bij een bestand met daarin een memoriaal boeking, zal het bestand niet in de resulterende bestandenlijst worden opgenomen.
U kunt één of meerdere inhoudfilters aanmaken. Hiervoor zijn de volgende knoppen beschikbaar:
Pictogram |
Betekenis |
|
Toevoegen nieuwe inhoud filter |
|
Wijzigen inhoud filter |
|
Verwijder inhoud filter |
Het venster waarin u de inhoudfilter aanmaakt of wijzigt:
Extensie
Een inhoudfilter wordt alleen uitgevoerd voor een bestand met de hier opgegeven extensie.
Moet bevatten
Hier geeft u de tekst op (case insensitive) welke de inhoud van het bestand moet bevatten.
Zoek ASCII tekst
Wanneer u deze optie aanvinkt zal het bestand in kleine delen worden doorlopen totdat de tekst is gevonden. Grote voordeel is dat de tekst sneller gevonden kan worden (zeker indien deze zich aan het begin bevindt) en er minder geheugen nodig is. Enige nadeel is dat er alleen gezocht kan worden op 'normale' tekens. Dit houdt in dat er wel wordt gezocht op 'e', maar niet op 'é'.
NB: Indien u wilt controleren op meer dan 1 tekst in de inhoud, dan kunt u dit bereiken door meerdere inhoud filters voor dezelfde extensie aan te maken.