Passa ai contenuti principali

Microsoft Band SDK – Web Tile : Feed RSS

In questo post vorrei prendere in esame come sia possibile creare una Web Tile prendendo i dati da un feed RSS.
Abbiamo visto nel precedente post dedicato alle Web Tile quale è la struttura del file manifest.json, in questo post vedremo come configurare la parte relativa alle risorse e alle pagine per poter visualizzare il contenuto di un feed RSS.
Cominciamo con il prendere un feed RSS: nell’esempio riportato utilizzerò il feed di dotNET{podcast} (così faccio anche pubblicita’ occulta al sito  Smile).
Il feed completo si trova al seguente link.
Prima cosa che andiamo a configurare è la sezione resources e, precisamente:

"resources": [
  {
    "url": "http://www.dotnetpodcast.com/feed/RSS",
    "style": "Feed",
    "content": {
      "title": "title",
      "pubdate": "pubDate",
      "itunesduration": "itunes:duration"
    }
  }
],

Osserviamo che:
  • lo style è Feed il che dice all’infrastruttura delle web tile che stiamo recuperando un feed e che quando apriremo la tile sul Band, avremo un numero di pagine, tutte uguali e fino ad un massimo di 8, che conterranno i dati secondo il layout che sceglieremo nella parte delle pages;
  • l’url del feed è nella proprietà url;
  • l’estrazione dei dati che ci interessano è definita nell’oggetto content ed in particolare definiamo tre variabili “title”, “pubdate” e “itunesduration” (i nomi sono quelli che ci fanno più comodo) che contengono, rispettivamente i campi “title”, “pubDate” e “itunes:duration” del tag <item> contenuto nell’XML del feed;
In questo modo, di fatto costruiamo una sorta di DTO che mappa il contenuto del feed in opportune variabili.
Il secondo step consiste nel definire come vogliamo appaiano i dati al’interno della tile che metteremo nella strip del Band.
Per fare ciò, dovremo agire sulla collezione pages del file di manifest.
In questo caso, poichè stiamo trattando un feed, avremo una pagina sola che verrà ripetuta per ogni item presente nel feed (fino ad un massimo di 8).

"pages": [
  {
    "layout": "MSBand_NoScrollingText",
    "condition": "true",
    "textBindings": [
      {
        "elementId": "1",
        "value": "{{title}}"
      },
      {
        "elementId": "2",
        "value": "{{pubdate}}"
      },
      {
        "elementId": "3",
        "value": "durata: {{itunesduration}}"
      }
    ]
  }
]

In questo caso abbiamo scelto il layout MSBand_NoScrolingText impostando opportunamente la proprietà layout.
SNAGHTML407c5aa
La proprietà condition in questa versione delle Web Tile deve essere posta obbligatoriamente a true.
L’oggetto textBindings, infine, contiene l’associazione tra i controlli presenti nel layout e le variabili definite nella sezione resources.
Nel nostro caso specifico abbiamo:
  • nell’elementid 1 (quello che nell’immagine del template è Header)mettiamo il contenuto della variabile title;
  • nell’elementid 2 (Body lines 1) mettiamo il contenuto della variabile pubdate;
  • nell’elementid 3 (Secondary Content) mettiamo la concatenazione tra il testo “durata: “ e il contenuto della variabile itunesduration.
Possiamo osservare che si utilizza la sintassi {{nomevariabile}} per definire il binding.
E’ possibile combinare, in uno degli elementi del layout, più variabili o anche concatenare stringhe e variabili.
Infine, per personalizzare ulteriormente la visualizzazione del feed, possiamo cambiare il tema utilizzato all’interno della tile utilizzando l’oggetto JSON tileTheme:

  "tileTheme": {
      "base": "ffaf00",
      "highlight": "ffaf00",
      "lowlight": "f99a03",
      "secondary": "9e9678",
      "highContrast": "ffa500",
      "muted": "bc8b00"
},

La seguente figura mostra il significato delle singole proprieta’ dell’oggetto tileTheme:

image

Quello che otteniamo, una volta installata la Web Tile attraverso l’applicazione Microsoft Health, e’ mostrato nella seguente figura:

Pagina-del-feed

Il file manifest completo e’ il seguente:

{
    "manifestVersion" : 1,
    "name" : "dotNET{podcast}",
    "description" : "Il feed di dotNET{podcast}, il primo podcast italiano su tecnologie Microsoft.",
    "version" : 1,
    "versionString" : "1.0",
    "author" : "Massimo Bonanni",
    "contactEmail" : "massimo.bonanni@dotnetpodcast.com",
    "organization" : "dotNET{podcast}",
    "tileIcon" : {
        "46" : "icons/largeicon.png"
    },
    "badgeIcon" : {
        "24" : "icons/smallIcon.png"
    },
    "refreshIntervalMinutes" : 15,
    "tileTheme": {
        "base": "ffaf00",
        "highlight": "ffaf00",
        "lowlight": "f99a03",
        "secondary": "9e9678",
        "highContrast": "ffa500",
        "muted": "bc8b00"
  },
  "resources": [
    {
      "url": "http://www.dotnetpodcast.com/feed/RSS",
      "style": "Feed",
      "content": {
        "title": "title",
        "pubdate": "pubDate",
        "itunesduration": "itunes:duration"
      }
    }
  ],
  "pages": [
    {
      "layout": "MSBand_NoScrollingText",
      "condition": "true",
      "textBindings": [
        {
          "elementId": "1",
          "value": "{{title}}"
        },
        {
          "elementId": "2",
          "value": "{{pubdate}}"
        },
        {
          "elementId": "3",
          "value": "durata: {{itunesduration}}"
        }
      ]
    }
  ]
}

Nel prossimo post vedremo come creare una tile che mostri delle pagine i cui contenuti sono recuperati da un nostro servizio REST custom.

Rimanete connessi!!!

Commenti

Post popolari in questo blog

VB.NET : Aggregare stringhe con LINQ

Tip facile facile, ma a qualcuno potrebbe servire. Supponiamo di avere una lista di stringhe (magari come risultato di una query LINQ) e di voler ottenere una stringa con la concatenazione delle stesse: Dim list = CreateList() Dim concatStr = (From s In list _ Select s).Aggregate( Function (currentString, nextString) currentString + nextString) MessageBox.Show(concatStr) Il metodo CreateList non ci interessa, in questo momento, ma crea una lista di oggetti String. Protected Function CreateList() As IEnumerable( Of String ) Dim list As String () = {" stringa1 ", " stringa2 ", " stringa3 ", " stringa4 ", " stringa5 "} Return list.AsEnumerable() End Function Questo metodo potrebbe restituire una qualsiasi lista di oggetti di cui, nella select successiva recuperiamo solo stringhe. La stessa tecnica è utilizzabile per concatenare stringhe inserendovi un carattere separatore Dim list = CreateList() Dim

VB.NET: SplashScreen con effetto fade-in

In questo post vorrei proporvi un modo per realizzare una splash screen per le nostre applicazioni Windows Form che appare progressivamente con un effetto fade. Supponiamo di avere il nostro progetto VB.NET in una soluzione Visual Studio 2008 in cui abbiamo il sorgente della nostra applicazione Windows Form. Inseriamo una splash screen utilizzando il menù Progetto->Aggiungi Nuovo Elemento e selezionando il tipo di elemento “Schermata Iniziale” A questo punto Visual Studio creerà, automaticamente, la schermata iniziale che possiamo personalizzare graficamente come vogliamo. Per poter fare in modo che questa finestra appaia nel momento in cui avviamo l’applicazione, è necessario aprire le proprietà del progetto e impostare la maschera di avvio: In questo modo, all’avvio dell’applicazione, la schermata appare immediatamente e scompare un attimo prima della visualizzazione della finestra dell’applicazione. Possiamo far apparire la schermata iniziale con un ef

VB.NET: Convertire un file DOC in RTF e PDF con office interop

In questo post vorrei proporvi del codice per poter convertire un file .doc in un file .rtf oppure .pdf utilizzando le API di interoperabilità di Office. Creeremo una classe, DocConverter, che esporrà le due funzionalità sopra citate. Cominciamo con il prevedere un attributo privato della classe che rappresenterà l’applicazione Word che utilizzeremo per la conversione. Creeremo l’istanza dell’attributo privato all’interno del costruttore della classe: Public Sub New () If Not CreateWordApp() Then Throw New ApplicationException(" Assembly di interoperabilità con Office non trovato! ") End If End Sub Private _wordApp As Word.ApplicationClass Protected Function CreateWordApp() As Boolean Dim retval = True Try _wordApp = New Word.ApplicationClass() _wordApp.Visible = False Catch ex As System.Exception _wordApp = Nothing retval = False End Try Return retval End Function La conve