Referenzen
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.
Inhaltsverzeichnis
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().
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>