Tech Notes

Lizenzen

• Lizenzierte Serverprozessoren: Es ist sicherzustellen, dass genügend Serverprozessoren lizenziert sind. Ansonsten ist das Starten des Servermode-ServiceBus nicht möglich.
• Für die Nutzung der WebService-Schnittstelle ist zusätzlich die Option WebService-Schnittstelle zu lizenzieren.

Applikationsserver - Technische Vorgaben

F-Scripts: Ersetzen von absoluten Pfaden zu Insyde

# -----------------------------------------------
# Varianten welche anzupassen sind:
# Beispiel InsydePath mit Laufwerksangabe
O:\INSYDE\TMP\Datei.txt
# Beispiel statischer Pfad ohne Laufwerksangabe
\INSYDE\TMP\Datei.txt

# Nach der Anpassung:
«SYS(FULLPATH)»TMP\BODY.HTM
# -----------------------------------------------

F-Scripts: Ersetzen von individuellen Pfaden

Achtung Der OXAS Server muss auf diesen UNC-Pfad natürlich auch Zugriff haben. Eingeschränkte Freigaben sind zu vermeiden!

Notiz Legen Sie individuelle Pfade welche sich nicht relativ zu Insyde befinden immer in einer Endusertabelle ab. Dies hat den Vorteil, dass Pfade - wenn diese jemals ändern sollten – nur an einer Stelle geändert werden müssen.

# -----------------------------------------------
# Beispiel indiv Pfad (Netzlaufwerk)
Z:\EDI\Protokolle\
X:\TRANSFER\XMLEXPORT\Processing
X:\TRANSFER\XMLEXPORT\Done
# Nach der Anpassung:
«SCRIPTING.PATH(PATH.EDI)»\Protokolle
«SCRIPTING.PATH(PATH.XMLEXPORT)»\Processing
«SCRIPTING.PATH(PATH.XMLEXPORT)»\Done
# oder wenn nciht in einer Endusertabelle:
\\SERVER001\EDI\Protokolle
\\SERVER002\Transfer\XMLExport\Processing
\\SERVER002\Transfer\XMLExport\Done
# -----------------------------------------------

F-Scripts: Pfade auf lokale Verzeichnisse am Client

Notiz Idealerweise verschieben Sie den Pfad einfach relativ zu Insyde (am Server). Ist dies nicht möglich müsste dieses Script mit einem BOFScript gekappselt werden.

OpaccERP auf UNC-Pfad umstellen

Analyse F-Script Statistik

Notiz Exportieren Sie die Datensätze ins Excel. In Excel können die einzelnen Einträge dann einfacher beurteilt und nach Themen gruppiert werden.

Achtung Denken Sie daran, dass Kunden z.T. Scripts oder Verarbeitungen nur 1x im Monat oder Jahr verwenden könnten! Diese Scripts sollten auch in die Analyse miteinbezogen werden!

Bereinigung FF-Verzeichnis

Notiz Mittels F-Script Statistik lassen sich Rückschlüsse über die Verwendung von F-Scripts ziehen. Wird ein F-Script in der Statistik nicht aufgeführt, kann davon ausgegangen werden, dass dieses potentiell nicht mehr benötigt wird oder es sich um eine Kopie/Sicherung handelt. Verschieben Sie Dateien welche offensichtlich nicht mehr benötigt werden in ein Unterverzeichnis.

Achtung Löschen Sie diese Dateien nicht! Sollte ein Script nach ein paar Monaten dann doch noch von jemand benötigt werden, kann dieses einfach wieder aus dem Unterverzeichnis kopiert werden.

Gruppierung nach Dialog-Typ

• Dialoge Typ «Meldungen / Infos» (keine User-Interaktion)
• Dialoge Typ «Script-Eingabe» (klassicher Script-Dialog z.B. "Startdatum eingeben")
• Dialoge Typ «HARRAY(POPUP)» Selektionen (Select/MultiSelect)

Gruppierung nach Anwendungsbereich

• Dialoge bei «Auswertungen»
• Dialoge von F-Scripts welche ab «DeskItem» usw. gestartet werden (OnClick)
• Dialoge in «Logik-Scripts» (VEVV,VERPSAVE, ARTSAVE usw.)

Dialog Typ: «Meldungen / Infos»

Dialog Typ: «Script-Eingabe»

Dialog Typ: «HARRAY(POPUP)»

Installieren und Konfigurieren des Servermode-ServiceBus

Tool: Opacc.Update.ReportsXml.Test.App.exe

Datenbank-Verbindung erstellen...
...ok
'OpaccOneInstallation.xml' für 'L:\Insyde' einlesen...
- Configured-Root-Path: '\\lab-db-03\OpaccLab1510\Insyde'

Notiz "Discarded" bedeutet, dass diese Reports beim Update gelöscht würden! Reports mit "Error" müssen vor dem Update bereinigt werden.

Alle Reports.xml migrieren (nur Simulation)...
Zusammenfassung --------------------
- Mandant 1: -> 302 Reports (218 Ok / 8 Discarded / 76 ERROR)
- Mandant 67: -> 96 Reports (89 Ok / 5 Discarded / 2 ERROR)

• Invalid Template-Path

  '\\LABV14DB.lab.intra.local\OpaccOneV1420\Insyde\Reports\Templates\Adressetikette.dot': Invalid Path/Name given: Path '\\LABV14DB.lab.intra.local\OpaccOneV1420\Insyde\Reports\Templates\Adressetikette.dot' outside of 'l:\Insyde'

  Die Auswertung verwendet ein Pfad-Muster welches gem. OpaccOneInstallation.xml nicht gültig ist.. Pfade egal ob Scripts oder Vorlagen etc. müssen sich innerhalb der Insyde-Struktur befinden.
  Lösung:
  Pfad bereinigen wenn Auswertung noch benötigt wird.
  Report löschen, wenn es sich um einen Test handelt.
• Unexpected Criterion Rows Value detected

  Concat Operator is 'ZZZZZZ'

  Die Auswertung enthält ein ungültiges Filter-Kriterium im XML-Element <CriterionRows> Erwartet wäre "and" oder "or".

  <CriterionRows>Addr.Number;null;;;;8;Ein;;&gt;=;1;99999;;and;0;Addr.CountrySc;null;;;;8;Ein;;&gt;=;;ZZZ;;and;0;Addr.Zip;null;;;;8;Ein;;&gt;=;;ZZZZZZ;;ZZZZZZ;0;</CriterionRows>

  Hier trat beim Ändern der Selektionskriterien mal ein Fehler auf. Das UI korrigierte (ignorierte) diese Fehler bei der Ausführung oftmals.
  Lösung:
  Erneutes Speichern der Auswahlkriterien im BC 84110 Auswertung Eigenschaft en löst das Problem

  <CriterionRows>Addr.Number;null;;;;8;UI.84120.Inner;;&gt;=;1;99999;;and;0;Addr.CountrySc;null;;;;8;UI.84120.Inner;;&gt;=;;ZZZ;;and;0;Addr.Zip;null;;;;8;UI.84120.Inner;;&gt;=;;ZZZZZZ;;;0;</CriterionRows>

• Error: Unexpected Result Value detected

  Type is 'Addr.Email(AddrPoolItem.AddrNo)'

  In dieser Auswertung sind ungültige Ausgabe-Attribute enthalten. Diese wurde vom UI oftmals ignoriert oder führten vor dem Update schon zu Fehlern.

  Mail=if(Contact.Email(AddrPoolItem.ContactBoId)="";Addr.Email(AddrPoolItem.AddrNo);Contact.Email(AddrPoolItem.ContactBoId))

  Lösung:
  In diesem Fall hier: Die If-Expresison erlaubt kein Semikolon sondern nur Kommas als Delimiter Es liegt hierbei eigentlich immer an der falschen Defintion eines virtuellen Attributes.
• Discarded: Reports without Main-Selection

  Reports without Main-Selection ('content/BoSelection/Selection') not support

  Diese Auswertung besitzt keine Selektion und funktioniert so vor der Migration schon nicht. Oft handelt es sich um Tests.
  Da das BC 84100 vor V. 16.10.00 keine Suchmöglchkeit besass, wurden teils Begriffe als Auswertungen erfasst um geziehlt an diese Stelle zu "springen". Diese hätten jeweils gelöscht werden müssen – daran scheinen sich aber viele Personen nicht gestört zu haben.
  Lösung:
  Diese Auswertung wird automatisch gelöscht beim Update.
• Discarded: 'E-Mail KP, mit Anhang' / 'E-Mail mit Anhang, einzeln'

  Standard-Reports with fixed Email-Attachements do not make any sense

  Diese beiden Standard-Auswertung waren früher mal als "Beispiel" gedacht. Diese besitzen ein fixes Attachment und können nicht durch Kunden reell verwendet werden.
  Standardauswertungen sollten eigentlich "Fullfeatured" sein und somit durch einen Kunden verwendbar sein. Hier handelte es sich um ein "Beispiel".
  Lösung:
  Diese Auswertungen werden automatisch gelöscht beim Update.

Tool: RegularExpressionScripts.exe

Notiz Beachten Sie, dass nicht jeder Treffer zwingend auch "falsch" sein muss, da auch Regex (Suchmechanik) seine Grenzen hat. Dieses Tool soll lediglich die Suche der potentiell anzupassenden Codestellen vereinfachen.