continuing on disco example, use the service to retrieve principal name.

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>