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

• Элемент UserList
  
  Элемент UserList является элементом верхнего уровня в XML-файле.
  
  
• Элемент User
  
  Каждый элемент User содержит сведения о пользователе, который является членом домена. Для каждого пользователя можно назначить одно или несколько устройств линии.
  
  Кроме того, в каждом элементе User можно указать атрибут NoMerge. При наличии данного атрибута перед определением новых назначений устройств все текущие назначения устройств удаляются. С помощью этого атрибута можно легко удалить нежелательные назначения пользователей. По умолчанию данный атрибут не установлен.
  
  Элемент User должен содержать один элемент DomainUserName, указывающий домен и имя пользователя. Элемент User также может содержать один элемент FriendlyName, указывающий понятное имя данного пользователя.
  
  Элемент User может содержать один элемент LineList. Если элемент LineList отсутствует, то удаляются все устройства линии данного пользователя.
  
  
• Элемент LineList
  
  Элемент LineList содержит сведения о каждой линии или каждом устройстве, которые можно назначить данному пользователю. Каждый элемент LineList может содержать несколько элементов Line. Если элемент LineList отсутствует, то удаляются все устройства линии данного пользователя.
  
  
• Элемент Line
  
  Каждый элемент Line определяет устройство линии. Каждое устройство линии необходимо определить, указав элемент Address или PermanentID в элементе Line.
  
  Для каждого элемента Line можно установить атрибут Remove. Если этот атрибут установлен, то назначение пользователя для данного устройства линии отменяется. Если этот атрибут не установлен, то пользователь получает доступ к данному устройству линии. Если данное устройство недоступно пользователю, сообщение об ошибке не выводится.
  
  

• В приведенных ниже примерах XML-кода показано правильное использование определенных выше элементов
  
  
  • В следующем коде с помощью атрибута NoMerge удаляются все устройства линии, назначенные для пользователя User1.
    
    

    <UserList>
      <User NoMerge="1">
    	<DomainUser>domain1\user1</DomainUser>
      </User>
    </UserList>
    

  • В следующем коде с помощью атрибута NoMerge удаляются все устройства, назначенные для пользователя User1, после чего добавляется элемент LineList с одним элементом Line для назначения одного устройства с адресом 99999. Независимо от предыдущих назначений пользователю User1 не будут назначены другие устройства линии.
    
    

    <UserList>
      <User NoMerge="1">
    	<DomainUser>domain1\user1</DomainUser>
    	<FriendlyName>User1</FriendlyName>
    	<LineList>
    	<Line>
    		<Address>99999</Address>
    	</Line>
    	</LineList>
      </User>
    </UserList>
    

  • В следующем коде для пользователя User1 добавляется одно устройство линии без удаления ранее назначенных устройств.
    
    

    <UserList>
      <User>
    	<DomainUser>domain1\user1</DomainUser>
    	<FriendlyName>User1</FriendlyName>
    	<LineList>
    	<Line>
    		<Address>99999</Address>
    	</Line>
    	</LineList>
      </User>
    </UserList>
    

  • В следующем коде пользователю User1 предоставляется доступ к устройству с адресом 99999 и удаляется доступ к устройству с адресом 88888.
    
    

    <UserList>
      <User>
    	<DomainUser>domain1\user1</DomainUser>
    	<FriendlyName>User1</FriendlyName>
    	<LineList>
    	<Line>
    		<Address>99999</Address>
    	</Line>
    	<Line Remove="1">
    		<Address>88888</Address>
    	</Line>
    	</LineList>
      </User>
    </UserList>
    

  • В следующем коде пользователю User1 предоставляется доступ к фиксированному устройству 1000 и удаляется доступ к устройству с адресом 88888.
    
    

    <UserList>
      <User>
    	<DomainUser>domain1\user1</DomainUser>
    	<FriendlyName>User1</FriendlyName>
    	<LineList>
    	<Line>
    		<PermanentID>1000</PermanentID>
    	</Line>
    	<Line Remove="1">
    		<Address>88888</Address>
    	</Line>
    	</LineList>
      </User>
    </UserList>
    

• В следующем примере представлены результаты, которые выводятся при указании в командной строке параметра -d для отображения текущей конфигурации сервера телефонии. Для каждого поставщика услуг телефонии приводится список соответствующих устройств линии, а также адресов и пользователей для каждого устройства.
  
  

  NDIS Proxy TAPI Service Provider
  		Line: "WAN Miniport (L2TP)"
  Permanent ID: 12345678910
  
  NDIS Proxy TAPI Service Provider
  		Line: "LPT1DOMAIN1\User1"
  Permanent ID: 12345678910
  
  Microsoft H.323 Telephony Service Provider
  		Line: "H323 Line"
  Permanent ID: 123456
  Addresses:
  		BLDG1-TAPI32