Mijlpalen en het exporteren van gegevens

Eigenaar Taal Status
Laurens Eykelkamp (Administrator) Nederlands Published
Dit document beschrijft de mogelijkheden voor mijlpalen en het exporteren van gegevens hiervan.
 

   Inhoudsopgave

  1 Mijlpalen van projecten exporteren
  2 Configuratie van de mijlpalen export
 
Dit document is bedoeld voor geregistreerde gebruikers van het bovenstaande product. De inhoud van dit document wordt u as-is aangeboden. Groome Computer Services is niet verantwoordenlijk voor het gebruik van de informatie uit dit document.

1 Mijlpalen van projecten exporteren


 

Het is nu mogelijk om op gewenste momenten (mijlpalen) een export aan te laten maken van de tot dat moment ingevoerde gegevens en deze te versturen naar een extern systeem. Opgemerkt moet worden dat het ook mogelijk is om de mijlpalen voor andere doeleinden te gebruiken (bijvoorbeeld export van statussen naar Timewax), waarvoor het mogelijk is gemaakt om de ApeX2 export uit te schakelen voor een mijlpaal! De export, indien dus actief, vindt plaats in het open ApeX2 formaat van GCS. De momenten van export of de export van de mijlpalen kan naar eigen wens worden geconfigureerd. Bij elke geconfigureerde mijlpaal hoort een statuswaarde en -code die in het ApeX2 formaat opgeslagen worden. Het geëxporteerde bestand heeft dus voldoende informatie om door externe systeem als asbest beheersystemen ingelezen en verwerkt te kunnen worden.

Indien de Mijlpalen export functionaliteit voor uw systeem is geconfigureerd en actief is gemaakt, ziet u in het invoerscherm voor inventarisaties een tabblad en een menuoptie verschijnen:

                   

Onder de menuoptie hangen één of meerder sub menu's die een bepaalde mijlpaal in het traject van de inventarisatie aangeven:

                   

De termen van de te kiezen sub menu's kunnen naar eigen wens worden geconfigureerd, zie het volgende hoofdstuk. Wordt nu bijvoorbeeld gekozen voor de menuoptie 'Ingeboekt', dan wordt gevalideerd op de minimale aanwezigheid van een aantal ingevulde velden. Is hieraan voldaan dan zal de op dat moment beschikbare data voor de inventarisatie in een ApeX2 formaat XML bestand worden weggeschreven. Tevens komen in dit Apex2 bestand de status en statuscode voor 'Ingeboekt' terug:

                   

Deze status en statuscode zijn ook per sub menu te configureren.

Is het ApeX2 formaat volledig aangemaakt, dan wordt dit XML bestand, inclusief bijbehorende bestanden, verplaatst naar een geconfigureerde locatie. Dit kan een locatie binnen het netwerk zijn of een locatie op een externe SFTP server, bijvoorbeeld voor project 'bbb':

                   

Nadat de XML bestand met de bijbehorende bestanden is geplaatst, is het ook nog mogelijk om een notificatie te laten versturen naar een bepaald URL adres. Externe systemen kunnen er daardoor op gewezen worden dat er een project voor verwerking gereed staat op de uitwissellocatie.

Na uitvoering van de export en de notificatie wordt de handeling weergegeven in het nieuwe tabblad 'Mijlpaal export':

                   

In eerste instantie staat hier het resultaat 'Bestanden verzonden' of 'Notificatie verstuurd'. Bij elke keer dat een inventarisatie wordt geopend, zullen de applicatie controleren of een geëxporteerde projecten door het externe systeem zijn verwerkt. Is dit het geval dan veranderd het resultaat naar 'Verwerkt'.

 

2 Configuratie van de mijlpalen export


 

De mogelijkheid om mijlpalen te exporteren vanuit ProBIS Asbest is een module die u aanvullend aan kunt schaffen op uw bestaande licentie. Neem daarvoor contact op met GCS voor meer informatie.

Als u de module actief heeft in uw licentie, dan dient u tevens de ShowHide bestanden aan te passen. Voeg namelijk onder de sectie [ShowTab] de regel 'MijlPalen=1' toe of pas de aanwezig aan naar deze waarde. Zie voor meer informatie http://groomecs.net/DOCU/ViewDocument.php?D_ID=3#54 voor Werkvoorbereiding en http://groomecs.net/DOCU/ViewDocument.php?D_ID=3#55 voor rapportage.

Voor de module is een centrale configuratie van toepassing. Het configuratie wordt geregeld door een bestand met de naam 'Milestones.ini'. Dit bestand moet aanwezig zijn in de \Config centraal folder van uw installatie. De inhoud van het bestand kent eerst een gedeelte dat de beschikbare menuopties regelt. In het ini bestand kan meerdere keren de volgende sectie voorkomen:

Sectie Sleutel Beschrijving
[SubMenu{x}]   Gegevens waarmee de menuopties beschikbaar komen in de applicaties onder het menu 'Mijlpalen exporteren'. {x} is hierin een correct oplogend volgnummer
  Name Code bedrijf voor login. Bekende informatie, te zien in Timewax door het gezicht symbool in taakbalk aan te klikken
  Status Gebruikersnaam medewerker uit Timewax. Deze code is te vinden in Timewax via Stamgegevens en Resources. Open de betreffende persoon en kijk op het tabblad Databeveiliging naar het veld 'API ID'
  StatusCode Wachtwoord. LET OP: deze moet leeg blijven, wordt dan éénmalig gevraagd tijdens een export en versleuteld weggeschreven in dit INI bestand
  ShowWvb  Indien 1 dan is de menuoptie beschikbaar in Werkvoorbereiding, bij 0 niet zichtbaar. 1 is standaardwaarde bij ontbreken
  ShowInv Idem voor Inventarisatie
  ShowRap Idem voor Rapportage
  TimewaxStatusCode Indien u ook de Timewax module gebruikt, kan via deze sleutel een Statuscode van Timewax worden aangegeven die moet worden ingesteld als deze mijlpaal wordt aangeklikt. Toegestande codes zijn te vinden onder de Veldlijsten in Timewax
  TimewaxStatusName Dit is de omschrijving die hoort bij de statuscode uit de vorige sleutel. Wordt gebruikt in het overzicht van uitgevoerde mijlpalen
  ExportToApex Met deze sleutel is het mogelijk om de export van APEX uit te schakelen

 Voorbeeld:

[SubMenu1]
Name=Ingeboekt
StatusCode=001
Status=Ingeboekt
ShowWVB=1
ShowINV=1
ShowRap=0
[SubMenu2]
Name=Gereed
StatusCode=002
Status=Gereed
ShowWVB=0
ShowINV=0
ShowRap=1

Naast de definitie van de sub menu's, is er ook een configuratiedeel die zorgt voor het uitwisselen van de geëxporteerde data. Belangrijk hierbij is de sleutel 'Type', afhankelijk van de waarde hiervoor zijn andere sleutels relevant onder deze sectie. De inhoud van deze sectie in het bestand is als volgt:

sFTPPassword
Sectie Sleutel Beschrijving
[Communication]   Informatie over het uitwisselen van de gegevens na export
  Type Methode van uitwisseling. Mogelijke waarden zijn:
2=naar een SFTP server
3=naar een bepaalde map binnen het netwerp
Indien Type=2
  sFTPHostName Hostname voor SFTP koppeling
  sFTPUser Username voor SFTP toegang. LET OP: de username moet er toe leiden dat direct de folder wordt geopend waarin de projectfolders aangemaakt moeten worden
  sFTPPassword Password voor SFTP toegang. LET OP: deze moet eerst leeg blijven! Bij het valideren bij een export van een mijlpaal wordt dan éénmalig om het wachtwoord voor de communicatie gevraagd
  sFTPFingerprint Fingerprint voor SFTP toegang
  sFTPSubFolder Submap op de SFTP server waarin de projectfolders geplaatst moeten worden. Gebruik geen / aan het begin, hiervoor is SlashForFolder bedoeld. Gebruik ook geen / aan het einde
  SlashForFolder Indien 1 dan wordt voor het (S)FTP adres een slash geplaatst. Dit is afhankelijk van de configuratie van de (S)FTP server soms nodig. Standaard is 0
  ConfirmationType2  URL die verstuurd moet worden om een notificatie te doen van een geplaatste export. Mag code {FILENAME} bevatten, deze wordt vervangen door de naam van de geplaatste file, zonder extensie
 Indien Type=3
  Directory Locatie waarin de folders van de export aangemaakt en gevuld moeten worden
  ConfirmationType3 URL die verstuurd moet worden om een notificatie te doen van een geplaatste export. Mag code {FILENAME} bevatten, deze wordt vervangen door de naam van de geplaatste file, zonder extensie

Voorbeeld:

[Communication]
Type=3
Directory=D:\apps\ProBIS Asbest 2017 V3.7.4\Export milestones\
ConfirmationType3=http://www.website.com/sandbox/pb.php?id={FILENAME}
sFTPHostName=ftp.voorbeeld.com
sFTPUser=User1
sFTPPassword=
SFTPFingerprint=00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:
ConfirmationType2=http://www.website.com/sandbox/pb.php?id={FILENAME}

Zoals hierboven al genoemd moet het veld 'sFTPPassword' in een basisconfiguratie leeg blijven. Reden hiervoor is dat er dan tijdens de eerste export van een mijlpaal een scherm in beeld komt waarmee dit wachtwoord éénmalig ingevoerd kan worden:

                                        

Dit ingevoerde wachtwoord wordt dan versleuteld opgeslagen onder de sleutel 'sFTPPassword' in het INI bestand. Mocht het wachtwoord verkeerd zijn ingevoerd of zijn veranderd, dan moet u de sleutel in het INI bestand leegmaken. Het wachtwoord wordt dan opnieuw gevraagd.

De configuratie is nu ingericht voor het exporteren van mijlpalen!