Versions Compared

Version Old Version 29 New Version 30
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. 
Om de voorbeelden uit te kunnen voeren heeft u een gebruikersnaam en wachtwoord nodig van een gebruiker met toegang tot de webservice.  De data die u ophaalt   
De teruggestuurde data bevat geen geneste gegevens. De planning die u ophaalt via getPlanning bevat bijvoorbeeld geen afdelingsnaam, maar alleen het (cloudplan) afdelingsid.  Deze data
Als u deze data ook wenst zult u die apart moeten ophalen via de webservice. (Zie hiervoor ook 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.

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! Verwijderde gegevens kunnen alleen teruggehaald worden uit een backup.
    Neem contact op met Planning.nl als u een testomgeving wenst waarin u veilig kunt experimenteren met wijzigen of verwijderen van data.
  • Bij overbelasting van de webservice kan Planning.nl de verbinding verbreken. 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.


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
planning voor gegeven klant en status en periode, inclusief projectnaam en getplanning
  • 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.

importProjects.ps1 projects.csv

Importeer personeel en afdelingslidmaatschappenimportPersonnel personnel.csv

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