Ricardo Silva
11368Views
81Comments
How to configure Integration Studio to work with .NET and Java / J2EE extensions
Discussion
IntegrationStudio
Java
OS Certified
Integration
Extension
How-to

Permalink: www.outsystems.com/goto/howto-configure-integration-studio



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.


Where and what to configure

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:

  • Integrated Development Environment
  • Compiler Tool
  • Compiler Tool Options
  • Java Home (Java only)

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.


Configuring .NET

What's required?

  • Microsoft .NET Framework 2.0 (OutSystems 5.0-) or 3.5 (OutSystems 5.1 thru 8.0)
  • Microsoft .NET Framework 4.0 (OutSystems 9.0+)
  • Visual Studio 2008 or 2010 (OutSystems 6.0+ only). If using the Express version, install Visual Express C#.

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:

  • Compiler Tool should point to your MSBuild.exe, usually found in "C:\Windows\Microsoft.NET\Framework\v<VERSION>\"
  • Integrated Development Environment should point to your devenv.exe, by default located in "c:\Program Files (x86)\Microsoft Visual Studio 9.0\Common7\IDE\devenv.exe"
  • Compiler Tool Options: just leave the defaults, unless you know exactly what you are doing.


Configuring J2EE

What's required?

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):

  • Integrated Development Environment: path to your eclipse.exe file
  • Compiler Tool: path to the ant.bat script inside ANT_HOME/bin/
  • Compiler Tool Options: you shouldn't need to fill this in
  • Java Home: path to the JAVA_HOME directory.


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.


Best regards,

Ricardo Silva

21
0
on 2012-11-20
Copy link to comment
OLEG YAVO
Rank: #57134
What is Integration Studio ? Is it a separate product or Outsystems ?
0
0
on 2013-07-03
Copy link to comment
- -
Rank: #31
OLEG YAVO wrote:
What is Integration Studio ? Is it a separate product or Outsystems ?
 There are two Outsystems products that you can use...

Outsystems Service Studio -  allows you to build and publish your application and 
Outsystems Integration Studio - allows you to extend the existing functionality and data model of Outsystems Platform.
 
2
0
on 2013-07-03
Copy link to comment
OLEG YAVO
Rank: #57134
Cool ! Thanks a lot !
0
0
on 2013-07-03
Copy link to comment
J.
mvp_badge
MVP
Rank: #14
Hi,

I followed your instructions and I got the following error-messages in eclipse (if I test it with just opening httprequesthandler.xif)

Project 'J2EE' is missing required library: '\RuntimePlatform\lib\commons-fileupload-1.2.1.jar'
Project 'J2EE' is missing required Java project: 'RuntimeCommon'
Project 'J2EE' is missing required Java project: 'RuntimePlatform'
Project 'J2EE' is missing required Java project: 'RuntimeUtil'
The project cannot be built until build path errors are resolved
 
0
0
on 2013-09-03
Copy link to comment
Claudio Lichtenthal
Rank: #0
Do you know of any lightweight version of Visual Studio one can downlaod for free? Thank you!
0
0
on 2014-06-27
Copy link to comment
Curt Raddatz
Rank: #241
Microsoft has express versions of most of it's development products.  A simple Google search shows the following - https://www.visualstudio.com/downloads/download-visual-studio-vs#d-express-windows-8 - which gets you the latest version, 2013.  It may be better to use the 2010 version as it will probably be more compatible.  There is a link at the top of that page for that.
0
0
on 2014-06-27
Copy link to comment
Hi I am trying a couple of extensions to be published in but I am not able to due to this error:

.NET Compilation.

XmlRecords.cs(38,121): warning CS1573: Parameter 'ssDefaultConfig' has no matching param tag in the XML comment for 'OutSystems.NssXmlRecords.CssXmlRecords.MssRecordListToXml(object, OutSystems.NssXmlRecords.RLRecordXmlConfigRecordList, OutSystems.NssXmlRecords.RCDefaultXmlConfigRecord, bool, out string)' (but other parameters do) [C:\Users\CarlosE.MISNET\Desktop\XML.Records-1.5.5\Source\NET\XmlRecords.csproj]
XmlRecords.cs(38,143): warning CS1573: Parameter 'ssAddRootNode' has no matching param tag in the XML comment for 'OutSystems.NssXmlRecords.CssXmlRecords.MssRecordListToXml(object, OutSystems.NssXmlRecords.RLRecordXmlConfigRecordList, OutSystems.NssXmlRecords.RCDefaultXmlConfigRecord, bool, out string)' (but other parameters do) [C:\Users\CarlosE.MISNET\Desktop\XML.Records-1.5.5\Source\NET\XmlRecords.csproj]
XmlRecords.cs(90,113): warning CS1573: Parameter 'ssDefaultConfig' has no matching param tag in the XML comment for 'OutSystems.NssXmlRecords.CssXmlRecords.MssRecordToXml(object, OutSystems.NssXmlRecords.RLRecordXmlConfigRecordList, OutSystems.NssXmlRecords.RCDefaultXmlConfigRecord, out string)' (but other parameters do) [C:\Users\CarlosE.MISNET\Desktop\XML.Records-1.5.5\Source\NET\XmlRecords.csproj]
XmlRecords.cs(116,97): warning CS1573: Parameter 'ssXmlConfig' has no matching param tag in the XML comment for 'OutSystems.NssXmlRecords.CssXmlRecords.MssXmlToRecordList(string, object, OutSystems.NssXmlRecords.RLRecordXmlConfigRecordList, bool, string, OutSystems.NssXmlRecords.RCDefaultXmlConfigRecord, bool)' (but other parameters do) [C:\Users\CarlosE.MISNET\Desktop\XML.Records-1.5.5\Source\NET\XmlRecords.csproj]
XmlRecords.cs(116,115): warning CS1573: Parameter 'ssIgnoreXMLDeclarationAndNS' has no matching param tag in the XML comment for 'OutSystems.NssXmlRecords.CssXmlRecords.MssXmlToRecordList(string, object, OutSystems.NssXmlRecords.RLRecordXmlConfigRecordList, bool, string, OutSystems.NssXmlRecords.RCDefaultXmlConfigRecord, bool)' (but other parameters do) [C:\Users\CarlosE.MISNET\Desktop\XML.Records-1.5.5\Source\NET\XmlRecords.csproj]
XmlRecords.cs(116,151): warning CS1573: Parameter 'ssAttributePrefix' has no matching param tag in the XML comment for 'OutSystems.NssXmlRecords.CssXmlRecords.MssXmlToRecordList(string, object, OutSystems.NssXmlRecords.RLRecordXmlConfigRecordList, bool, string, OutSystems.NssXmlRecords.RCDefaultXmlConfigRecord, bool)' (but other parameters do) [C:\Users\CarlosE.MISNET\Desktop\XML.Records-1.5.5\Source\NET\XmlRecords.csproj]
XmlRecords.cs(116,195): warning CS1573: Parameter 'ssDefaultConfig' has no matching param tag in the XML comment for 'OutSystems.NssXmlRecords.CssXmlRecords.MssXmlToRecordList(string, object, OutSystems.NssXmlRecords.RLRecordXmlConfigRecordList, bool, string, OutSystems.NssXmlRecords.RCDefaultXmlConfigRecord, bool)' (but other parameters do) [C:\Users\CarlosE.MISNET\Desktop\XML.Records-1.5.5\Source\NET\XmlRecords.csproj]
XmlRecords.cs(116,217): warning CS1573: Parameter 'ssBypassRootRecordListNode' has no matching param tag in the XML comment for 'OutSystems.NssXmlRecords.CssXmlRecords.MssXmlToRecordList(string, object, OutSystems.NssXmlRecords.RLRecordXmlConfigRecordList, bool, string, OutSystems.NssXmlRecords.RCDefaultXmlConfigRecord, bool)' (but other parameters do) [C:\Users\CarlosE.MISNET\Desktop\XML.Records-1.5.5\Source\NET\XmlRecords.csproj]
  XmlRecords -> C:\Users\CarlosE.MISNET\Desktop\XML.Records-1.5.5\Source\NET\bin\OutSystems.NssXmlRecords.dll

What could have I missed?
0
0
on 2014-07-30
Copy link to comment
João Fernandes
Rank: #0
I'm not sure about this, but looks like a problem with the documentation of one of the methods in the extension.

In .NET you can use XML elements to document your code. The problem seems to be that in the documentation of the RecordListToXML method, there is an open XML tag that is never closed, or a parameter that doesn't have documentation.

"Parameter 'ssAddRootNode' has no matching param tag in the XML comment"

Looks like you have two options:
  • Fix the documention;
  • Try to find a way to compile the code and ignore the documentation.
0
0
on 2014-07-31
Copy link to comment
Loki
Rank: #28776
Tried publish a java extension. It fails compiling.  Doesn't say why this fails.  I followed the video at https://www.outsystems.com/videos/integration/extend-platform-with-your-own-code/

Error while publishing extension
0
0
on 2014-09-01
Copy link to comment
João Fernandes
Rank: #0
Hi Loki,

Have you tried clicking on the "Compiler Error - J2EE Compilation" row on that window?
When you click on it, it should display what's causing the error.


1
0
on 2014-09-01
Copy link to comment
Loki
Rank: #28776
After  restarting the integration studio, it started working fine.. I had not restarted integration studio after setting up the IDE options. Not sure if it requires a restart, but it works fine now and i am able to publish the extension
1
0
on 2014-09-01
Copy link to comment
Martijn Habraken
mvp_badge
MVP
Rank: #246
Yes, a restart is necessary. I encountered the same problem, error disappeared after restart.
0
0
on 2015-02-10
Copy link to comment
Remco Dekkinga
mvp_badge
MVP
Rank: #26
Could this thread be updated with the newest Visual Studio and Outsystems versions?
0
0
on 2015-06-26
Copy link to comment
Ricardo Silva
Rank: #0
Hello, the information on the initial post has been updated to reflect the required versions as of version 9 of the OutSystems Platform.
1
0
on 2015-06-26
Copy link to comment
Remco Dekkinga
mvp_badge
MVP
Rank: #26
Thank you for the fast reply / update.

0
0
on 2015-06-26
Copy link to comment
Simone
Rank: #4914
Hi Ricardo,

I have set up the Net configurations has you suggested but I'm still receiving the pop up that said "Integration Studio options are not correctly defined"

could you please give me a suggestion for the field:
 - compare files using
 - Proxy Authentication

Current setup:



Thanks

Simon

2
0
on 2015-09-16
Copy link to comment
André Siébra
mvp_badge
MVP
Rank: #106
Hi Simon,

Verify if the Application Server of your extension is set to "Both". If this case, Integration Studio will force you to fill the development enviroment informantion of both .NET and JAVA on the options. You must set the the Application Server of the extension to .NET.

 
3
0
on 2015-09-16
Copy link to comment
Pedro Coelho
mvp_badge
MVP
Rank: #35
What about the new Java/J2EE configurations/requirements for 9.1?

I'm guessing they are different now, since Java 8 was a breaking change to 9.1

Best regards,
PC
0
0
on 2016-01-13
Copy link to comment
Martijn Habraken
mvp_badge
MVP
Rank: #246
Hi Pedro,

You’re right.
You can change the Java home to a JDK 8 path on your machine and you’re okay again.
That’s the only thing to change :)

Kind regards,
Martijn
0
0
on 2016-01-13
Copy link to comment
Pedro Coelho
mvp_badge
MVP
Rank: #35
Any particular version of jdk required? Or can be any of the latest (8u65 / 8u66)?

Best regards,
PC
0
0
on 2016-01-13
Copy link to comment
Martijn Habraken
mvp_badge
MVP
Rank: #246
I installed the 8u65 version and that works.
0
0
on 2016-01-13
Copy link to comment
Pedro Coelho
mvp_badge
MVP
Rank: #35
I'm currently testing (with sucess) the 8u66 :)

So it all works ;)

Best regards,
PC
0
0
on 2016-01-13
Copy link to comment
Hello there,
I am using Integration Studio 9.1.300.0 and Eclipse 4.5.2 and when I press the "Edit source code..." eclipse opens but nothing is generated. I only have an "Action" defined. Do I also need a structure? 
0
0
on 2016-03-14
Copy link to comment
Pedro Coelho
mvp_badge
MVP
Rank: #35
Are you creating or editing an extension?

Best regards,
PC
0
0
on 2016-03-14
Copy link to comment
Creating.

Thanks in advance
0
0
on 2016-03-14
Copy link to comment
Pedro Coelho
mvp_badge
MVP
Rank: #35
Then that is the expected behaviour, you now need to start to input your code :)

Best regards,
PC
0
0
on 2016-03-14
Copy link to comment
But I have to create a new file etc in eclipse. How it's then linked to Outsystems Integration Studio?
0
0
on 2016-03-15
Copy link to comment
Pedro Coelho
mvp_badge
MVP
Rank: #35
Check out point 7 (integrating with other systems) from the  https://www.outsystems.com/academy/14/mastering-outsystems/

Best regards,
PC
0
0
on 2016-03-15
Copy link to comment
Ken Hommel
Rank: #5247
Is it possible to use IntelliJ instead of Eclipse? 
0
0
on 2016-04-20
Copy link to comment
Pedro Coelho
mvp_badge
MVP
Rank: #35
Kenneth Hommel wrote:
Is it possible to use IntelliJ instead of Eclipse? 
 
 That is a question I'ld like to hear the answer too :)

Best regards,
PC
0
0
on 2016-04-20
Copy link to comment
Guilherme Pereira
Staff
Rank: #4
Hi Guys,

This question has been poping up lately as well as "Can I use Maven instead of ant as the build tool"?

For both question the answer is no. As per the OutSystems Platform System Requirements only Eclipse and ant are supported.

This happens because the files generated (project files, build scripts, etc) are targeted at those two tools specifically.

Hope this clarifes,
Guilherme
0
0
on 2016-04-21
Copy link to comment
Bill House
Rank: #49281
BTW, when Integration Studio launches Eclipse, there is always a Dummy.java file in the same folder and the Action java files.  Is this Dummy.java file needed for anything?
0
0
on 2016-05-07
Copy link to comment
João Rosado
Staff
Rank: #29
Hi Bill,

It's an implementation detail, it is used as a placeholder to make sure the namespace for that folder always exist even when you don't have any action/entity/structure. It just makes the code generation simpler.
0
0
on 2016-05-07
Copy link to comment
Manas B
Rank: #36312
Hi,
I am using integration studio 9.1.4,jdk1.8.0_73,apache-ant-1.9.7 And Eclipse Mars.But After configuring when i was trying to compile its showing J2EE Compilation error and when click of that error its showing some Build failed.I have restarted also but getting the same error.Can someone please guide me.Please find attached sheet for more details.
Capture12.JPG

0
0
on 2016-07-12
Copy link to comment
Rebecca Hall
Rank: #119

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.

0
0
on 2016-07-21
Copy link to comment
Ricardo Silva
Rank: #0

Hello Rebecca,

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.

0
0
on 2016-07-22
Copy link to comment
Charles Betman
Rank: #894

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.

0
0
on 2016-08-31
Copy link to comment
Charles Betman
Rank: #894

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".

Please help!


0
0
on 2016-09-01
Copy link to comment
João Rosado
Staff
Rank: #29

Hi Charley,


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?


Regards,

João Rosado

1
0
on 2016-09-01
Copy link to comment
Charles Betman
Rank: #894

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 :-)

3
0
on 2016-09-01
Copy link to comment
Mário Cunha
Rank: #509

Charles Betman wrote:

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 :-)


Hi,

Had a similar issue where the integration studio would say that the configuration was not correct. Your solution helped me because i also had the specification for the ant_home up to the bin and not with the bat file.

Specified the full path to the eclipse, java and ant bat file and started working.

Best regards


1
0
on 2017-04-28
Copy link to comment
Gurvinder Singh
Rank: #987

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

0
0
on 2016-09-15
Copy link to comment
Myles Chippendale
Rank: #22719

Hi Gurvinder,

I am having the same problem. Do you manage to fix this issue?


Regards,

Myles


Gurvinder Singh wrote:

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



0
0
on 2016-11-04
Copy link to comment
Myles Chippendale
Rank: #22719

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. 

Myles

Hi Gurvinder,

I am having the same problem. Do you manage to fix this issue?


Regards,

Myles


Gurvinder Singh wrote:

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





0
0
on 2016-11-04
Copy link to comment
João Rosado
Staff
Rank: #29

Hi,


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 needs
Symptoms: There is no error closing the preferences window, but eclipse opens without a project
Solution: 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 error
Solution: 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.


Regards,
João Rosado



2
0
on 2016-09-15
Copy link to comment
Pedro Oliveira
Staff
Rank: #13

João Rosado wrote:

Hi,


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 needs
Symptoms: There is no error closing the preferences window, but eclipse opens without a project
Solution: 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 error
Solution: 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.


Regards,
João Rosado




These notes should definitely be moved into the main post.

0
0
on 2017-01-20
Copy link to comment
Andre Goncalves
Rank: #5102

Hi,

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.

André

0
0
on 2016-10-20
Copy link to comment
Pedro Gonçalves
Staff
Rank: #98

Hi André,


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.


Kind regards!

1
0
on 2016-10-20
Copy link to comment
Andre Goncalves
Rank: #5102

Pedro Gonçalves wrote:

Hi André,


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.


Kind regards!

Hi Pedro,


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?


Regards,

André


0
0
on 2016-10-20
Copy link to comment
Paulo Torres
Rank: #1232

Pedro Gonçalves wrote:

Hi André,


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.


Kind regards!

It's not true. I did use the SharpDevelop recently.


0
0
on 2017-12-15
Copy link to comment
Pedro Gonçalves
Staff
Rank: #98

Hi André,


[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!


1
0
on 2016-10-20
Copy link to comment
João Rosado
Staff
Rank: #29

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.


Regard,

João Rosado

2
0
on 2016-10-20
Copy link to comment
Andrei Tarutin
Rank: #21796

Ricardo Silva wrote:

Permalink: www.outsystems.com/goto/howto-configure-integration-studio



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.


Where and what to configure

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:

  • Integrated Development Environment
  • Compiler Tool
  • Compiler Tool Options
  • Java Home (Java only)

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.


Configuring .NET

What's required?

  • Microsoft .NET Framework 2.0 (OutSystems 5.0-) or 3.5 (OutSystems 5.1 thru 8.0)
  • Microsoft .NET Framework 4.0 (OutSystems 9.0+)
  • Visual Studio 2008 or 2010 (OutSystems 6.0+ only). If using the Express version, install Visual Express C#.

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:

  • Compiler Tool should point to your MSBuild.exe, usually found in "C:\Windows\Microsoft.NET\Framework\v<VERSION>\"
  • Integrated Development Environment should point to your devenv.exe, by default located in "c:\Program Files (x86)\Microsoft Visual Studio 9.0\Common7\IDE\devenv.exe"
  • Compiler Tool Options: just leave the defaults, unless you know exactly what you are doing.


Configuring J2EE

What's required?

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):

  • Integrated Development Environment: path to your eclipse.exe file
  • Compiler Tool: path to the ant.bat script inside ANT_HOME/bin/
  • Compiler Tool Options: you shouldn't need to fill this in
  • Java Home: path to the JAVA_HOME directory.


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.


Best regards,

Ricardo Silva

Hi Ricardo,

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.


0
0
on 2016-11-13
Copy link to comment
Ricardo Silva
Rank: #0

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

1
0
on 2016-11-13
Copy link to comment
Andrei Tarutin
Rank: #21796

Ricardo Silva wrote:

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.


0
0
on 2016-11-14
Copy link to comment

Ricardo Silva wrote:

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

So, maybe have a better error message? You know, one that actually tells what's wrong so as we can have an idea on how to correct the problem?

It's not like Integration Studio doesn't know what's wrong, so why not tell the user?


0
0
on 2017-04-13
Copy link to comment
Arthur Cheng
Rank: #3362

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.

0
0
on 2016-12-08
Copy link to comment
Rajendra Singh
Rank: #448

Hi, while configuring i am getting the error..


Thanks

Rajendra Singh

0
0
on 2017-01-17
Copy link to comment
João Rosado
Staff
Rank: #29

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.


Regards,

João Rosado

0
0
on 2017-01-20
Copy link to comment
Pedro Oliveira
Staff
Rank: #13

Cool! With the current revision at least one step I had to do manually was to copy the plugin to the dropins folder.

0
0
on 2017-01-26
Copy link to comment
Lina Kwok
Rank: #72710



Hello, 

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?

0
0
on 2017-03-10
Copy link to comment
Ity Sharma
Rank: #25543

Hi All,

I was trying to configure Eclipse with my Integration studio but i am getting popup box

saying  

Please do let me know what wrong i am doing here.

Thanks

Ity Sharma

0
0
on 2017-06-29
Copy link to comment
Daniel Martins
Staff
Rank: #66

Ity Sharma wrote:

Hi All,

I was trying to configure Eclipse with my Integration studio but i am getting popup box

saying  

Please do let me know what wrong i am doing here.

Thanks

Ity Sharma

Hi Ity,

That warnin pop-up if if the application server is set to both and you do not have the .NET settings set.

Set to J2EE and see if it works:


Hope it helps you.

1
0
on 2017-06-29
Copy link to comment

Hey Guys,

So I'm using the Service Studio version 10.0.717.0 and the Platform server 10.0.710.0, our projects only are in .Net architecture (VS 2017) on Windows 10. 

When I try to open an XIF, the Integration start and stores an error that calls feedback and close his window.

My Steps:

  • Open Integration Studio across XIF was selected in Service Studio;
  • Authenticate my user on Integration Studio;
  • Click on the action that I want to explore;
  • Click on Edit Souce Code .Net;
  • Occurs an error and open it Feedback dialog
  • When I check the Report, return the message access denied to "IntegrationStudio.exe.config"

Points that may considerate:

  • My privileges on Windows isn't like administrator account;
  • The configuration in Integration Studio on Options menu, only apply if I run as administrator, but not work fine if Service Studio is not running as administrator as well.
  • In the menu Options: 
    • on General was set as Default Application Server Type: .Net;
    • J2EE: Java Home as jdk.1.8.0_161
    • .NET: the path of VS 2017 ("C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE\devenv.exe") 
    • If I'm not runnig as administrator the Integration Studio loses the path of Visual Studio and don't apply, give an error as well.

When I always need use the Integration Studio with Service Studio, will be necessary run as administrator both?
I try to use the Visual Studio Code and didn't work, so now I use the Visual Studio 2017. There will be enable some feature for work with Visual Studio Code?

Why Integration Studio doesn't leaves me set the path of .Net Integrated Development Enviroment? if I'm not running as administrator.

0
0
on 2018-01-26
Copy link to comment
Remco Dekkinga
mvp_badge
MVP
Rank: #26

Hi Marcel,

It is true that you need to run Integration Studio as administrator When you want to change the configuration. What you deactiveren sounds like a bug, but most developers I know don’t have it, because they are local admins. you can report the bug to OutSystems support via their website and for the time being run Integration Studioas administrator. 

1
0
on 2018-01-26
Copy link to comment

Remco Dekkinga wrote:

Hi Marcel,

It is true that you need to run Integration Studio as administrator When you want to change the configuration. What you deactiveren sounds like a bug, but most developers I know don’t have it, because they are local admins. you can report the bug to OutSystems support via their website and for the time being run Integration Studioas administrator. 

Tks Remco I will do that


0
0
on 2018-01-27
Copy link to comment
Michael Manzano
Rank: #13662

Hi Guys!

I can't seem to edit the .NET source code it keeps on saying this:


I have not configured J2EE. Do I need to configure that too? It seems in the comments that there is no need but I keep on having this problem. How do I fix this?

Thank you.

0
0
on 2018-01-26
Copy link to comment
Remco Dekkinga
mvp_badge
MVP
Rank: #26

Hi Michael,

If you want to build an extensions for both .net and Java, you need to configure both. If you are only building your extension for .net, you only need to configure the .net environment. 

Next to this configuration, you have to set your extension to be available for only .net instead of both (Java & .net). You can do this in the main screen on the details of your module. 

0
0
on 2018-01-26
Copy link to comment
Michael Manzano
Rank: #13662

Remco Dekkinga wrote:

Hi Michael,

If you want to build an extensions for both .net and Java, you need to configure both. If you are only building your extension for .net, you only need to configure the .net environment. 

Next to this configuration, you have to set your extension to be available for only .net instead of both (Java & .net). You can do this in the main screen on the details of your module. 

Thank you. I think I have already done that. Here, check these out:





Was there something I missed?

0
0
on 2018-01-26
Copy link to comment
Remco Dekkinga
mvp_badge
MVP
Rank: #26

Hi Michael,

These settings are correct. If you stil get the error, you need to make call with OutSystems support, because it seems you hit a bug that needs to be identified. 

0
0
on 2018-01-27
Copy link to comment
Michael Manzano
Rank: #13662

Remco Dekkinga wrote:

Hi Michael,

These settings are correct. If you stil get the error, you need to make call with OutSystems support, because it seems you hit a bug that needs to be identified. 

I see. I will do that. Thank you.


0
0
on 2018-01-29
Copy link to comment
Dol Hee Kim
Rank: #55813

Hi, I am trying to configure .NET and I have downloaded Visual Studio 2017. However, whenever I attempt to apply change to the option, the system error pops up and shut down Integration Studio immediately, so I cannot make any changes even though I know what to change. Can anyone help me regarding this issue?

0
0
on 2018-07-09
Copy link to comment
Stefan Swanepoel
Rank: #69685

Dol Hee Kim wrote:

Hi, I am trying to configure .NET and I have downloaded Visual Studio 2017. However, whenever I attempt to apply change to the option, the system error pops up and shut down Integration Studio immediately, so I cannot make any changes even though I know what to change. Can anyone help me regarding this issue?


Hi, I get the same error when trying to configure .NET and Visual Studio 2017 community version.

0
0
on 2018-09-08
Copy link to comment
Pedro Guimarães
Staff
Rank: #480

Hi Dol Hee Kim and Stefan Swanepoel,

First of all, I'm sorry you had this problem. We are analyzing and trying to reproduce it, I'll get back to you when we have more information.

Meanwhile, you can try something to see if it solves the problem: delete the file "%AppData%\Roaming\OutSystems\Integration Studio\IntegrationStudio.Preferences". Attention: this will clean your recently open extensions and environments list.

Pedro Guimarães

0
0
on 2018-09-12
Copy link to comment
Phani M
Rank: #9697

Hi There,


I am getting below issue, please help




0
0
on 2018-11-06
Copy link to comment
Nuno Reis
mvp_badge
MVP
Rank: #71

Seetharam Phanindra Maringanti wrote:

Hi There,


I am getting below issue, please help





I don't see any below issue. Please open a new topic instead of adding more things to this one.

0
0
on 2018-11-06
Copy link to comment

Please please please answer what the Compare files with option is for, and what to specify?  The documentation has a circular trio of pages that try to explain it which fail miserably at providing clarity!

0
0
on 2020-06-18
Copy link to comment
Rui Coutinho
Rank: #121

Lars Berntrop-Bos wrote:

Please please please answer what the Compare files with option is for, and what to specify?  The documentation has a circular trio of pages that try to explain it which fail miserably at providing clarity!

 I never used that option, so I just keep it empty and I'm able to create my extesions without issues.

 

0
0
on 2020-07-28
Copy link to comment

But what is it for?  That is not answered...

0
0
on 2020-07-28
Copy link to comment
Rui Coutinho
Rank: #121

I never saw any documentation on it, but as far I can tell, this option allows you to compare the .net latest version with the template file - template here means the files automatically generated by the platform. 

If you go to the Resources tab on Integration Studio, you can right click on one of the .net files and do compare with template. 


It will open and compare the latest version with the template version, using the tool you selected in the configuration. You may test it with notepadd++, it opens both versions. Or you may use a real compare tool, such as Beyond Compare, which automatically tells you the differences.

The only use case I see for this is, if by mistake some of the platform code is deleted, and you want to revert it, otherwise the extension may not work. But, as I mention, I never had the need to used it in all my years of OutSystems.

0
0
on 2020-07-28
Copy link to comment

Thanks to all of you guys, I'm transitioning from .Net to Outsystems platform and having lots of doubt for integration, this thread clear most of my doubt.

Sanjay 

0
0
on 2020-07-29
Copy link to comment