Interface overview
The web service allows you to remove all user-level project visibility from a specified person. This does not affect projects defined through a person group.
The WSDL schema of the web service is publicly available here. The interfaces are described in general here.
The occurrences column in the description determines whether a piece of information is mandatory in the call or not. Occurrences 0 means that the information in question does not need to be passed in the call. Occurrences 1 means that the information must appear once in the call. Occurrences 0..n means that the information in question can appear any number of times in the call. Occurrences 1..n means that the information in question must appear in the data at least once, but can appear more often.
User identifiers
The target user can be identified by a unique Nepton ID, employee number, or a username. One of these must be provided. The service returns an error if no username has been specified or no user matching the identifier was found.
Data to be sent
| LEVEL | FIELD NAME | FORMAT | OCCURRENCES | DESCRIPTION |
|---|---|---|---|---|
| 0 | ParametersForClearVisibleProjectsForUser | XML element | Root, below SOAP body |
|
| 1 | CallerAuthentication | XML element | 1 | Authentication details. See more here. |
| 1 | ClearVisibleProjectsForUserList | XML element | 1 | |
| 2 | ClearVisibleProjectForUser | XML element | 1..n | |
| 3 | UserId | integer | 0..1 | Target user's Nepton ID. |
| 3 | PersonnelNumber | string | 0..1 | Target user's personnel number. |
| 3 | UserName | string | 0..1 | Target user's username. |
Call example
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tyo="http://tyoaika.tyoteho.fi">
<soapenv:Header/>
<soapenv:Body>
<tyo:ParametersForClearVisibleProjectsForUser>
<CallerAuthentication /> <!-- Autentikointi vaaditaan, mutta on jätetty pois tästä esimerkistä -->
<ClearVisibleProjectsForUserList>
<ClearVisibleProjectForUser>
<PersonnelNumber>54236</PersonnelNumber>
</ClearVisibleProjectForUser>
</ClearVisibleProjectsForUserList>
</tyo:ParametersForClearVisibleProjectsForUser>
</soapenv:Body>
</soapenv:Envelope>