nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

User creation

Uldis_Silovs

I'm new to web services and not an expert in java or #c

anyway i'm looking for how to use livelink webservices to create a new user in Livelink

i cannot find any dedicated funciton (like createuser) in Enterprise Web Services 9.7.1 API

There is public Member createMember(Member member), but what here is Member object

how it look like?

could someone please provide some simple example for creating new user in Livelink using web services

Thanks

Uldis

Find more posts tagged with

Comments

Kyle_Swidrovich

Hi Uldis,

You’re looking for the MemberService functions.

In Enterprise Web Services, both users and groups are considered to be “Members”.

In particular, you’re looking for this function (createMember):

https://knowledge.opentext.com/knowledge/Livelink.exe/wiki/15622433/com.opentext.livelink.service.memberservice.MemberService_JAXWS#createMember(com.opentext.livelink.service.memberservice.Member)

public Member createMember(Member member)

Create a member in the system

Parameters:

member - Information about the member to create

Returns:

Returns the created member. Throws fault exception with codes: MemberService.MemberObjectRequired, MemberService.MemberIdMustNotBePreSet, MemberService.MemberNameRequired, MemberService.GroupIDRequired, MemberService.PasswordRequired, MemberService.CouldNotGetUapiSession, MemberService.CouldNotCreateUser, MemberService.CouldNotCreateGroup, MemberService.MemberTypeUserOrGroupRequired.

You need to pass in a “Member” object to this method.

Since both a “User” object and a “Group” object are extensions of a “Member” object, you can simply fill out the necessary properties of a “User” object and pass that in:

https://knowledge.opentext.com/knowledge/Livelink.exe/wiki/15622433/com.opentext.livelink.service.memberservice.User

The only required fields are Name, Password and DepartmentGroupID (what base group they will belong to).

All other fields are optional.

There’s one tricky optional bit – setting the TimeZone property for a user.

The TimeZone field is an integer based on its 1-based offset in the list of Time Zones on the ?func=user.edituser page for the user in the GUI. The dynamic mapping of this integer to its text representation is not yet natively possible as it is not exposed in any EWS API methods. As such, you’ll need to implement a code-to-human-readable-timezone lookup in your code for assistance.

For convenience, I’ve written the following C# helper function for use in choosing the right integer for your time zone:

private static Dictionary<int, string> timeZones = new Dictionary<int, string>();

private static string lookupTimeZone(int? timeZoneValue)

{

int tzValue = -1;

if (timeZoneValue != null)

tzValue = (int)timeZoneValue;

if (timeZones.Count == 0)

{

timeZones.Add (-1, "");

timeZones.Add (1, "U.S. Pacific");

timeZones.Add (2, "U.S. Mountain");

timeZones.Add (3, "U.S. Central");

timeZones.Add (4, "U.S. Eastern");

timeZones.Add (5, "U.S. Alaska");

timeZones.Add (6, "U.S. Hawaii");

timeZones.Add (7, "--------------------");

timeZones.Add (8, "GMT -12:00 Dateline");

timeZones.Add (9, "GMT -11:30");

timeZones.Add (10, "GMT -11:00 Samoa");

timeZones.Add (11, "GMT -10:30");

timeZones.Add (12, "GMT -10:00 Hawaiian");

timeZones.Add (13, "GMT -09:30");

timeZones.Add (14, "GMT -09:00 Alaskan");

timeZones.Add (15, "GMT -08:30");

timeZones.Add (16, "GMT -08:00 Pacific");

timeZones.Add (17, "GMT -07:30");

timeZones.Add (18, "GMT -07:00 Mountain");

timeZones.Add (19, "GMT -06:30");

timeZones.Add (20, "GMT -06:00 Central");

timeZones.Add (21, "GMT -05:30");

timeZones.Add (22, "GMT -05:00 Eastern");

timeZones.Add(23, "GMT -04:30");

timeZones.Add (24, "GMT -04:00 Atlantic");

timeZones.Add (25, "GMT -03:30 Newfoundland");

timeZones.Add (26, "GMT -03:00 Brasilia, Buenos Aires");

timeZones.Add (27, "GMT -02:30");

timeZones.Add (28, "GMT -02:00 Mid-Atlantic");

timeZones.Add (29, "GMT -01:30");

timeZones.Add (30, "GMT -01:00 Azores");

timeZones.Add (31, "GMT -00:30");

timeZones.Add (32, "Greenwich Mean Time");

timeZones.Add (33, "GMT +00:30");

timeZones.Add (34, "GMT +01:00 Western Europe");

timeZones.Add (35, "GMT +01:30");

timeZones.Add (36, "GMT +02:00 Eastern Europe");

timeZones.Add (37, "GMT +02:30");

timeZones.Add (38, "GMT +03:00 Russia, Saudi Arabia");

timeZones.Add (39, "GMT +03:30 Iran");

timeZones.Add (40, "GMT +04:00 Arabian");

timeZones.Add (41, "GMT +04:30");

timeZones.Add (42, "GMT +05:00 West Asia");

timeZones.Add (43, "GMT +05:30 India");

timeZones.Add (44, "GMT +06:00 Central Asia");

timeZones.Add (45, "GMT +06:30");

timeZones.Add (46, "GMT +07:00 Bangkok, Hanoi, Jakarta");

timeZones.Add (47, "GMT +07:30");

timeZones.Add (48, "GMT +08:00 China, Singapore, Taiwan");

timeZones.Add (49, "GMT +08:00 Australia (WT)");

timeZones.Add (50, "GMT +08:30");

timeZones.Add (51, "GMT +09:00 Korea, Japan");

timeZones.Add (52, "GMT +09:30 Australia (CT)");

timeZones.Add (53, "GMT +10:00 Australia (ET)");

timeZones.Add (54, "GMT +10:30");

timeZones.Add (55, "GMT +11:00 Central Pacific");

timeZones.Add (56, "GMT +11:30");

timeZones.Add (57, "GMT +12:00 Fiji, New Zealand");

}

return timeZones[tzValue];

}

If I get a chance (won’t be soon), I’ll try to provide a sample on OTDN for the general public to peruse, demonstrating all MemberService methods.

Regards,

________________________________________

Kyle Swidrovich

Principal Search / SDK Product Specialist
Livelink Escalations Support Team
Open Text Corporation

275 Frank Tompa Dr.
Waterloo, ON, CANADA

Phone : +1-800-540-7292
Online: http://support.opentext.com
_________________________________________

Uldis_Silovs

Thanks Kyle! For start this is enough

Dave_Ross

Quoted Kyle Swidrovich (kswidrov) on 2010/03/19 17:49:

If I get a chance (won’t be soon), I’ll try to provide a sample on OTDN for the general public to peruse, demonstrating all MemberService methods.

Hi Kyle,

Any chance of getting that code example for creating a user Member using MemberService methods? It would be really appreciated.

Thanks!

Dave Ross

Jason_Smith

Here is a quick C# example of how to create a user:

// Setup the basic user information to create the user

User user = new User();

user.Name = name;

user.Password = "";

user.DepartmentGroupID = DEFAULT_GROUP_ID;

// Create the user in Content Server

user = (User) MemberServiceInstance.CreateMember( MemberServiceAuth, user );

Kyle_Swidrovich

Quoted Dave Ross (dave.j.ross@watson.com) on 2010/03/22 10:03:

Quoted Kyle Swidrovich (kswidrov) on 2010/03/19 17:49:

If I get a chance (won’t be soon), I’ll try to provide a sample on OTDN for the general public to peruse, demonstrating all MemberService methods.

Hi Kyle,

Any chance of getting that code example for creating a user Member using MemberService methods? It would be really appreciated.

Thanks!

Dave Ross

I've posted what should be a working sample of methods in the MemberService component of EWS here in the Samples section:

https://knowledge.opentext.com/knowledge/llisapi.dll/Properties/17485166

Best regards,

Kyle

Dave_Ross

Thanks so much Kyle. That was extremely helpful (especially about how to set user privileges; I was banging my head on the wall with enabling logins and allowing public access).

One other questions if I may:

Our system is set up to use Directory Services for authentication, so I'd like to be able to "hide" the password for newly created users so that they use DS for authentication. Can that be done through EWS at user creation time? Or is there a way after a user is created to set them to use DS authentication?

Thanks again for all your help.

Dave_Ross

Kyle,

One other question:

I tried to implement the create new group function in your code (which is very clearly documented. Thanks!). But when I uncomment and set the newGroup.LeaderID property using the ID of an active user, the createmember function completes and creates the group without error, but there is no Group Leader or members in the group. I even attempted to add the user to the group after creating it, and then attempt to update the LeaderID property, but no luck.

Are there some additional permissions or properties that need to be set for the user and/or group to set a group leader?

Thanks again for your help,

daver

Kyle_Swidrovich

Quoted Dave Ross (dave.j.ross@watson.com) on 2010/03/22 21:27:

Thanks so much Kyle. That was extremely helpful (especially about how to set user privileges; I was banging my head on the wall with enabling logins and allowing public access).

One other questions if I may:

Thanks again for all your help.

I don't believe you can mark a user as "Externally Authenticated" through the standard API. I know that some work is being done on Directory Services, so perhaps they may have something that would allow you to do that. I would recommend contacting Open Text Customer Support to have a DS + SDK specialist look into this for you.

Kyle_Swidrovich

Quoted Dave Ross (dave.j.ross@watson.com) on 2010/03/23 18:17:

Kyle,

One other question:

Are there some additional permissions or properties that need to be set for the user and/or group to set a group leader?

Thanks again for your help,

daver

Hi Dave,

Setting the LeaderID on a group at the time the group is created does store the LeaderID value in KUAF against that group, however, you still need to add that "leader" user to the group for that to take effect. Once you've created the group with the LeaderID specified, try adding that user to the new group and see if they automatically appear as the leader of the group.

-- Kyle

Dave_Ross

I was concerned about that. I did create a ticket (852964) but having trouble getting it escalated. Any suggestions for a good escalation point? It's kind of an important part in automating our user creation process.

Dave_Ross

Thanks! I tried everything but that. Worked like a charm. This thread has been very helpful.

Kyle_Swidrovich

Quoted Dave Ross (dave.j.ross@watson.com) on 2010/03/23 21:48:

Hi Dave,

I've reviewed that particular ticket and it looks like you're in the midst of the initial scoping of the problem. Once this has been successful, the specialist can proceed to research the issue for you in detail. If the specialist needs further assistance, senior resources and/or escalation resources will be pulled in. I will contact that particular specialist and clarify the issue to ensure that they are on track.

Regards,

Kyle