We’ve tried to make installing app-stitch as easy as A-B-C, but if you’d run into trouble during the installation process or if anything is unclear, remember we’re here to help!

A: installing app-stitch

Using the package manager console

If you are familiar with Nuget, open the console, make sure you target your server project and:

Image 109

 

Note: installing this package implies you agree to our EULA.

You can now skip to step B.

Using the package manager

If you’re not familiar with Nuget: it is a central repository of .NET packages that contain code, libraries, tools, macros, dependent packages or a combination thereof. Consuming these packages can be done from within Visual Studio, we’ll walk you through all the steps and have plenty of screenshots.

First step is to open the Nuget package manager by right clicking on the server project and clicking on ‘Manage Nuget Packages…’
Image 136
You can either scroll through all 24k+ packages until you find app-stitch (not recommended) or just type app-stitch in the search box and you will find our awesome appstitch.LightSwitch package immediately. Select it and click on the Install button.
Image 137
app-stitch relies on a ton of frameworks and the installation process itself attempts to resolve all these dependencies.

Image 138
After all the dependencies have been resolved you first have to accept the EULAs of these dependencies and of app-stitch itself. Scroll down and on the bottom you will see the EULA for appstitch.LightSwitch. Click on the View License link and after reading, go back to visual studio and click on the ‘I Accept’ button to continue.
Image 140

After this the installation will continue and once finished display this nice green check icon next to the app-stitch nuget package.
Image 141

B: create a place to store your items

app-stitch has now been stitched into your application, however there’s one more step to complete before it will actually work: app-stitch does not have an intrinsic way to store it’s own data, so you’ll have to create a table named AppStitchItem.

Each AppStitchItem contains only six fields:

  • Id, the primary key
  • Owner, a nullable string
  • Data, non-nullable string
  • DataType, non-nullable string
  • TimeStamp, a DateTime
  • Tags, a nullable string

Image 115

The field named ‘Data’, is where app-stitch stores your the content of you rules, amongst other things, in a securely encrypted form. An encrypted rule will often take a lot more than 256 characters, so select the ‘Data’ field in the designer, open your properties window and empty the Maximum Length property.

If you are using an external datasource, you can use this SQL query to create the database for you instead:

CREATE TABLE [dbo].[AppStitchItem] (
    [Id]        INT           NOT NULL IDENTITY,
    [Owner]     VARCHAR (256) NULL,
    [Data]      VARCHAR (MAX) NOT NULL,
    [DataType]  VARCHAR (256) NOT NULL,
    [TimeStamp] DATETIME      NOT NULL,
    [Tags]      VARCHAR (256) NULL,
    CONSTRAINT [PK_AppStitchItem] PRIMARY KEY CLUSTERED ([Id] ASC)
);

Note: if you have issues with the naming conventions used or do not have a data source named ApplicationData, please refer to this article in our Help Center.

 

 C: Play time!

Launch your application (F5) and navigate to {{YourRootURL}/app-stitch.

Ours was found at http://localhost:45929/app-stitch .  Yours will probably be hosted at a different port. If in doubt, check the IIS Express icon in your Windows Taskbar 😉

Image 114

If all went well, app-stitch will launch and includes a 30 day free trial.  You can now start creating your first rule, we hope app-stitch is intuitive enough so you can take it from here but there’s plenty of help available too.

Have fun and please help us spread the word and/or let us know what you think!

Image 112