Vytvoření aplikace Cordova za použití služby Služby zjišťování v O365 a rozhraní API pro soubory

Článek
07/08/2015

V tomto tématu se dozvíte, jak využít některé nové rozhraní API v klientské knihovny pro Office 365 v aplikace vytvořené s použitím Visual Studio Tools pro Apache Cordova.

Nástroje Office 365 rozhraní API pro Visual Studio 2013

Pokud se pokoušíte poprvé v pracovním postupu Cordova aplikace spotřebovávat rozhraní API Office 365, postupujte podle pokynů v dokumentace k Instalace nástroje rozhraní API Office 365 pro Visual Studio Preview a chcete-li přidat službu do projektu.

Office 365 poskytuje rozhraní API REST systémem, která umožňují vývojářům pro přístup k prostředkům Office, jako je například kalendář, kontakty, pošty, soubory a další.Můžete programovat přímo proti rozhraní API REST k interakci se službami Office 365, ale pokud používáte rozhraní API REST, je nutné zapsat a udržovat kódu kolem správu tokeny ověřování tvorbu správné adresy URL, dotazování pro rozhraní API chcete přístup a provádění dalších úloh správy.Pomocí služeb Office 365 klientské knihovny pro přístup k rozhraní API Office 365 namísto REST, můžete je zjednodušit kód, který je nutné k zápisu ve své Cordova aplikaci.

Nejnovější aktualizaci pro Office 365 rozhraní API Tools for Visual Studio Preview zahrnuje podporu služby SharePoint souborů, která poskytuje přístup ke službě MyFiles.Kromě služeb SharePoint podporu pro službu O365 zjišťování je poskytována, což usnadňuje nalezení koncových bodů služby SharePoint pro přihlášeného uživatele.Tyto služby lze použít k sestavení Průzkumníka jednoduchý soubor, který vytvoří výčet souborů v Onedrivem pro společnost.

Vývoj aplikací Simple File Explorer pro Onedrivem pro Business

Cílem této aplikace je pro vytvoření výčtu soubory uložené v Onedrivem pro firmu.Zdroj pro ukázku je na GitHub.

Aplikaci Onedrivem Explorer pomocí služeb Office 365

Začínáme

Následující rozhraní a knihovny se používají v této aplikaci.

Bootstrap, pro rozložení a stylu.
AngularJS, pro vytvoření vazby dat s uživatelským rozhraním.
Rozhraní API office 365, pro interakci s Office 365 pro vytvoření výčtu Onedrivem pro firmu.

Služeb v rámci Ukázka aplikace pro získávání soubory z Onedrivem jsou:

O365 zjišťování služeb, najít služby SharePoint koncové body pro přihlášeného uživatele.
Rozhraní API soubory, načíst informace o souboru a složky pro uživatele Onedrive pro podnikání.

Vytváření ověřování a kontexty zjišťování

Před svou aplikaci můžete získat přístup ke službám služeb Office 365, je třeba ověřit aplikaci.Společný rámec souhlasu v Azure AD handles the authentication.

Základní objekty, je nutné před můžete provádět operace s služby O365 jsou objektů kontextu.Ukázka aplikace jsou požadovány následující objekty kontextu:

Kontext ověřování
Kontext zjišťování

Následující kód vytvoří tyto objekty následujícím způsobem:

var authContext = new O365Auth.Context();
var discoveryContext = new O365Discovery.Context();

authContext Objekt umožňuje načtěte požadované ID tokenu a získat přístup k tokeny, které lze použít, chcete-li získat informace o uživateli a k volání určité služby.

discoveryContext Objekt umožňuje načíst možnosti služeb Office 365, jako například pošta nebo kalendář nebo MyFiles, spolu s jejich odpovídající koncové body adresy URL.

Jakmile je třeba zadat ID tokenu, lze použít k identifikaci uživatele.ID tokenu je token webové kódovanou ve formátu base64.Tento token slouží k načtení uživatele, který má aktuálně přihlášeni, takto.

authContext.getIdToken("https://outlook.office365.com/").then(
        (function (token) {
    // Can use token.givenName and token.familyName
}).bind(this), function (reason) {
    console.og(reason.message);
});

Přístupový token je ve formátu base64 token kódovaná adresou URL webu, který lze použít pro přístup k rozhraní API.Zde je, jak lze získat přístupový token, který se používá k volání služby SharePoint.

authContext.getAccessTokenFn('Microsoft.SharePoint')

Použití souborů rozhraní API

Objekt schopností služby SharePoint pro "MyFiles" umožňuje pracovat se soubory a složkami programově.Chcete-li to provést, je nutné nejprve získat kolekci schopností a vyhledejte schopností MyFiles v vrácená kolekce.Chcete-li získat objekt možností, použijte zjišťování služby předáním tokenu přístupu Microsoft.SharePoint takto:

var fileCapability;
discoveryContext.services(authContext.getAccessTokenFn(
    'Microsoft.SharePoint')).then(
    (function (capabilities) {
    // We have the capabilities object. 
    // Enumerate the object to get the capability 
    // for "My Files"
    capabilities.forEach(function (v, i, a) {
        if (v.capability === 'MyFiles') {
            filesCapability = v;
        }
    });
}).bind(this), function (error) {
    // error
});

Nyní, když máte objekt schopností pro MyFiles, můžete vytvořit klientskou aplikaci služby SharePoint a poté zavolá rozhraní API souboru pro práci se soubory uživatele, jako jsou soubory uložené na Onedrivem pro firmu.

Vytvoření objektu klienta služby SharePoint

Chcete-li vytvořit objekt klienta služby SharePoint potřebujeme koncový bod URI informace uložené v objektu schopností a tokenu přístupu pro daný prostředek.

var sharePoint = new 
    Microsoft.CoreServices.SharePointClient (
    filesCapability.endpointUri,
    authContext.getAccessTokenFn(
        filesCapability.resourceId)
);

Načtení soubory a složkami

Nyní můžeme provést výčet souborů voláním getFileSystemItems() takto:

sharePoint.files.getFileSystemItems().fetch().then(
    function (value) {
    value.currentPage.forEach(function (o) {
        // o._type will indicate whether this is a
        // file or folder.
        // o._Id provides the full path.
        // o._name provides the name of the file.
    });
}, function (reason) {
    console.log(reason);
});

V aplikaci Ukázka aplikace načte informace o jednotlivých souborů a ukládá informace do místní objekt JSON.Aplikace sváže uživatelského rozhraní pomocí AngularJS objekt ve formátu JSON.

Zkuste to!

Dokončení aplikace je k dispozici v Github.Stáhněte si prosím a zkuste vzorku a sdělte nám svůj názor.Rádi bychom poslechněte si své názory o nové rozhraní API.

Sdílet prostřednictvím