Tutorial

Jak připojit knihovnu?

Základní nastavení

Před prvním dotazem na SkautIS musíme nastavit Application_ID jedinečné pro naši aplikaci. Jako druhý argument můžeme uvést jestli aplikace běží v testovacím režimu. Výchozí nastavení je TRUE.

<?php
$skautIS = SkautIS::getInstance("moje-application-id", $isTestMode = TRUE);

nebo

<?php
$skautIS = SkautIS::getInstance();
$skautIS->setAppId("moje-application-id");
$skautIS->setTestMode(FALSE);

nebo

<?php
define("SkautIS_ID_Application", "moje-application-id");
$skautIS = SkautIS::getInstance();

Přihlášení

<?php
echo '<a href="'.$skautIS->getLoginUrl();.'"> Prihlasit se</a>'; //Vypise odkaz pro prihlaseni do SkautISu

Po úspěšném přihlášení jsme přesměrováni na předem nastavenou adresu (viz. nápověda) a pošle nám údaje přes $_POST (ID_Login, ID_Role, ID_Unit). Ty nastavíme knihovně, která si je zapamatuje.

<?php
$skautIS->setToken($_POST['skautIS_Token']);
$skautIS->setRoleId($_POST['skautIS_IDRole']);
$skautIS->setUnitId($_POST['skautIS_IDUnit']);

Získání dat ze SkautISu

<?php
$data = $skautIS->nazev_webove_sluzby->nazev_funkce(array("nazev_atributu"=>"hodnota_atributu", ...));

Pro přístup k webové službě SkautISu můžeme použít její plný název nebo alias.

Již předdefinované aliasy:

• usr => user => UserManagement
• org => OrganizationUnit
• app => ApplicationManagement
• event => events => Events

Argumenty zadáváme v asociativním poli "nazev_atributu"=>"hodnota_atributu". Pokud je atribut ID_Login nastaven, je automaticky přidán ke všem požadavkům.

<?php
$data = $skautIS->user->UserDetail(array("ID"=>1940)); //1940 je ID uzivatele okres blansko

Návratové hodnoty

Data se vrací jako object třídy stdClass nebo jako pole, pokud třída vrací $nazevTridy.Output. (např. RoleAllOutput)