SharePoint Service V2
The SharePoint Service V2 Service Type is used to expose SharePoint 2010 and SharePoint 2007 Lists and Libraries as SmartObjects. It provides read and write capabilities to read, update, delete, list and add attachments in Libraries and Lists, and is also used to read user information such as user details, colleagues, peers, managers and direct reports.
Service Authentication
The following Authentication Modes may be used with the Service Type:
- Impersonate
- ServiceAccount
- Single Single-on
- Static
Service Keys (Service Instance Configuration Settings)
| Key | Can be modified | Data Type | Sample Value | Notes |
|---|---|---|---|---|
| SharePointSiteURL | Yes |
Text |
http://portal.denallix.com/site1 | Enter the SharePoint Site URL. |
| List | Yes | Text | Orders;Accounts | Leave this setting blank or specify a list or library name, using a semicolon if more than one list or library is specified. |
| SmartObjectSettings | Yes | Text | This field is for internal use of the SharePoint K2 SmartObject Service Management feature. Leave this setting blank or enter a SmartObject Associations that is set as parameters in this field. | |
| Dynamic | Yes | True/ False | False | This is a Boolean field. Enter either True or False value. Dynamic service instances allow you to change the site URL. |
| ConnectionString | Yes | Text | Integrated=True;IsPrimaryLogin=True;Authenticate=True ;EncryptedPassword=False;Host=DENNALIX | The connection string values for the SharePoint Server. |
| Version | Yes | Text | 4.10060.1129.0 | This ties to the K2 service type assembly version (the file version of SourceCode.SmartObjects.Services.SharePointV2.dll, which can be found in \Program Files (x86)\K2 blackpearl\ServiceBroker\). |
| DoNotCreateSo | Yes | True/ False | False | If True , K2 will not automatically generate SmartObjects for the Service Objects. Default is False |
| ReturnInternalValue | Yes | True/ False | False |
If True, lookup fields are returned in the format ID;#Value. See KB001154: Behavior change – the return of a lookup value from a SharePoint SmartObject Service is now configurable for more information. |
Service Objects
K2 will generate Service Objects for the Lists and Libraries in the targeted Site. If values were entered into the List Service Key, only the specified Lists/Libraries are exposed as Service Objects.
SmartObjects
K2 automatically generates SmartObjects for these Service Objects, unless the DoNotCreateSo Service Key is set to True. SmartObjects are automatically created when selecting the Generate SmartObjects for this Service Instance check box when creating a new Service Instance. Designers may use the available Service Objects in this service to create advanced SmartObjects using the available K2 SmartObject design tools. It is recommended to use the K2 Design tools to create SmartObjects rather than generating SmartObjects, since this allows better control over the naming, behavior and design of the SmartObject and its methods and properties.
Considerations
- This service requires that the K2 for SharePoint integration is deployed to SharePoint, and the solutions activated to each WFE. If you want to integrate with SharePoint using the client side object model (CSOM) in SharePoint 2010, you should use the SharePoint Content service type
- Service instances are configured per site, and you may limit which list and libraries are exposed as Service Objects.