Referenzen: Unterschied zwischen den Versionen

Aus succestWiki
Wechseln zu: Navigation, Suche
(Die Seite wurde neu angelegt: „Wenn Zielsysteme z. B. bei der Erstellung von Daten mit einer internen Nummernvergabe arbeiten, ist es sc…“)
 
Zeile 28: Zeile 28:
  
 
Dafür müssen Variablen vom Typ SuccestReference definiert werden. Um diese zu initialisieren brauchen sie einen Standardwert: <code>new SuccestReference()</code>.
 
Dafür müssen Variablen vom Typ SuccestReference definiert werden. Um diese zu initialisieren brauchen sie einen Standardwert: <code>new SuccestReference()</code>.
 +
Zu beachten ist, dass bei den Importen für den Testfall der Namespace <code>Succest</code> geladen werden muss.
 
<gallery>
 
<gallery>
 
Datei: Verwendung von Referenzen.png|Abb.2: Verwendung von Referenzen im TCE
 
Datei: Verwendung von Referenzen.png|Abb.2: Verwendung von Referenzen im TCE
 +
Datei: Import Succest Namespace.png|Abb.3: Import des Succest-Namespace
 
</gallery>
 
</gallery>
  
Zeile 116: Zeile 118:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 +
== Ausgabe in einem Kiosk-Testfall ==
 +
Um Referenzen in einem [[Testfälle_für_den_Kiosk_schreiben|Kiosk-Testfall]] ausgeben zu können, müssen bestimmte Vorraussetzungen getroffen werden. Im folgenden Abschnitt sind diese beschrieben.
 +
 +
Um einen Wert nach der Ausführung eines Kiosk-Testfalls ausgeben zu können, muss dieser als Ausgabe-Argument im TCE definiert werden. Anschließend kann dieser wie eine
 +
Variable verwendet werden. Da Argumente jedoch keinen Standardwert besitzen, ist es nötig die Referenz im Testfall zu definieren. Dies geschieht über die [[Aktivität_Assign|Assign-Aktivität]].
 +
Dort wird einem Ausgabe-Argument vom Typ SuccestReference der Wert <code>new SuccestReference()</code> zugewiesen.
 +
 +
<gallery>
 +
Datei: Zuweisung von Referenzen.png|Abb.4: Zuweisung von Referenzen
 +
</gallery>
  
 
[[Category:TCE]][[Category:Aktivitäten]][[Category:Vorlagen]]
 
[[Category:TCE]][[Category:Aktivitäten]][[Category:Vorlagen]]

Version vom 13. September 2019, 07:48 Uhr

Wenn Zielsysteme z. B. bei der Erstellung von Daten mit einer internen Nummernvergabe arbeiten, ist es schwierig sich in nachfolgenden Testfallschritten auf den eben erstellten Datensatz zu beziehen. Schließlich kennt man dann nicht die ID des Datensatzes.

Die Lösung ist eine Referenz, die im TCE erstellt wird und anhand dieser ein Datensatz eindeutig referenziert werden kann. Der FMC Loader hat bereits eine eigene Implementierung hierfür, welche allerdings nur mit SAP funktioniert. Will man nun bei einem Testfall für eine WebAPI einen Datensatz anlegen und anschließend bearbeiten, kann man dies mit einer Referenz bewerkstelligen.

In succest gibt es die Möglichkeit einer Aktivität ein Feld vom Typ SuccestReference zu geben. In diesem wird die Referenz angegeben, um in mehreren Testfallschritten auf denselben Datensatz zu verweisen.

Vorraussetzungen

Um mit Referenzen arbeiten zu können müssen diese entsprechend in den Erzeugungs- und Ergebnisvorlagen hinterlegt sein.

Aktivitäten

Damit eine Referenz in einer Aktivität genutzt werden kann, muss dieser ein Feld vom Typ SuccestReference zugewiesen werden.

Anschließend können der Aktivität im TCE eine oder mehrere Referenzen (entsprechend der Anzahl der Felder) zugewiesen werden.

Dafür müssen Variablen vom Typ SuccestReference definiert werden. Um diese zu initialisieren brauchen sie einen Standardwert: new SuccestReference(). Zu beachten ist, dass bei den Importen für den Testfall der Namespace Succest geladen werden muss.

Erzeugungsvorlagen

Um beim Aufruf einer WebAPI eine gespeicherte Referenz mitgeben zu können, muss dies in der Erzeugungsvorlage definiert werden. Es ist möglich einer Erzeugungsvorlage mehrere Referenzen mitzugeben. In dem unteren Beispiel soll die Adresse eines Kunden geändert werden. Mithilfe von Referenzen kann auf den Kunden und dessen Adress-Datensatz verwiesen werden. Die Referenzen werden in diesem Fall von der verknüpften Aktivität ausgelesen.

<?xml version="1.0" encoding="utf-8"?>
<root>
  <version>1</version>
  <textTemplateType>GenerationTemplate</textTemplateType>
  <id>9aead5bc-8e3d-4fa4-b22d-80042e6a9125</id>
  <recs>
    <rec>
      <stepId>01B{$RecordIndex:00000000}{$TestCaseId:N}{$Id:N}</stepId>
      <uri>/customers/{$CustomerId}/addresses/{$AddressId}</uri>
      <method>PUT</method>
      <contentType>JSON</contentType>
      <body>
        {
        "City": "{$City}",
        "CountryCode": "{$CountryCode}",
        "HouseNumber": "{$HouseNumber}",
        "Street": "{$Street}",
        "ZipCode": "{$ZipCode}",
        }
      </body>
      <authentication type="JWT">
        <uri>/authenticate</uri>
        <method>POST</method>
        <contentType>JSON</contentType>
        <body>
          {
            "Username": "{$EMail}",
            "Password": "test"
          }
        </body>
      </authentication>
    </rec>
  </recs>
  <fields>
    <field group="Information" name="City" prompt="City" type="System.String" />
    <field group="Information" name="CountryCode" prompt="Country code" type="System.String" />
    <field group="Information" name="HouseNumber" prompt="House number" type="System.String" />
    <field group="Information" name="Street" prompt="Street" type="System.String" />
    <field group="Information" name="ZipCode" prompt="Zip code" type="System.String" />
    <field group="Information" name="EMail" prompt="E-Mail" type="System.String" />
  </fields>
  <loadingObject>WEBAPI</loadingObject>
  <availableInActivities>
    <activity>Referenzen.CustomerWithCustomerIdAndAddressId</activity>
  </availableInActivities>
</root>

Ergebnisvorlagen

Damit eine Referenz ausgelesen werden kann, muss in den Ergebnisvorlagen definiert sein, von wo der Wert ausgelesen werden soll. Also welcher Wert in der Rückgabe die zu speichernde Referenz enthält. Die Ergebnisvorlage im unten folgenden Beispiel erwartet, dass die Anfrage einen HTTP-Status-Code 200 zurückgibt und liest gleichzeitig den Wert des eben angelegten Datensatzes aus (dieses Feld ist auch mit isSuccestReference="true" markiert). Ergebnisvorlagen können im Gegensatz zu Erzeugungsvorlagen nur eine Referenz verarbeiten.

<?xml version="1.0" encoding="utf-8"?>
<root>
  <version>2</version>
  <textTemplateType>ResponseAnalyzisTemplate</textTemplateType>
  <id>2b83f7b7-24b1-4fc2-a937-376b2474ccd6</id>
  <recs>
    <rec isSuccestReference="true" isTrue="true" type="xpath">//contentAsXml//Id/text()</rec>
    <rec isSuccestReference="false" isTrue="true" type="xpath">//statusCode[contains(text(), '200')]</rec>
  </recs>
  <internal.recs>
    <recs line="0" id="//contentAsXml//Id/text()" description="Referenz auslesen" isTrue="true" type="SUCCEST_REFERENCE" filtertype="XPath" variable="" isSuccestReference="true" />
    <recs line="1" id="//statusCode[contains(text(), '200')]" description="Status code 200" isTrue="true" type="FIX_VALUE" filtertype="XPath" variable="" />
  </internal.recs>
  <availableInActivities>
    <activity>Referenzen.Customer</activity>
  </availableInActivities>
  <description></description>
  <fields />
</root>

Ausgabe in einem Kiosk-Testfall

Um Referenzen in einem Kiosk-Testfall ausgeben zu können, müssen bestimmte Vorraussetzungen getroffen werden. Im folgenden Abschnitt sind diese beschrieben.

Um einen Wert nach der Ausführung eines Kiosk-Testfalls ausgeben zu können, muss dieser als Ausgabe-Argument im TCE definiert werden. Anschließend kann dieser wie eine Variable verwendet werden. Da Argumente jedoch keinen Standardwert besitzen, ist es nötig die Referenz im Testfall zu definieren. Dies geschieht über die Assign-Aktivität. Dort wird einem Ausgabe-Argument vom Typ SuccestReference der Wert new SuccestReference() zugewiesen.