Versions Compared

Version Old Version 31 New Version Current
Changes made by

Planning.nl

Planning.nl

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

1.

 Gebruik

De matchers bepalen welke gegevens opgehaald, gewijzigd of verwijderd moeten worden (get, push, delete). Dat kunnen 1 of meerdere records zijn.  
De teruggestuurde data bevat geen geneste gegevens. De planning die u ophaalt via getPlanning bevat bijvoorbeeld geen afdelingsnaam, maar alleen het (cloudplan) afdelingsid. 
Als u deze data ook wenst zult u die apart moeten ophalen via de webservice. (Zie voorbeeld exportProject2.ps1).

Tip: gebruik het 'nummer' veld om hierin uw eigen (unieke) projectnummer/personeelsnummer/afdelingsnummer/etc op te slaan, zodat uw de gegevens later ook weer makkelijk kunt terugvinden via de webservice.

 Voorbeelden


Warning
  • Let erop dat u de matchers niet per ongeluk 'leeg' laat bij een delete of push. In dat geval worden alle gematchte gegevens uit cloudplan verwijderd of gewijzigd! 
  • Bij overbelasting van de webservice kan Planning.nl de verbinding verbreken of weigeren. Probeer de hoeveelheid data die u ophaalt altijd te beperken mbv de matchers. Neem contact op met support@planning.nl als u werkt met zeer grote hoeveelheden data of als u niet meer kunt verbinden met de webservice.


Hieronder zijn enkele voorbeelden voor het communiceren met de cloudplan webservice, geschreven in Powershell.  
Om de voorbeelden uit te kunnen voeren heeft u een gebruikersnaam en wachtwoord nodig van een gebruiker met toegang tot de webservice.

Voorbeeld
Webservice login / logout

authentication.ps1

Ophalen resources (personeel), exporteren naar csv

getresources.ps1

Gebruik van een matcher:
  • Ophalen van planning aan de hand van status en klantnummer
  • Ophalen projecten aan de hand van een lijst met projectstatussen
matcher.ps1
Toevoegen, opzoeken, bijwerken en verwijderen van planning

crud.ps1

Exporteer projecten naar csv

exportProjects.ps1

Exporteer projecten naar csv inclusief afdelingsnaam, afdelingsnummer, klantnaam en klantnummer per project

exportProjects2.ps1

Importeren projecten van csv. 
Afhandeling van errors / tonen mislukte imports.		importPersonnel personnel

importProjects.ps1 projects.csv

Importeer personeel en afdelingslidmaatschappen

.csv

Neem contact op met support@planning.nl als u extra uitleg nodig heeft voor de betekenis van velden.