Konfigurationsdatei LoadingSystemConfiguration: Unterschied zwischen den Versionen

Aus succestWiki
Wechseln zu: Navigation, Suche
Zeile 142: Zeile 142:
 
* [[#UFT (uft)|uft]]
 
* [[#UFT (uft)|uft]]
 
* [[#Web API (webapi)|Web API (webapi)]]
 
* [[#Web API (webapi)|Web API (webapi)]]
 +
* [[#CSV|csv]]
  
 
Nicht jedes Protokoll unterstützt jeden Parameter. Nachfolgend finden Sie eine Auflistung der zur Zeit möglichen Parameter je Loader.
 
Nicht jedes Protokoll unterstützt jeden Parameter. Nachfolgend finden Sie eine Auflistung der zur Zeit möglichen Parameter je Loader.
Zeile 338: Zeile 339:
 
|}
 
|}
  
 +
=== CSV ===
 +
Der CSV Loader ersetzt die, an der Zielsystemkonfiguration hinterlegten Platzhalter in der erstellten Ladedatei und überträgt diese anschließend zum Zielsystem.
 +
 +
<syntaxhighlight lang="xml">
 +
<Loader Name="CSV">
 +
  <Uri>csv://csvFile</Uri>
 +
  <!-- <BaseUrl>ftp://tst.ftp123.de/Test</BaseUrl> -->
 +
  <BaseUrl>D:\</BaseUrl>
 +
  <TransmitType>Local</TransmitType>
 +
  <UsePassive>True</UsePassive>
 +
  <EnableSsl>True</EnableSsl>
 +
  <Timeout>5</Timeout>
 +
  <Authentication>
 +
      <username>test</username>
 +
      <password AsCdata="true" Encrypt="true"><![CDATA[[!enc!]+diwadjkfowefkiowkr9238rk902398mpcfnbw891x9e89n12ex[!enc!]]]></password>
 +
  </Authentication>
 +
  <LoaderDirectory>D:\SUCCEST-TCR\TempLoadingFiles\CSV</LoaderDirectory>
 +
  <LoaderLogfileDirectory>D:\SUCCEST-TCR\TempLoadingFiles\CSV\Logs</LoaderLogfileDirectory>
 +
  <Encoding>UTF8</Encoding>
 +
  <Separator>;</Separator>
 +
  <FieldDelimiter>"</FieldDelimiter>
 +
  <EnableHeaderLine>True</EnableHeaderLine>
 +
  <MaxLines>5</MaxLines>
 +
</Loader>
 +
</syntaxhighlight>
 +
 +
==== Weitere Konfigurationsparameter ====
 +
{| class="wikitable"
 +
! Element
 +
! Beschreibung
 +
|-
 +
|
 +
BaseUrl
 +
| Die URL des zu testenden Systems. Sie können hier auch direkt einen Pfad mit angeben.
 +
Für FTP-Verbindungen mittels SSL (FTPS) die Option <code>EnableSsl</code> auf <code>True</code> setzen.
 +
Kein ftps in der Uri verwenden!
 +
|-
 +
|
 +
TransmitType
 +
| Gibt die Übertragungkanal an:
 +
* None - Die Ladedatei bleibt im LoaderDirectory liegen
 +
* Local - Die Ladedatei wird auf ein lokales Verzeichnis oder ein Netzlaufwerk kopiert
 +
* FTP - Überträgt die Ladedatei in ein Verzeichnis auf einem FTP Server
 +
|-
 +
|
 +
UsePassive
 +
| (Nur mit <code>TransmitType = FTP</code>)
 +
Gibt an, ob der aktiv oder passiv Modus für die Verbindung verwendet wird.
 +
* <code>True</code>
 +
* <code>False</code>
 +
|-
 +
|
 +
EnableSsl
 +
| (Nur mit <code>TransmitType = FTP</code>)
 +
Gibt an ob SSL für die Verbindung verwendet wird.
 +
Die <code>Uri</code> darf jedoch kein <code>ftps</code> enthalten.
 +
* <code>True</code>
 +
* <code>False</code>
 +
|-
 +
|
 +
Timeout
 +
| Gibt an, nach wie viel Sekunden die Abfrage abgebrochen werden soll.
 +
|-
 +
|
 +
Authentication
 +
| Ein optionaler Block, zur Authentifizierung am System.
 +
|-
 +
|
 +
type
 +
| Die Art der Authentifizierung. Aktuell wird nur <code>Basic</code> oder <code>JWT</code> ([https://jwt.io Json Web Token]) unterstützt.
 +
|-
 +
|
 +
:username
 +
| Benutzername der für die Authentifizierung genutzt wird.
 +
|-
 +
|
 +
:password
 +
| Passwort das für die Authentifizierung genutzt wird.
 +
|-
 +
|
 +
Separator
 +
| Gibt ein Seperator-Zeichen an, mit dem die Platzhalter in der Ladedatei ersetzt werden.
 +
|-
 +
|
 +
FieldDelimiter
 +
| Gibt ein Feldbegrenzer-Zeichen an, mit dem die Platzhalter in der Ladedatei ersetzt werden.
 +
|-
 +
|
 +
EnableHeaderLine
 +
| Gibt an ob Ladedatei mit oder ohne Kopfzeile erstellt wird.
 +
* <code>True</code>
 +
* <code>False</code>
 +
|-
 +
|
 +
MaxLines
 +
| Gibt an, wie viele Zeile pro Ladedateien enthalten sind.
 +
Sollte eine Ladedatei mehr als die angegebenen Zeilen enthalten, wird diese in mehrere Dateien aufgeteilt.
 +
|-}
  
 
[[Category:Konfiguration]]
 
[[Category:Konfiguration]]

Version vom 28. Juli 2020, 11:38 Uhr

Diese Konfiguration definiert die System Under Test (SUT): Welche es gibt, wie sie erreicht werden können, welche Parameter bei der Kommunikation gesetzt oder verwendet werden sollen und vieles mehr.

  • Kurzform: LoadingSystemConfiguration
  • Vollständig: TestcaseRepositoryAPI.LoadingSystem.LoadingSystemConfiguration.config

Beispiel

<root>
  <DefaultLoadingSystem Type="string">sap://TST/80</DefaultLoadingSystem>
  <Loaders Type="XmlDocument">
    <config>
      <Loader Name="TST" priority="2">
        <Uri>sap://TST/80</Uri>
        <NCo>
          <AppServerHost>tst.sap.fmc-test.de</AppServerHost>
          <SystemNumber>00</SystemNumber>
          <SystemID>TST</SystemID>
          <User>SUCCEST</User>
          <Password>...</Password>
          <Client>80</Client>
          <Language>DE</Language>
        </NCo>
        <DefaultPacketSize>50</DefaultPacketSize>
        <Encoding>default</Encoding>
        <IsDummyMode>False</IsDummyMode>
        <LoadFileIsBinary>False</LoadFileIsBinary>
        <LoaderDirectory>\\213.160.19.13\SUCCEST\Load</LoaderDirectory>
        <LoaderLogfileDirectory>\\213.160.19.13\SUCCEST\Logs</LoaderLogfileDirectory>
        <SchedulingMethod>p</SchedulingMethod>
        <UseByteOrderMarks>False</UseByteOrderMarks>
        <UseRfcFileCopy>true</UseRfcFileCopy>
        <UseUnixLineFeed>False</UseUnixLineFeed>
        <InitialAction>
          <BapiToCall>Z_BC_MIG_CREATE_MIG_FILES</BapiToCall>
          <Parameters>
            <Parameter name="FILENAMES" type="stringtab">file1</Parameter>
            <Parameter name="FILENAMES" type="stringtab">file2</Parameter>
            <Parameter name="FILENAMES" type="stringtab">file3</Parameter>
            <Parameter name="FILENAMES" type="stringtab">file4</Parameter>
          </Parameters>
        </InitialAction>
      </Loader>
    </config>
  </Loaders>
  <TargetLoaderMatrix Type="XmlDocument">
    <config>
      <LoadingSystem>
        <Uri>sap://TST/80</Uri>
        <TargetSystems>
          <TargetSystemUri>sap://TST/80</TargetSystemUri>
          <TargetSystemUri>sap://DEV/20</TargetSystemUri>
        </TargetSystems>
      </LoadingSystem>
    </config>
  </TargetLoaderMatrix>
</root>

Elemente

Nachfolgende Tabelle gibt eine Übersicht über alle generell verfügbaren Konfigurationsparameter. Je nach Art des Zielsystems, werden im Abschnitt Loader weitere Parameter unterstützt.

Element Beschreibung

DefaultLoadingSystem

Definiert das standardmäßig zu verwendende Zielsystem.

Loaders

Enthält Verbindungsinformationen für die Loader.
Loader
 Definiert einen eindeutigen Namen für einen Loader.
priority
 (ab Version 2017.04) Numerischer Wert, der die Reihenfolge angibt, in der die Loader bei einem Testlauf abgearbeitet werden sollen. Bei doppelten Prioritäten, wird eine Nachricht ins Trace-Log geschrieben. Je niedriger der Wert desto höher priorisiert.
Uri
 Ist der eindeutige Bezeichner eines Loaders. Dieser muss auch im succest Testcase Editor (TCE) in den Aktivitäten als SystemUri genutzt werden.
Encoding
 Kodierung der Ladedateien.

Dabei sind folgende Varianten unterstützt:

  • UTF8
  • UTF16LE: LE steht für Little Endian
  • UTF16BE: BE steht für Big Endian
  • Standard des Hostsystems
IsDummyMode
 Definiert ob der Testlauf nur im TCR simuliert wird. Es werden keine Dateien auf das SUT übertragen.
LoadFileIsBinary
 Definiert ob die Ladedatei im Binärformat vorliegt.
LoaderDirectory
 Pfad auf den die Ladedateien im Zielsystem hochgeladen werden sollen.
LoaderLogfileDirectory
 Pfad auf den die Logdateien im Zielsystem hochgeladen werden sollen.
UseByteOrderMarks
 Definiert ob ByteOrderMarks in den Ladedateien genutzt werden sollen.
UseUnixLineFeed
 Definiert ob der Linux Zeilenumbruch in den Ladedateien genutzt wird.

TargetLoaderMatrix

Definiert die Zugriffsweiterleitung zwischen verschiedenen Zielsystemen.
LoadingSystem
 Definiert das Mapping von einem Zielsystem auf mindestens ein Anderes.
Uri
 Bezeichner des Systems über das die Anfragen weitergeleitet werden.
TargetSystemUri
 Bezeichner eines Zielsystems.

Beispielkonfigurationen

Es gibt unterschiedliche Arten von Loadern. Welcher verwendet wird, wird durch die Protokollangabe der URI des Loaders bestimmt. Folgende Protokolle werden unterstützt:

Nicht jedes Protokoll unterstützt jeden Parameter. Nachfolgend finden Sie eine Auflistung der zur Zeit möglichen Parameter je Loader.

SAP (sap)

Siehe Beispielkonfiguration.

Die erstellten Ladedateien werden am Ende an succests Ladeprozess in SAP übermittelt und zur Ausführung herangezogen.

Weitere Konfigurationsparameter

Element Beschreibung

NCo

Die hier aufgeführten Parameter werden direkt an den SAP .NET Connector weitergeleitet.

Vollständige Dokumentation gibt es hier (SAP .NET Connector 3.0 Programming Guide, Abschnitt: Client Parameters).

AppServerHost
 Name des SAP Anwendungsservers.
SystemNumber
 Die SAP Systemnummer.
SystemID
 Enthält den eindeutigen drei Zeichen langen Namen des SAP Systems.
User
 Benutzername der für die SAP Verbindung genutzt wird.
Password
 Passwort das für die SAP Verbindung genutzt wird.
Client
 Mandantennummer des SAP Systems.
Language
 Die Sprache die für eine Verbindung genutzt wird.

DefaultPacketSize

InitialAction

Eine optionale Aktion die einmalig auf einem SUT vor dem Durchlauf eines Testfalls ausgeführt wird.
BapiToCall
 Name einer Funktion die einmalig auf einem SAP System vor dem Durchlauf eines Testfalls ausgeführt wird.
Parameter
 Parameter die mit Namen und Typ an die Funktion übergeben werden. Aktuellen werden nur Tabellen des Typs 'StringTab' unterstützt.

SchedulingMethod

Definiert ob der Ladeprozess im Zielsystem parallelisiert oder nicht parallelisiert durchgeführt wird.
  • p: Parallelisiert
  • n: Nicht parallelisiert

UseRfcFileCopy

Definiert ob die Ladedateien mittels RFC übertragen werden.

SAP File Controller (sapfc)

Wie beim SAP-Loader werden die erstellten Ladedateien am Ende an das SAP System Under Test (SUT) übermittelt. Ob und wie die Datei später verwendet werden soll hängt von Ihren Prozessen ab. 

<Loader Name="TSTFC">
  <Uri>sapfc://TST/80</Uri>
  <NCo>
    <AppServerHost>tst.sap.fmc-test.de</AppServerHost>
    <SystemNumber>00</SystemNumber>
    <SystemID>TST</SystemID>
    <User>SUCCEST</User>
    <Password>...</Password>
    <Client>80</Client>
    <Language>DE</Language>
  </NCo>
  <Encoding>default</Encoding>
  <IsDummyMode>False</IsDummyMode>
  <LoadFileIsBinary>False</LoadFileIsBinary>
  <LoaderDirectory>D:\SUCCEST-TCR\FileController\SAP\Load</LoaderDirectory>
  <LoaderLogfileDirectory>D:\SUCCEST-TCR\FileController\SAP\Logs</LoaderLogfileDirectory>
  <UseByteOrderMarks>False</UseByteOrderMarks>
  <UseUnixLineFeed>False</UseUnixLineFeed>
</Loader>

Weitere Konfigurationsparameter

Element Beschreibung

NCo

Siehe SAP (sap)

UseRfcFileCopy

Definiert ob die Ladedateien mittels RFC übertragen werden.

Standard File Controller (stdfc)

Die erstellten Ladedateien werden am Ende einfach zum SUT kopiert. 

<Loader Name="TSTFC">
  <Uri>stdfc://TST/80</Uri>
  <Encoding>default</Encoding>
  <IsDummyMode>False</IsDummyMode>
  <LoadFileIsBinary>False</LoadFileIsBinary>
  <LoaderDirectory>D:\SUCCEST-TCR\FileController\STD\Load</LoaderDirectory>
  <LoaderLogfileDirectory>D:\SUCCEST-TCR\FileController\STD\Logs</LoaderLogfileDirectory>
  <UseByteOrderMarks>False</UseByteOrderMarks>
  <UseUnixLineFeed>False</UseUnixLineFeed>
</Loader>

UFT (uft)

Die erstellte Ladedatei wird zum SUT übertragen, wo ein Service sie in Empfang nehmen und ausführen wird. 

<Loader Name="UFT">
  <Uri>uft://uft.fmc-gmbh.de/instance1</Uri>
  <Encoding>default</Encoding>
  <IsDummyMode>False</IsDummyMode>
  <LoaderDirectory>D:\SUCCEST-TCR\UFT\Load</LoaderDirectory>
  <LoaderLogfileDirectory>D:\SUCCEST-TCR\UFT\Logs</LoaderLogfileDirectory>
  <UseByteOrderMarks>False</UseByteOrderMarks>
  <UseUnixLineFeed>False</UseUnixLineFeed>
</Loader>

Web API (webapi)

Die erstellte Ladedatei enthält alle weiteren Informationen, wie ein Request an diese Web API geschickt werden soll. 

<Loader Name="WebAPItest">
  <Uri>webapi://test</Uri>
  <BaseUrl>https://tst.web.fmc-test.de/API</BaseUrl>
  <Timeout>5</Timeout>
  <RequestsInParallel>5</RequestsInParallel>
  <Authentication type="Basic">
    <username>TST</username>
    <password AsCdata="true" Encrypt="true">...</password>
  </Authentication>
  <LoaderDirectory>D:\SUCCEST-TCR\WebApi\Load</LoaderDirectory>
  <LoaderLogfileDirectory>D:\SUCCEST-TCR\WebApi\Logs</LoaderLogfileDirectory>
</Loader>

Weitere Konfigurationsparameter

Element Beschreibung

BaseUrl

Die URL des zu testenden Systems. Sie können hier auch direkt einen Pfad mit angeben.

Timeout

Gibt an, nach wie viel Sekunden die Abfrage abgebrochen werden soll.

RequestsInParallel

Gibt an, wie viele Anfragen maximal gleichzeitig zu dem System geschickt werden dürfen.

Authentication

Ein optionaler Block, zur Authentifizierung am System.

type

Die Art der Authentifizierung. Aktuell wird nur Basic oder JWT (Json Web Token) unterstützt.
username
 Benutzername der für die Authentifizierung genutzt wird.
password
 Passwort das für die Authentifizierung genutzt wird.

CSV

Der CSV Loader ersetzt die, an der Zielsystemkonfiguration hinterlegten Platzhalter in der erstellten Ladedatei und überträgt diese anschließend zum Zielsystem. 

<Loader Name="CSV">
   <Uri>csv://csvFile</Uri>
   <!-- <BaseUrl>ftp://tst.ftp123.de/Test</BaseUrl> -->
   <BaseUrl>D:\</BaseUrl>
   <TransmitType>Local</TransmitType>
   <UsePassive>True</UsePassive>
   <EnableSsl>True</EnableSsl>
   <Timeout>5</Timeout>
   <Authentication>
      <username>test</username>
      <password AsCdata="true" Encrypt="true"><![CDATA[[!enc!]+diwadjkfowefkiowkr9238rk902398mpcfnbw891x9e89n12ex[!enc!]]]></password>
   </Authentication>
   <LoaderDirectory>D:\SUCCEST-TCR\TempLoadingFiles\CSV</LoaderDirectory>
   <LoaderLogfileDirectory>D:\SUCCEST-TCR\TempLoadingFiles\CSV\Logs</LoaderLogfileDirectory>
   <Encoding>UTF8</Encoding>
   <Separator>;</Separator>
   <FieldDelimiter>"</FieldDelimiter>
   <EnableHeaderLine>True</EnableHeaderLine>
   <MaxLines>5</MaxLines>
</Loader>

Weitere Konfigurationsparameter

Element Beschreibung

BaseUrl

Die URL des zu testenden Systems. Sie können hier auch direkt einen Pfad mit angeben.

Für FTP-Verbindungen mittels SSL (FTPS) die Option EnableSsl auf True setzen. Kein ftps in der Uri verwenden!

TransmitType

Gibt die Übertragungkanal an:
  • None - Die Ladedatei bleibt im LoaderDirectory liegen
  • Local - Die Ladedatei wird auf ein lokales Verzeichnis oder ein Netzlaufwerk kopiert
  • FTP - Überträgt die Ladedatei in ein Verzeichnis auf einem FTP Server

UsePassive

(Nur mit TransmitType = FTP)

Gibt an, ob der aktiv oder passiv Modus für die Verbindung verwendet wird.

  • True
  • False

EnableSsl

(Nur mit TransmitType = FTP)

Gibt an ob SSL für die Verbindung verwendet wird. Die Uri darf jedoch kein ftps enthalten.

  • True
  • False

Timeout

Gibt an, nach wie viel Sekunden die Abfrage abgebrochen werden soll.

Authentication

Ein optionaler Block, zur Authentifizierung am System.

type

Die Art der Authentifizierung. Aktuell wird nur Basic oder JWT (Json Web Token) unterstützt.
username
 Benutzername der für die Authentifizierung genutzt wird.
password
 Passwort das für die Authentifizierung genutzt wird.

Separator

Gibt ein Seperator-Zeichen an, mit dem die Platzhalter in der Ladedatei ersetzt werden.

FieldDelimiter

Gibt ein Feldbegrenzer-Zeichen an, mit dem die Platzhalter in der Ladedatei ersetzt werden.

EnableHeaderLine

Gibt an ob Ladedatei mit oder ohne Kopfzeile erstellt wird.
  • True
  • False

MaxLines

Gibt an, wie viele Zeile pro Ladedateien enthalten sind.

Sollte eine Ladedatei mehr als die angegebenen Zeilen enthalten, wird diese in mehrere Dateien aufgeteilt.

Abgerufen von „http://wiki.succest.com/index.php?title=Konfigurationsdatei_LoadingSystemConfiguration&oldid=2826“