Beim Bearbeiten von Everystep-Skripten können Sie einen benutzerdefinierten C#-Code hinzufügen. Weitere Informationen zur EveryStep-Skriptanpassung finden Sie unter EveryStep Scripting Tool Object Model: Klassen, Methoden, Eigenschaften usw .

Skripts, die mit benutzerdefiniertem C#-Code bearbeitet wurden, müssen vor dem Speichern von unserem technischen Supportteam genehmigt werden. Jedes Mal, wenn Sie einen benutzerdefinierten C#-Code hinzufügen oder ein Skript bearbeiten, das benutzerdefinierten C#-Code enthält, wird das Skript automatisch zur Genehmigung gesendet. Beachten Sie, dass es einige Zeit dauern kann, bis unser Team das Skript überprüft und für die Verwendung freigegeben hat.

Im Folgenden finden Sie einige Beispiele für das Hinzufügen von C# zu einem Skript, um bedingte Anweisungen und zufällig definierte Variablen zu verwenden:

Abbrechen der Skriptausführung bei einem Inhaltsvalidierungsfehler
Bedingte Pop-up-Verwaltung
Bedingte Aktionen: Hinzufügen des Artikels in den Warenkorb oder zur Warteliste, wenn er nicht vorrätig ist
E-Mail-Randomisierung für Registrierungsprozesse
Eintritt in das Alter zwischen 18 und 12 Jahren
Wahl nach dem Zufallsprinzip männliches oder weibliches Geschlecht
Auswählen eines zufälligen Artikels aus einem Online-Produktkatalog
Erkennung der Videowiedergabe

Beispiele für bedingte Anweisungen

Abbrechen der Skriptausführung bei einem Inhaltsvalidierungsfehler

Step (1, "test - https://www.test.com");
tab0 = Tabs.NewTab ();
tab0.GoTo ("https://www.test.com");
if ( !tab0.Text.Contains("<KEYWORD>"))
{
return;
}

Um beispielsweise das Skript abzubrechen, wenn das Schlüsselwort “Login”nicht gefunden wird, fügen Sie hinzu:

if (!tab0.Text.Contains("Login"))

Schließen von bedingten Pop-ups, falls angezeigt

Die Bedingungen für die Skriptwiedergabe können je nach geografischer Region, Zeit usw. variieren. So können einige Inhalte, wie z. B. Pop-ups, basierend auf Bedingungen angezeigt werden, während wir das Skript erneut abspielen. Wenn Sie angeben möchten, wie Sie den bedingten Inhalt auf Ihrer Zielwebsite verwalten möchten, fügen Sie die if-Anweisung zu Ihrem EveryStep-Skript hinzu.

So schließen Sie z. B. ein Pop-up, wenn es während einer Skriptwiedergabe auf der Seite angezeigt wird, und navigieren Sie zu einer neuen Seite

Zeichnen Sie das Skript mit dem auf der Seite angezeigten Popup auf.
Alternativ: Wenn Sie Xpath haben, um die Schaltfläche “Schließen” auf der Zielseite zu finden, können Sie das Skript ohne das Popup aufzeichnen.
Fügen Sie die if-Anweisung für den Schritt hinzu, in dem das Popup angezeigt werden soll. Verwenden Sie die Schaltfläche “Schließen” Xpath, um die Bedingung anzugeben.

Beachten Sie, dass wir die WaitForElement-Methode im Testausdruck “if” verwenden, um auf das Laden des Popups zu warten:

tab0.WaitForElement (TimeSpan timeout, string xpath)

// script_version=3.0; everystep_version=0; date=4/8/2022; Chrome=91.0.4472.77
NetworkFilter.Deny ("https://www.adidas.com/api/chk/customer/baskets?sitePath=us");
Tabs.SetSize (1820, 513);
DMBrowser tab0 = null;
Step (1, "adidas Official Website | adidas US - https://www.adidas.com/us/kids");
tab0 = Tabs.NewTab ();
tab0.GoTo ("https://www.adidas.com/");
tab0.Link ("//A[normalize-space(text())=\"KIDS\"]", "//A[normalize-space()=\"3 STRIPE LIFE\"]/../preceding-sibling::DIV[2]//A[normalize-space()=\"KIDS\"]", "//A[normalize-space()=\"Give Back\"]/../preceding-sibling::DIV[3]//A[normalize-space()=\"KIDS\"]").Click ();
Step (2, "Kids Shoes and Clothing | adidas US - https://www.adidas.com/us/kids");
//Waits for pop-up window with the "Close" button to appear on the page for 5 seconds. 
if (tab0.WaitForElement("5sec".ToDuration (), "//*[@ID=\"modal-root\"]/DIV/DIV/BUTTON", "//BUTTON[@ARIA-LABEL=\"Close\"]"))
{
//If the "Close" button detected, clicks the button to close the pop-up. Otherwise, jumps to the next line.
 tab0.Button ("//*[@ID=\"modal-root\"]/DIV/DIV/BUTTON", "//BUTTON[@ARIA-LABEL=\"Close\"]").Click ();
}
tab0.Span ("//A[normalize-space(@TITLE)=\"SHOP NOW\"]//SPAN[normalize-space()=\"SHOP NOW\"]", "//A[normalize-space(@TITLE)=\"SHOP NOW\"]//SPAN[normalize-space(text())=\"SHOP NOW\"]", "(//SPAN[normalize-space(text())=\"SHOP NOW\"])[1]").Click ();
Step (3, "Kids - Ultraboost 22 | adidas US - https://www.adidas.com/us/kids-ultraboost_22");

Den Artikel in den Warenkorb oder auf die Warteliste legen, wenn der Artikel nicht verfügbar ist

Wenn… else-Anweisung ermöglicht es Ihrem Skript, bestimmte Aktionen wie Schaltflächenklicks, Checkbox-Prüfungen, Navigation zu einer anderen URL usw. auszuführen. basierend auf der angegebenen Bedingung. Sie können z. B. eine Transaktion “In den Warenkorb legen” aufzeichnen und möchten, dass das Skript entweder einen Artikel in den Warenkorb oder, wenn er nicht vorrätig ist, zu einer Warteliste hinzufügt. Sie können dies tun, indem Sie ein if… else-Anweisung:

Erfassen Sie die Warenkorbtransaktion.
Um den Testausdruck anzugeben, wählen Sie das Element aus, das angibt, dass der Artikel auf Lager ist, z. B. die Schaltfläche “Jetzt kaufen”.
Geben Sie die “if”-Anweisung an, nachdem Sie mit tab0 zur Elementseite navigiert haben. WaitForElement (TimeSpan-Zeitüberschreitung, Zeichenfolge xpath) mit der Schaltfläche “Jetzt kaufen” Xpath.
Geben Sie die Aktion an, die ausgeführt werden soll, wenn das Element als “if”-Anweisung verfügbar ist. Zum Beispiel der Klick auf “Jetzt kaufen”.
Geben Sie die Aktion, die ausgeführt werden soll, wenn der Artikel nicht vorrätig ist (keine Schaltfläche “Jetzt kaufen” erkannt), als “else”-Anweisung an. Klicken Sie z. B. auf “Zur Liste hinzufügen”.

Tipps

Um alternative Flow-Aktionen anzugeben, zeichnen Sie die Aktionen zusätzlich zum Standard-Flow innerhalb desselben Skripts auf. Verwenden Sie dann die zugehörigen Zeilen in der “else”-Anweisung.

Sehen Sie sich das folgende Beispiel an.

// script_version=3.0; everystep_version=0; date=4/8/2022; Chrome=91.0.4472.77
Tabs.SetSize (1820, 479);
DMBrowser tab0 = null;
Step (1, "International Shopping: Shop Computers that Ship Internationally - https://www.amazon.com/b?node=16225007011");
tab0 = Tabs.NewTab ();
tab0.GoTo ("https://www.amazon.com/b?node=16225007011");
tab0.Image ("//IMG[normalize-space(@ALT)=\"Seagate Portable 2TB External Hard Drive Portable HDD – USB 3.0 for PC, Mac, PlayStation, &amp; Xbox - 1-Year Rescue Service (...\"]", "/HTML/BODY/DIV[1]/DIV[2]/DIV[2]/DIV[1]/DIV[2]/DIV/DIV/DIV[2]/DIV[3]/DIV/DIV/SPAN/A/DIV/IMG").Click ();
Step (2, "Amazon.com: Seagate Portable 2TB External Hard Drive Portable HDD – USB 3.0 for PC, Mac, PlayStation, & Xbox - 1-Year Rescue Service (STGX2000400) : Electronics - https://www.amazon.com/gp/product/handle-buy-box/ref=dp_start-bbf_1_glance");
tab0.Navigating ("https://www.amazon.com/gp/product/handle-buy-box/ref=dp_start-bbf_1_glance");
tab0.Para ("//P[normalize-space()=\"500 GB\"]", "//P[normalize-space(text())=\"500 GB\"]", "//LI[normalize-space(@TITLE)=\"Click to select 500 GB\"]/SPAN/DIV/SPAN/SPAN/SPAN/BUTTON/DIV/DIV[1]/P").Click ();

// Waits for the "Buy Now" button to be loaded on the page for 5 seconds. 
if (tab0.WaitForElement("5sec".ToDuration(), "//INPUT[@ID=\"buy-now-button\"]", "(//SPAN[normalize-space()=\"Buy Now\"])[last()]/..//INPUT[@TYPE=\"submit\"]", "(//SPAN[normalize-space()=\"Buy Now\"])[last()]/..//INPUT"))
{
If the "Buy Now" button detected, clicks the button. Otherwise, the "Buy Now" click is skipped from execution and the "Add to List" click is executed. 
tab0.Button ("//INPUT[@ID=\"buy-now-button\"]", "(//SPAN[normalize-space()=\"Buy Now\"])[last()]/..//INPUT[@TYPE=\"submit\"]", "(//SPAN[normalize-space()=\"Buy Now\"])[last()]/..//INPUT").Click ();
}
//if the "Buy Now" button not detected, finds and clicks "Add to List" button instead.
else
{
  tab0.Link ("//A[normalize-space()=\"Add to List\"]", "//A[normalize-space(text())=\"Add to List\"]", "//A[@NAME=\"submit.add-to-registry.wishlist.unrecognized\"]").Click ();
}
Step (3, "Amazon Sign-In - https://www.amazon.com/ap/signin?openid.return_to=https%3A%2F%2Fwww.amazon.com%2Fgp%2Faw%2Fd%2FB07X3XGG3F&openid.identity=http%3A%2F%2Fspecs.openid.net%2Fauth%2F2.0%2Fidentifier_select&openid.assoc_handle=usflex&openid.mode=checkid_setup&openid.claimed_id=http%3A%2F%2Fspecs.openid.net%2Fauth%2F2.0%2Fidentifier_select&openid.ns=http%3A%2F%2Fspecs.openid.net%2Fauth%2F2.0&");
tab0.Navigating ("https://www.amazon.com/ap/signin?openid.return_to=https%3A%2F%2Fwww.amazon.com%2Fgp%2Faw%2Fd%2FB07X3XGG3F&openid.identity=http%3A%2F%2Fspecs.openid.net%2Fauth%2F2.0%2Fidentifier_select&openid.assoc_handle=usflex&openid.mode=checkid_setup&openid.claimed_id=http%3A%2F%2Fspecs.openid.net%2Fauth%2F2.0%2Fidentifier_select&openid.ns=http%3A%2F%2Fspecs.openid.net%2Fauth%2F2.0&");

Randomisierung der Daten

E-Mail-Randomisierung für Registrierungsprozesse

Um zufällig generierte E-Mails im Registrierungsprozess zu verwenden, können Sie eine neue Variable mit dem zufällig generierten Wert ähnlich dem folgenden deklarieren:

string mail = ("test" + Guid.NewGuid().ToString("N") + "@gmail.com");

Verwenden Sie die Variable wie unten gezeigt als TypeText-Methodenparameter für das E-Mail-Feld:

tab0.TextField ("//INPUT[@TYPE=\"text\"]", "//INPUT[@ID=\"Contact_Email_Addr\"]", "//INPUT).TypeText (mail.ToString ());

// script_version=3.0; everystep_version=4.0.8108.2121; date=4/8/2022; Chrome=91.0.4472.77
Tabs.SetSize (1768, 816);
DMBrowser tab0 = null;
//Declares the mail variable.
string mail = ("test+" + Guid.NewGuid().ToString("N") + "@gmail.com");
Step (1, "Dotcom-Monitor: Website Monitoring and Performance Testing - https://www.dotcom-monitor.com/");
tab0 = Tabs.NewTab ();
tab0.GoTo ("http://dotcom-monitor.com");
Tabs.SetSize (1768, 623);
tab0.Span ("(//SPAN[normalize-space(text())=\"Free Trial\"])[1]", "(//DIV[@ID=\"jivo-iframe-container\"]/preceding-sibling::DIV[3]//SPAN[normalize-space(text())=\"Free Trial\"])[1]", "(//IFRAME[normalize-space(@TITLE)=\"Jivochat\"]/../preceding-sibling::DIV[3]//SPAN[normalize-space(text())=\"Free Trial\"])[1]").Click ();
Step (2, "Free Trial Sign Up - https://userauth.dotcom-monitor.com/Account/FreeTrialSignUp");
tab0.Navigating ("https://userauth.dotcom-monitor.com/Account/FreeTrialSignUp");
tab0.TextField ("//INPUT[@TYPE=\"text\"]", "//INPUT[@ID=\"Contact_Email_Addr\"]", "//INPUT").Click ();
//Sets the email value to the randomly generated value of the mail variable.
tab0.TextField ("//INPUT[@TYPE=\"text\"]", "//INPUT[@ID=\"Contact_Email_Addr\"]", "//INPUT").TypeText (mail.ToString ());
tab0.Button ("//BUTTON[normalize-space()=\"Start Free Trial\"]", "//BUTTON[normalize-space(text())=\"Start Free Trial\"]", "//BUTTON[@TYPE=\"button\"]").Click ();

Eintritt in das Alter zwischen 18 und 12 Jahren

// script_version=3.0; everystep_version=4.0.5953.25078; date=4/19/2016; IE=11.0.9600.17126
Tabs.ConfigureIEVersion (BrowserMode.IE11, DocumentMode.IE11Emulate);
Tabs.SetSize (1768, 651);
DMBrowser tab0 = null;
Step (1, "The input element - HTML5 tutorial - http://www.html-5-tutorial.com/input-element.php");
tab0 = Tabs.NewTab ();
tab0.GoTo ("http://www.html-5-tutorial.com/input-element.php");

// produces random number in range from 18 to 120
int r = (new Random(DateTime.Now.Second)).Next(18, 121);

tab0.TextField ("//INPUT[@TYPE=\"number\"]", "//INPUT[@NAME=\"age\"]", "//B[normalize-space()=\"Age:\"]/..//INPUT").TypeText (r.ToString());

Wahl nach dem Zufallsprinzip männliches oder weibliches Geschlecht

// script_version=3.0; everystep_version=4.0.5953.25078; date=4/19/2016; IE=11.0.9600.17126

Tabs.ConfigureIEVersion (BrowserMode.IE11, DocumentMode.IE11Emulate);
Tabs.SetSize (1768, 714);
DMBrowser tab0 = null;
Step (1, "visible - http://www.w3schools.com/html/tryit.asp?filename=tryhtml_form_radio");
tab0 = Tabs.NewTab ();
tab0.GoTo ("http://www.w3schools.com/html/tryit.asp?filename=tryhtml_form_radio");
for (int i = 0; i < 5; i++)

// produces random number in range from 0 to 2

int r = (new Random(DateTime.Now.Second)).Next(0, 3);
if (r == 0)
{
tab0.Frame ("//IFRAME[@ID=\"iframeResult\"]", "//IFRAME").RadioButton ("//INPUT[@VALUE=\"female\"]", "//INPUT[@VALUE=\"other\"]/preceding-sibling::INPUT[1]", "//INPUT[@VALUE=\"male\"]/following-sibling::INPUT[1]").Click ();
}
else if (r == 1)
{
tab0.Frame ("//IFRAME[@ID=\"iframeResult\"]", "//IFRAME").RadioButton ("//INPUT[@VALUE=\"other\"]", "//INPUT[@VALUE=\"female\"]/following-sibling::INPUT[1]", "//INPUT[@VALUE=\"male\"]/following-sibling::INPUT[2]").Click ();
}
else if (r == 2)
{
tab0.Frame ("//IFRAME[@ID=\"iframeResult\"]", "//IFRAME").RadioButton ("//INPUT[@VALUE=\"male\"]", "(//INPUT[@TYPE=\"radio\"])[1]", "(//INPUT[@NAME=\"gender\"])[1]").Click ();
}
Delay("3sec".ToDuration());
}

Auswählen eines zufälligen Artikels aus einem Online-Produktkatalog

Um ein Skript zu erstellen, das wiederholt zufällige Elemente aus einem Onlinekatalog auswählt, verwenden Sie das unten bereitgestellte Beispiel. Beachten Sie, dass es empfohlen wird, zuerst mehrere Elementklicks aufzuzeichnen, um die spätere Bearbeitung des Ursprungs zu erleichtern.

// script_version=3.0; everystep_version=4.0.8108.2121; date=4/12/2022; Chrome=91.0.4472.77
Tabs.SetSize (1768, 714);
DMBrowser tab0 = null;
Step (1, "Amazon.com: Jewelry Made in Italy: Clothing, Shoes & Jewelry - https://www.amazon.com/b?node=19219863011&pf_rd_r=ZS16WVQN9RD996FPB6TH&pf_rd_p=0b9330ec-285a-4f51-9e1c-6765ca451c5f&pd_rd_r=3b9e3cf5-d247-4f50-8d15-a6683fa46846&pd_rd_w=uNsg8&pd_rd_wg=xFg13&ref_=pd_gw_unk");
tab0 = Tabs.NewTab ();
tab0.GoTo ("https://www.amazon.com/b?node=19219863011&pf_rd_r=ZS16WVQN9RD996FPB6TH&pf_rd_p=0b9330ec-285a-4f51-9e1c-6765ca451c5f&pd_rd_r=3b9e3cf5-d247-4f50-8d15-a6683fa46846&pd_rd_w=uNsg8&pd_rd_wg=xFg13&ref_=pd_gw_unk");

//Collects all images to count the total number of images in the body and saves them to the body's Attribute
tab0.RunScript("(function(){const imgCount=document.querySelectorAll(\".s-image\").length;document.body.setAttribute(\"data-imgCount\", imgCount);})()");
int count = 0;

//Gets the value of the Attribute 
string countString = tab0.Element("//BODY").GetAttributeValue("data-imgCount");

//If countString parsed successfully then clicks a random image on the page. Otherwise, raises an error. 
if (!int.TryParse(countString, out count)) {
  RaiseError(string.Format("Failed to get elements count: {0}", countString));
} else {
  var rnd = new Random();
  int i = rnd.Next(1, count);

//Clicks the picked image  
  tab0.Image (string.Format ("(//IMG[@CLASS=\"s-image\"])[{0}]", i)).Click ();

//Navigates to the item page
Step (2, string.Format ("Amazon.com: Selected Item {0}", i));

//Waits for the navigation to be finished. The Navigating (string url) argument can be set to a random URL since it is being scripted while the source script recording and not interfered with the script execution logic. However, the specified URL will be presented in the report data. Check report data for network requests to find an actual URL that was used in the related script run.
tab0.Navigating ("https://www.amazon.com/KEZEF-Creations-Sterling-Overlay-Necklace/dp/B008Y357US/ref=lp_19219863011_1_1");

//Navigates back to the main page and repeats the cycle. You can populate the following lines as many times as necessary within your script.
Step (3, "Amazon.com: Jewelry Made in Italy: Clothing, Shoes & Jewelry - https://www.amazon.com/b?node=19219863011&pf_rd_r=ZS16WVQN9RD996FPB6TH&pf_rd_p=0b9330ec-285a-4f51-9e1c-6765ca451c5f&pd_rd_r=3b9e3cf5-d247-4f50-8d15-a6683fa46846&pd_rd_w=uNsg8&pd_rd_wg=xFg13&ref_=pd_gw_unk");
tab0.Back ();
  i = rnd.Next(1, count);
  tab0.Image (string.Format ("(//IMG[@CLASS=\"s-image\"])[{0}]", i)).Click ();
Step (4, string.Format ("Amazon.com: Selected Item {0}", i));
tab0.Navigating ("https://www.amazon.com/Saint-MIchael-Archangel-Medal-Patron/dp/B01G3K6M5C/ref=lp_19219863011_1_3");
Step (5, "Amazon.com: Jewelry Made in Italy: Clothing, Shoes & Jewelry - https://www.amazon.com/b?node=19219863011&pf_rd_r=ZS16WVQN9RD996FPB6TH&pf_rd_p=0b9330ec-285a-4f51-9e1c-6765ca451c5f&pd_rd_r=3b9e3cf5-d247-4f50-8d15-a6683fa46846&pd_rd_w=uNsg8&pd_rd_wg=xFg13&ref_=pd_gw_unk");
tab0.Back ();
}

Erkennung der Videowiedergabe

Wenn Ihr Videoplayer mit dem <Video-Tag> implementiert ist (ähnlich wie bei YouTube), können Sie den unten angegebenen Code verwenden, um zu überprüfen, ob die Videowiedergabe auf einer geladenen Seite gestartet wurde. Um sicherzustellen, dass das Skript den Start der Videowiedergabe genau erkennt, fügen Sie direkt nach dem Schritt, der den Videoplayer auf der Seite lädt, eine Verzögerung hinzu, und fügen Sie dann das folgende Codebeispiel hinzu.

tab0.RunScript ("(function(){const video=document.querySelector('video');let count=0;video.addEventListener('progress', (e)=>{count++;document.body.setAttribute('data-video-progress', count);});})()");
Delay ("10sec".ToDuration());
int count = 0;
try
{
    count = int.Parse(tab0.Element("//BODY").GetAttributeValue ("data-video-progress"));
}
catch {}
if (count == 0)
{
    RaiseError("A video playback didn't start.");
}