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", FALSE);

nebo

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

nebo

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'])
        ->setRoleId($post['skautIS_IDRole'])
        ->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
• msg => Message

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)