Tech Notes

Voraussetzungen

• Arbeitsplätze auf denen mit dem CloudClient gearbeitet wird, müssen komplett im Servermode laufen.
• Der FrontendService muss auf dem OpaccOXAS-APS installiert und konfiguriert sein.
• Die WebService-Schnittstelle inklusive WebSockets muss auf dem OpaccOXAS-APS installiert und konfiguriert sein.

  Notiz Sollte die WebService-Schnittstelle bei Ihnen noch nicht installiert und konfiguriert sein, wenden Sie sich bitte an Ihren OpaccERP-Projektleiter oder unsere Systemtechnik.

• In der Konfigurationsdatei OpaccOneInstallation.xml muss bei der entsprechenden ServiceBusInstance das CohortPattern eingetragen sein.

Anpassen der Konfiguration - OpaccOneInstallation.xml

• Notepad++
• XML Notepad von Microsoft
• TextPad

Achtung Notepad.exe (Bestandteil von Windows) ist aufgrund der schlechten Darstellung von XML-Dateien nicht für die Bearbeitung von XML-Dateien geeignet.

Notiz Sie können hier auch mit Wildcards arbeiten. Beispiele: Erp.* Erp.Filiale*

...
...
...
<ServiceBusInstance>
  <Name>APS_22E</Name>
  <Description>
  </Description>
  <Comment>
  </Comment>
  <Activated>true</Activated>
  <Path>./ServiceBus/Opacc.ServiceBus.App.exe</Path>
  <Mode>Server</Mode>
  <!--CPU 4,3,2,1 (Bitset: 0000 1111) 8+4+2+1=15-->
  <ServerModeProcessorAffinity>15</ServerModeProcessorAffinity>
  <ProgressUpdateIntervalInSeconds>15</ProgressUpdateIntervalInSeconds>
  <OrderedAccessRule>
...
...
...

...
...
...
<ServiceBusInstance>
  <Name>APS_22E</Name>
  <Description>
  </Description>
  <Comment>
  </Comment>
  <Activated>true</Activated>
  <Path>./ServiceBus/Opacc.ServiceBus.App.exe</Path>
  <Mode>Server</Mode>
  <!--CPU 4,3,2,1 (Bitset: 0000 1111) 8+4+2+1=15-->
  <ServerModeProcessorAffinity>15</ServerModeProcessorAffinity>
  <ProgressUpdateIntervalInSeconds>15</ProgressUpdateIntervalInSeconds>
  <AllowedClientCohortPattern>Default.ErpClient</AllowedClientCohortPattern>
  <OrderedAccessRule>
...
...
...

Wichtig Starten Sie nach dieser Anpassung den ServiceBus-Dienst neu!

CloudClient - Installation und erster Start

• Verbindung: Beliebiger Name für die Verbindung.
• URL: URL des OpaccOXAS-APS auf welchem der FrontendService läuft.

  Notiz Die URL welche Sie eingeben müssen, wird Ihnen beim Download unter Step 3 angezeigt. (Siehe Printscreen weiter oben.)

• Mandant: Nachdem die URL eingegeben wurde, wird die Mandantenliste angezeigt. Sie können einen Mandanten für die Anmeldung vorauswählen.
• Benutzer: Ihre OpaccERP Benutzernummer.
• Passwort: Ihr OpaccERP-Passwort.

  Notiz Das Passwort können Sie auf Wunsch speichern. Öffnen Sie dafür über die Checkbox Erweiterte Optionen anzeigen den Bereich mit den erweiterten Optionen.

• Passwort speichern: Aktivieren Sie die Checkbox, wenn Sie das Passwort für die aktive Verbindung speichern wollen.
• Anmelden als: Um sich unter einer anderen Mitarbeiter-Nr. anzumelden (Impersonation) geben Sie hier die entsprechende Mitarbeiter-Nr. ein. Beachten Sie, dass Sie für das Nutzen der Impersonation über die entsprechende Berechtigung (Administrator) verfügen müssen..

  Notiz Unter Impersonation verstehen wir folgendes: Ich (Administrator oder Benutzer mit Administrator-Stufe) melde mich mit meinem Login (Benutzer-Nr. und Passwort) am System an, gebe dabei aber (zusätzlich) eine andere Benutzer-Nr. an. Als Administrator "imitiere" ich also einen bestimmten Benutzer. Beachten Sie, dass für das Nutzen der Impersonation die Checkbox Einloggen mit Admin Passwort gesperrt beim entsprechenden Benutzer nicht aktiv sein darf. Sie finden diese Einstellung (Checkbox) in den persönlichen Einstellungen (BC 99004). Beachten Sie, dass eine Anmeldung mit Impersonation nicht mehr möglich ist, sobald der entsprechende Benutzer (Impersonation) über eine Administrator-Berechtigung verfügt (Administrator-Stufe > 0).

• Cohort Id: Über die hier erfasste Cohort Id erfolgt die Zuordnung zur entsprechenden ServiceBus Instance. Siehe auch Kapitel Anpassen der Konfiguration - OpaccOneInstallation.xml
• Optionen: Aktuell werden folgende Optionen unterstützt: -console, -console:file und -test.
  • -console - OpaccERP bzw. OpaccOXAS Studio werden direkt mit aktivierter Konsole gestartet.
  • -console:file - Ab dem Start werden sämtliche Aktionen in ein Logfile geschrieben. Das Logfile wird lokal im Verzeichnis ...AppData\Local\Opacc\Erp\Log abgelegt.
  • -test:<Testverzeichnis> - Mit dieser Option können Sie speziell von unserer Entwicklung zur Verfügung gestellte Test-Versionen des User Interface nutzen.

• Desktopverknüpfung erstellen: Erstellt eine Desktopverknüpfung mit der aktiven Verbindung bzw. den eingegebenen Werten.
• Verbindung entfernen: Entfernt die aktive/ausgewählte Verbindung.
• Windows-Anmeldeinformationsverwaltung...: Öffnet die Windows-Anmeldeinformationsverwaltung (Windows Credential Manager).
• Protokolldateien anzeigen...: Öffnet das Verzeichnis mit den Protokolldateien (Logs) im Windows Explorer.