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 bevat geen geneste gegevens. De planning die u ophaalt via getPlanning bevat bijvoorbeeld geen afdelingsnaam, maar alleen het (cloudplan) afdelingsid. Deze data zult u apart moeten ophalen via de webservice. (Zie hiervoor ook exportProject2.ps1)
- 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!
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.
Hieronder zijn enkele voorbeelden voor het communiceren met de cloudplan webservice, geschreven in Powershell:
| Voorbeeld | |
|---|---|
| Webservice login / logout | |
| Ophalen resources (personeel), exporteren naar csv | |
| Ophalen planning voor gegeven klant en status en periode, inclusief projectnaam en | getplanning.ps1 |
| Toevoegen, opzoeken, bijwerken en verwijderen van planning | |
| Exporteer projecten naar csv | |
| Exporteer projecten naar csv inclusief afdelingsnaam, afdelingsnummer, klantnaam en klantnummer per project | |
| Importeren projecten van csv. Afhandeling van errors / tonen mislukte imports. | |
| Importeer personeel en afdelingslidmaatschappen | importPersonnel personnel.csv |
Neem contact op met support@planning.nl als u extra uitleg nodig heeft voor de betekenis van velden.