AppManager Content SDK: Starter Content Apps - akumina/AkuminaTraining GitHub Wiki

Applies to

Akumina Foundation 3.3.0.0 and later

Starter Content Apps

Simple Content App

The Simple Content App is a very basic 1-Controller, 1-View ‘Hello World’ style app that shows you the basics for creating your first Content App. image 5

image 6

Standard Content App

The Standard Content App is most likely the default use for many of your Content Apps. It provides Listing, Editing, Adding and Updating List Items. It allows you to completely change the UI around editing a List / List Item.

image 7

image 8

Adding You Content App to Interchange

Content App Packaging

Namespace of class inheriting from IContentApp should match your Controllers. Build the solution. A Zip file will be created from the build. This is will be uploaded to AppManager to integrate your Content App.

image 13

Uploading Your Content App Package

  1. Log into AppManager
  2. Click on Admin Tab
  3. Choose Content App Type Registration
  4. Click on Upload new Content App package
  5. Browse to your zip file created in the Content App Packaging step above and click Upload
  6. Please be aware uploading a content app package will recycle the app pool
  7. Verify the progress output below the Upload button to validate your Content App was recognized and that the Area files get extracted properly
  8. If you have server access, verify your Area folder shows up under webroot\Areas
  9. Verify that your DLL has been extracted into webroot\target directory

image 9

image 10

image 11

Extraction Details

Temp path configuration

In the file interchange.settings.config Default Value: C:\temp

<add key="akumina:tempuploadpath " value="C:\adifferentpathhere " />

Directories affected during Extraction

  1. Temp path directory (C:\temp)
  2. Webroot\Areas
  3. Webroot\target
  4. Webroot\target\temp (this is the shadow directory for \target, files will get deleted and re-copied here during app startup)

Enabling/Disabling your Content App

  1. Log into Interchange
  2. Click on Admin Tab
  3. Choose Content App Type Registration
  4. You should see your new Content App Type in the list with a checkbox next to it
  5. Simply check the box to enable the app and click on Save or Save & Exit

image 12

Main Components of Content App SDK

See the following for an overview of the Content App SDK.