Novell Documentation: iManager 2.0 - Параметры и примеры команд

Параметры и примеры команд

No Action

При передаче этой команды из командной строки в режиме анонимного доступа инициируется действие eGuideForm. В режиме принудительной аутентификации загружается AuthForm.

Параметр

Параметр	Описание
None

Пример

http://www.domainname.com/eGuide/servlet/eGuide

AuthForm

Это действие по умолчанию в режиме принудительной аутентификации. Настраиваются начальные фреймы страниц регистрации, а также используется Authform.XSL, инициирующий действия AuthHeader AuthBody.

Параметры

Параметры	Описание
Action=AuthForm
User.context=rypxSbuoirAi	Создание нового сеанса с пустым User.context

Примеры

Режим принудительной аутентификации:

http://www.domainname.com/eGuide/servlet/eGuide

Только режим принудительной аутентификации:

http://www.domainname.com/eGuide/servlet/eGuide?Action=AuthForm

ПРИМЕЧАНИЕ: если нужно создать тему без фреймов, удалите ссылки на AuthHeader и AuthBody в Authform.XSL. Поскольку Authbody.XSL загружается в процессе аутентификации по умолчанию Authform.XSL и Authbody.XSL должны содержать одинаковую информацию.

AuthHeader

Это действие вызывается после AuthForm для завершения настройки фреймов. Файл Authheader.XSL загружается по умолчанию.

Параметры

Параметр	Описание
Action=AuthHeader
User.context=rypxSbuoirAi	Создание нового сеанса с пустым User.context

Пример

Только режим принудительной аутентификации:

eGuide?Action=AuthHeader&User.context=rgyadiof

AuthBody

Это действие вызывается для настройки основной HTML-страницы аутентификации. Доступ к ней можно получить в режиме анонимного доступа с помощью действия Login. Файл Authbody.XSL загружается по умолчанию.

Параметры

Параметр	Описание
Action=AuthBody
User.context=rypxSbuoirAi	Создание нового сеанса с пустым User.context

Примеры

Только режим принудительной аутентификации:

eGuide?Action=AuthBody&User.context=rgyadiof

Режим анонимного доступа:

eGuide?Action=Login&User.context=rgyadiof

Detail.get

Эти действия отображают информацию элемента LDAP из указанного Каталога.

Параметры

Параметр	Описание
Action=Detail.get	Действие
User.dn=cn=name,ou=name2,o=novell	Характерное имя элемента
Directory.uid=Имя_Каталога	Это имя нужно узнать у системного администратора eGuide
Object.uid=USER	Категория, в которой определен элемент

Необязательный параметр	Описание
User.context=	Элемент управления сеансом
stsh=other.xsl	Определяет таблицу стилей, отличную от принятой по умолчанию
RecurseDN=false	Чтение DN и возвращение информации, определенной в DN

Пример

eGuide?User.context=rytuUjkhhkAi&Action=Detail.get&User.dn=cn=userid,ou=org,o=Novell&Directory.uid=Extensive&Object.uid=USER'

DetailEdit

Обратитесь к разделу Detail.get и замените указанное там действие на те действия, которые необходимы. Разница только в том, что в документе XML содержится дополнительная информация для этих действий.

DetailModify

DetailUpdate

Это действие обновляет элемент LDAP в каталоге и возвращает результаты.

ПРИМЕЧАНИЕ: измененные атрибуты возвращаются в eGuide вместе с именем ключа атрибута и значением. Значение должно быть создано в формате XML и должно быть свернуто с тегом CDATA. Если в значении будет найдено ключевое слово "nochange" (нет изменений), атрибут будет игнорирован и не будет обновлен.

Параметры

Параметр	Описание
Action=DetailUpdate	Действие
User.dn=cn=name,ou=name2,o=novell	Характерное имя элемента
Directory.uid=Имя_Каталога	Это имя нужно узнать у системного администратора eGuide
Object.uid=USER	Категория, в которой определен элемент
AttributeKeyName=<undefined><value><![CDATA[new value]]</value></undefined>

Необязательный параметр	Описание
User.context=	Элемент управления сеансом
stsh=other.xsl	Определяет таблицу стилей, отличную от принятой по умолчанию
RecurseDN=false	Заменяет DN на информацию пользователя. Значение по умолчанию - "True" (Истина).

Пример

<form action="eGuide?&Action=DetailUpdate method="post" > 
     <input name=Directory.uid type=hidden value="novell"> 
     <input name="User.context" type="hidden" value="eiadyda"> 
     <input name="Object.uid" type="hidden" value="USER"> 
      <input name="User.dn" type="hidden" value="cn=name,ou=organUnit,o=novell"> 
     <input name="TITLE" type="text" value="<undefined><value> <![CDATA[new value]]> 
</value> </undefined>" > 
</form>

eGuideForm

Действие по умолчанию в режиме анонимного доступа или после завершения процесса аутентификации в режиме принудительной аутентификации.

Параметры

Параметр	Описание
Action= eGuideForm	Действие
User.context=rypxSbuoirAi	Создание нового сеанса с пустым User.context

Необязательный параметр	Описание
stsh=otherform.xsl	Используется для указания таблицы стилей, отличной от принятой по умолчанию

Пример

Режим анонимного доступа:

eGuide

или

eGuide?Action=eGuideForm&User.context=rgyadiof&stsh=otherform.xsl

eGuideHeader

Вызывается из Eguideform.XSL и используется для настройки категорий и атрибутов поиска eGuide.

Параметры

Параметр	Описание
Action=eGuideHeader	Действие
User.context=rypxSbuoirAi	Создание нового сеанса с пустым User.context
Search.rows=1	Число строк поиска, отображаемых по умолчанию

Необязательный параметр	Описание
stsh=otherform.xsl	Используется для указания таблицы стилей, отличной от принятой по умолчанию

Пример

eGuide

или

eGuide?Action=eGuideForm&User.context=rgyadiof&stsh=otherform.xsl

eGuide.verifyCredentials

Используется в процессе аутентификации для осуществления аутентифицированного соединения с Каталогом и проверки идентификационной информации и паролей пользователей.

Параметры

Параметр	Описание
Action=eGuide.verifyCredentials	Действие
User.context=rypxSbuoirAi	Создание нового сеанса с пустым User.context
Value1=	DN пользователя для аутентификации
Value2=	Пароль

Необязательный параметр	Описание
RememberUserInfo=true	Если установлено значение "true" (истина), то идентификационная информация и пароль сохраняются в виде "cookie" в навигаторе

Пример

eGuide?eGuide.verifyCredentials&User.context=rypxSbuoirAi&DN=cn=Admin,o=novell

eGuide.verifyNewPassword

Используется, если определено, что срок действия пароля завершен и пароль нужно изменить.

Параметры

Параметр	Описание
Action=eGuide.verifyNewPassword	Действие
User.context=rypxSbuoirAi	Создание нового сеанса с пустым User.context
OldPassword=	Старый пароль
Value1=	Пароль
Value2=	Пароль

Пример

eGuide?Action=eGuide.verifyNewPassword&User.context=rypxSbuoirAi&OldPassword=old &Value1=new psswrd&Value2=new psswrd

eGuide.selectContext

Используется в процессе аутентификации, если выявлено несколько пользователей с одинаковым ИД регистрации.

Параметры

Параметр	Описание
Action=eGuide.selectContext	Действие
User.context=rypxSbuoirAi	Создание нового сеанса с пустым User.context
DN=cn=name,o=container	Выбранное имя DN для аутентификации

Пример

eGuide?eGuide.selectContext&User.context=rypxSbuoirAi&DN=cn=Admin,o=novell

List.get

Это запрос поиска с указанным фильтром, результатом которого является список. Поиск с указанным фильтром осуществляется во всех каталогах, сконфигурированных для этого в утилите администрирования eGuide. Для кэширования результатов поиска, не поместившихся в список с указанным значением результатов, используйте ключ "max", кэшированные списки можно просмотреть, используя действие List.get, описанное ниже.

Параметры

Параметр	Описание
Action=list.get	Действие
val1=значение	Значение для поиска
attr1=атрибут	Имя ключа атрибута
crit1=sw	Критерий для оценки значения
Object.uid=USER	Категория поиска
Search.attributes=attr1,attr2,attr3,...	Возвращаемые в результате поиска атрибуты

Необязательный параметр	Описание
User.context=rypxSbuoirAi	Создание нового сеанса с пустым User.context
Primary.sortkey=attr1	Первый атрибут, использующийся для определения порядка сортировки списка
Secondary.sortkey=attr2	Второй атрибут, использующийся для определения порядка сортировки списка
max=20	Число одновременно отображаемых в навигаторе результатов; служит для ускорения предоставления конечному пользователю результатов выполнения запроса
stsh=otherform.xsl	Служит для указания таблицы стилей, отличной от принятой по умолчанию

Пример

<form action="eGuide?&Action=List.get&Object.uid=USER&User.context=" method="post" > 
 <input name="Search.attributes" type="hidden" value="GIVENNAME,LASTNAME,DEPARTMENT"> 
  <input name="Primary.sortkey" type="hidden" value="LASTNAME"> 
  <input name="Secondary.sortkey" type="hidden" value="GIVENNAME"> 
 <select name="crit1"> 
  <option value="co">contains</option> 
  <option value="eq">equals</option> 
  <option selected="true" value="sw">starts with</option> 
 </select> 
 <select name="attr1"> 
  <option value="GIVENNAME">First Name</option> 
  <option selected="true" value="LASTNAME">Last Name</option> 
 </select> 
 <input size="20" type="text" name="val1"> 
 <input type="Submit"> 
</form>

List.get (Cached list)

С помощью параметров "max" и "start" это действие позволяет получить информацию из ранее кэшированного списка. Использование кэшированного списка позволяет значительно улучшить производительность. Для кэширования результатов в ходе пользовательского сеанса необходимо использовать запрос "list.get" с параметром "max". Значение "start" позволяет eGuide определить место начала чтения кэшированного списка. Используйте значения "prev" и "next" в файле XML для определения стартового значения.

Параметры

Параметр	Описание
Action=list.get	Действие
start=100	Следующая стартовая точка списка
max=20	Число одновременно отображаемых в навигаторе результатов; служит для ускорения предоставления конечному пользователю результатов выполнения запроса

Необязательный параметр	Описание
stsh=otherform.xsl	Служит для указания таблицы стилей, отличной от принятой по умолчанию
User.context=rypxSbuoirAi	Создание нового сеанса с пустым User.context

Пример

eGuide?Action=list.get&max=20&start=20&User.context=rypxSbuoirAi

List.get (расширенный)

Это запрос поиска с указанным фильтром, результатом которого является список. Разница между обычным и расширенным действием состоит в возможности расширенного действия передавать любое заданное число значений и атрибутов в запросе для определения фильтра поиска. Любому передаваемому заданному числу значений (параметр val1,val2,val3) должно соответствовать такое же число атрибутов (attr1,attr2,attr3) и ассоциированных критериев (crit1,crit2,crit3), передаваемых в этом же запросе. Все наборы атрибутов, критериев и значений (attr1,crit1,val1), (attr2,crit2,val2) должны быть разделены булевым значением (aoval1).

Параметры

Параметр	Описание
Action=list.get	Действие
val1=valu1&val2=val2&val3=value3
attr1=attribute&attr2=attribute&attr3=attribute3
crit1=sw&crit2=cq&crit3=sw
Object.uid=USER	Категория поиска
Search.attributes=attr1,attr2,attr3,...	Возвращаемые в результате поиска атрибуты

Необязательный параметр	Описание
User.context=rypxSbuoirAi	Создание нового сеанса с пустым User.context
Primary.sortkey=attr1	Первый атрибут, использующийся для определения порядка сортировки списка
Secondary.sortkey=attr2	Второй атрибут, использующийся для определения порядка сортировки списка
aoval1=and	Для расширенных поисков, когда определяется более одного искомого значения
max=20	Указывает число одновременно отображаемых в навигаторе результатов; служит для ускорения предоставления конечному пользователю результатов выполнения запроса
stsh=otherform.xsl	Служит для указания таблицы стилей, отличной от принятой по умолчанию

Login

Обычно вызывается для аутентификации, если eGuide работает в режиме анонимного доступа. Команда запускает процесс аутентификации, и загружается таблица стилей Authbody.XSL.

Параметры

Параметр	Описание
Action=Login	Действие

Необязательный параметр	Описание
User.context=rypxSbuoirAi	Создание нового сеанса с пустым User.context

Пример

eGuide?Action=Login&User.context=rypxSbuoirAi

OrgChart

Это комбинация действий "list" и "detail". Команда осуществляет получение информации о руководителе из указанного Каталога, тогда как подчиненные элементы могут быть получены из нескольких Каталогов.

Параметры

Параметр	Описание
Action=Org.Chart	Действие
Directory.uid=Имя_Каталога
Manager.dn=cn=userid,o=org,o=novell
attr1=Manager
crit1=eq
val1=cn=userid,o=org,o=novell
Search.attributes=GIVENNAME,LASTNAME,ORGCHARTPARENTDN,ORGCHARTISPARENT
Object.uid=USER
User.dn=cn=userid,ou=org,o=novell

Необязательный параметр	Описание
User.context=rypxSbuoirAi	Создание нового сеанса с пустым User.context
stsh=other.xsl	Служит для указания таблицы стилей, отличной от принятой по умолчанию
RecurseDN=false	Возвращение информации пользователя. Значение по умолчанию - "true" (истина).

Пример

eGuide?User.context=rytuUjkhhkAi&Action=Org.Chart&Directory.uid=Extensive&User.dn=cn=nbjensen,ou=eGuide,ou=Demo,o=Novell&Object.uid=USER&Search.attributes=GIVENNAME,INITIALS,LASTNAME,EMAIL,TITLE,ORGCHARTPARENTDN,ORGCHARTISPARENT,&attr1=MANAGER&crit1=eq&Manager.dn=cn=Bgarrett,ou=eGuide,ou=Demo,o=Novell&val1=cn=Bgarrett,ou=eGuide,ou=Demo,o=Novell

OrgChartUpdate

Эта команда используется для обновления атрибута, назначенного ключу ORCHARTPARENT.

Параметры

Параметр	Описание
Action=Org.Chart	Действие
Directory.uid=Имя_Каталога
Manager.dn=cn=userid,o=org,o=novell
attr1=Manager
crit1=eq
val1=cn=userid,o=org,o=novell
Search.attributes=GIVENNAME,LASTNAME,ORGCHARTPARENTDN,ORGCHARTISPARENT
Object.uid=USER
TargetDN=cn=userid,ou=org,o=novell	Пользователь, данные которого изменяются
AttrTargetValue=cn=admin,o=novell	Изменяемое значение
AttrTargetName=ORGCHARTPARENTDN	Имя ключа обновляемого атрибута

Необязательный параметр	Описание
User.context=rypxSbuoirAi	Создание нового сеанса с пустым User.context
stsh=other.xsl	Служит для указания таблицы стилей, отличной от принятой по умолчанию
RecurseDN=false	Возвращение информации пользователя. По умолчанию используется "true" (истина)

Пример

Обратитесь к разделу OrgChart , в качестве параметров добавьте TargetDN, AttrTargetValue и AttrTargetName.

PasswordModify

Эта команда применяется для настройки вида страницы, используемой при изменении пароля. Конечному пользователю будет представлена страница, сформированная в зависимости от исполняемой функции. Администратору пользователей (установленному с помощью утилиты администрирования eGuide) или пользователю с функцией изменения паролей для других пользователей, предоставляется страница с двумя полями для ввода. Обычному конечному пользователю предоставляется страница с тремя полями.

Параметры

Параметр	Описание
Action=PasswordModify	Действие
User.dn=cn=name,ou=name2,o=novell	Характерное имя элемента
Directory.uid=Имя_Каталога	Это имя нужно узнать у системного администратора eGuide
Object.uid=USER	Категория, в которой определен элемент

Необязательный параметр	Описание
User.context=rypxSbuoirAi	Создание нового сеанса с пустым User.context

PasswordUpdate

Параметры

Параметр	Описание
Action=PasswordUpdate	Действие
User.dn=cn=name,ou=name2,o=novell	Характерное имя элемента
Directory.uid=Имя_Каталога	Это имя нужно узнать у системного администратора eGuide
Object.uid=USER	Категория, в которой определен элемент
Value1=	Новый пароль
Value2=	Новый пароль
OldPassword=	Старый пароль

Необязательный параметр	Описание
User.context=rypxSbuoirAi	Создание нового сеанса с пустым User.context

PhotoModify

Эта функция служит для создания страницы, с помощью которой конечный пользователь сможет добавлять или удалять фотографию, а также выражать согласие на размещение фотографии.

Параметры

Параметр	Описание
Action=PhotoModify	Действие
User.dn=cn=name,ou=name2,o=novell	Характерное имя элемента
Directory.uid=Имя_Каталога	Это имя нужно узнать у системного администратора eGuide
Object.uid=USER	Категория, в которой определен элемент

Необязательный параметр	Описание
User.context=	Управление сеансом
RecurseDN=false	Возвращение информации пользователя. Значение по умолчанию - "true" (истина).

ПРИМЕЧАНИЕ: User.context используется для слежения за текущим сеансом пользователя. При выполнении начального запроса User.context можно пропустить, но все последующие страницы должны содержать параметр User.context.