Versions Compared

Old Version 10

changes.mady.by.user Wojciech Przybylski

Saved on

compared with

New Version Current

changes.mady.by.user Joanna Jankowiak

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Polish

Instalacja eclipse

Należy pobrać najnowszą wersję Eclipse IDE dla swojego systemu operacyjnego ze strony: https://www.eclipse.org/downloads/

Warning

Należy zwrócić uwagę na kompatybilność Eclipse z serwerem Tomcat - jeżeli posiadamy starszą wersję Eclipse, to możemy napotkać problemy z działaniem najnowszej wersji serwera Tomcat (którego instalacja jest następnym krokiem).

Konfiguracja

Edycja pliku eclipse.ini

Do pliku eclipse.ini (znajdującym się w głównym folderze z zainstalowanym eclipsem) dodajemy nasze dane:

-Duser.name=Jan Kowalski

Ustawienia edycji kodu

Eclipse

Window -> Preferences -> Java -> Code Style -> Formatter:

suncode-java-formatter-eclipse.xml

Window -> Preferences -> Java -> Code Style -> Code Templates:

suncode-codetemplates.xml

IntelliJ

File -> Settings -> Editor -> Code Style -> Java

suncode-java-formatter-intellij.xml

Prettier

Instalacja w IntelliJ:

  1. Budujemy system plusworkflow przy pomocy narzędzia Maven. Zależność prettier z pliku package.json projektu plusworkflow-web zostanie automatycznie zainstalowana.
  2. Instalujemy wtyczkę Prettier (File -> Settings -> Plugins).
  3. Zmieniamy ustawienia wtyczki Prettier (File -> Settings -> Langugages & Frameworks -> JavaScript -> Prettier):
    1. Ustawiamy pakiet prettier w polu Prettier package (pakiet pojawi się tam po wykonaniu punktu 1).

...

    1. W pole Run for files wklejamy "plusworkflow-web/src/main/frontend/**/*.{js,ts,jsx,tsx,vue}".
    2. Zaznaczamy pola On 'Reformat Code' action oraz On save.
Image Removed

Image Added

Edycja pliku settings.xml

Aby maven korzystał z naszego lokalnego repozytorium, należy zmodyfikować plik settings.xml znajdujący się w katalogu domowym maven'a:

  • windows: C:/Documents and Settings/<nazwa użytkownika>/.m2
  • unix: /home/<nazwa użytkownika>/.m2
Konfiguracja

 Aby maven korzystał z naszego lokalnego repozytorium, należy zmodyfikować plik settings.xml znajdujący się w katalogu domowym maven'a:

  • windows: C:/Documents and Settings/<nazwa użytkownika>/.m2
  • unix: /home/<nazwa użytkownika>/.m2
Info

Jeżeli plik settings.xml nie istnieje, należy go utworzyć.

Zalecaną konfiguracją jest używanie repozytorium Suncode jako mirror'a wszystkich repozytoriów, dzięki czemu wszystkie artefakty pobierane są z naszego lokalnego repozytorium:

Code Block
languagehtml/xml
titlesettings.xml
<settings>
  <mirrors>
    <mirror>
      <id>nexus</id>
      <mirrorOf>*</mirrorOf>
      <url>http://192.168.1.51:8081/nexus/content/groups/public</url>
    </mirror>
  </mirrors>
  <profiles>
    <profile>
      <id>nexus</id>
      <repositories>
        <repository>
          <id>central</id>
          <url>http://central</url>
          <releases><enabled>true</enabled></releases>
          <snapshots><enabled>true</enabled></snapshots>
        </repository>
      </repositories>
     <pluginRepositories>
        <pluginRepository>
          <id>central</id>
          <url>http://central</url>
          <releases><enabled>true</enabled></releases>
          <snapshots><enabled>true</enabled></snapshots>
        </pluginRepository>
      </pluginRepositories>
    </profile>
  </profiles>
  <activeProfiles>
    <activeProfile>nexus</activeProfile>
  </activeProfiles>
</settings>
Tip
titlesettings.xml

Jeżeli często pracujemy zdalnie, dobrym rozwiązaniem jest tylko dodanie nowego znanego repozytorium, dzięki czemu będziemy mogli nadal ściągać artefakty z innych repozytoriów, jeżeli nie jesteśmy podłączeni do Suncode VPN.

Code Block
languagehtml/xml
titlesettings.xml
<settings>
  <profiles>
    <profile>
      <id>nexus</id>
      <repositories>
        <repository>
          <id>suncode</id>
          <url>http://192.168.1.51:8081/nexus/content/groups/public</url>
          <releases><enabled>true</enabled></releases>
          <snapshots><enabled>true</enabled></snapshots>
        </repository>
      </repositories>
     <pluginRepositories>
        <pluginRepository>
          <id>suncode</id>
          <url>http://192.168.1.51:8081/nexus/content/groups/public</url>
          <releases><enabled>true</enabled></releases>
          <snapshots><enabled>true</enabled></snapshots>
        </pluginRepository>
      </pluginRepositories>
    </profile>
  </profiles>
  <activeProfiles>
    <activeProfile>nexus</activeProfile>
  </activeProfiles>
</settings>
Info
titleUWAGA

W przypadku pracy z projektem z zewnątrz, spoza sieci firmowej (bez VPN) w pliku settings.xml jako adres repozytorium systemu zamiast http://192.168.1.51:8081/nexus/content/groups/public należy podać adres: http://www.api.plusworkflow.pl/nexus/content/groups/public

...

Instalacja niezbędnych wtyczek

<DO UZUPEŁNIENIA>

Z nexusa należy pobrać 3 wtyczki: cuf-components, PWE, DBexplorer. Są to jedne z najczęściej używanych wtyczek.

Katalog domowy

Należy pobrać zip'a katalogu domowego(niestety jest za duży na wrzucenie tutaj, można wziąć od innego programisty).

Następnie w projekcie w plusworkflow-web/src/main/resources należy utworzyć plik 'plusworkflow-home.properties'. W tym pliku zostanie wskazana ścieżka do katalogu domowego.

 

plusworkflow.home=/home/kamil/Work/plusworkflow-home

 



English

Eclipse installation

You should download the latest version of the Eclipse IDE for your operating system from the website:: https://www.eclipse.org/downloads/

Warning

Pay attention to the compatibility of Eclipse with Tomcat server - if you have an older version of Eclipse, you may face problems with the operation of the latest version of Tomcat server (whose installation is the next step).

Configuration

Edit eclipse.ini file

Add data to the eclipse.ini file (located in the main folder with eclipse installed):

-Duser.name=Jan Kowalski

Code editing settings

Eclipse

Window -> Preferences -> Java -> Code Style -> Formatter:

suncode-java-formatter-eclipse.xml

Window -> Preferences -> Java -> Code Style -> Code Templates:

suncode-codetemplates.xml

IntelliJ

File -> Settings -> Editor -> Code Style -> Java

suncode-java-formatter-intellij.xml

Prettier

Installation in IntelliJ:

  1. Build the plusworkflow system using the Maven tool. The prettier dependency from the package.json file of the plusworkflow-web project will be automatically installed
  2. Install the Prettier plugin (File -> Settings -> Plugins).
  3. Change the settings of the Prettier plugin (File -> Settings -> Langugages & Frameworks -> JavaScript -> Prettier):
    1. Set the prettier package in the Prettier package field (the package will appear there after step 1).
    2. In the Run for files field, paste "plusworkflow-web/src/main/frontend/**/*.{js,ts,jsx,tsx,vue}".
    3. Check the On 'Reformat Code' action and On save boxes.

Image Added

Edit the settings.xml file

In order for maven to use our local repository, we need to modify the settings.xml file located in maven's home directory:

  • windows: C:/Documents and Settings/<username>/.m2

  • unix: /home/<username>/.m2

Configuration

In order for maven to use our local repository, we need to modify the settings.xml file located in maven's home directory:

  • windows: C:/Documents and Settings/<nazwa użytkownika>/.m2

  • unix: /home/<nazwa użytkownika>/.m2

    Info

    If the settings.xml file does not exist, create it.

The recommended configuration is to use the Suncode repository as a mirror of all repositories, so that all artifacts are downloaded from our local repository:

Code Block
languagehtml/xml
titlesettings.xml
<settings>
  <mirrors>
    <mirror>
      <id>nexus</id>
      <mirrorOf>*</mirrorOf>
      <url>http://192.168.1.51:8081/nexus/content/groups/public</url>
    </mirror>
  </mirrors>
  <profiles>
    <profile>
      <id>nexus</id>
      <repositories>
        <repository>
          <id>central</id>
          <url>http://central</url>
          <releases><enabled>true</enabled></releases>
          <snapshots><enabled>true</enabled></snapshots>
        </repository>
      </repositories>
     <pluginRepositories>
        <pluginRepository>
          <id>central</id>
          <url>http://central</url>
          <releases><enabled>true</enabled></releases>
          <snapshots><enabled>true</enabled></snapshots>
        </pluginRepository>
      </pluginRepositories>
    </profile>
  </profiles>
  <activeProfiles>
    <activeProfile>nexus</activeProfile>
  </activeProfiles>
</settings>
Tip
titlesettings.xml

If you often work remotely, it's a good idea to just add a new known repository, so you can still download artifacts from other repositories if you're not connected to Suncode VPN.

Code Block
languagehtml/xml
titlesettings.xml
<settings>
  <profiles>
    <profile>
      <id>nexus</id>
      <repositories>
        <repository>
          <id>suncode</id>
          <url>http://192.168.1.51:8081/nexus/content/groups/public</url>
          <releases><enabled>true</enabled></releases>
          <snapshots><enabled>true</enabled></snapshots>
        </repository>
      </repositories>
     <pluginRepositories>
        <pluginRepository>
          <id>suncode</id>
          <url>http://192.168.1.51:8081/nexus/content/groups/public</url>
          <releases><enabled>true</enabled></releases>
          <snapshots><enabled>true</enabled></snapshots>
        </pluginRepository>
      </pluginRepositories>
    </profile>
  </profiles>
  <activeProfiles>
    <activeProfile>nexus</activeProfile>
  </activeProfiles>
</settings>
Info
titleNote

When working with the project from outside the company network (without VPN) in the settings.xml file as the address of the system repository instead of the http://192.168.1.51:8081/nexus/content/groups/public address should be provided: http://www.api.plusworkflow.pl/nexus/content/groups/public

Installation of the necessary plugins

You need to download 3 plugins from nexus: cuf-components, PWE, DBexplorer. These are some of the most commonly used plugins.

Home directory

You need to download a zip of the home directory(unfortunately it is too big to upload here, you can take from another developer).

Then create a 'plusworkflow-home.properties' file in the project in plusworkflow-web/src/main/resources. This file will indicate the path to your home directory.


 

plusworkflow.home=/home/kamil/Work/plusworkflow-home