Custom Compile of an Integration Pack

Problem

You need to have your own version of one of the Codeplex integration packs. There are numerous reasons that this may be true, the biggest one that people have contacted me about is that people are not allowed to run any software that is not supported by a vendor. This applies to all of the code that I have up on Codeplex. This however does not, in many cases, mean that they could not create an integration pack based off of the work on Codeplex for their own environment. So, how would someone go about doing that?

Pre-Requisites

  • C# Compiler
    • All of the code that I publish on Codeplex is written in C# (my roots are in C) so you will need a C# compiler to use my code (all my work is done in Visual Studio 2010).
  • Source Code
    • This can be downloaded from Codeplex
  • QIK Wizard
    • This can be found in your Opalis Source

Steps for Making an IP

  1. Get The Code
  2. Compile the Code
  3. Wrap with the QIK Wizard
  4. Run in environment

For the purposes of this example I will use my Active Directory IP as an example

 

Step 1: Get the Code

To do this we can simply go out to Codeplex, go to source code, and download the latest version of the code.

What is downloaded is a zip Folder containing the source files. Unpack these into a folder

Step 2: Compile the Code

Now that you have a local version of the code you can open it up with visual studio, add in any missing references and compile.

You want to open the solution file. This will setup the project correctly for you.

 

You now have the project loaded up but you cannot yet compile it (there are errors). This is because all of the reference files do not download, if you expand ‘References’ you will be able to see which references you need to re-add to the project in order for it to compile correctly. The one reference that you will always need to re-add is Opalis.QuickIntegrationKit. This can be found on any machine that has QIK installed.

To re-add the .DLL file simply right click on the references folder and choose ‘Add Reference’

Then choose the reference (for QIK we need to ‘browse’ and locate the actual .DLL file). This will be located at “c:\Program Files\Opalis Software\Quick Integration Kit 3\Bin” on 32 bit systems and “c:\Program Files (x86)\Opalis Software\Quick Integration Kit 3\Bin” on 64 bit systems. You should copy this file local and then add it to your project

 

Add Reference

You should now be able to compile the code

Step 3: Wrap with QIK

Now you need to install the QIK wizard on a machine and point it at the .DLL file that was created from compiling. The compiled .DLL file will be in /bin/release if you compiled ‘release’ or /bin/debug if you compiled ‘debug’

Copy this to a machine with QIK installed then run the QIK Wizard

 

Fill out product information for you OIP

Then Add objects from the .DLL file

Then walk through the rest of the wizard

Step 4: Import the OIP

Use the deployment manager to import the new IP into your environment using your normal change control process

Advertisements
Posted in Uncategorized

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: