added file upload
This commit is contained in:
Roland Gruber
parent
fed75050b8
commit
965bec63da
|
|
@ -33,7 +33,7 @@ lists</a><br>
|
||||||
<ul>
|
<ul>
|
||||||
<li>Profile editor</li>
|
<li>Profile editor</li>
|
||||||
<li>Samba 3 domains</li>
|
<li>Samba 3 domains</li>
|
||||||
<li>File upload</li>
|
<li><a href="upload.htm">File upload</a></li>
|
||||||
<li>OU editor</li>
|
<li>OU editor</li>
|
||||||
<li>PDF editor<br>
|
<li>PDF editor<br>
|
||||||
</li>
|
</li>
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,102 @@
|
||||||
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||||||
|
<html>
|
||||||
|
<head>
|
||||||
|
<meta content="text/html; charset=ISO-8859-15"
|
||||||
|
http-equiv="content-type">
|
||||||
|
<title>File upload</title>
|
||||||
|
<link rel="stylesheet" type="text/css" href="style/layout.css">
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
<h1 style="text-align: center;">File upload<br>
|
||||||
|
</h1>
|
||||||
|
<br>
|
||||||
|
<div style="text-align: center;"><img
|
||||||
|
style="width: 886px; height: 162px;" alt="upload"
|
||||||
|
src="images/lam_upload.png"><br>
|
||||||
|
<div style="text-align: left;"><br>
|
||||||
|
<h2>Account selection (masscreate.php)<br>
|
||||||
|
</h2>
|
||||||
|
This is the initial page of the file upload. The user selects the
|
||||||
|
account type for the new upload.<br>
|
||||||
|
<br>
|
||||||
|
<br>
|
||||||
|
<h2>Attribute overview (masscreate.php)</h2>
|
||||||
|
After the account selection LAM will display an overview of the
|
||||||
|
possible and required input columns.<br>
|
||||||
|
The <span style="font-style: italic;">DN</span> attributes (<span
|
||||||
|
style="font-style: italic;">DN suffix</span> and <span
|
||||||
|
style="font-style: italic;">RDN</span>) are static and are always
|
||||||
|
displayed. The default suffix is read from config with <span
|
||||||
|
style="font-weight: bold;">getAccountSuffix()</span> and the list of
|
||||||
|
RDN possibilities is taken from modules.inc - <span
|
||||||
|
style="font-weight: bold;">getRDNAttributes()</span>.<br>
|
||||||
|
The next attributes are read from modules.inc - <span
|
||||||
|
style="font-weight: bold;">getUploadColumns()</span>. LAM will display
|
||||||
|
all attributes of one module in a separate fieldset. The <span
|
||||||
|
style="font-weight: bold;">getUploadColumns()</span> function also
|
||||||
|
returns if an attribute is required and additional information like an
|
||||||
|
example value.<br>
|
||||||
|
<br>
|
||||||
|
After clicking the upload button the user will be forwarded to the
|
||||||
|
account building page.<br>
|
||||||
|
<br>
|
||||||
|
<br>
|
||||||
|
<h2>Account building (massBuildAccounts.php)<br>
|
||||||
|
</h2>
|
||||||
|
This part takes the submitted <span style="font-weight: bold;">CSV file</span>
|
||||||
|
and generates the LDAP accounts.<br>
|
||||||
|
<br>
|
||||||
|
The scripts separates the head row from the data rows in the CSV file.
|
||||||
|
The head array is used to find the position of the input values. The
|
||||||
|
data array contains one subarray for each account.<br>
|
||||||
|
<br>
|
||||||
|
After the data has been extracted there are some basic checks done,
|
||||||
|
e.g. checking required and unique columns. The modules provide the
|
||||||
|
necessary information for this.<br>
|
||||||
|
<br>
|
||||||
|
Then all data is given to the modules with <span
|
||||||
|
style="font-weight: bold;">buildUploadAccounts()</span> in
|
||||||
|
modules.inc. They return a list of accounts which can be uploaded with <span
|
||||||
|
style="font-style: italic;">ldap-add()</span> and generate possible
|
||||||
|
error messages.<br>
|
||||||
|
<br>
|
||||||
|
If the accounts are built the script will give the user the possibility
|
||||||
|
to check the result with an <span style="font-style: italic;">LDIF-file</span>
|
||||||
|
or to do the upload.<br>
|
||||||
|
<br>
|
||||||
|
<br>
|
||||||
|
<h2>LDIF export (massBuildAccounts.php)<br>
|
||||||
|
</h2>
|
||||||
|
LAM simply takes the built accounts and generates an <span
|
||||||
|
style="font-style: italic;">LDIF-file</span> from them. This is passed
|
||||||
|
to the user's browser.<br>
|
||||||
|
The <span style="font-style: italic;">LDIF-file</span> will only
|
||||||
|
contain the accounts itself. If modules do additional tasks after the
|
||||||
|
upload (e.g. adding users to groups) this will not be covered.<br>
|
||||||
|
<br>
|
||||||
|
<br>
|
||||||
|
<h2>Account creation (massDoUpload.php)<br>
|
||||||
|
</h2>
|
||||||
|
This script finally uploads the LDAP accounts with <span
|
||||||
|
style="font-style: italic;">ldap_add()</span>.<br>
|
||||||
|
<br>
|
||||||
|
The upload can last longer than the maximum execution time of PHP.
|
||||||
|
Therefore the script will check regulary how much time is left and
|
||||||
|
pause the upload. This is resumed with a meta refresh which loads the
|
||||||
|
script again.<br>
|
||||||
|
<br>
|
||||||
|
After all accounts were created in LDAP the modules may do additional
|
||||||
|
tasks. LAM will call <span style="font-weight: bold;">doUploadPostActions()</span>
|
||||||
|
and also provide a list of failed accounts which can be ignored. The
|
||||||
|
function is called as long the returned status is <span
|
||||||
|
style="font-style: italic;">"inProgress"</span>. The script uses again
|
||||||
|
a
|
||||||
|
meta refresh to handle the maximum execution time.<br>
|
||||||
|
Typical post actions are setting quotas or adding an user to groups.<br>
|
||||||
|
<br>
|
||||||
|
A progress bar is shown for the LDAP adding and the module actions to
|
||||||
|
give the user a hint how long it will still take.<br>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
Loading…
Reference in New Issue