tgextra.wsdl

					<ul>
						<li>auth - String, SessionID of Project Leader</li>
						<li>log - String for log information, optional</li>
						<li>project - String with projectID</li>
						<li>file - String with URI of project file</li>
					</ul>
				</li>
				<li>
					<b>Output Parameters</b>
					booleanResponse, with element
					<ul>
						<li>result - boolean, true if operation was successful,
							false
							otherwise</li>
					</ul>
				</li>
				<li>
					<b>Faults</b>
					<ul>
						<li>authenticationFault</li>
					</ul>
				</li>
			</ul>
		</wsdl:documentation>
		<wsdl:input message="tns:setProjectFileRequest" />
		<wsdl:output message="tns:setProjectFileResponse" />
		<wsdl:fault name="authenticationFault" message="tns:authenticationFault" />
	</wsdl:operation>
	<wsdl:operation name="setName">
		<wsdl:documentation>
			Supply user-specific information for display instead of the ePPN.
			<ul>
				<li>
					<b>Input Parameters</b>
					setNameRequest, with elements
					<ul>
						<li>auth - String, SessionID of User who wants to set their name</li>
						<li>log - String for log information, optional</li>
						<li>webAuthSecret - String that is known by the Web
							Authentication
							which will assure that the data are correct. If
							the secret is not
							given, the user entry will be marked as a
							volunteered one, where
							the users gave their details themselves.</li>
						<li>name - String with User Name, preferredly in the form of
							"givenname surname"</li>
						<li>mail - String with User's E-Mail address</li>
						<li>organisation - String with Affiliation of the User</li>
						<li>agreeSerach - Boolean telling whether the user agrees to be
							searchable by the getIDs function.</li>
					</ul>
				</li>
				<li>
					<b>Output Parameters</b>
					booleanResponse, with element
					<ul>
						<li>result - boolean, true if operation was successful,
							false
							otherwise</li>
					</ul>
				</li>
				<li>
					<b>Faults</b>
					<ul>
					</ul>
				</li>
			</ul>
		</wsdl:documentation>
		<wsdl:input message="tns:setNameRequest" />
		<wsdl:output message="tns:setNameResponse" />
	</wsdl:operation>
	<wsdl:operation name="addMember">
		<wsdl:documentation>
			Project leaders can assign users into specific roles. This
			still does
			not effect
			<em>activation</em>
			of the role in the
			user(s)' session(s).
			<ul>
				<li>
					<b>Input Parameters</b>
					addMemberRequest, with elements
					<ul>
						<li>auth - String, SessionID of project leader</li>
						<li>log - String for log information, optional</li>
						<li>username - String with ePPN of user to be added</li>
						<li>role - String with full-qualified role name of the
							role the
							user is to be signed into. The full-qualified
							role name has the
							form
							"Administrator,TGPR3,Projekt-Teilnehmer"</li>
					</ul>
				</li>
				<li>
					<b>Output Parameters</b>
					booleanResponse, with element
					<ul>
						<li>result - boolean, true if operation was successful,
							false
							otherwise</li>
					</ul>
				</li>
				<li>
					<b>Faults</b>
					<ul>
						<li>rbacFault</li>
					</ul>
				</li>
			</ul>
		</wsdl:documentation>
		<wsdl:input message="tns:addMemberRequest" />
		<wsdl:output message="tns:addMemberResponse" />
		<wsdl:fault name="rbacFault" message="tns:rbacFault" />
	</wsdl:operation>
	<wsdl:operation name="deleteMember">
		<wsdl:documentation>
			Project leaders can delete a role from a user. This
			still does not
			effect
			<em>(de-)activation</em>
			of the role in the
			user(s)' session(s).
			<ul>
				<li>
					<b>Input Parameters</b>
					deleteMemberRequest, with elements
					<ul>
						<li>auth - String, SessionID of project leader</li>
						<li>log - String for log information, optional</li>
						<li>username - String with ePPN of user to be signed off</li>
						<li>role - String with full-qualified role name of the
							role the
							user is to be signed off. The full-qualified
							role name has the
							form
							"Administrator,TGPR3,Projekt-Teilnehmer"</li>
					</ul>
				</li>
				<li>
					<b>Output Parameters</b>
					booleanResponse, with element
					<ul>
						<li>result - boolean, true if operation was successful,
							false
							otherwise</li>
					</ul>
				</li>
			</ul>
		</wsdl:documentation>
		<wsdl:input message="tns:deleteMemberRequest" />
		<wsdl:output message="tns:deleteMemberResponse" />
	</wsdl:operation>
	<wsdl:operation name="tgAddActiveRole">
		<wsdl:documentation>
			Activates a role for a session. NB, currently the login
			process
			activates
			<em>all</em>
			available roles of the user.
			<ul>
				<li>
					<b>Input Parameters</b>
					tgAddActiveRoleRequest, with elements
					<ul>
						<li>auth - String, SessionID of user</li>
						<li>log - String for log information, optional</li>
						<li>role - String with full-qualified role name of the
							role the
							user wants to activate. The full-qualified role
							name has the form
							"Administrator,TGPR3,Projekt-Teilnehmer".</li>
					</ul>
				</li>
				<li>
					<b>Output Parameters</b>
					booleanResponse, with element
					<ul>
						<li>result - boolean, true if operation was successful,
							false
							otherwise</li>
					</ul>
				</li>
			</ul>
		</wsdl:documentation>
		<wsdl:input message="tns:tgAddActiveRoleRequest" />
		<wsdl:output message="tns:tgAddActiveRoleResponse" />
	</wsdl:operation>
	<wsdl:operation name="tgDropActiveRole">
		<wsdl:documentation>
			De-activates a role for a session.
			<ul>
				<li>
					<b>Input Parameters</b>
					tgDropActiveRoleRequest, with elements
					<ul>
						<li>auth - String, SessionID of user</li>
						<li>log - String for log information, optional</li>
						<li>role - String with full-qualified role name of the
							role the
							user wants to de-activate. The full-qualified role
							name has the
							form
							"Administrator,TGPR3,Projekt-Teilnehmer".</li>
					</ul>
				</li>
				<li>
					<b>Output Parameters</b>
					booleanResponse, with element
					<ul>
						<li>result - boolean, true if operation was successful,
							false
							otherwise</li>
					</ul>
				</li>
			</ul>
		</wsdl:documentation>
		<wsdl:input message="tns:tgDropActiveRoleRequest" />
		<wsdl:output message="tns:tgDropActiveRoleResponse" />
	</wsdl:operation>
	<wsdl:operation name="tgGrantPermission">
		<wsdl:documentation>
			Enables given operation for given role on given
			resource. Resource
			may
			be an URI of a TgObject, or
			a projectID. Users need delegate
			right on
			resource or project
			(i.e. be project leader).
			<ul>
				<li>
					<b>Input Parameters</b>
					tgGrantPermissionRequest, with elements
					<ul>
						<li>auth - String, SessionID of user</li>
						<li>log - String for log information, optional</li>
						<li>role - String with full-qualified role name of the
							role the
							user wants to grant a right. The full-qualified
							role name has the
							form
							"Administrator,TGPR3,Projekt-Teilnehmer".</li>
						<li>operation - String, operation to be granted, such as
							"read",
							"write".</li>
						<li>resource - String, URI of TgObject, or projectID</li>
					</ul>
				</li>
				<li>
					<b>Output Parameters</b>
					booleanResponse, with element
					<ul>
						<li>result - boolean, true if operation was successful,
							false
							otherwise</li>
					</ul>
				</li>
				<li>
					<b>Faults</b>
					<ul>
						<li>authenticationFault</li>
						<li>rbacFault</li>
					</ul>
				</li>
			</ul>
		</wsdl:documentation>
		<wsdl:input message="tns:tgGrantPermissionRequest" />
		<wsdl:output message="tns:tgGrantPermissionResponse" />
		<wsdl:fault name="authenticationFault" message="tns:authenticationFault" />
	</wsdl:operation>
	<wsdl:operation name="tgRevokePermission">
		<wsdl:documentation>
			Disables this permission, see tgGrantPermission for limitations.
			<ul>
				<li>
					<b>Input Parameters</b>
					tgRevokePermissionRequest, with elements
					<ul>
						<li>auth - String, SessionID of user</li>
						<li>log - String for log information, optional</li>
						<li>role - String with full-qualified role name of the
							role the
							user wants to revoke a right. The full-qualified
							role name has
							the
							form
							"Administrator,TGPR3,Projekt-Teilnehmer".</li>
						<li>operation - String, operation to be granted, such as
							"read",
							"write".</li>
						<li>resource - String, URI of TgObject, or projectID</li>
					</ul>
				</li>
				<li>
					<b>Output Parameters</b>
					booleanResponse, with element
					<ul>
						<li>result - boolean, true if operation was successful,
							false
							otherwise</li>
					</ul>
				</li>
				<li>
					<b>Faults</b>
					<ul>
						<li>authenticationFault</li>
					</ul>
				</li>
			</ul>
		</wsdl:documentation>
		<wsdl:input message="tns:tgRevokePermissionRequest" />
		<wsdl:output message="tns:tgRevokePermissionResponse" />
		<wsdl:fault name="authenticationFault" message="tns:authenticationFault" />
	</wsdl:operation>
	<wsdl:operation name="deactivateProject">
		<wsdl:documentation>
			Hides a project. User must be project leader of the project to
			be
			deactivated. Hidden projects cannot be modified or read
			anymore
			(except published resources). However, information is
			preserved so
			that the project can be re-activated by manual
			modification of the
			database.
			<ul>
				<li>
					<b>Input Parameters</b>
					deactivateProjectRequest, with elements
					<ul>
						<li>auth - String, SessionID of user that wants publish</li>
						<li>log - String for log information, optional</li>
						<li>project - String, ProjectID</li>
					</ul>
				</li>
				<li>
					<b>Output Parameters</b>
					booleanResponse, with element
					<ul>
						<li>result - boolean, true if operation was successful,
							false
							otherwise</li>
					</ul>
				</li>
				<li>
					<b>Faults</b>
					<ul>
						<li>authenticationFault</li>
					</ul>
				</li>
			</ul>
		</wsdl:documentation>
		<wsdl:input message="tns:deactivateProjectRequest" />
		<wsdl:output message="tns:deactivateProjectResponse" />
		<wsdl:fault name="authenticationFault" message="tns:authenticationFault" />
	</wsdl:operation>
	<wsdl:operation name="reactivateProject">
		<wsdl:documentation>
			Reactivate a hidden and deactivated project. The user must be the
			former project leader of the project to be able to reactivate it.
			All
			rights will be restored.
			<ul>
				<li>
					<b>Input Parameters</b>
					reactivateProjectRequest, with elements
					<ul>
						<li>auth - String, SessionID of user that wants publish</li>
						<li>log - String for log information, optional</li>
						<li>project - String, ProjectID</li>
					</ul>
				</li>
				<li>
					<b>Output Parameters</b>
					booleanResponse, with element
					<ul>
						<li>result - boolean, true if operation was successful,
							false
							otherwise</li>
					</ul>
				</li>
				<li>
					<b>Faults</b>
					<ul>
						<li>authenticationFault</li>
					</ul>
				</li>
			</ul>
		</wsdl:documentation>
		<wsdl:input message="tns:reactivateProjectRequest" />
		<wsdl:output message="tns:reactivateProjectResponse" />
		<wsdl:fault name="authenticationFault" message="tns:authenticationFault" />
		<wsdl:fault name="unknownProjectFault" message="tns:unknownProjectFault" />
	</wsdl:operation>
	<wsdl:operation name="deleteProject">
		<wsdl:documentation>
			Delete a project. User must be project leader of the project that
			is
			deleted. Before a project can be deleted there must not be any
			resources associated with the project. A deleted project cannot be
			restored.
			<ul>
				<li>
					<b>Input Parameters</b>
					deleteProjectRequest, with elements
					<ul>
						<li>auth - String, SessionID of user that wants publish</li>
						<li>log - String for log information, optional</li>
						<li>project - String, ProjectID</li>
					</ul>
				</li>
				<li>
					<b>Output Parameters</b>
					booleanResponse, with element
					<ul>
						<li>result - boolean, true if operation was successful,
							false
							otherwise</li>
					</ul>
				</li>
				<li>
					<b>Faults</b>
					<ul>
						<li>authenticationFault</li>
						<li>notEmptyFault</li>
					</ul>
				</li>
			</ul>
		</wsdl:documentation>
		<wsdl:input message="tns:deleteProjectRequest" />
		<wsdl:output message="tns:deleteProjectResponse" />
		<wsdl:fault name="authenticationFault" message="tns:authenticationFault" />
		<wsdl:fault name="notEmptyFault" message="tns:notEmptyFault" />
	</wsdl:operation>
	<wsdl:operation name="setMyUserAttributes">
		<wsdl:documentation>TODO</wsdl:documentation>
		<wsdl:input message="tns:setMyUserAttributesRequest" />
		<wsdl:output message="tns:setMyUserAttributesResponse" />
		<wsdl:fault name="authenticationFault" message="tns:authenticationFault" />
	</wsdl:operation>

	<!-- ################################################################### -->
	<!-- ## -- Binding -------------------------------------------------- ## -->
	<!-- ################################################################### -->

	<wsdl:binding name="binding_tgextra" type="tns:port_tgextra">
		<soap:binding style="document"
			transport="http://schemas.xmlsoap.org/soap/http" />
		<wsdl:operation name="userExists">
			<soap:operation
				soapAction="http://textgrid.info/namespaces/middleware/tgauth/userExists" />
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
			<wsdl:output>
				<soap:body use="literal" />
			</wsdl:output>
			<wsdl:fault name="authenticationFault">
				<soap:fault use="literal" name="authenticationFault" />
			</wsdl:fault>
		</wsdl:operation>
		<wsdl:operation name="getNames">
			<soap:operation
				soapAction="http://textgrid.info/namespaces/middleware/tgauth/getNames" />
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
			<wsdl:output>
				<soap:body use="literal" />
			</wsdl:output>
		</wsdl:operation>
		<wsdl:operation name="getIDs">
			<soap:operation
				soapAction="http://textgrid.info/namespaces/middleware/tgauth/getIDs" />
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
			<wsdl:output>
				<soap:body use="literal" />
			</wsdl:output>
		</wsdl:operation>
		<wsdl:operation name="getObjects">
			<soap:operation
				soapAction="http://textgrid.info/namespaces/middleware/tgauth/getObjects" />
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
			<wsdl:output>
				<soap:body use="literal" />
			</wsdl:output>
		</wsdl:operation>
		<wsdl:operation name="tgCheckAccess">
			<soap:operation
				soapAction="http://textgrid.info/namespaces/middleware/tgauth/tgCheckAccess" />
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
			<wsdl:output>
				<soap:body use="literal" />
			</wsdl:output>
			<wsdl:fault name="unknownResourceFault">
				<soap:fault use="literal" name="unknownResourceFault" />
			</wsdl:fault>
		</wsdl:operation>
		<wsdl:operation name="tgAssignedRoles">
			<soap:operation
				soapAction="http://textgrid.info/namespaces/middleware/tgauth/tgAssignedRoles" />
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
			<wsdl:output>
				<soap:body use="literal" />
			</wsdl:output>
			<wsdl:fault name="authenticationFault">
				<soap:fault use="literal" name="authenticationFault" />
			</wsdl:fault>
		</wsdl:operation>
		<wsdl:operation name="tgAssignedProjects">
			<soap:operation
				soapAction="http://textgrid.info/namespaces/middleware/tgauth/tgAssignedProjects" />
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
			<wsdl:output>
				<soap:body use="literal" />
			</wsdl:output>
		</wsdl:operation>
		<wsdl:operation name="getAllProjects">
			<soap:operation
				soapAction="http://textgrid.info/namespaces/middleware/tgauth/getAllProjects" />
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
			<wsdl:output>
				<soap:body use="literal" />
			</wsdl:output>
		</wsdl:operation>
		<wsdl:operation name="getLeader">
			<soap:operation
				soapAction="http://textgrid.info/namespaces/middleware/tgauth/getLeader" />
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
			<wsdl:output>
				<soap:body use="literal" />
			</wsdl:output>
		</wsdl:operation>
		<wsdl:operation name="filterBySid">
			<soap:operation
				soapAction="http://textgrid.info/namespaces/middleware/tgauth/filterBySid" />
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
			<wsdl:output>
				<soap:body use="literal" />
			</wsdl:output>
			<wsdl:fault name="authenticationFault">
				<soap:fault use="literal" name="authenticationFault" />
			</wsdl:fault>
		</wsdl:operation>
		<wsdl:operation name="getOwner">
			<soap:operation
				soapAction="http://textgrid.info/namespaces/middleware/tgauth/getOwner" />
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
			<wsdl:output>
				<soap:body use="literal" />
			</wsdl:output>
			<wsdl:fault name="authenticationFault">
				<soap:fault use="literal" name="authenticationFault" />
			</wsdl:fault>
		</wsdl:operation>
		<wsdl:operation name="getMembers">
			<soap:operation
				soapAction="http://textgrid.info/namespaces/middleware/tgauth/getMembers" />
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
			<wsdl:output>
				<soap:body use="literal" />
			</wsdl:output>
			<wsdl:fault name="authenticationFault">
				<soap:fault use="literal" name="authenticationFault" />
			</wsdl:fault>
		</wsdl:operation>
		<wsdl:operation name="getUserRole">
			<soap:operation
				soapAction="http://textgrid.info/namespaces/middleware/tgauth/getUserRole" />
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
			<wsdl:output>
				<soap:body use="literal" />
			</wsdl:output>
			<wsdl:fault name="authenticationFault">
				<soap:fault use="literal" name="authenticationFault" />
			</wsdl:fault>
			<wsdl:fault name="unknownProjectFault">
				<soap:fault use="literal" name="unknownProjectFault" />
			</wsdl:fault>
		</wsdl:operation>
		<wsdl:operation name="getFriends">
			<soap:operation
				soapAction="http://textgrid.info/namespaces/middleware/tgauth/getFriends" />
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
			<wsdl:output>
				<soap:body use="literal" />
			</wsdl:output>
		</wsdl:operation>
		<wsdl:operation name="getRights">
			<soap:operation
				soapAction="http://textgrid.info/namespaces/middleware/tgauth/getRights" />
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
			<wsdl:output>
				<soap:body use="literal" />
			</wsdl:output>
			<wsdl:fault name="authenticationFault">
				<soap:fault use="literal" name="authenticationFault" />
			</wsdl:fault>
		</wsdl:operation>
		<wsdl:operation name="isPublic">
			<soap:operation
				soapAction="http://textgrid.info/namespaces/middleware/tgauth/isPublic" />
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
			<wsdl:output>
				<soap:body use="literal" />
			</wsdl:output>
		</wsdl:operation>
		<wsdl:operation name="getNumberOfResources">
			<soap:operation
				soapAction="http://textgrid.info/namespaces/middleware/tgauth/getNumberOfResources" />
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
			<wsdl:output>
				<soap:body use="literal" />
			</wsdl:output>
		</wsdl:operation>
		<wsdl:operation name="getProjectDescription">
			<soap:operation
				soapAction="http://textgrid.info/namespaces/middleware/tgauth/getProjectDescription" />
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
			<wsdl:output>
				<soap:body use="literal" />
			</wsdl:output>
		</wsdl:operation>
		<wsdl:operation name="getDeactivatedProjects">
			<soap:operation
				soapAction="http://textgrid.info/namespaces/middleware/tgauth/getDeactivatedProjects" />
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
			<wsdl:output>
				<soap:body use="literal" />
			</wsdl:output>
		</wsdl:operation>
		<wsdl:operation name="getSupportedUserAttributes">
			<soap:operation
				soapAction="http://textgrid.info/namespaces/middleware/tgauth/getSupportedUserAttributes" />
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
			<wsdl:output>
				<soap:body use="literal" />
			</wsdl:output>
		</wsdl:operation>
		<wsdl:operation name="getMyUserAttributes">
			<soap:operation
				soapAction="http://textgrid.info/namespaces/middleware/tgauth/getMyUserAttributes" />
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
			<wsdl:output>
				<soap:body use="literal" />
			</wsdl:output>
			<wsdl:fault name="authenticationFault">
				<soap:fault use="literal" name="authenticationFault" />
			</wsdl:fault>
		</wsdl:operation>
		<wsdl:operation name="getSid">
			<soap:operation
				soapAction="http://textgrid.info/namespaces/middleware/tgauth/getSid" />
			<wsdl:input>
				<soap:body use="literal" />
			</wsdl:input>
			<wsdl:output>
				<soap:body use="literal" />
			</wsdl:output>
		</wsdl:operation>
	</wsdl:binding>

	<!-- ################################################################### -->
	<!-- ## -- Service-Definition --------------------------------------- ## -->
	<!-- ################################################################### -->

	<wsdl:service name="tgextra">
		<wsdl:port binding="tns:binding_tgextra" name="tgextra">
			<soap:address location="https://textgridlab.org/dev/tgauth/tgextra.php" />
		</wsdl:port>
	</wsdl:service>

</wsdl:definitions>