Update package with installation code and nice readme.

Author: Joachim-Ally-Skyline

ISS Tracker/CatalogInformation/Images/ISSTracker_Deployed.png

@@ -1,3 +1,19 @@
-# ISS Tracker
+# ISS Tracker 
 
-![WIP](./Images/wip.png)
+The ISS Tracker Product Solution allows you to track the real-time position of the International Space Station (ISS) and monitor the number of people currently in space.
+
+![ISS Tracker Deployed](./Images/ISSTracker_Deployed.png)
+
+When deployed to your DMS, this solution automatically installs the [ISS Tracker Connector](https://catalog.dataminer.services/details/91fc2840-9139-41d0-874f-566926f4325a), creates an element running the protocol, and applies a default alarm template and trend template.
+
+## Key Features
+
+- **Live ISS Tracking**  View the real-time position of the ISS on a world map.
+- **Crew Monitoring**  See how many and which astronauts are currently in space.
+- **Automated Deployment**  Installs with predefined alarm and trend templates.
+
+## International Space Station
+
+The ISS is a multinational research station orbiting Earth, hosting astronauts conducting scientific experiments in microgravity. This tracker keeps you updated on its position and crew status.
+
+![ISS](./Images/ISSPicture.png)

ISS Tracker/CatalogInformation/Images/ISSpicture.png

@@ -51,14 +51,33 @@ DATE		VERSION		AUTHOR			COMMENTS
 
 using Skyline.AppInstaller;
 using Skyline.DataMiner.Automation;
+using Skyline.DataMiner.Core.DataMinerSystem.Automation;
+using Skyline.DataMiner.Core.DataMinerSystem.Common;
 using Skyline.DataMiner.Net.AppPackages;
 using System;
+using System.Collections.Generic;
+using System.Diagnostics;
 
 /// <summary>
 /// DataMiner Script Class.
 /// </summary>
 internal class Script
 {
+	private readonly string protocolName = "ISS Tracker";
+	private readonly string protocolVersion = "1.0.0.2";
+
+	private readonly int rootViewId = -1;
+	private readonly string viewLvl1 = "DataMiner Catalog";
+	private readonly string viewLvl2 = "Apps & Solutions";
+	private readonly string viewLvl3 = "ISS Tracker";
+	private readonly string elementName = "ISS Tracker";
+
+	private IDmsView elementView;
+	private IDma dmaAgent;
+
+	private readonly string ipAddress = @"http://api.open-notify.org/";
+	private readonly int port = 80;
+
 	/// <summary>
 	/// The script entry point.
 	/// </summary>
@@ -77,10 +96,121 @@ public void Install(IEngine engine, AppInstallContext context)
 			////string setupContentPath = installer.GetSetupContentDirectory();
 
 			// Custom installation logic can be added here for each individual install package.
+
+			IDms thisDms = engine.GetDms();
+
+			IDms dms = engine.GetDms();
+			dmaAgent = dms.GetAgent(Engine.SLNetRaw.ServerDetails.AgentID);
+
+			if (dmaAgent == null)
+				engine.ExitFail("DMA agent invalid.");
+
+			CreateViewStructure(dmaAgent, engine, dms);
+			CreateElement(dms, engine);
 		}
 		catch (Exception e)
 		{
 			engine.ExitFail($"Exception encountered during installation: {e}");
 		}
 	}
+
+	private void CreateViewStructure(IDma agent, IEngine engine, IDms dms)
+	{
+		IDmsView rootview;
+		try
+		{
+			rootview = agent.Dms.GetView(rootViewId);
+		}
+		catch
+		{
+			throw new Exception("No rootview found");
+		}
+
+		IDmsView dataMinerCatalog = CreateNewView(agent, dms, rootview, viewLvl1, engine);
+		IDmsView appsAndSolutions = CreateNewView(agent, dms, dataMinerCatalog, viewLvl2, engine);
+		IDmsView issTracker = CreateNewView(agent, dms, appsAndSolutions, viewLvl3, engine);
+		elementView = issTracker;
+	}
+
+	private IDmsView CreateNewView(IDma agent, IDms dms, IDmsView rootview, string viewName, IEngine engine)
+	{
+		IDmsView newView;
+		if (!dms.ViewExists(viewName))
+		{
+			int newViewId = agent.Dms.CreateView(new ViewConfiguration(viewName, rootview));
+			if (!Retry(() => dms.ViewExists(newViewId), TimeSpan.FromSeconds(5)))
+			{
+				engine.ExitFail($"View with the name {viewName} is not created.");
+			}
+
+			newView = agent.Dms.GetView(newViewId);
+		}
+		else
+		{
+			newView = agent.Dms.GetView(viewName);
+		}
+
+		return newView;
+	}
+
+	private ElementConfiguration CreateElementConfig(IDms dms, IEngine engine)
+	{
+		var protocol = dms.GetProtocol(protocolName, protocolVersion);
+		var elementConfig = new ElementConfiguration(dms, elementName, protocol, CreateElementConnection());
+
+		try
+		{
+			elementConfig.AlarmTemplate = protocol.GetAlarmTemplate("Alarm_Default");
+			elementConfig.TrendTemplate = protocol.GetTrendTemplate("Template_Default");
+		}
+		catch (TemplateNotFoundException e)
+		{
+			engine.GenerateInformation($"Template not found: {e.Message}");
+		}
+
+		return elementConfig;
+	}
+
+	private List<IElementConnection> CreateElementConnection()
+	{
+		ITcp tcp = new Tcp(ipAddress, port);
+		HttpConnection httpConnection = new HttpConnection(tcp);
+
+		return new List<IElementConnection>
+			{
+				httpConnection,
+			};
+	}
+
+	private void CreateElement(IDms dms, IEngine engine)
+	{
+		if (dms.ElementExists(elementName))
+		{
+			engine.ExitSuccess($"Element with the name {elementName} already exists.");
+		}
+
+		ElementConfiguration configuration = CreateElementConfig(dms, engine);
+		configuration.Views.Add(elementView);
+		dmaAgent.CreateElement(configuration);
+	}
+
+	private bool Retry(Func<bool> func, TimeSpan timeout)
+	{
+		bool success = false;
+
+		Stopwatch sw = new Stopwatch();
+		sw.Start();
+
+		do
+		{
+			success = func();
+			if (!success)
+			{
+				System.Threading.Thread.Sleep(250);
+			}
+		}
+		while (!success && sw.Elapsed <= timeout);
+
+		return success;
+	}
 }

ISS Tracker/CatalogInformation/Images/wip.png

@@ -16,6 +16,7 @@
 	</PropertyGroup>
 	<ItemGroup>
 		<PackageReference Include="Skyline.DataMiner.Core.AppPackageInstaller" Version="2.1.1" />
+		<PackageReference Include="Skyline.DataMiner.Core.DataMinerSystem.Automation" Version="1.1.2.2" />
 		<PackageReference Include="Skyline.DataMiner.Dev.Automation" Version="10.5.3" />
 		<PackageReference Include="Skyline.DataMiner.Utils.SecureCoding.Analyzers" Version="1.2.5">
 			<PrivateAssets>all</PrivateAssets>