mirror of https://github.com/apache/jmeter.git
455 lines
12 KiB
HTML
455 lines
12 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
<!--
|
|
Licensed to the Apache Software Foundation (ASF) under one or more
|
|
contributor license agreements. See the NOTICE file distributed with
|
|
this work for additional information regarding copyright ownership.
|
|
The ASF licenses this file to You under the Apache License, Version 2.0
|
|
(the "License"); you may not use this file except in compliance with
|
|
the License. You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
-->
|
|
|
|
<!-- Content Stylesheet for Site -->
|
|
|
|
|
|
<!-- start the processing -->
|
|
<!-- ====================================================================== -->
|
|
<!-- Main Page Section -->
|
|
<!-- ====================================================================== -->
|
|
<html>
|
|
<head>
|
|
<link rel="stylesheet" type="text/css" href="../css/style.css"/>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
|
|
|
|
|
|
<meta name="author" value="Dolf Smits">
|
|
<meta name="email" value="Dolf.Smits@Siemens.com">
|
|
|
|
<title>Apache JMeter - User's Manual: LDAP answer XML description</title>
|
|
</head>
|
|
|
|
<body bgcolor="#ffffff" text="#000000" link="#525D76">
|
|
<table border="0" cellspacing="0">
|
|
<!-- TOP IMAGE -->
|
|
<tr>
|
|
<td>
|
|
<!-- Need to specify height otherwise iframe seems to grab extra -->
|
|
<iframe src="http://www.apache.org/ads/halfbanner.html" height="102"
|
|
style="border-width:0; float: left" frameborder="0" scrolling="no"></iframe>
|
|
</td>
|
|
<td align="left">
|
|
<a href="http://www.apache.org"><img title="Apache Software Foundation" width="387" height="100" src="../images/asf-logo.gif" border="0"/></a>
|
|
</td>
|
|
<td align="right">
|
|
<a href="http://jmeter.apache.org/"><img width="221" height="102" src="../images/logo.jpg" alt="Apache JMeter" title="Apache JMeter" border="0"/></a>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
<table border="0" width="100%" cellspacing="4">
|
|
<tr><td colspan="2">
|
|
<hr noshade size="1"/>
|
|
</td></tr>
|
|
<tr>
|
|
<!-- LEFT SIDE NAVIGATION -->
|
|
<td width="20%" valign="top" nowrap="true">
|
|
<p><strong>About</strong></p>
|
|
<ul>
|
|
<li><a href="../index.html">Overview</a>
|
|
</li>
|
|
<li><a href="../changes.html">Changes</a>
|
|
</li>
|
|
<li><a href="http://projects.apache.org/feeds/rss/jmeter.xml">Subscribe to What's New</a>
|
|
</li>
|
|
<li><a href="../issues.html">Issues</a>
|
|
</li>
|
|
<li><a href="http://www.apache.org/licenses/">License</a>
|
|
</li>
|
|
<li><a href="http://wiki.apache.org/jmeter/JMeterCommitters">Contributors</a>
|
|
</li>
|
|
</ul>
|
|
<p><strong>Download</strong></p>
|
|
<ul>
|
|
<li><a href="../download_jmeter.cgi">Download Releases</a>
|
|
</li>
|
|
<li><a href="../nightly.html">Developer (Nightly) Builds</a>
|
|
</li>
|
|
</ul>
|
|
<p><strong>Documentation</strong></p>
|
|
<ul>
|
|
<li><a href="../usermanual/index.html">User Manual</a>
|
|
</li>
|
|
<li><a href="../usermanual/best-practices.html">Best Practices</a>
|
|
</li>
|
|
<li><a href="../usermanual/component_reference.html">Component Reference</a>
|
|
</li>
|
|
<li><a href="../usermanual/functions.html">Functions Reference</a>
|
|
</li>
|
|
<li><a href="../api/index.html">Javadocs</a>
|
|
</li>
|
|
<li><a href="../localising/index.html">Localisation (Translator's Guide)</a>
|
|
</li>
|
|
<li><a href="../building.html">Building JMeter and Add-Ons</a>
|
|
</li>
|
|
<li><a href="http://wiki.apache.org/jmeter">JMeter Wiki</a>
|
|
</li>
|
|
<li><a href="http://wiki.apache.org/jmeter/JMeterFAQ">FAQ (Wiki)</a>
|
|
</li>
|
|
</ul>
|
|
<p><strong>Tutorials (PDF format)</strong></p>
|
|
<ul>
|
|
<li><a href="../usermanual/jmeter_distributed_testing_step_by_step.pdf">Distributed Testing</a>
|
|
</li>
|
|
<li><a href="../usermanual/jmeter_proxy_step_by_step.pdf">Recording Tests</a>
|
|
</li>
|
|
<li><a href="../usermanual/junitsampler_tutorial.pdf">JUnit Sampler</a>
|
|
</li>
|
|
<li><a href="../usermanual/jmeter_accesslog_sampler_step_by_step.pdf">Access Log Sampler</a>
|
|
</li>
|
|
<li><a href="../extending/jmeter_tutorial.pdf">Extending JMeter</a>
|
|
</li>
|
|
</ul>
|
|
<p><strong>Community</strong></p>
|
|
<ul>
|
|
<li><a href="http://www.apache.org/foundation/getinvolved.html">Get Involved</a>
|
|
</li>
|
|
<li><a href="../mail.html">Mailing Lists</a>
|
|
</li>
|
|
<li><a href="../svnindex.html">SVN Repositories</a>
|
|
</li>
|
|
</ul>
|
|
<p><strong>Foundation</strong></p>
|
|
<ul>
|
|
<li><a href="http://www.apache.org/">ASF</a>
|
|
</li>
|
|
<li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
|
|
</li>
|
|
<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a>
|
|
</li>
|
|
</ul>
|
|
</td>
|
|
<td width="80%" align="left" valign="top">
|
|
<br>
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
<tr><td bgcolor="#525D76">
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
<a name="ldapans_xml"><strong>description of the ldapanswer XML definition</strong></a><a class="sectionlink" href="#ldapans_xml" title="Link to here">¶</a></font>
|
|
</td></tr>
|
|
<tr><td>
|
|
<blockquote>
|
|
<p>
|
|
|
|
The extended LDAP sampler was built to support testing for very complex testpurposes.
|
|
It was aimed at supporting the LDAP operations as close as possible.
|
|
As the results are not passed back in a user-readable form, I invented my own xml definition to
|
|
construct an answer in xml encoding, so the results may be parsed with regextracter or alike functions.
|
|
|
|
</p>
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
<tr><td bgcolor="#828DA6">
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
<a name="overview"><strong>1 Global overview</strong></a>
|
|
<a class="sectionlink" href="#overview" title="Link to here">¶</a></font>
|
|
</td></tr>
|
|
<tr><td>
|
|
<blockquote>
|
|
<p>
|
|
|
|
The global structure is as follows:
|
|
<br>
|
|
|
|
|
|
|
|
|
|
<ol>
|
|
<li>
|
|
<ldapanswer> and <ldapanswer/> are the begin and endtags which are used to define the beginning ands end of the answer.
|
|
|
|
</li>
|
|
<li>
|
|
each ldapanswer contains 4 sections, an "operation" section (enclosed by
|
|
<operation> tags) a respons code section (enclosed by <responsecode> tags), a
|
|
response message (enclosed by <responsemessage> tags and (only with a search
|
|
request) a searchresult section (enclosed with <searchresult> tags>
|
|
</li>
|
|
</ol>
|
|
|
|
|
|
|
|
</p>
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
<tr><td bgcolor="#828DA6">
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
<a name="operation"><strong>1.1 The operation section</strong></a>
|
|
<a class="sectionlink" href="#operation" title="Link to here">¶</a></font>
|
|
</td></tr>
|
|
<tr><td>
|
|
<blockquote>
|
|
<p>
|
|
|
|
The operation section defines the operation as it is sent to the LDAP Server. The
|
|
following tags (with a short explanation) are used
|
|
|
|
|
|
<ol>
|
|
<li>
|
|
<opertype><br>
|
|
Thise describes which kind of operation was sent, it can have the following values:
|
|
<ol>
|
|
<li>
|
|
bind<br>
|
|
(this code is used for both a thread bind as a single bind/unbind operation)
|
|
</li>
|
|
<li>
|
|
unbind
|
|
</li>
|
|
<li>
|
|
compare
|
|
</li>
|
|
<li>
|
|
add
|
|
</li>
|
|
<li>
|
|
delete
|
|
</li>
|
|
<li>
|
|
modfy
|
|
</li>
|
|
<li>
|
|
rename
|
|
</li>
|
|
<li>
|
|
search
|
|
</li>
|
|
</ol>
|
|
</li>
|
|
<li>
|
|
<attributes>
|
|
This will name all attributes that will be added or modified during an "add" or a "modify"
|
|
operation.
|
|
</li>
|
|
<li>
|
|
<baseobject>
|
|
This will hold the value of the root or context prefix that will be used in the current session.
|
|
This value is given for any "thread bind" and "thread unbind" operation
|
|
</li>
|
|
<li>
|
|
<binddn>
|
|
This is the DN of the user that is binding to the directory, it is used in the
|
|
"thread bind", "thread unbind" and "single bind" operations.
|
|
</li>
|
|
<li>
|
|
<comparedn>
|
|
This is the DN of the object from which an attribute is compared to a given attributevalue
|
|
It is only used in the "compare" operation.
|
|
</li>
|
|
<li>
|
|
<comparefilter>
|
|
This is the filter, in the form (attribute= value) that is used in the "compare" operation.
|
|
</li>
|
|
<li>
|
|
<countlimit>
|
|
This is the maximum number of searchresults that will be returned, as it is requested by the client.
|
|
The actual number might be smaller as the server can have its own countlimit configured.
|
|
This will be used only in search requests.</li>
|
|
<li>
|
|
<dn>
|
|
This is the distinguished name of the object on which the actions are performed.
|
|
It is used in Add, Delete, Modify and ModifyDN operations
|
|
</li>
|
|
<li>
|
|
<newdn>
|
|
This is the new distinghuised name of an object to which the object will be renamed
|
|
or moved, it is used in de ModifyDN operation
|
|
</li>
|
|
<li>
|
|
<scope>
|
|
This is used in search operations, it can be 0 (object), 1 (onelevel) or 2 (subtree).
|
|
It defines the scope of the search which can be limited to the above settings.
|
|
</li>
|
|
<li>
|
|
<searchfilter>
|
|
The searchfilter that will be used in a search request, it should be in proper LDAP syntax.
|
|
</li>
|
|
<li>
|
|
<searchbase>
|
|
The searchbase where a search is started, this is given, relative to the baseobject of the current connection.
|
|
</li>
|
|
<li>
|
|
<timelimit>
|
|
This is the maximum timethe server will use in finding the requested objects.as it is requested by the client.
|
|
The actual number might be smaller as the server can have its own countlimit configured.
|
|
This will be used only in search requests.</li>
|
|
</ol>
|
|
|
|
|
|
|
|
</p>
|
|
</blockquote>
|
|
</td></tr>
|
|
<tr><td><br></td></tr>
|
|
</table>
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
<tr><td bgcolor="#828DA6">
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
<a name="response_message"><strong>1.2 Response message section</strong></a>
|
|
<a class="sectionlink" href="#response_message" title="Link to here">¶</a></font>
|
|
</td></tr>
|
|
<tr><td>
|
|
<blockquote>
|
|
<p>
|
|
|
|
As the response code, the official LDAP error definitions are used, so this section
|
|
contains the error message as returned from the server.
|
|
A succesfull request always returns "Success" as the responsmessage.
|
|
The following tag is used:
|
|
|
|
|
|
<responsemessage><br>
|
|
|
|
</p>
|
|
</blockquote>
|
|
</td></tr>
|
|
<tr><td><br></td></tr>
|
|
</table>
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
<tr><td bgcolor="#828DA6">
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
<a name="response_code"><strong>1.3 Response code section</strong></a>
|
|
<a class="sectionlink" href="#response_code" title="Link to here">¶</a></font>
|
|
</td></tr>
|
|
<tr><td>
|
|
<blockquote>
|
|
<p>
|
|
|
|
As the response code, the official LDAP error definitions are used, so this section
|
|
contains the error number as returned from the server.
|
|
A succesfull request always returns 0 (zero) as the responscode.
|
|
The following tag is used:
|
|
|
|
|
|
<responsecode><br>
|
|
|
|
|
|
|
|
</p>
|
|
</blockquote>
|
|
</td></tr>
|
|
<tr><td><br></td></tr>
|
|
</table>
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
<tr><td bgcolor="#828DA6">
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
<a name="search"><strong>1.4 Search Result section</strong></a>
|
|
<a class="sectionlink" href="#search" title="Link to here">¶</a></font>
|
|
</td></tr>
|
|
<tr><td>
|
|
<blockquote>
|
|
<p>
|
|
|
|
The following tag is used:
|
|
|
|
|
|
<searchresult><br>
|
|
This gives the results from a serachrequest, as they are returned by the server.
|
|
It contains the following tags:
|
|
<ol>
|
|
<li>
|
|
<dn>
|
|
This contains the complete distinghuised name of the object which is represented here
|
|
</li>
|
|
<li>
|
|
<returnedattr>
|
|
This contains the number of returned attributes.
|
|
</li>
|
|
<li>
|
|
<attribute>
|
|
Each returned attribute is given between these tags, it always consists of an
|
|
attribute name and attribute value pair
|
|
<ol>
|
|
<li>
|
|
<attributename>
|
|
This contains the official attributename as returned by the server.
|
|
</li>
|
|
<li>
|
|
<attributevalue>
|
|
This contains the attribute value as returned by the server.
|
|
</li>
|
|
</ol>
|
|
</li>
|
|
</ol>
|
|
|
|
|
|
</p>
|
|
</blockquote>
|
|
</td></tr>
|
|
<tr><td><br></td></tr>
|
|
</table>
|
|
</blockquote>
|
|
</td></tr>
|
|
<tr><td><br></td></tr>
|
|
</table>
|
|
</blockquote>
|
|
</p>
|
|
</td></tr>
|
|
<tr><td><br></td></tr>
|
|
</table>
|
|
<br>
|
|
</td>
|
|
</tr>
|
|
<tr><td colspan="2">
|
|
<hr noshade size="1"/>
|
|
</td></tr>
|
|
<tr><td colspan="2">
|
|
<div align="center"><font color="#525D76" size="-1"><em>
|
|
Copyright © 1999-2012, Apache Software Foundation
|
|
</em></font></div>
|
|
</td></tr>
|
|
<tr><td colspan="2">
|
|
<div align="center"><font color="#525D76" size="-1">
|
|
Apache, Apache JMeter, JMeter, the Apache feather, and the Apache JMeter logo are
|
|
trademarks of the Apache Software Foundation.
|
|
</font>
|
|
</div>
|
|
</td></tr>
|
|
</table>
|
|
</body>
|
|
</html>
|
|
<!-- end the processing -->
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|