Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 30 Next »

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.

  • 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 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.


  • No labels