Installation and Configuration Steps:
-------------------------------------

WebToolz 4.50 installers must also follow "WebToolz 4.50 - Release and Installation Guide.md".
That document contains the mandatory shared-secret configuration, Web.config
decryption/re-encryption procedure, release checks, and rollback guidance.

1. Import 
	a. "FormToolz Content Type.xml" in the Staff view through RiSE -> Maintenance -> Content Types
	b. "AfdCountryRefList and AfdPre-population example.xml" in the Staff site through RiSE -> Intelligent Query Architect (optional if licensed for AFD)
2. Drop following folders/files into the respective folders
	a. "Flexible Formz" in the folder "%iMIS Installation%\net\iParts\Zengage" e.g. C:\Program Files (x86)\ASI\iMIS\Net\iParts\Zengage
	b. "Zengage.FlexibleFormz.dll" and all other dlls in the folder "%iMIS Installation%\net\bin" e.g. C:\Program Files (x86)\ASI\iMIS\Net\bin	
	d. "Zengage.FlexibleFormz.dll" in the folder "%Asi.Scheduler%\bin" e.g. C:\AsiPlatform\Asi.Scheduler_iMIS\bin
	d. "SAML" in the folder "%iMIS Installation%\net" (optional if licensed for SAML)
	e. "Zentso.iMis.Api.dll" in the folder "%iMIS Installation%\net\bin" e.g. C:\Program Files (x86)\ASI\iMIS\Net\bin (optional if licensed for Plus)	
3. Go to the licence screen to enter your details (once the iPart is added to a content page a WebToolz license button is visible).
4. Replace following binding in the web.config file in iMIS under 
  	<runtime>
    		<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
		...
    		</assemblyBinding>
  	</runtime>

	Version 20.2.26 ... none needed
	Version 20.2.46-49
		<dependentAssembly>
			<assemblyIdentity name="Telerik.Web.UI" publicKeyToken="121fae78165ba3d4" />
			<bindingRedirect oldVersion="2012.2.607.40-2014.3.1024.45" newVersion="2014.3.1209.45" />
		</dependentAssembly>
	Version 20.2.63 to Q42025 ... none needed
	Version 20.2.63 Q42025 ... 
		<dependentAssembly>
			<assemblyIdentity name="Telerik.Web.UI" publicKeyToken="121fae78165ba3d4" culture="neutral" />
			<bindingRedirect oldVersion="0.0.0.0-2025.1.416.462" newVersion="2025.1.416.462" />
		</dependentAssembly>
	Version 20.2.63 Q3 2026 ... none needed when the installed iMIS Telerik.Web.UI
	assembly is version 2026.3.812.462. Do not copy the Q4 2025 binding redirect.

5. If licensed for PLUS and also anticipating of using the REST endpoint builder add following to the web.config in the section
    <modules runAllManagedModulesForAllRequests="true">
	...
	<add name="Interceptor" type="Zentso.iMis.Api.Interceptor" />
    </modules>	
   Also following table needs to be created
    CREATE TABLE [dbo].[Zen_Routes](
	[RouteGuid] [uniqueidentifier] NOT NULL,
	[Route] [nvarchar](255) NOT NULL,
	[RouteMapping] [nvarchar](255) NOT NULL
    ) ON [PRIMARY]
   
   This table holds routing information of routes to actual WebToolz iPart pages e.g. 
	RouteGuid				Route		RouteMapping
	0164797F-E5B6-4A36-897D-23BA2022A744	v1/trans	~/zenapi/zendonr/transaction.aspx

6. For better experience when building interfaces you can replace the following section in the web.config to allow HTML tags in various controls.
   However, this can come with security implications hence it is recommended to keep the original settings intact.
 
  <location path="iMIS/ContentManagement/ContentItemEdit.aspx">
    <system.web>
      <authorization>
        <deny users="?" />
        <allow users="*" />
      </authorization>
    </system.web>
  </location>

  with

  <location path="iMIS/ContentManagement/ContentItemEdit.aspx">
    <system.web>
      <authorization>
        <deny users="?" />
        <allow users="*" />
      </authorization>
      <pages validateRequest="false" />
      <httpRuntime requestValidationMode="2.0" />
    </system.web>
  </location>

7. The "SQL scripts" folder holds additional scripts which can be used for building a REST endpoint
8. In case FIPS is enabled add
	<enforceFIPSPolicy enabled="false"/> to
	C:\Windows\Microsoft.NET\Framework64\v4.0.30319\aspnet.config
	before </runtime>

---------------------------------------------------------
| Please direct any questions or support requests to 	|
| Alexander Kopetzky alex@zentso.com			|
---------------------------------------------------------	
