OrgaMon-RC: Unterschied zwischen den Versionen

Aus OrgaMon Wiki
Zur Navigation springen Zur Suche springen
Keine Bearbeitungszusammenfassung
 
(41 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 2: Zeile 2:
** OrgaMon-RC (RC = Release Candidate) ist der neueste OrgaMon der ganz getrennt von Ihrem "normalen" OrgaMon installiert werden kann. Er ist über einen eigenen Menü-Eintrag "OrgaMon-RC" zu starten. Er kann parallel zu einem normalen OrgaMon verwendet werden.  
** OrgaMon-RC (RC = Release Candidate) ist der neueste OrgaMon der ganz getrennt von Ihrem "normalen" OrgaMon installiert werden kann. Er ist über einen eigenen Menü-Eintrag "OrgaMon-RC" zu starten. Er kann parallel zu einem normalen OrgaMon verwendet werden.  
* Warum OrgaMon-RC?
* Warum OrgaMon-RC?
** Bei grösseren Umstellungen in der OrgaMon-Code-Basis besteht immer eine Regressions-Gefahr. Das bedeutet: bisher funktionierende Dinge sind nun unentdeckt fehlerhaft, ohne dass in diesem Bereich programmiert wurde. Der RC dient nun zum Testen und Aufspüren dieser Fehlfunktionen. Dabei braucht die Entwickler-Gemeinschaft das Feedback von OrgaMon-Power-Usern.
** Bei der Verwendung eines neuen Compilers oder einer neuen Code-Komponente besteht immer auch eine Regressions-Gefahr. Das bedeutet: Bisher funktionierende Dinge sind nun unentdeckt fehlerhaft, ohne dass in diesem Bereich etwas programmiert wurde. Der RC dient nun zum Testen und Aufspüren dieser Fehlfunktionen. Dabei braucht die Entwickler-Gemeinschaft das Feedback von OrgaMon-Power-Usern.
** Erstmals 2009/2010 wurden die öffentlichen Releases eingefrohren (bei 7.211) und die Weiterentwicklung in einem extra RC-Zweig vorangetrieben. Dies war nötig da durch die interne Umstellung auf den Delphi 2010 Compiler zahlreiche Regressions zu erwarten waren. Die RC-Phase wurde am 26.01.2010 beendet. Mit der OrgaMon Rev. 7.300 wurde wieder in die normale Weiterentwicklung eingeschwenkt.
* Muss ich irgendwo eine bestimmte Programmversion laden
** Ja, man muss einen RC-[[#Setup]] durchführen
 
* Was wenn etwas nicht funktioniert?
* Was wenn etwas nicht funktioniert?
** Melden Sie den Fehler dem Entwickler, er wird eine korrigierte RC Version erstellen
** Melden Sie den Fehler dem Entwickler, er wird eine korrigierte RC Version erstellen
Zeile 15: Zeile 17:
* Was sollte ich mit dem RC machen?
* Was sollte ich mit dem RC machen?
** Prüfen und Verwenden Sie möglichst alle Bereiche, die Sie im OrgaMon normalerweise auch benutzen
** Prüfen und Verwenden Sie möglichst alle Bereiche, die Sie im OrgaMon normalerweise auch benutzen
* Warum lohnt es sich, sich die Mühe zu machen am RC-Test teilzunehmen
* Warum lohnt es sich, sich die Mühe zu machen am RC-Test teilzunehmen?
** Sollte es einen Fehler geben der Sie in der RC Phase finden, melden Sie es einfach dem Entwickler und arbeiten ganz normal mit ihrem "normalen" OrgaMon. Der Fehler wird dann behoben.
** Sollte es einen Fehler geben den Sie in der RC Phase finden & melden, arbeiten Sie und ihr Team ganz normal und fehlerlos mit ihrem "normalen" OrgaMon weiter. Der Fehler wird dann behoben.
** Bleibt der Fehler jedoch unentdeckt und gelangt so in die nächste normale OrgaMon Version müssen Sie die Verteilung dieser OrgaMon Version zurückfahren, was immer mit Stress und Aufwand verbunden ist
** Bleibt der Fehler jedoch unentdeckt und gelangt so in die nächste normale OrgaMon Version müssen Sie die Verteilung dieser OrgaMon Version zurückfahren, was immer mit Stress und Aufwand verbunden ist
 
* Funktioniert das alles mit meiner momentan eingesetzten Orgamon Version xxxx
** Nein, erst zum Ende der RC-Phase wird die Entwicklungslinie RC auf den normalen OrgaMon übertragen
== Setup ==
== Setup ==


* Machen Sie vor dem Einsatz des RC eine Datensicherung, bzw. stellen Sie sicher dass der letzte Tagesabschluss sauber durchgelaufen ist.
* Machen Sie vor dem Einsatz des RC eine Datensicherung, bzw. stellen Sie sicher dass der letzte Tagesabschluss sauber durchgelaufen ist.
* Laden Sie den Setup-Link herunter und installieren Sie ein NEUES Symbol in Ihrer Startleiste "OrgaMon-RC"
https://cargobay.orgamon.net/Setup-OrgaMon-RC.exe


http://cargobay.orgamon.net/Setup-OrgaMon-RC.exe
* In Start->Programme suchen Sie den Ordner "OrgaMon", darin verbirgt sich der Eintrag "OrgaMon-RC"
** Machen Sie sich nach Möglichkeit ein Desktop Symbol "OrgaMon-RC"


* Es beginnt die RC-Testschleife:
** Verwenden Sie den RC bei ALLEN normalen Aufgaben die Sie normalerweise mit dem OrgaMon machen, bis Sie auf den ersten Fehler stossen
*** Melden Sie den Fehler an den Entwickler
** Starten Sie den "normalen" OrgaMon und wiederholen Sie den letzten Schrift und arbeiten Sie somit fehlerlos weiter
*** Der Entwickler wird sich melden wenn er das Problem gelöst hat
*** Danach wird eine neue RC Version veröffentlicht
** Der OrgaMon wird beim Start selbst merken wenn ein neuer RC erschienen ist
** Bitte testen Sie weiter und prüfen Sie angeblich Behobene Fehler oder Arbeitsschritte die mit dem RC noch ungetestet sind


== bekannte Fehler ==
== bekannte Fehler ==


bisher keine (Stand 14.09.2016)
=== bereits bestätigt ===


=== bereits bestätigt ===
* ARTIKEL.VERLAG_R ist ein PERSON_R
* BUGET_R ist ein Schreibfehler


=== bisher ungeprüft ===
=== bisher ungeprüft ===


=== nicht nachvollziehbar ===
=== nicht nachvollziehbar ===
== technischer Hintergrund ==
* Die Versionsnummern (Rev) laufen weiter wie bei normalen Releases
* Bei der Setup Erstellung (via <code>AutoUp</code>) gibt es einen "RC" Modus
* Auf https://cargobay.orgamon.net/ wird der RC-Setup nicht publiziert
* Dieser RC-Setup installiert nicht nach "OrgaMon.exe" sondern nach "OrgaMon-RC.exe"
* Das merkt die Anwendung, nun ist innerhalb der Anwendung das Flag "isBeta" gesetzt
* Prüfung auf Updates: Auf Cargobay wird ein "...-RC.html" abgelegt, dieses ist entkoppelt vom normalen Versions-Strang
* deshalb sind RC-Updates "unsichtbar" für die normale Versions-Verwaltung
=== Änderungen an der Datenbank-Struktur ===
Es kann der Wunsch entstehen, dass der RC mit der Produktiv-Datenbank arbeitet, da neue Funktionalitäten mit aktuellen Daten getestet werden müssen. Zusätzlich stehen jedoch Datenbank-Änderungen an. Dies ist möglich jedoch sind einige Dinge zu beachten. (Wenn dies zu riskant oder zu umfassend ist, sollte ein RC besser mit der spare-Datenbank verbunden werden).
* Strukturänderungen an der Datenbank können wie gewohnt nach <code>.SQL INIT BEGIN</code> dem RC mitgegeben werden
* Änderung sollten mit den produktiven OrgaMon-Versionen kompatibel ist, also dass zumindest keine Regressionen zu erwarten sind
* Typische Änderungen in RC-Phasen sind <b>neue Datenbankfelder</b>, die alte Versionen einfach zumeist nicht sehen und deshalb kein Problem entsteht
* es wird vom RC bei Start nicht "automatisch" die Datenbankstruktur geändert wie bei produktiven OrgaMons, aber mit &rarr;<code>Update</code>&rarr;Reiter <code>Datenbank-Update</code>&rarr;<code>weiter >></code> können dennoch die Schritte durchgeführt werden
* nach so einem Update wird die Versionsnummer NICHT in der REVISION-Tabelle eingetragen
** dies würde bei allen produktiven OrgaMons zu einer Störung <i>"EnforceBaseUpdate: "Setup-OrgaMon-nnnn-Update.exe" fehlt!"</i> führen
* am Ende der RC- Phase muss durch leeres Durchspielen aller Datenbank-Änderungen die neue Versionsnummer eingetragen werden


== Historie der RC - Phasen ==
== Historie der RC - Phasen ==
Zeile 46: Zeile 85:
=== 2014: Umstellung der Excel Komponente ===
=== 2014: Umstellung der Excel Komponente ===
=== 2016: Umstellung auf Delphi 10.1 ===
=== 2016: Umstellung auf Delphi 10.1 ===
=== 2019: Entkopplung des UI ===
=== 2019: Erweiterung der Lager-Funktionen ===
=== 2020: Ermöglichung von SFTP ===
=== 2021: Auftragsarbeitsplatz, Selektion des Druckumfanges ===
=== 2021: ZUTAT geht nicht mehr in die Summenbildung mit ein ===
=== 2022: KOPIE_R neues Datenbankfeld für Aufträge ===
==== geht noch nicht ====
* Warnung ist möglich wenn jemand versucht an einem Kopie-Datensatz was zu ändern (ist sinnlos, da es wieder überschrieben wird)
* Man könnte schnell auf den Original-Datensatz springen und dort die Änderung machen
=== 2023: Fotobenennung in Phasen & neuer MDEREC ===

Aktuelle Version vom 19. April 2023, 19:11 Uhr

  • Was ist der OrgaMon-RC?
    • OrgaMon-RC (RC = Release Candidate) ist der neueste OrgaMon der ganz getrennt von Ihrem "normalen" OrgaMon installiert werden kann. Er ist über einen eigenen Menü-Eintrag "OrgaMon-RC" zu starten. Er kann parallel zu einem normalen OrgaMon verwendet werden.
  • Warum OrgaMon-RC?
    • Bei der Verwendung eines neuen Compilers oder einer neuen Code-Komponente besteht immer auch eine Regressions-Gefahr. Das bedeutet: Bisher funktionierende Dinge sind nun unentdeckt fehlerhaft, ohne dass in diesem Bereich etwas programmiert wurde. Der RC dient nun zum Testen und Aufspüren dieser Fehlfunktionen. Dabei braucht die Entwickler-Gemeinschaft das Feedback von OrgaMon-Power-Usern.
  • Muss ich irgendwo eine bestimmte Programmversion laden
    • Ja, man muss einen RC-#Setup durchführen
  • Was wenn etwas nicht funktioniert?
    • Melden Sie den Fehler dem Entwickler, er wird eine korrigierte RC Version erstellen
  • Muss ich ständig auf neue RCs achten?
    • Nein, bei Start eines OrgaMon-RC wird jedesmal geprüft ob es eine neue RC-Version gibt
  • Wie erkenne ich dass ich im RC arbeite und nicht im normalen OrgaMon?
    • der RC ist rosa eingefärbt
  • Was passiert am Ende der RC Phase?
    • Sind keine Probleme mehr bekannt wird die aktuelle RC Programmversion als "normaler" OrgaMon veröffentlicht
    • Es gibt dann keine aktualisierten RC Versionen mehr, die Weiterentwicklung erfolgt agil im normalen Versionsmodell
  • Was sollte ich mit dem RC machen?
    • Prüfen und Verwenden Sie möglichst alle Bereiche, die Sie im OrgaMon normalerweise auch benutzen
  • Warum lohnt es sich, sich die Mühe zu machen am RC-Test teilzunehmen?
    • Sollte es einen Fehler geben den Sie in der RC Phase finden & melden, arbeiten Sie und ihr Team ganz normal und fehlerlos mit ihrem "normalen" OrgaMon weiter. Der Fehler wird dann behoben.
    • Bleibt der Fehler jedoch unentdeckt und gelangt so in die nächste normale OrgaMon Version müssen Sie die Verteilung dieser OrgaMon Version zurückfahren, was immer mit Stress und Aufwand verbunden ist
  • Funktioniert das alles mit meiner momentan eingesetzten Orgamon Version xxxx
    • Nein, erst zum Ende der RC-Phase wird die Entwicklungslinie RC auf den normalen OrgaMon übertragen

Setup

  • Machen Sie vor dem Einsatz des RC eine Datensicherung, bzw. stellen Sie sicher dass der letzte Tagesabschluss sauber durchgelaufen ist.
  • Laden Sie den Setup-Link herunter und installieren Sie ein NEUES Symbol in Ihrer Startleiste "OrgaMon-RC"

https://cargobay.orgamon.net/Setup-OrgaMon-RC.exe

  • In Start->Programme suchen Sie den Ordner "OrgaMon", darin verbirgt sich der Eintrag "OrgaMon-RC"
    • Machen Sie sich nach Möglichkeit ein Desktop Symbol "OrgaMon-RC"
  • Es beginnt die RC-Testschleife:
    • Verwenden Sie den RC bei ALLEN normalen Aufgaben die Sie normalerweise mit dem OrgaMon machen, bis Sie auf den ersten Fehler stossen
      • Melden Sie den Fehler an den Entwickler
    • Starten Sie den "normalen" OrgaMon und wiederholen Sie den letzten Schrift und arbeiten Sie somit fehlerlos weiter
      • Der Entwickler wird sich melden wenn er das Problem gelöst hat
      • Danach wird eine neue RC Version veröffentlicht
    • Der OrgaMon wird beim Start selbst merken wenn ein neuer RC erschienen ist
    • Bitte testen Sie weiter und prüfen Sie angeblich Behobene Fehler oder Arbeitsschritte die mit dem RC noch ungetestet sind

bekannte Fehler

bereits bestätigt

  • ARTIKEL.VERLAG_R ist ein PERSON_R
  • BUGET_R ist ein Schreibfehler

bisher ungeprüft

nicht nachvollziehbar

technischer Hintergrund

  • Die Versionsnummern (Rev) laufen weiter wie bei normalen Releases
  • Bei der Setup Erstellung (via AutoUp) gibt es einen "RC" Modus
  • Auf https://cargobay.orgamon.net/ wird der RC-Setup nicht publiziert
  • Dieser RC-Setup installiert nicht nach "OrgaMon.exe" sondern nach "OrgaMon-RC.exe"
  • Das merkt die Anwendung, nun ist innerhalb der Anwendung das Flag "isBeta" gesetzt
  • Prüfung auf Updates: Auf Cargobay wird ein "...-RC.html" abgelegt, dieses ist entkoppelt vom normalen Versions-Strang
  • deshalb sind RC-Updates "unsichtbar" für die normale Versions-Verwaltung

Änderungen an der Datenbank-Struktur

Es kann der Wunsch entstehen, dass der RC mit der Produktiv-Datenbank arbeitet, da neue Funktionalitäten mit aktuellen Daten getestet werden müssen. Zusätzlich stehen jedoch Datenbank-Änderungen an. Dies ist möglich jedoch sind einige Dinge zu beachten. (Wenn dies zu riskant oder zu umfassend ist, sollte ein RC besser mit der spare-Datenbank verbunden werden).

  • Strukturänderungen an der Datenbank können wie gewohnt nach .SQL INIT BEGIN dem RC mitgegeben werden
  • Änderung sollten mit den produktiven OrgaMon-Versionen kompatibel ist, also dass zumindest keine Regressionen zu erwarten sind
  • Typische Änderungen in RC-Phasen sind neue Datenbankfelder, die alte Versionen einfach zumeist nicht sehen und deshalb kein Problem entsteht
  • es wird vom RC bei Start nicht "automatisch" die Datenbankstruktur geändert wie bei produktiven OrgaMons, aber mit →Update→Reiter Datenbank-Updateweiter >> können dennoch die Schritte durchgeführt werden
  • nach so einem Update wird die Versionsnummer NICHT in der REVISION-Tabelle eingetragen
    • dies würde bei allen produktiven OrgaMons zu einer Störung "EnforceBaseUpdate: "Setup-OrgaMon-nnnn-Update.exe" fehlt!" führen
  • am Ende der RC- Phase muss durch leeres Durchspielen aller Datenbank-Änderungen die neue Versionsnummer eingetragen werden

Historie der RC - Phasen

2009: Umstellung auf Delphi 2010

Erstmals 2009/2010 wurden die öffentlichen Releases eingefrohren (bei 7.211) und die weiterentwicklung in einem extra RC-Zweig vorangetrieben. Dies war nötig da durch die interne Umstellung auf den Delphi 2010 Compiler zahlreiche Regressions zu erwarten waren. Die RC-Phase wurde am 26.01.2010 beendet. Mit der OrgaMon Rev. 7.300 wurde wieder in die normale Weiterentwicklung eingeschwenkt.

2011: Umstellung auf Delphi XE 2

2014: Umstellung der Excel Komponente

2016: Umstellung auf Delphi 10.1

2019: Entkopplung des UI

2019: Erweiterung der Lager-Funktionen

2020: Ermöglichung von SFTP

2021: Auftragsarbeitsplatz, Selektion des Druckumfanges

2021: ZUTAT geht nicht mehr in die Summenbildung mit ein

2022: KOPIE_R neues Datenbankfeld für Aufträge

geht noch nicht

  • Warnung ist möglich wenn jemand versucht an einem Kopie-Datensatz was zu ändern (ist sinnlos, da es wieder überschrieben wird)
  • Man könnte schnell auf den Original-Datensatz springen und dort die Änderung machen

2023: Fotobenennung in Phasen & neuer MDEREC