openmrs core Download - openmrs core -Quellcode-Download

openmrs core

JAVA-Quellcode

1.0.0

Herunterladen

api: test: tools: web: webapp:

OpenMRS ist ein patientenbasiertes Krankenaktensystem, das sich darauf konzentriert, Anbietern ein kostenlos anpassbares elektronisches Krankenaktensystem (EMR) zur Verfügung zu stellen.

Die Mission von OpenMRS besteht darin, die Gesundheitsversorgung in ressourcenbeschränkten Umgebungen zu verbessern, indem eine globale Gemeinschaft koordiniert wird, die eine robuste, skalierbare, benutzergesteuerte Open-Source-Plattform für Krankenaktensysteme schafft.

Inhaltsverzeichnis

Bauen
1. Voraussetzungen
2. Befehl erstellen
3. Einsetzen
Docker-Build
Navigieren im Repository
Software-Entwicklungskit
OpenMRS mit Modulen erweitern
Dokumentation
1. Entwicklerhandbücher
2. Wiki
3. Webseite
Mitwirken
1. Code
2. Codeüberprüfungen
3. Übersetzung
Probleme
Gemeinschaft
Unterstützung
Lizenz

Bauen

Voraussetzungen

Java

OpenMRS ist eine Java-Anwendung, weshalb Sie ein Java JDK installieren müssen.

Wenn Sie den Master-Zweig erstellen möchten, benötigen Sie ein Java JDK der Mindestversion 8.

Maven

Installieren Sie das Build-Tool Maven.

Sie müssen sicherstellen, dass Maven das Java JDK verwendet, das für den Zweig, den Sie erstellen möchten, erforderlich ist.

Führen Sie dazu aus

mvn -version

Hier erfahren Sie, welche Version Maven verwendet. Lesen Sie die Maven-Dokumente, wenn Sie Maven konfigurieren müssen.

Git

Installieren Sie das Versionskontrolltool Git und klonen Sie dieses Repository mit

git clone https://github.com/openmrs/openmrs-core.git

Befehl erstellen

Nachdem Sie sich um die Voraussetzungen gekümmert haben

Führen Sie Folgendes aus

 cd openmrs-core
mvn clean package

Dadurch wird die OpenMRS-Anwendung in webapp/target/openmrs.war generiert, die Sie auf einem Anwendungsserver wie beispielsweise Tomcat oder Jetty bereitstellen müssen.

Einsetzen

Zu Entwicklungszwecken können Sie openmrs.war einfach über auf dem Anwendungsserver-Steg bereitstellen

 cd openmrs-core/webapp
mvn jetty:run

Wenn alles gut geht (überprüfen Sie die Konsolenausgabe), können Sie unter localhost:8080/openmrs auf die OpenMRS-Anwendung zugreifen.

Weitere Informationen zu nützlichen Maven-Befehlen und Build-Optionen finden Sie unter „Erste Schritte als Entwickler – Maven“.

Docker-Build

Docker-Builds sind noch in Arbeit. Wir freuen uns über jedes Feedback und Verbesserungen des Prozesses.

Die einzige erforderliche Voraussetzung ist Docker.

Um eine Entwicklungsversion zu erstellen, führen Sie Folgendes aus:

docker-compose build

Es ruft standardmäßig mvn install auf. Wenn Sie MVN-Build-Argumente anpassen möchten, können Sie dies tun, indem Sie Folgendes ausführen:

docker-compose build --build-arg MVN_ARGS= ' install -DskipTests '

Es ist auch möglich, das erstellte Entwickler-Image zum Ausführen von jetty zu verwenden:

docker-compose up

Um eine Produktionsversion zu erstellen, führen Sie Folgendes aus:

docker-compose -f docker-compose.yml build

Zuerst wird das Entwickler-Image erstellt und dann ein Image mit Tomcat und openmrs.war. Es gibt keine Entwicklerabhängigkeiten.

Die Produktionsversion kann ausgeführt werden mit:

docker-compose -f docker-compose.yml up

Wenn Sie debuggen möchten, müssen Sie eine Entwicklungsversion ausführen und Ihren Debugger mit Port 8000 verbinden, der standardmäßig verfügbar ist.

Leider erfordern zu diesem Zeitpunkt alle Codeänderungen einen vollständigen Neustart und eine Neuerstellung des Docker-Containers. Um den Vorgang zu beschleunigen, verwenden Sie bitte:

docker-compose build --build-arg MVN_ARGS= ' install -DskipTests '
docker-compose up

Wir arbeiten daran, Unterstützung für die automatische Neuladefunktion von Spring Boot bereitzustellen, die hier dokumentiert wird, sobald sie verfügbar ist.

Es ist auch möglich, ein von unserem CI erstelltes Image bereitzustellen, das unter https://hub.docker.com/r/openmrs/openmrs-core veröffentlicht ist

Sie können jedes verfügbare Tag ausführen mit:

TAG=nightly docker-compose -f docker-compose.yml up

Es ist auch möglich, eine Entwicklungsversion eines Images auszuführen mit:

TAG=dev docker-compose up

Alle Entwicklungsversionen enthalten das Dev-Suffix. Das Cache-Suffix dient der Verwendung durch unser CI.

Navigieren im Repository

Der Projektbaum ist wie folgt aufgebaut:

API/	Java- und Ressourcendateien zum Erstellen der Java-API-JAR-Datei.
Werkzeuge/	Beim Kompilieren und Testen verwendeter Metacode. Geht nicht in eine veröffentlichte Binärdatei (wie Doclets).
web/	Java- und Ressourcendateien, die in der Datei webapp/war verwendet werden.
webapp/	Dateien, die beim Erstellen der WAR-Datei verwendet werden (enthält JSP-Dateien in älteren Versionen).
pom.xml	Die Haupt-Maven-Datei, die zum Erstellen und Packen von OpenMRS verwendet wird.

Software-Entwicklungskit

Für eine schnelle Entwicklung von Modulen und dem Code der OpenMRS-Plattform schauen Sie sich das tolle SDK an

https://wiki.openmrs.org/display/docs/OpenMRS+SDK

OpenMRS mit Modulen erweitern

OpenMRS verfügt über eine modulare Architektur, die es Entwicklern ermöglicht, die OpenMRS-Kernfunktionalität durch die Erstellung von Modulen zu erweitern, die einfach hinzugefügt oder entfernt werden können, um den Anforderungen einer bestimmten Implementierung gerecht zu werden.

Bevor Sie Ihr eigenes Modul erstellen, gehen Sie zum OpenMRS-Modul-Repository und prüfen Sie, ob es bereits ein Modul für Ihren spezifischen Anwendungsfall gibt. Wenn ja, stellen Sie es bereit und probieren Sie es aus. Wenn eine Funktionalität fehlt, schließen Sie sich den Entwicklern des Moduls an, um eine Funktion hinzuzufügen.

Wenn Sie nicht gefunden haben, wonach Sie gesucht haben, lesen Sie im Modul-Wiki nach, wie Sie ein neues Modul erstellen können.

Dokumentation

Entwicklerhandbücher

Wenn Sie einen Beitrag leisten möchten, nutzen Sie bitte diese Ressourcen

Erste Schritte als Entwickler
So konfigurieren Sie Ihre IDE
So erstellen Sie eine Pull-Anfrage

Wiki

Wenn Sie nach detaillierten Anleitungen zum Installieren, Konfigurieren, Mitwirken und Erweitern von OpenMRS suchen, besuchen Sie uns

http://wiki.openmrs.org

Webseite

Wenn Sie weitere Informationen zu OpenMRS als Organisationscheck suchen

http://openmrs.org

Mitwirken

Beiträge sind herzlich willkommen, wir können Ihre Hilfe auf jeden Fall gebrauchen!

OpenMRS organisiert die Privilegien seiner Mitwirkenden in Entwicklerstufen, die hier dokumentiert sind.

Lesen Sie die folgenden Abschnitte, um herauszufinden, wo Sie helfen können.

Code

Schauen Sie sich unsere Beitragsrichtlinien an und lesen Sie die Entwicklerhandbücher durch.

Nachdem Sie sich informiert haben? Schnappen Sie sich eine Einführungsausgabe, die Ready For Work ist.

Codeüberprüfungen

Möglicherweise haben Sie nicht die Zeit, sich weiterzuentwickeln, verfügen aber über genügend Erfahrung mit OpenMRS und/oder der Überprüfung von Code. Ihre Hilfe bei der Codeüberprüfung wird sehr geschätzt!

Lesen

https://wiki.openmrs.org/display/docs/Code+Review

und legen Sie los mit re-:eyes: Pull Requests!

Übersetzung

Wir verwenden

https://www.transifex.com/openmrs/OpenMRS/

um unsere Übersetzungen zu verwalten.

Die Datei messages.properties in diesem Repository ist unsere einzige Quelle der Wahrheit. Es enthält Schlüssel-Wert-Paare für die Standardsprache Englisch.

Transifex ruft jede Nacht Aktualisierungen dieser Datei ab, die dann von Ihnen und mir auf der Transifex-Website selbst übersetzt werden können. Wir können jederzeit neue Übersetzungen von Transifex zurück in dieses Repository ziehen. Andere Sprachen wie z.B. Spanisch befindet sich dann in der Datei messages_es.properties .

Wenn Sie wissen möchten, wie Sie bei Übersetzungen helfen können, lesen Sie

http://openmrs.org/join-the-community/translate/