Assembly Endpoint Service

General Information about the Assembly Endpoints

The Assembly Endpoint supports all Generic Collections that implement System.Collections.Generic.IEnumerable<T> interface.

The Default configuration that is used is the K2HostServer.exe.Config it can be accessed via code

var value = System.Configuration.ConfigurationManager.AppSettings["anykey"];

It is also possible to have a config file just for the assembly, however it will have to explicitly use it

var appConfig = System.Configuration.ConfigurationManager.OpenExeConfiguration(System.Reflection.Assembly.GetExecutingAssembly().Location);

var value = appConfig.AppSettings.Settings["anykey"].Value;

Referenced assemblies needs to be placed in the %ProgramFiles%\K2 blackpearl\ServiceBroker or the %ProgramFiles%\K2 blackpearl\Host Server\Bin directory or can be registered in the GAC.

The Service Instance Configuration wizard screen adds new Assembly Endpoint Service Instances. Two screens are used to configure the Service Instance.

Required fields are marked in red as in Assembly FullPath in the image below.

Fig. 1. Assembly Endpoint Service - Service Instance Configuration Screen 1

Option	What it is
Assembly Full Path	The full path, relative to the K2 Server, to the assembly. UNC paths are supported.
Serialization: Compress:	Compress the serialization data for complex types. Default value: False.
Serialization: Include All Assembly types	Includes all available serialization objects regardless of usage in public methods. Default value: True.
Names: Append Property Types	Includes the property type in parentheses after the complex property name. Default value: True.
Names: Use Method FullName	Uses the full name of the method including the property names and types. Default value: True.
Debugging Enabled	Displays stack trace information in dialog and error information. Default value: False.
Security Provider	Specifies the Security Provider. Not applicable to this service
User Name	Specifies the User Name that should be used to access the specified Server
Password	Specifies the Password that should be used to access the specified Server
Extra	Provides additional information, for example dll paths needed. Not applicable to this service
Impersonate	The impersonate option allows the K2HostServer service account to impersonate the user.

When configuring the rights the following applies:

If the User Name and password is configured and the Impersonate checkbox is selected (set to True) the service will ignore the User Name and password and use Impersonate.
If the User Name and password is configured and the Impersonate checkbox is not selected (set to False) the service will use SQL Authentication.
If the User Name and password is not configured and the Impersonate checkbox is not selected (set to False) the service will use the K2 Service Account.
If only the User Name and password is configured the service will use SQL Authentication.

The second Service Instance Configuration screen:

Fig. 2. WebService Endpoint Service - Service Instance Configuration Screen 2

Option	What it is
System Name	Automatically generated System Name for the new Service Instance
Display Name	Provides an automatically generated display name for the new Service Instance. The display name can be edited to be more user friendly. This allows users to distinguish between different Oracle Service Instances as multiple Oracle Service Instances can be created
Description	Provides a description for the new Service Instance

Example Code

The following code is a very simple example of two methods in the Assembly Broker:

Copy
public static int AddTwoNumbers(int Number1, int Number2) { return Number1 + Number2; } public static string ConcatTwoStrings(string string1, string string2) { return string.Concat(string1, " ", string2); }

Copy

public static int AddTwoNumbers(int Number1, int Number2)

{
return Number1 + Number2;
}

public static string ConcatTwoStrings(string string1, string string2)

{
return string.Concat(string1, " ", string2);
}

The input properties to the method will be your input properties to the Endpoint and the RETURN will be the results showing.