Follow

Your own Apps

Wally allows you to integrate your own application. This means that we provide you with the option to add the app you have built yourself. If you have interest in connecting your own app, please contact WallyLabs Support

Please note that this is not an option to integrate any app available online. If you use an app and want it to be integrated with Wally, please contact us with this feature request. We will take your request into consideration and notify you about our decision.

Please follow the steps below to add your own app to Wally:

Add your own app to Wally

Connect

First you have to create a connection for your app.

Step 1

To go to your connections, click on Connections on the top right corner of your webpage.

Step 2

Click on the “Add new Connection” button to add a new connection.

Step 3

Click on the Custom App “Connect” button.

Step 4

  1. Fill in the title of your connection.
  2. Fill in your meta-data endpoint. This endpoint should return your data endpoints.*
  3. Fill in your username. (This is used to grant Wally access to your app and is optional.)**
  4. Fill in your password. (This is used to grant Wally access to your app and is optional.)**
  5. Click on connect.

* Expected xml example:
<CustomAppDescription>
   <Options>
       <Title>[Name of endpoint1]</Title>
       <Url>[Endpoint1 url]</Url>
   </Options>
   <Options>
       <Title>[Name of endpoint2]</Title>
       <Url>[Endpoint2 url]</Url>
   </Options>
</CustomAppDescription>

**Authorization is done using basic authorization with your username and token colon separated and Base64 encoded.

Step 5

Now you will go back to “Manage Connections”. Here you can see the connection you have just made.

By clicking “Close Window” you can go back to you preview screen.

Create block

Step 1

When you made a connection, you are ready to create a block. Click on “Edit Content”.

Step 2

Now you see a grid of block spaces. You can start creating a block by clicking on the “plus sign”.

Step 3

Here you will see a list of apps. Click on the “Custom App” to create a block for your app.

Step 4

  1. Select the connection that you want to use
  2. Add your custom app.

Step 5

  1. Select the name of the endpoint you want to receive data from.
  2. You are able to customize your block colors by clicking on the “Customize” tab.
  3. Create the block.

Customize

  1. Open a color palette popup*
  2. Reset to default color values.
  3. Create the block

*The color palette popup

Drag the dot to choose the color you want or put in a hexadecimal color code in the textbox.

Step 6

When you have created your block, you will go back to the “Edit Content” page.

  1. Edit your block data.
  2. Remove your block
  3. Resize your block
  4. You are also able to drag your block. This can be done by selecting and moving your block.

Click on “Preview” to see a preview of your app.

Preview

 

 

Technical documentation

Authorization and Security

Wally sends the username and password in the authorization header in each requests using Basic access.

E.G. authorization: Basic username:password where “username:password” is encoded with Base64

Format

Wally can only understand XML in the response.

Meta-data url

When creating a connection with your app, you will need to fill in the Meta-data endpoint. This endpoint should return a “CustomAppDescription” object. Example url: http://www.startwally.com/CustomAppInfo/ConnectionMetaData

CustomAppDescription

Field

Description

Object

Options

A list of Options

Options

 

Options

Field

Description

Object

Title

The name of the endpoint

string

Url

The url to a block type option

string

E.g.
<CustomAppDescription>
   <Options>
       <Title>Name1</Title>
       <Url>Endpoint1 url</Url>
   </Options>
   <Options>
       <Title>Name2</Title>
       <Url>Endpoint2 url</Url>
   </Options>
</CustomAppDescription>

Block types

Wally is able to display data in the following block types.

  • List (List/Slideshow)
  • Summary
  • Headlines
  • ChartDonut
  • ChartLine
  • ChartBar

List (List/SLideshow)

ListView

 

Field

Description

Object

App

The app name

string

ListItems

An array of ListItems

ListItems[]

Display

Display as

  • list
  • one_item*

string

ShowSlideShowText

Show text on slideshow blocks.

Boolean

*If display is one_item, only the App, PictureExtraUrl and DateTime are displayed.
ListItems

Field

Description

Object

Subtitle

Title

string

DateTime

DateTime

string

Description

Description

string

PictureUrl

Profile picture

string

PictureExtraUrl

Image

string

 

Xml

<ListView>
   <App>App name</App>
   <ListItems>
       <Subtitle>subtitle1</Subtitle>
       <Title>title1</Title>
       <DateTime>date1</DateTime>
       <Description>description1</Description>
       <PictureUrl>http://www.startwally.com/Content/images/logos/logoSocialwally_165x32.jpg</PictureUrl>
       <PictureExtraUrl>http://www.startwally.com/Content/images/logos/logoSocialwally_165x32.jpg</PictureExtraUrl>
   </ListItems>
   <ListItems>
       <Subtitle>subtitle2</Subtitle>
       <Title>title2</Title>
       <DateTime>date2</DateTime>
       <Description>description2</Description>
       <PictureUrl>http://www.startwally.com/Content/images/logos/logoSocialwally_165x32.jpg</PictureUrl>
       <PictureExtraUrl>http://www.startwally.com/Content/images/logos/logoSocialwally_165x32.jpg</PictureExtraUrl>
   </ListItems>
   <Display>list</Display>
   <ShowSlideShowText>true</ShowSlideShowText>
</ListView>

Summary

SummaryView

Field

Description

Object

Title

Block title

string

App

App name

string

Picture

Link to the app picture

string

Label1

Label of the first value

string

Label2

Label of the second value

string

Label3

Label of the third value

string

Label4

Label of the fourth value

string

Label5

Label of the fifth value

string

Value1

First value

string

Value2

Second value

string

Value3

Third value

string

Value4

Fourth value

string

Value5

Fifth value

string

 

Xml

<SummaryView>
    <Title>Block title</Title>
       <App>App name</App>
<Picture>http://www.startwally.com/Content/images/logos/logoSocialwally_165x32.jpg</Picture>
<Label1>Label1</Label1>
<Label2>Label2</Label2>
<Label3>Label3</Label3>
<Label4>Label4</Label4>
<Label5>Label5</Label5>
<Value1>Value1</Value1>
<Value2>Value2</Value2>
<Value3>Value3</Value3>
<Value4>Value4</Value4>
<Value5>Value5</Value5>
</SummaryView>

Headlines

HeadlinesView

Field

Description

Object

Title

Block title

string

App

App name

string

Picture

Link to the app picture

string

Label1

Label of the first value

string

Label2

Label of the second value

string

Label3

Label of the third value

string

Value1

First value

string

Value2

Second value

string

Value3

Third value

string

 

Xml

<HeadlinesView>
   <Title>Block title</Title>
<App>App name</App>   <Picture>http://www.startwally.com/Content/images/logos/logoSocialwally_165x32.jpg</Picture>
<Label1>Label1</Label1>
<Label2>Label2</Label2>
<Label3>Label3</Label3>
<Value1>Value1</Value1>
<Value2>Value2</Value2>
<Value3>Value3</Value3>
</HeadlinesView>

ChartDonut

ChartDonutView

Field

Description

Object

Title

Block title

string

App

App name

String

Picture

Link to the app picture

string

Units

Unit name

string

Values

Array of items

item

Item

Field

Description

Object

key

Name

string

value*

Value

int

color

Color

string

*The value and percentage of the donut are shown.

Xml

<ChartDonutView>
  <Title>Block title</Title>
    <App>App name</App>
    <Units>Units</Units>
   <Picture>http://www.startwally.com/Content/images/logos/logoSocialwally_165x32.jpg</Picture>
 <Values>
  <item>
    <key>
      <string>Category1</string>
    </key>
        <value>
           <int>20</int>
        </value>
        <color>
          <string>#0ff00f</string>
        </color>
  </item>
  <item>
     <key>
       <string>Category2</string>
     </key>
         <value>
           <int>8</int>
         </value>
            <color>
                <string>#f0ff00</string>
            </color>
   </item>
   <item>
      <key>
         <string>Category3</string>
      </key>
          <value>
              <int>80</int>
          </value>
            <color>
               <string>#0f0ff0</string>
            </color>
   </item>
   <item>
       <key>
          <string>Category4</string>
       </key>
          <value>
             <int>12</int>
</value>
      <color>
          <string>#00f0ff</string>
      </color>
    </item>
 </Values>
</ChartDonutView>

 

ChartLine

ChartLineView

Field

Description

Object

Title

Block title

string

App

App name

string

Picture

Link to the app picture

string

Units

Unit name

string

Categories

Array of Category

Category[]

Series

Array of Series

Series[]

 

Categories

Field

Description

Object

Category

Category name

String

 

Series

Field

Description

Object

Name

Serie name

string

Values

int array

int[]

 

Xml

<ChartLineView>
   <Title>Block title</Title>
     <App>App name</App>
     <Units>Units</Units
 <Picture>http://www.startwally.com/Content/images/logos/logoSocialwally_165x32.jpg</Picture>
  <Categories>
    <Category> Category 1</Category>
    <Category> Category 2</Category>
    <Category> Category 3</Category>
    <Category> Category 4</Category>
  </Categories>
 <Series>
   <Name>Line 1</Name>
      <Values>
        <int>0</int>
        <int>2</int>
        <int>1</int>
        <int>3</int>
      </Values>
 </Series>
 <Series>
    <Name>Line 2</Name>
       <Values>
         <int>3</int>
         <int>1</int>
         <int>2</int>
         <int>0</int>
       </Values>
 </Series>
</ChartLineView> 

ChartBar

ChartBarView

Field

Description

Object

Title

Block title

string

App

App name

string

Picture

Link to the app picture

string

Units

Unit name

string

Values

Array of items

Item[]

Item

 

Field

Description

Object

key

Key name

string

value

Value

int

color

Color

string

 

Xml

<ChartBarView>
   <Title>Block title</Title>
     <App>App name</App>
<Picture>http://www.startwally.com/Content/images/logos/logoSocialwally_165x32.jpg</Picture>
   <Units>Units</Units>
     <Values>
      <item>
        <key>
          <string>Key 1</string>
        </key>
     <value>
        <int>20</int>
     </value>
        <color>
          <string>#0ff00f</string>
        </color>
       </item>
       <item>
            <key>
              <string>Key 2</string>
            </key>
          <value>
               <int>10</int>
          </value>
               <color>
                   <string>#f0ff00</string>
               </color>
        </item>
         <item>
            <key>
                 <string>Key 3</string>
            </key>
          <value>
             <int>80</int>
          </value>
              <color>
                <string>#0f0ff0</string>
              </color>
         </item>
         <item>
            <key>
               <string>Key4</string>
            </key>
              <value>
                <int>5</int>
              </value>
                 <color>
                     <string>#00f0ff</string>
                 </color>
         </item>
      </Values>
</ChartBarView>

 

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk