Skip to main content

Gebruikers wijzigen

Voor het bewerken van een gebruiker in Pynter kan gebruik gemaakt worden van de UpdatePerson endpoint. Deze endpoint ziet er als volgt uit:

POST /service/apiservice.asmx HTTP/1.1
Host: tools4ever.domein.acc.pynter.nl
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <UpdatePerson xmlns="/service/ApiService.asmx">
      <username>string</username>
      <password>string</password>
      <pynterPersonId>int</pynterPersonId>
      <personUpdate>
        <ManagerExternalIdentifier>string</ManagerExternalIdentifier>
      </personUpdate>
    </UpdatePerson>
  </soap12:Body>
</soap12:Envelope>

De endpoint verwacht een personCreatepynterPersonId. Dit is het interne ID voor de persoon in Pynter. Deze krijg je terug wanneer je de createPerson endpoint aanroept. Voor meer informatie, zie de Gebruikers aanmaken sectie.

Daarnaast verwacht de endpoint een personUpdate object geserialiseerd als XML. Dit object zietis ergelijk alsaan volgtdat uit:

bij 
het <personCreate> <!--object Hetzoals medewerkernummerbesproken voor deze persoon. Kan gebruikt worden omin de persoonGebruikers opaanmaken te wijzigen of op te halen. Moet uniek zijn. -->
    <ExternalIdentifier>string</ExternalIdentifier>

    <!-- De voornaam. -->
    <FirstName>string</FirstName>

    <!-- OPTIONEEL: Het tussenvoegsel. -->
    <Insertion>string</Insertion>

    <!-- De achternaam exclusief tussenvoegsel. -->
    <FamilyName>string</FamilyName>

    <!-- Een zakelijk e-mailadres voor de persoon. -->
    <Email>string</Email>

    <!-- Het autorisatieniveau van de persoon. -->
    <!-- Zie de opmerking onder dit blok voor meer uitleg. -->
    <AccountLevel></AccountLevel>

    <!-- Of deze persoon een manager is of niet. -->
    <IsManager>boolean</IsManager>

    <!-- OPTIONEEL: De naam van de functie. -->
    <!-- LET OP: Wanneer dit leeggelaten wordt krijgt de persoon 'Functie onbekend'sectie. -->
    <FunctionName>string</FunctionName>

    <!-- OPTIONEEL: De naam van de divisie / locatie van de persoon. -->
    <!-- LET OP: Wanneer dit leeggelaten wordt krijgt de persoon 'Locatie onbekend'. -->
    <DivisionName>string</DivisionName>

    <!-- OPTIONEEL: De kostenplaats voor de persoon. -->
    <!-- LET OP: Wanneer dit leeggelaten wordt krijgt de persoon een lege kostenplaats. -->
    <CostCentre>string</CostCentre>

    <!-- OPTIONEEL: De telefoonnummer. -->
    <PhoneNumber>string</PhoneNumber>

    <!-- OPTIONEEL: Wanneer het contract van kracht is. -->
    <ContractStartTime>datetime</ContractStartTime>

    <!-- OPTIONEEL: Wanneer het contract afloopt. -->
    <ContractEndTime>datetime</ContractEndTime>

    <!-- OPTIONEEL: Het medewerkernummer van de leidinggevende van deze persoon. -->
    <!-- LET OP: Wanneer dit leeggelaten wordt krijgt de persoon 'Manager onbekend'. -->
    <ManagerExternalIdentifier>string</ManagerExternalIdentifier>
</personCreate>

Voor meer informatie over AccountLevel kan je de pagina over Autorisatie inzien.

Bij het succesvol aanroepen krijg je het volgende resultaat terug:

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <CreatePersonResponseUpdatePersonResponse xmlns="/service/ApiService.asmx">
      <CreatePersonResultUpdatePersonResult>
        <Success>boolean</Success>
        <Contents>int<Contents />
        <Error>string</Error>
      </CreatePersonResultUpdatePersonResult>
    </CreatePersonResponseUpdatePersonResponse>
  </soap12:Body>
</soap12:Envelope>

In de Contents van de response bevind zich heteen internelege Pynter ID van de persoon die later gebruikt kan worden voor het wijzigen van de persoon.waarde.

Back to top