Beispiele
=========

Im Verzeichnis ``examples`` finden sich Python Dateien, die die Verwendung von `PyAPplus64` demonstrieren. 


Config-Dateien
--------------
Viele Scripte teilen sich Einstellungen. Beispielsweise greifen fast alle Scripte irgendwie auf APplus zu und benötigen Informationen,
mit welchem APP-Server, welchem Web-Server und welcher Datenbank sie sich verbinden sollen. Solche Informationen, insbesondere die Passwörter, werden nicht in  
jedem Script gespeichert, sondern nur in den Config-Dateien. Es bietet sich wohl meist an, 3 Konfigdateien zu erstellen, je eine für 
das Deploy-, das Test- und das Prod-System. Ein Beispiel ist im Unterverzeichnis ``examples/applus-server.yaml`` zu finden.

.. literalinclude:: ../../examples/applus-server.yaml
   :language: yaml
   :lines: 9-
   :linenos:
   
Damit nicht in jedem Script immer wieder neu die Konfig-Dateien ausgewählt werden müssen, werden die Konfigs für 
das Prod-, Test- und Deploy-System in ``examples/applus_configs.py`` hinterlegt. Diese Datei wird in allen Scripten importiert,
so dass das Config-Verzeichnis und die darin enthaltenen Configs einfach zur Verfügung stehen. Zudem werden in dieser Datei auch alle verwendeten 
Kombinationen aus System und Umgebung hinterlegt. So kann in Scripten auch eine Auswahl des Systems implementiert werden. 

.. literalinclude:: ../../examples/applus_configs.py
   :language: python
   :lines: 9-
   :linenos:

   
``read_settings.py``
-----------------------
Einfaches Beispiel für Auslesen der SysConf und bestimmter Einstellungen.

.. literalinclude:: ../../examples/read_settings.py
   :language: python
   :lines: 9-
   :linenos:

``check_dokumente.py``
-----------------------
Einfaches Beispiel für lesenden und schreibenden Zugriff auf APplus Datenbank.

.. literalinclude:: ../../examples/check_dokumente.py
   :language: python
   :lines: 9-
   :linenos:


``adhoc_report.py``
-------------------
Sehr einfaches Beispiel zur Erstellung einer Excel-Tabelle aus einer SQL-Abfrage.

.. literalinclude:: ../../examples/adhoc_report.py
   :language: python
   :lines: 9-
   :linenos:


``mengenabweichung.py``
-----------------------
Etwas komplizierteres Beispiel zur Erstellung einer Excel-Datei aus SQL-Abfragen.

.. literalinclude:: ../../examples/mengenabweichung.py
   :language: python
   :lines: 9-
   :linenos:

``mengenabweichung_gui.py``
---------------------------
Beispiel für eine sehr einfache GUI, die die Eingabe einfacher Parameter erlaubt.
Die GUI wird um die Erzeugung von Excel-Dateien mit Mengenabweichungen gebaut.

.. literalinclude:: ../../examples/mengenabweichung_gui.pyw
   :language: python
   :lines: 9-
   :linenos:

``complete_sql.pyw``
--------------------
Beispiel, wie ein einfacher APP-Server Aufruf über eine GUI zur Verfügung gestellt und mittels
Python-Bibliotheken erweitert werden kann. Zudem wird demonstriert, wie eine Auswahl verschiedenere 
Systeme und Umgebungen realisiert werden kann.

.. literalinclude:: ../../examples/complete_sql.pyw
   :language: python
   :lines: 9-
   :linenos:

``importViewUDF.py``
--------------------
Folgende Scripte erlauben den einfachen Import von DB-Anpass-Dateien, Views und UDFs über den Windows-Explorer.
Werden Verknüpfungen zu den Scripten ``importViewUDFDeploy.pyw`` und ``importViewUDFTest.pyw`` in ``%appdata%\Microsoft\Windows\SendTo`` abgelegt, 
so können eine oder mehrerer solcher Dateien mittels _Kontextmenü (Rechtsklick) - Senden an_ an APplus zur Verarbeitung übergeben werden.
Dabei ist es wichtig, dass sich die Dateien im für den jeweiligen Typ passenden Verzeichnis befinden.

.. literalinclude:: ../../examples/importViewUDF.py
   :language: python
   :lines: 9-
   :linenos:

Wrapper für Deploy-System:

.. literalinclude:: ../../examples/importViewUDFDeploy.pyw
   :language: python
   :lines: 9-
   :linenos:

Wrapper für Test-System:

.. literalinclude:: ../../examples/importViewUDFTest.pyw
   :language: python
   :lines: 9-
   :linenos:


``copy_artikel.py``
-----------------------
Beispiel, wie Artikel inklusive Arbeitsplan und Stückliste dupliziert werden kann.

.. literalinclude:: ../../examples/copy_artikel.py
   :language: python
   :lines: 22-
   :linenos: