Creating a custom Integration pack with OIT for SCORCH 2016

Overview

The OIT (Orchestrator Integration Toolkit) is used for creating a custom Integration Pack (IP) and bundling multiple custom activities into one package. The created IP can be imported in SCORCH 2016. Currently there is no OIT version available for SCORCH 2016. The OIT version for SCORCH 2012 (download-link: https://www.microsoft.com/en-us/download/details.aspx?id=39622) also works fine for 2016 but still needs the old version of WiX (3.5) to be installed on the same PC/Server.

For this example I created a simple “Hello World” DLL to be used as a custom SCORCH activity. The SCORCH SDK (also 2012 version) must be available on the development PC, otherwise we cannot build the SCORCH DLL.

Steps to build a SCORCH activity (DLL) in Visual Studio

  • Start a new C# class project in VS, make sure the framework is .Net 3.5, newer versions of the .Net framework are not yet supported. If a newer framework is selected to build the DLL it won’t load into the OIP tool.
  • Add the following reference to the project: Microsoft.SystemCenter.Orchestrator.Integration;This reference is located in:C:\Program Files (x86)\Microsoft System Center 2012\Orchestrator\Integration Toolkit\Bin
  • Example code I used to build a simple DLL
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using Microsoft.SystemCenter.Orchestrator.Integration;
 
namespace iCiber_SCORCH_hello_world
{
    [Activity("HelloWorld")]
    public class HelloWorldActivity
    {
        private string hwinput;
 
        [ActivityInput("Hello World Input")]
        public string HWInput
        {
            set { hwinput = value; }
        }
 
        [ActivityOutput("Hello World Output")]
        public string HWOutput
        {
            get
            {
                char[] arr = hwinput.ToCharArray();
                Array.Reverse(arr);
                return new string(arr);
            }
        }
    }
}
  • Compile the code in Visual Studio

 

Use Orchestrator Integration Kit to build a custom Integration Pack

  • Start the Orchestrator Integration Pack tool and click Next

  • Fill in the details for the IP

  • Add a new Activity to the IP (“Hello World” DLL build in the previous step). Unfortunately if you have multiple custom activities you need to add them one by one.

  • Select the path where you want to save the new IP and click Next

In a next posts I will go into the details on how to use the Custom IP in SCORCH 2016.

Share This Post:

rbruinsma