summaryrefslogtreecommitdiffstats
path: root/docs/reference/tmpl/data_service.sgml
blob: c3cf17ebcc45a24e058ad8e2aba235c7f944bb9a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
<!-- ##### SECTION Title ##### -->
LassoDataService

<!-- ##### SECTION Short_Description ##### -->
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>

</para>

<!-- ##### SECTION Stability_Level ##### -->


<!-- ##### STRUCT LassoDataService ##### -->
<para>

</para>

@resource_id: 
@encrypted_resource_id: 
@resource_data: 
@provider_id: 
@abstract_description: 

<!-- ##### FUNCTION lasso_data_service_new ##### -->
<para>

</para>

@server: 
@Returns: 


<!-- ##### FUNCTION lasso_data_service_init_query ##### -->
<para>

</para>

@service: 
@select: 
@item_id: 
@Returns: 


<!-- ##### FUNCTION lasso_data_service_add_query_item ##### -->
<para>

</para>

@service: 
@select: 
@item_id: 
@Returns: 


<!-- ##### FUNCTION lasso_data_service_process_query_msg ##### -->
<para>

</para>

@service: 
@message: 
@Returns: 


<!-- ##### FUNCTION lasso_data_service_build_response_msg ##### -->
<para>

</para>

@service: 
@Returns: 


<!-- ##### FUNCTION lasso_data_service_process_query_response_msg ##### -->
<para>

</para>

@service: 
@message: 
@Returns: 


<!-- ##### FUNCTION lasso_data_service_get_answer ##### -->
<para>

</para>

@service: 
@select: 
@Returns: 


<!-- ##### FUNCTION lasso_data_service_get_answer_for_item_id ##### -->
<para>

</para>

@service: 
@item_id: 
@Returns: