Estrelica.Core.Demos solution

The Estrelica.Core.Demos solution (available on GitHub) contains several demo applications to show you how to use Estrelica.Core in various scenarios, and get you started building your own applications with it.

The C# code in these demo apps (but not the Estrelica.Core library itself) is released under the MIT license, meaning you are free to reuse the code in whatever way you see fit in order to develop your own Archer integration applications.

The demo apps available in the Estrelica.Core.Demos solution are:

  • Metadata Demo - Demonstrates a variety of ways to interact with Archer metadata

  • Content Demo - Demonstrates a variety of ways to interact with Archer content, including CRUD operations.

  • Section Name Repair - This comprises two projects: One (UsingArcherAPIs.csproj) demonstrating how a simple requirement might be implemented by programming directly against the Archer API, contrasted with another (UsingEstrelicaCore.csproj) showing how much easier and faster it is to do the same thing (with far less resulting code) using Estrelica.Core.

  • Datafeed Explorer - Allows you to view all of your datafeeds, their dependent feeds, their mapping configurations (if extensions are available), their last run status and execution histories. It will also allow you to manually invoke a datafeed's execution.

  • Report Explorer - Similar to the Datafeed Explorer, allowing you to view the reports in your system by Application, including details like the type (Content or Statistics) and XML search options. It will also allow you to execute the report and see its returned results.

  • Workflow Activity Report - This application demonstrates how to evaluate content history (captured by one or more History Log fields in the application) to track Workflow Activity and related content changes that have occurred over time.

Two demo implementations for user management (i.e. asserting that a given user is a member of specific groups) are also provided:

  • CHUM Tool - This is the CastleHill User Management tool, a simplified user management utility which utilizes the standard Archer Contacts application, requiring only the addition of two new fields.

  • User Access Processor - This is a more complex user management utility which requires the installation of a new ODA ("User Access Request"), but includes features for management approval via Advanced Workflow and record-based logging of all activities performed by the processor.

Configuration

All of these demo projects (except for Workflow Activity Report) rely on configuration settings stored in the appSettings.json file found in the solution's Estrelica.Demo.Common project. You'll need to modify this file to enter your own settings (i.e. the Estrelica.Core authorization key provided to you by CastleHill Software and the connection/authentication information for your Archer instance and user account).

Or better still, leave the appSettings.json file unmodified and put all of your settings into a user secrets file. This will ensure that you don't accidentally leak your authentication key and/or Archer credentials if you decide to fork the Estrelica.Core.Demos solution to your own GitHub repo, and that you won't lose any of your configuration settings whenever appSettings.json is overwritten by updates to this solution in our Github repo. CastleHill Software reserves the right to terminate any license authentication keys shared outside the terms of their respective license agreements, including any that are committed to publicly-accessible repositories.

See the article on managing configuration with Estrelica.Core.Configuration for details on the configuration process.