K2 Active Directory Solutions

Helper QUICK START GUIDE

CORPORATE HEADQUARTERS EMEA HEADQUARTERS APAC HEADQUARTERS [ WWW.K2.COM ]

4042 148th Avenue NE 26 Worple Road 9 Shenton Way #06-02
Redmond, WA 98052 Wimbledon Singapore
USA London 068813
PH +1 (425) 883 4200 UK PH +1 65 6327 4110
FAX +1 (425) 671 0411 PH +1 44 (0) 845 612 0912 FAX +1 65 6327 4120
FAX +1 44 (0) 845 612 0911

This information is provided for informational purposes only, and SourceCode Technology Holdings, Inc. makes no warranties, expressed or
implied, with respect to this document or the information contained within it.
Copyright © 2007. SourceCode Technology Holdings Inc. All rights reserved. Patents pending. SourceCode and K2 are registered trademarks
or trademarks of SourceCode Technology Holdings, Inc. in the United States and/or other countries. The names of actual companies and
products mentioned herein may be the trademarks of their respective owners.
K2 Active Directory Solutions Helper
QUICK START GUIDE [WWW.K2.COM]

1 INSTALLATION ........................................................................................................................................... 2
2 CONFIGURING A K2 BLACKPOINT PROCESS ....................................................................................... 2
2.1 ADDING THE REFERENCE ......................................................................................................................... 2
2.2 CONFIGURING THE PROCESS XML FIELD.................................................................................................. 3
2.3 CREATE AN EVENT IN THE PROCESS......................................................................................................... 4
3 POST CONFIGURATION AND ERROR HANDLING ................................................................................. 5

1 INSTALLATION
a) Copy the K2SolutionsHelper.dll into the GAC

2 CONFIGURING A K2 BLACKPOINT PROCESS

2.1 ADDING THE REFERENCE

a) Open any process in K2 Studio

b) Click the “References” button

c) Select K2SolutionsHelper (if this doesn’t appear, ensure it is in the GAC and restart K2Studio)

THIS SOLUTION IS FOR DEMONSTRATION PURPOSES AND IS NOT SUPPORTED BY K2 PAGE 2 OF 5

PAGE 2
K2 Active Directory Solutions Helper
QUICK START GUIDE [WWW.K2.COM]

2.2 CONFIGURING THE PROCESS XML FIELD

a) Create a new K2 XML Field in which we’ll store all user information (e.g called UserInformation).

b) Go to the “Schema” tab and click the “Browse” button.

c) Open the “SampleUserProperties.xsd” file.

d) This will automatically set up the process XML Field to have the right structure.

THIS SOLUTION IS FOR DEMONSTRATION PURPOSES AND IS NOT SUPPORTED BY K2 PAGE 3 OF 5

PAGE 3
K2 Active Directory Solutions Helper
QUICK START GUIDE [WWW.K2.COM]

2.3 CREATE AN EVENT IN THE PROCESS

a) Drag on the Reference Event to the relevant Activity in your process.

b) In the “Event Method Editor” page, click the arrow next to “Add” and choose “Add Constructor”.

c) Select K2SolutionsHelper -> Sourcecode.K2Solutions -> SolutionsHelper -> Constructor().

d) Chose “Add Method” from the “Add” button’s menu.

THIS SOLUTION IS FOR DEMONSTRATION PURPOSES AND IS NOT SUPPORTED BY K2 PAGE 4 OF 5

PAGE 4
K2 Active Directory Solutions Helper
QUICK START GUIDE [WWW.K2.COM]

e) Choose a method (e.g. RetrieveUserInformation) and map fields, using the XML Field for the return field.

3 POST CONFIGURATION AND ERROR HANDLING

a) If you want to update or create users in Active Directory, you’ll need to make the K2 Service Account a
Domain Admin. Otherwise, Domain User permissions should be sufficient.

b) Check the K2 Error List for any errors; this should contain explanatory error messages.

THIS SOLUTION IS FOR DEMONSTRATION PURPOSES AND IS NOT SUPPORTED BY K2 PAGE 5 OF 5

PAGE 5