summaryrefslogtreecommitdiffstats
path: root/docs/reference
diff options
context:
space:
mode:
Diffstat (limited to 'docs/reference')
-rw-r--r--docs/reference/tmpl/data_service.sgml33
1 files changed, 29 insertions, 4 deletions
diff --git a/docs/reference/tmpl/data_service.sgml b/docs/reference/tmpl/data_service.sgml
index c2c49469..8c70d473 100644
--- a/docs/reference/tmpl/data_service.sgml
+++ b/docs/reference/tmpl/data_service.sgml
@@ -6,9 +6,38 @@ ID-WSF Data Service Profile
<!-- ##### SECTION Long_Description ##### -->
<para>
+XXX
+</para>
+<para>
+Following up on #LassoDiscovery first example, it created a @service object,
+this is a #LassoDataService instance. This example continues from that step
+and retrieves the name of the principal:
</para>
+<informalexample><programlisting><![CDATA[
+char *soap_answer; /* SOAP answer from data service */
+xmlNode *principal_name; /* libxml2 xmlNode with the principal name */
+
+service = lasso_discovery_get_service(discovery);
+lasso_data_service_init_query(service, "/pp:PP/pp:InformalName", NULL);
+lasso_data_service_build_request_msg(service);
+
+/*
+ * service must perform SOAP call to LASSO_WSF_PROFILE(service)->msg_url
+ * the SOAP message is LASSO_WSF_PROFILE(service)->msg_body. The answer
+ * is stored in char* soap_answer;
+ */
+
+lasso_data_service_process_query_response_msg(service, soap_answer);
+principal_name = lasso_data_service_get_answer(service, "/pp:PP/pp:InformalName");
+
+/*
+ * app should probably then use xmlNodeGetContent libxml2 function to get
+ * access to node content.
+ */
+]]></programlisting></informalexample>
+
<!-- ##### SECTION See_Also ##### -->
<para>
@@ -22,10 +51,6 @@ ID-WSF Data Service Profile
</para>
-@parent:
-@resource_id:
-@encrypted_resource_id:
-@resource_data:
<!-- ##### FUNCTION lasso_data_service_new ##### -->
<para>