Integration Studio is the Agile Platform tool you should use when making low level integrations. This tool allows you to connect with entities from other databases (through Service Center defined Database Connections) and also to define Actions whose operation is determined in "low level" Java or .NET code.
In this post I will guide you through what configurations are needed to allow you to correctly compile and develop Java or .NET source code in Integration Studio.
In the Edit -> Options Menu you will find a tab for each framework (J2EE and .NET) where you can configure the following options for each:
In order to be able to compile extensions with a certain Application Server type, you'll need to correctly configure the Compiler Tool (and possibly the options). In order to be able to Edit the Source code of an extension with a certain Application Server type, you'll need to correctly configure the Integrated Development Environment for that Application Server type.
With these installed the default options in Integration Studio should work. You can always use Reset Settings to replace them.
In case the defaults don't work use the following:
Java SDK is installed normally; for ANT and Eclipse, simply download the ZIP file and extract them to a folder of your choice.
Regarding Eclipse, if you are using Windows Vista or 7 and have UAC enabled (the default) unzip eclipse to a folder outside "Program Files" - this will avoid privileges problems when writing to C:\Program Files\.
Suggestion: create a "C:\opt" folder and put both ANT and Eclipse in it (C:\opt\apache-ant-1.8.4 and C:\opt\eclipse).
To configure ANT and JAVA for Eclipse you need to create system environment variables for their installation paths.
The variables that need to be created are JAVA_HOME and ANT_HOME; for example, your JAVA_HOME could have a value of C:\Program Files\Java\jdk1.6.0_45 and your ANT_HOME could have a value of C:\opt\apache-ant-1.8.4.
After setting the environment variables, you need to perform the following configurations in Integration Studio (Edit -> Options):
Now you should be able to build .NET and Java extensions.
Happy Integrations !
If you have any questions related to this topic, feel free to ask them.
Is there an update for the newer versions of Integration Studio? I was able to figure it out again, but it looks like the inputs have been changing.
Nothing changed for .NET, and Java simply added the possibility to define the Java Home.
I'll update the original post to cover for that.
Hi, I'm trying to configure Integration Studio for Java/J2EE but a couple of problems ...
1) the link for creating system environment variables results in the error "Payment required"But I found another site that explained it to me.
2) skipping that part, the following error occurs after having installend ANT and Eclipse and trying to apply the configurtaion:
This is how my Eclipse installation directory looks like ...
By the way ... I had to choose which package of Eclipse to download ... I chose the first one, the Java EE version.
I deleted the (unpacked zip) installation of Eclipse, re-installed eclipse using the installer, and tried again to configure Integration Studio for J2EE / Oracle ... same result .., "Error copying Integration Plugin into Eclipse plugin directory".
Can you try by running Integration Studio as administrator to see if it helps?
Also, in this last installation does it also have a "plugins" folder there?
Hi Joao, thnx for replying.
Just solved the problem myself ... I had to specify the full path to eclipse, including eclipse.exe, and also the full path to the ant.bat file ... my first tries were the path names without the filenames themselves.
Working now, and successfully created my fist extension :-)
I have set everything up as said in the instruction but when I try to open the java code for editing, no project opens up in the eclipse, only eclipse shows up. I don't get any errors or anything and if I try to open the project directly from folder in eclipse, then after writing the code when I close the eclipse or publish the extension, all of the code that I have written gets deleted. Any Idea what could be causing this?
Note: I'm using Eclipse Neon and my Integration studio version is 9.1.6
So from what I tested and here are some problems that can cause the "plugin" problems and how to fix them.The differences depend on either: eclipse version, installation folder, what eclipse type installed or how it was installed (via installer or zip)
Cause 1: Eclipse is installed in the Program Files and integration Studio cannot install the plugin it needsSymptoms: There is no error closing the preferences window, but eclipse opens without a projectSolution: Run Integration studio in Administrator Mode and change the eclipse path in the preferences window. Check if inside the eclipse folder there is a "\plugins\outsystems.integration.plugin\" directory created after that
Cause 2: Eclipse is configured to not use its own folder as Data Folder.Symptoms: Either there is no "\plugins\" folder and Integration Studio gives an errorSolution: Create a "\plugins\" folder inside the eclipse directory, change the eclipse path in the preferences window. Check if inside the eclipse folder there is a "\plugins\outsystems.integration.plugin\" directory created after that
Regardless of what issue it was, if there is still no project inside eclipse after it opens, then go copy the "outsystems.integration.plugin" directory from "\plugins\" to "\dropins\"
Tell me if it any of these solutions works for you.
Can any other IDE for .NET be used besides Visual Studio? I tried to use SharpDevelop put every time I apply the configurations this popup comes up:
My configurations are the following:
Thanks for the help.
Unfortunately no, you can't use any other IDE for .NET besides Visual Studio. According to OutSystems Platform system requirements (https://success.outsystems.com/Support/Enterprise_Customers/Installation/OutSystems_Platform_system_requirements), you'll need Visual Studio 2013 or higher, to edit the source code of Extension Actions. I don't really know the deep details, but I believe it has to do with how Integration Studio generates all your project structure and configurations which are aimed solely for a Visual Studio project.
Pedro Gonçalves wrote:
Thanks for the quick reply ;)
I wanted to know if the programming language chosed for the Extension has to match with the server platform framework installed. For exemple my server platform is supporter in .Net and I try to create a java extension. Is this possible?
[edited] Sorry, but it is not possible to include a stack's code (e.g. Java) in an extension and publish it in another platform installation's stack (e.g. .NET), due to an Integration Studio validation (e.g. Invalid Extension error)
If you are publishing a double-stack extension (Integration Studio > Extension properties > Application Server: Both) then you may be able to publish that extension yes, however the uninstalled stack will never be executed on that platform installation. This is a common case with double-stack extensions that are included in the platform (e.g. System Components) and others you may find in the Community Forge - only the respective stack code that matches the platform installation will actually be executed.
Hoped I clarified your question!
Regarding the IDE question, you can actually use any Visual Studio compatible IDE, but you won't be able to configure it in the preferences.
After compiling your extension once you can locate the folder that is created in the disk next to the .xif file and open it in your prefered IDE.
The important is that the .NET project files (.sln and .csproj) are still correct after using other IDE (thats why I said compatible IDE), as Integratoon Studio will use them to compile.
Same also applies to Java ...anyone is free to import the project manually in other IDEs like Intellij, the platform will use the Ant build.xml to compile, so as long that ia correct it will work. But for example in this case Intellij will not update the eclipse .project file ...so if other developer goes and tries to edit that extension in eclipse he may not have a correct eclipse project configuration.
So, use them at your own responsibility :)
My personal recommendation is to stick with the latest versions of the officially supported IDEs.
I am having the same problem. Do you manage to fix this issue?
Gurvinder Singh wrote:
Myles Chippendale wrote:
I managed to fix this by re-installing eclipse.
I had originally installed the "Eclipse IDE for Java Development" version of Eclipse Mars using an eclipse installer. I then downloaded the "Java EE Development" version of Eclipse Mars, the version that you just unzip. After changing the path to my eclipse in Integration Studio, it worked.
Ricardo Silva wrote:
What if I don't need Java because I am not writing Java extensions? Integration studio tells me that options are not correctly defined and asks me to setup up options for java environment. But I don't have cause I don't use and I don't want to install it.
In that case you need to set your extension to be ".NET Only".
You can do that by selecting the extension name and on the right pane you have the option to say it's for .net stack only
Thanks, got it.
Hi, I'm using Integration Studio 9.1.301, with JDK 1.8.0_72. I created an empty extension and when I compile I got the following error. Can anyone please see what cause this is? (Original screenshot attached). Thanks.
Hi, while configuring i am getting the error..
João Rosado wrote:
These notes should definitely be moved into the main post.
The objective is not for those to be necessary steps. If all goes well, the next revision (at least for 10.0) should work correctly without the workaround.
Cool! With the current revision at least one step I had to do manually was to copy the plugin to the dropins folder.
I tried to publish my extension and it gives me error that there is no jar file found on the directory?
Can somebody help me pls?