Activiti

Activités

Page d'accueil : http://activiti.org

Activiti est une plate-forme légère de flux de travail et de gestion des processus métier (BPM) destinée aux hommes d'affaires, aux développeurs et aux administrateurs système. Son cœur est un moteur de processus BPMN 2 ultra-rapide et solide comme le roc pour Java. Il est open source et distribué sous licence Apache. Activiti s'exécute dans n'importe quelle application Java, sur un serveur, sur un cluster ou dans le cloud. Il s'intègre parfaitement à Spring, il est extrêmement léger et basé sur des concepts simples.

* *REMARQUE : Nous avons déplacé vers la branche master tout le contenu de la branche de développement que nous utilisions pour concevoir et coder la prochaine version majeure du projet. Si vous souhaitez contribuer avec la version 6.x, veuillez consulter la branche 6.x.**

Si vous souhaitez en savoir plus sur la structure de nos référentiels, vous pouvez lire notre GitBook.

Configuration d'IntelliJ

• Forcer le niveau de langage 21 à échouer rapidement lors de l'utilisation (accidentellement) de fonctionnalités disponibles uniquement dans les versions Java les plus récentes.

  • Ouvrir le menu Fichier , élément de menu Structure du projet
  • Cliquez sur l'élément de liste Modules , pour chaque module, onglet Sources , combobox Le niveau de langue doit être automatiquement défini sur 21 ...

• Évitez que les modifications apportées à certaines ressources soient ignorées lors de la prochaine exécution/débogage (et que vous soyez obligé d'utiliser mvn)

  • Ouvrez le menu Fichier , élément de menu Paramètres ou menu IntelliJ IDEA , élément de menu Préférences... si sur un Mac
  • Cliquez sur l'élément de l'arborescence Compilateur , champ de texte Modèles de ressources : remplacez par !?*.java (supprimez tout autre contenu)

• Évitez une StackOverflowError lors de la construction

  • Ouvrez le menu Fichier , élément de menu Paramètres ou menu IntelliJ IDEA , élément de menu Préférences... si sur un Mac
  • Cliquez sur l'élément d'arborescence Compilateur , élément d'arborescence Compilateur Java , champ de texte Paramètres de ligne de commande supplémentaires
  • Ajouter -J-Xss1024k

• Style de code recommandé : utilisez le guide de style Google Java avec editorconfig

  • Téléchargez le style de code XML IntelliJ à partir de : [https://google.github.io/styleguide/intellij-java-google-style.xml]
  • Ouvrez le menu Fichier , élément de menu Paramètres ou menu IntelliJ IDEA , élément de menu Préférences... si sur un Mac
  • Cliquez sur l'élément de l'arborescence Code Style , cliquez sur la roue dentée et sélectionnez Import Scheme , puis IntelliJ Code Style XML.
  • Parcourez l'endroit où vous avez téléchargé le fichier XML et ouvrez-le. Vérifiez que GoogleStyle est le schéma actif.
    • Remarque : IntelliJ IDEA ne formate pas votre code automatiquement. Vous devez appuyer sur la combinaison de touches Ctrl+Alt+L pour déclencher le formatage automatique une fois le codage terminé.
  • Il existe un .editorconfig qui définit les retraits, l'encodage des fichiers et les fins de ligne.
  • Si vous le désactivez, vous devez définir manuellement le codage du fichier et le nombre d'espaces.
  • Style de code XML Eclipse : [https://google.github.io/styleguide/eclipse-java-google-style.xml]
  • Eclipse a besoin du plugin editorconfig-eclipse pour prendre en charge les fichiers EditorConfig.

• Définissez manuellement le codage de fichier correct (UTF-8 sauf pour les fichiers de propriétés) et les caractères de fin de ligne (unix) :

  • Ouvrez le menu Fichier , élément de menu Paramètres ou menu IntelliJ IDEA , élément de menu Préférences... si sur un Mac
  • Cliquez sur l'élément d'arborescence Code Style , élément d'arborescence Général
    • Séparateur de ligne Combobox (pour les nouveaux fichiers) : Unix
  • Cliquez sur l'élément de l'arborescence Encodages de fichiers
    • Encodage global Combobox : UTF-8
    • Combobox Encodage par défaut des fichiers de propriétés : ISO-8859-1
      • Remarque : les fichiers de propriétés i18n normaux doivent être au ISO-8859-1 comme spécifié par le contrat Java ResourceBundle .

• Définissez manuellement le nombre correct d'espaces lorsque vous appuyez sur la tabulation :

  • Ouvrez le menu Fichier , élément de menu Paramètres ou menu IntelliJ IDEA , élément de menu Préférences... si sur un Mac
  • Cliquez sur l'élément d'arborescence Code Style , élément d'arborescence Général
  • Cliquez sur l'onglet Java
    • Case à cocher Utiliser le caractère de tabulation : off
    • Taille de l'onglet du champ de texte : 4
    • Retrait du champ de texte : 4
    • Champ de texte Retrait de suite : 8
  • Ouvrir l'onglet XML
    • Case à cocher Utiliser le caractère de tabulation : off
    • Taille de l'onglet du champ de texte : 2
    • Retrait du champ de texte : 2
    • Champ de texte Retrait de suite : 4

• Définissez les en-têtes de fichiers corrects (n'incluez pas @author ou un javadoc dénué de sens) :

  • Ouvrez le menu Fichier , élément de menu Paramètres ou menu IntelliJ IDEA , élément de menu Préférences... si sur un Mac
  • Cliquez sur l'élément de l'arborescence Modèles de fichiers , onglet Comprend , élément de liste File Header
  • Supprimez la ligne @author Your Name .
    • Nous n'acceptons pas les lignes @author dans les fichiers sources, voir FAQ ci-dessous.
  • Supprimez l'intégralité du javadoc car les données automatiquement modélisées n'ont aucun sens.

• Définir l'en-tête de licence correct

  • Ouvrez le menu Fichier , élément de menu Paramètres ou menu IntelliJ IDEA , élément de menu Préférences... si sur un Mac
  • Cliquez sur l'élément de l'arborescence Copyright , sur l'élément de l'arborescence Profils de copyright
    • Cliquez sur le bouton Importer pour importer le profil Copyright
    • Sélectionnez le fichier : Alfresco_Software.xml
  • Cliquez sur l'élément de l' arborescence
    • Copyright du projet par défaut Combobox : Alfresco Software

FAQ

• Pourquoi n'acceptez-vous pas les lignes @author dans votre code source ?

  • Parce que les balises d'auteur dans les fichiers Java sont un cauchemar de maintenance

    • Un grand pourcentage est faux, incomplet ou inexact.
    • La plupart du temps, il ne contient que l’auteur original. De nombreux fichiers sont entièrement remaniés/développés par d'autres auteurs.
    • Git est exact, c'est la source canonique pour trouver le bon auteur.

  • Parce que les balises d'auteur favorisent la propriété du code , ce qui est mauvais à long terme.

    • Si les gens travaillent sur une pièce qu’ils perçoivent comme appartenant à quelqu’un d’autre, ils ont tendance à :
      • réparez uniquement ce qu'ils sont chargés de réparer, au lieu de tout ce qui est cassé
      • rejeter la responsabilité si ce code ne fonctionne pas correctement
      • avoir peur de marcher sur les pieds du propriétaire.

  • Le crédit aux auteurs est attribué :

    • avec Open Hub qui dispose également de statistiques
    • dans l'interface Web GitHub.

Commandes de développement

Ajouter un en-tête de licence

Pour formater des fichiers avec la licence requise :

mvn license:format

Style de contrôle

Pour vérifier si votre style de code respecte toutes les règles :

mvn checkstyle:check -DskipCheckstyle=false

Site

Pour générer le site maven :

mvn clean site site:stage

le site sera généré à l'adresse : target/staging/index.html

CI/CD

Fonctionnant sur GH Actions.

Pour que les PR Dependabot soient validés par CI, le label « CI » doit être ajouté au PR.

Nécessite la définition des secrets suivants :

Nom	Description
BOT_GITHUB_TOKEN	Jeton pour lancer d'autres builds sur GH
BOT_GITHUB_USERNAME	Nom d'utilisateur pour émettre des PR de propagation
NEXUS_USERNAME	Nom d'utilisateur du référentiel Maven interne
NEXUS_PASSWORD	Mot de passe du référentiel Maven interne
SLACK_NOTIFICATION_BOT_TOKEN	Jeton pour notifier Slack en cas d'échec