You are here: Entitlement Management > Enterprise User Identities > addEnterpriseUserIds

Add Enterprise User IDs

Description

Add user IDs to a enterprise named entitlement. The entitlement must be deployed before adding the user IDs.

Default Protocol Method Type URI

HTTPS

POST

addEnterpriseUserIds.xml

Post Parameters

Parameter Description Valid Values Optional

entId

Identifier of the entitlement

Note: The entId is the handle returned by the createEntitlement.xml web service. You can use the searchEntitlements.xml web service to retrieve entId for an entitlement.

Integer

No

userIds

User name.

The input string is truncated to 50 characters.

List of strings (comma separated)

No

Sample Code

import java.io.IOException;
//..............................
//..............................
//..............................
import org.apache.http.params.HttpParams;
public class EMSSample {
   private static DefaultHttpClient httpclient = new DefaultHttpClient();
   private static Principal principal = null;
   //..............................
   //..............................
   //..............................
   public static String addEnterpriseUserIds.xml()throws Exception {
      if(!verifyLogin()){
         return "login failed";
      }
      HttpContext context = new BasicHttpContext();
      context.setAttribute(ClientContext.USER_TOKEN, principal);
      HttpPost post =  new HttpPost("https://localhost:8443/ems/3.6/addEnterpriseUserIds.xml");
      List<NameValuePair> nvps = new ArrayList<NameValuePair>();
      nvps.add(new BasicNameValuePair("entId", ""));
      nvps.add(new BasicNameValuePair("userIds", ""));
      post.setEntity(new UrlEncodedFormEntity(nvps, HTTP.UTF_8));
      HttpResponse response = httpclient.execute(post, context);
      HttpEntity entity = response.getEntity();
      byte[] b = null;
      if (entity != null) {
         long l = entity.getContentLength();
         b = new byte[(int) l];
         entity.getContent().read(b);
         entity.consumeContent();
      }
      return new String(b);
   }
}

Sample Response

<?xml version="1.0" encoding="UTF-8"?> 
<emsResponse> 
   <stat>ok</stat> 
</emsResponse>
See Also:

Output Format for Failure

Error codes

Error Code

Description

101

You are not authorized to use this service.

107

An internal error occurred! Please report the error to System administrator.

118

{field} should be of data type integer. [Note: This error code is applicable for the fields - featureId, License modelId, entId, ftrId, customerId, lmId, templateType, lineItemId, CustomerId, stationCount, status, and granularity.]

122

{field} is a required field and should have a not null value. [Note: This error code is applicable for the fields - Eid, namespaceName, featureName, startDate, endDate, userIds, featureId, productName, productVersion, detailsLM, lmId, templateType, customAttribute, lineItemId, customerRefId, granularity, loginId, oldPassword, and newPassword.]

128

You should log on first.

132 The URL address does not exist.
621 Entitlement does not exist. Retry with a correct ID.

1002

Entitlement is not Activated.

1003

Entitlement is for a Retail Customer.

1004

Enterprise UserIDs not added.

1009 Entitlement is for an unnamed enterprise Customer.

1013

Identity(s) not added. [Note: The reason is dynamic, such as total number of permitted identities exceeded.]

1081 Invalid Web service version provided
1084 No Web service version provided
1088 The EMS system is running on HTTPS. Please provide the correct Web service URL.