Fetching Functions

$t→fetch()

Given a URL and post data, the fetch function makes a HTTP request and sets $t->result to be the resulting source code.

By convention we work with a string, $t, applying mADL functions to it. In the fetch function we load the string $t with the page source or structured data (XML or such like) that is to be interpreted.

The fetch may be a request for a web page from which the required information will be “parsed” into variables for display or further use, or may be a call to a web API

which returns structured data (eg. XML) without any formatting information. Regardless of the format of the return data, the correct fetch must be constructed.

Parameters	An array of options including the following.
$url	A String containing the requested URL.
$post	An Array or String containing post data or array.
$headers	An Array or String containing page header type.
$referer	An Array or String containing url or page to re-direct to.
$header_in_output=false	A boolean value that defines if the header is included in the output.
$timeout_second=30	a numeric value for CURLOPT_CONNECTTIMEOUT.
$curlOpts = array()	key-value pair for curl options

Return values#

Used for performing HTTP connections. Fetch is a wrapper for the PHP cURL function. All results from $t->fetch are stored in $t->result.

$t->Fetch() Simple Example

$t->fetch("[http://blinkmobile.com.au/");] \\
return $t->result;

$t->Fetch() With Get Example

$t->fetch("[http://blinkmobile.squarespace.com/display/Search?searchQuery="] . $args[0] . "&moduleId=6598880");
$t->between("", "");  $t->rows(   "|~*<a href=\"{URL}\">~*hit-word-title\">{TITLE}~*search-result-date\">{DATE}~*search-result-body\">{COPY}
|U",   ""  );  if($t->isblank()){   return "Your search returned no results"; }  return $t->result;

$t->Fetch() With Post Example

$_POST=array(
"method"=>'init',
"callCount"=>1,
"c0-scriptName"=>'null',
"c0-methodName"=>'getFilteredImpounds',
"c0-id"=>"1511_1305600140169");

$t->fetch("[http://www.blblinkmobile.com.au",]$_POST);
return $t->result;

$t->Fetch() With Search Parameters Example

 <arg>
 <prefix>Beach:{NL}</prefix>
 <select>
<option value="bilinga">Bilinga</option>
<option value="broadbeach">Broadbeach</option>
<option value="burleigh-heads">Burleigh Heads</option>
<option value="coolangatta">Coolangatta</option>
<option value="currumbin">Currumbin</option>
<option value="kirra">Kirra</option>
<option value="main-beach">Main Beach</option>
<option value="mermaid-beach">Mermaid Beach</option>
<option value="palm-beach">Palm Beach</option>
<option value="rainbow-bay">Rainbow Bay</option>
<option value="runaway-bay">Runaway Bay</option>
<option value="south-stradbroke-island">South Stradbroke Island</option>
<option value="surfers-paradise">Surfers Paradise</option>
<option value="tallebudgera">Tallebudgera</option>
<option value="tugun">Tugun</option>
</select>
</arg>  

 
$t->fetch("[http://www.verygoldcoast.com.au/]$args[0]/");

Multiple fetches within one Interaction

$theProgram=$t->getjourneyobject("theProgram");

echo $theProgram;

$listjo=$t->listJourneyObjects();

$t->row("|{INFO}|U","$theProgram");

$t->rows("|{URLS}|U","{URLS}@@@ZZZ");

$abstracts=explode("@@@ZZZ",$t->result);

$html .= "";

foreach($abstracts as $abstract) {

echo $abstract;

$t->fetch("[http://ccaeducause1.caudit.edu.au/index.php/educause/ccae2011/paper/viewPaper/"] . $abstract); 
$t->after("<body>"); echo "<br>"; 
$t->row("|id=\"title\">{doctitle}~*id=\"author\">{authors}~*<h4>Abstract{description}|U","");

$html .= "" . $t->result;   $t->fetch("[http://ccaeducause1.caudit.edu.au/index.php/educause/ccae2011/rt/bio/"] . $abstract . "/0");  $t->after("<body>");  echo "<br>";  $t->row("|id=\"authorBio\">{authorBio}{authors}|U","");  $html .=  $t->result . "";  echo $t->result;  };   $html = "" . $html . "";  $t->result=$html;  $t->preg_replace("|

$t->refresh( )

This function resets $t->result to be the value of the previous fetch request.

Example

$t->fetch("http://blinkmobile.com.au/"); 
if($t->contains("Logged Successful")){
// do something
}
// read more data from scrap
$t->refresh( );
return $t->result;

Return values#

Returns the last requested source into $t->result

$t->submitForm( )

Often known as a "PassThru"... On occasions when you are retrieving a page source into an Interaction you may require authorisation from a login form.

SubmitForm function can be used to 1. Fetch the form at the requested url. 2. Submit the required parameters 3. Return the results of the fetch for additional formatting.

Parameters
$mystring	A String. The reference to the form name. 0 can be used instead to select the first form found, 1 then next and so on.
$myarray	As Array of values to be passed to the form.

Return values#

Returns requested source into $t->result

Example

$t->fetch("[http://support.blinkmobile.com.au/");] 


 $t->submitForm( 0,
    array(
    'username'=>'YourUserName',
    'passwd'=>'YourPassword'
    )
);
return $t->result;

// Page source returned here for additional processing