Agility.config.xml

From Agility
Revision as of 13:49, 4 July 2016 by Marcinz (Talk | contribs)

Jump to: navigation, search


Agility.config.xml It is a main configuration file for Agility.


Databases configuration section

<configuration>
	<databases DefaultDatabase="fastNet" DefaultmaxResults="500" >
		<fastNet 
			ConnectionString="Initial Catalog=Agility7213FNLive;Data Source=SERVERNAME\SQLSERVER2008R2;user id=agilityuser;password=Ag1l1tyuser"
			DatabaseType="MSSQL"
			DatabaseSubType=""
			InitializationString="set transaction isolation level read uncommitted"
			ConnectionInitializationString = ""
			TopPhrase="true" 
			QuoteStartChar=""" 
			QuoteEndChar=""" 
			NationalCharSupport="true"
			ODBCGetSchemaSupport="False"
			controlVersionMode="Version"
			CommandTimeout="180"
			UpdateCommandTimeout="1800"
			/>
		<sxp 
			ConnectionString="Initial Catalog=Agility7213Live;Data Source=SERVERNAME\SQLSERVER2008R2;user id=agilityuser;password=Ag1l1tyuser"
			DatabaseType="MSSQL"
			DatabaseSubType=""
			InitializationString="set transaction isolation level read uncommitted"
			ConnectionInitializationString = "set transaction isolation level read uncommitted"
			TopPhrase="true"
			QuoteStartChar=""" 
			QuoteEndChar=""" 
			NationalCharSupport="true"
			ODBCGetSchemaSupport="False"
			controlVersionMode="Version"
			CommandTimeout="180"
			UpdateCommandTimeout="1800"
		/>
  </databases> 

The databases section details all the databases that are known to the system. They are known by their logical names which is how they are referenced within the Business Objects, against each logical database name are the parameters required in order to provide a connection to the physical database and also to reflect the “dialect” of MSSQL to be used.

PARAMETER NAME VALUE DESCRIPTION
DefaultDatabase fastnet The logical name of the database which contains all the forms etc used by the Fastnet system
DefaultMaxResults “300” The maximum number of records returned in any scan or help form. This default value may be overridden on any scan or help forms.

The format of the connections string will be different dependant upon the database type. However the parameters available are:-

Connection Parameters

PARAMETER NAME VALUES DESCRIPTION
ConnectionString “” The physical connection parameters needed to connect to the database. As the values here are all one parameter they should be enclosed within Double Quotation marks. See examples below.
DatabaseType “MSSQL”, “ODBC”, or “OLEDB” The database type which will be used to determine the driver to be used to access the data.
DatabaseSubType Information to further identify the Database within the above broad categories.
InitialisationString

“” ||The string of characters set to the database immediately after connection. See examples below.

ConnectionInitializationString “” See examples below.
TopPhrase “True” or “False” If the SQL database understands the SELECT “TOP” syntax to restrict the size of a result set, set this parameter to “True”.
QuoteStartChar """ The Character to be used (if any) to prefix table/field names in a query. e.g. SELECT “PMCRAFT”.”CRAFTCODE”. Use of this option avoids “reserved words” used in “data names” Corrupting SQL strings. Not all Databases support this option.
QuoteEndChar "&quot" The Character to be used (if any) to suffix table/field names in a query. e.g. SELECT “PMCRAFT”.”CRAFTCODE”. Use of this option avoids “reserved words” used in “data names” corrupting SQL strings. Not all Databases support this option.
NationalCharSupport “True” or “False” If the database can understand double byte characters set this option to true. Typically if the database supports the NVARCHAR and NCHAR functions this option should be set.
ODBCGetSchemaSupport “False” Only relevant for ODBC databases.

If the database supports the GetSchemaTable function call to provide a list of all fields within a table set this option to “true”. Otherwise the syTableColumns will need to be manually populated. controlVersionMode ||“Version” or “COMSEQ” etc. ||Either the name of the field within every Table of the database which will be used to determine if a record has been changed by another user. Or the following reserved words

CheckAllFields – the system will check each field individually against the copy originally read and its reject the update if any field has changed.
NoCheckFields - No check is made for changes to data before writing back to the database. (Only valid for single user Installations).
LockingControlFieldType The type of the Database field above may be either integer in which case it is incremented with each write or datetime in which case it is date/time stamped with every update.
CommandTimeout Gets or sets the wait time before terminating the attempt to execute a command and generating an error. A value of 0 indicates no limit. This property supported by all database types.
TransactionIsolationLevel “chaos”, “readcommitted”, “readuncommitted”, “repetableread”, “serializable”, “snapshot”, “unspecified” Specifies the transaction isolation level that will be used by data access layer for any transactional data processing. See specific database documentation for details about specific isolation level. ReadCommitted isolation level is used as default if nothing specified.

MSSQL Databases

PARAMETER NAME VALUE DESCRIPTION
ConnectionString =”InitialCatalog=PhysicalName; Data Source=SQLHostName; User id=UserLogin; Password=UserPassword” The physical connection parameters needed to connect to the database. As the values here are all one parameter they should be enclosed within Double Quotation marks.
DatabaseType “MSSQL” The database type which will be used to determine the driver to be used to access the data.
InitialisationString

"set transaction isolation level read uncommitted"

ConnectionInitializationString “”
TopPhrase “True”
QuoteStartChar """
QuoteEndChar "&quot"
NationalCharSupport “True”
ODBCGetSchemaSupport “False”
LockingControlField

For the Fastnet and Agility Databases this will be “VERSION”

LockingControlType For the Fastnet and Agility Database this will be “Integer”

Progress Databases

PARAMETER NAME VALUE DESCRIPTION
ConnectionString "DRIVER={MERANT 3.60 32-BIT Progress SQL92 v9.1D}; DB=PhysicalName; PORT=PortNumber; HOST=ProgressHost; UID=UserLogin; PWD=UserPassword;"
DatabaseType “ODBC”
InitialisationString "set schema ‘pub’"
ConnectionInitializationString “”
TopPhrase “False”
QuoteStartChar """
QuoteEndChar "&quot"
NationalCharSupport “True”
ODBCGetSchemaSupport “True”
controlVersionMode For the IMPACTxp database this will be “COMSEQ”
LockingControlType For the IMPACTxp Database this will be “Integer”


Access Databases via ODBC

PARAMETER NAME VALUE DESCRIPTION
ConnectionString "DRIVER={Driver do Microsoft Access (*.mdb)}; DBQ=C:\database\access\Northwind.mdb; UID=username; PWD=Password”;
DatabaseType “ODBC”
InitialisationString

""

ConnectionInitializationString “” TopPhrase “” QuoteStartChar """ QuoteEndChar "&quot" NationalCharSupport “True” ODBCGetSchemaSupport “True” controlVersionMode LockingControlType


Sections below currently not used

  <!-- Example connection methods -->
	<!--<NOT_USED> 
    <Rapid
			ConnectionString="DRIVER={MERANT 3.60 32-BIT Progress SQL92 v9.1D};UID=sysprogress;DB=rapdpoc;PORT=27000;HOST=bigone;PWD=password;"
			DatabaseType="ODBC"
			ConnectionInitializationString = "set schema 'pub'"
			InitialisationString = ""
			TopPhrase="false"
			QuoteStartChar='"'
			QuoteEndChar='"'
			NationalCharSupport="false"
			ODBCGetSchemaSupport="true"/>
    <fastNet
			ConnectionString="Initial Catalog=DC020305;Data Source=bigone;user id=sa;password=sa"
			DatabaseType="MSSQL"/>
    <impactxp
			ConnectionString="DRIVER={MERANT 3.60 32-BIT Progress SQL92 v9.1D};UID=sysprogress;DB=imp2000;PORT=25010;HOST=bigone;PWD=sysprogress;"
			DatabaseType="ODBC"/>
    <impactxp
			ConnectionString="DRIVER={MERANT 3.60 32-BIT Progress SQL92 v9.1D};UID=sysprogress;DB=imp2000;PORT=20000;HOST=localhost;PWD=sysprogress;"
			DatabaseType="ODBC"
			ConnectionInitializationString = "set schema 'pub'"
			InitialisationString = ""
			TopPhrase="false"
			QuoteStartChar='"'
			QuoteEndChar='"'
			NationalCharSupport="false"
			ODBCGetSchemaSupport="true"/>
    <xpint
			XPIntConnectionString="DRIVER={DataDirect 4.2 32-Bit OpenEdge SQL v10.0A};UID=sysprogress;DB=xpint;PORT=16002;HOST=devserver;PWD=sysprogress;"
			DatabaseType="ODBC"/>
  </NOT_USED> -->       
	<application 
		DebugLevel="0"
		DebugMode="0"
		BLOBbuferSize="50000"
		BusinessObjectNameClass=""
		checkmessages=""
		NewMessageText="New Messages"
		WindowTitle="Agility 7.2"
		DefaultFormState="Enquire"
		ObjectsTimeoutMinutes="50"
		TemporaryLoginOn="true"
		AutoLoginUsingWindowsLogin="false"
		LDAPPath="LDAP://LDAPSERVERNAME/DC=softsol,DC=com"
		ADProfileRule="SUBSTRING(USERINFO('emailaddr'),INDEXOF(USERINFO('emailaddr'),'@')+1,STRLEN(USERINFO('emailaddr'))-(INDEXOF(USERINFO('emailaddr'),'@')+1))"
		ADUserName=""
		ADEncryptedPassword=""
		ADPassword=""
		DefaultThemePath = "AgilityFresh"	
		IsEditableAdminMenu="0"
		GoogleClientID=""
		GoogleApiKey=""
		AllowOnlyUniqueRelations="false"
		ChartDataCachingEnabled="false"
		ChartDataTimeoutMinutes="0"
		DeleteRequestLogOlderThanDays="10"
		ShowRequestLicense="false"
		RequestLoggingEnabled="true"
        FormDefaultsCalculationOrder="RowNum,ColNum,ElementID"
        MobileFormsAutodetection="false"
	>
	<!-- Active Directory Settings -->

If using AD, you can specify server parameters here

 
 <!--  
    <ADIntegration
	LDAPPathFormat = "LDAP://{0}"
	WithFormsAuthentication = "0"
	AuthenticationType = "Secure"
        UseADForGeneralInterface="false" >
    </ADIntegration>	

 -->

Exchange integration section

	<!-- Possible values of version Microsoft Exchange Server:
       	Exchange2013
       	Exchange2010_SP2
	Exchange2010_SP1
	Exchange2010
	Exchange2007_SP1 -->
  	<msexchange
    	  enabled="false"
          server=""
	  username=""
	  password=""
	  domain=""
	  version="">
  	</msexchange>

Default language / Culture / Phrases collect section

	<language
	  TranslateEnabled = "false"
	  CollectNewPhrases = "false"		
	  DefaultLanguageCode="English"
	  DefaultCultureName="en-gb"
	  SetLanguageFromRequest="true"
	  SetCultureInfo="true"
	  SetNumberFormatInfo="false">
	</language>
	<externalbusinessassemblies>
	  <agility name="Agility"/>

	</externalbusinessassemblies>		
	<ObjectNameMappings>
	 <!--
         <RAAMP nameClass = "RAAMP" originalName = "DataBO.ProcessMngt.JobBO" specializedName="Bespoke.RAAMP.JobBO"/>
         -->
	</ObjectNameMappings>

Help url section

  <help
	HelpBaseURL="http://MARCINZ/Agility7213Help" 
	DefaultFormHelp="default.htm" 
	MainMenuHelp="default.htm" 
	LoginHelp="_d2h_ctxt_help.htm?contextID=3002&mode=1">
  </help>

Reporting Services config section

	<!-- reporting settings, for server based reporting set mode="server" and remove "local" -->
	<reports 
	 mode="local"
	 username="rsUSR"
	 pass="rsusr"	
	 domain=""
	 BaseWebServiceURL="http://MARCINZ/ReportServer$SQLSERVER2008R2/reportservice.asmx" 		
	 AuthenticationMethod="windows"
	 ReportDataAccess=""
	 DebugRDLfullname=""
	 EventLogSwitch="ON"
	 TopLevelDirectory="Agility"
	 MainTableView="MainTableView">
	</reports>
	<datasources>
	  <Reports_SXP ConnectionString="Initial Catalog=Agility51Live;Data Source=MARCINZ\SQLSERVER2008R2;user=agilityuser;password=ag1l1tyuser"/>	
	</datasources>

Empty row

	<emptyRowDef
	 text="( NULL )"
	 scantext="(empty)"
	 value="">
	</emptyRowDef>

Event Log configuration

	<eventlog 
	 enabled="1"	
	 machineName="." 
	 logName="FastNet" 
	 sourceName="Agility7213Live" 
	 LogFile="">
	 <information	enabled="0"	withstack="Deny"/>
	 <warning	enabled="0"	withstack="Always"/>
	 <error		enabled="1"	withstack="Always"/>		
	</eventlog>
	<!--			
		<license 		LicenseFilePath=".\license.signed.xml">
		</license>
	-->
	</application>
	<interface>		<!-- Customer specific settings -->
	<!--<procurment
			IsEnabled="False"
			SiteCode="SITECODE"
			WSUrl="http:\\Webservice\goeshere\generalinterface.asmx"
			WSUser=""
			WSPassword=""
			CProUser=""
			CProPassword="admin"
 		/>-->
  <!--<xpint
			XpintImportEnabled="1"
			CPY="train">
   	  </xpint>-->
	<!--<AgilityService
			AgilityWS="http://MARCINZ/AgilityService.asmx"
			LocalAgilityWSUserName="admin"
			LocalAgilityWSUserPass="admin">
		  </AgilityService>-->
    <!--<homehotline
			HomeHotlineWS="http://bigone/HHWS/HHWS.asmx"
			LocalWebServiceClientIP=""
			LocalWebServiceUserName="ACA0101"
			LocalWebServiceUserPass="ACA0101"
			BusinessUserName="hhl"
			BusinessUserPass="">
    </homehotline> -->

	<GeneralWebService
			enabled="true"
			RemoveLogAfterDays="1"
			RemoveAllLogAfterDays="5"
			receiver="false"
			sender="false"
			CompatibleWithVersion="current"
			userName=""
			userPass=""
	/>
	<GeneralImport
			ImportWebServiceEnabled="true"
			DefaultUser=""
			DefaultUserPass=""
			WebServiceLocation="http://MARCINZ/Services/GeneralImport.ashx"
		  	DataChangedByAnotherUserRetryCount="5"
			ADIntegration="false"
	/>
	
  <!-- General Export Configuration -->
	<!--
        GeneralExport:
          QueueProcessEnabled=[true, false]
          HandleExportEvents=[true, false]
          AcceptAllCertifications=[true, false]
          SecurityProtocol=[Auto, Ssl3, Tls]
          
          Warnig! AcceptAllCertifications & SecurityProtocol are static properties for whole application. 
          They will affect any request created in agility.
        
    -->		
	<GeneralExport
		QueueProcessEnabled="true"
		HandleExportEvents="true"
        AcceptAllCertifications="false"
        SecurityProtocol="Auto"
	/>
== Sharepoint integration section ==
    <sharepoint
      enabled="false"
      server=""
      username=""
      password=""
      domain=""
      version="">
    </sharepoint>

  </interface>

Background Config

  <background>
    <EventProcess
	EventsEnabled="true"
	EventsPoolTime="10000"
        EventRetryMinutes="60"
        StatusFlowEnabled="true"
        StatusFlowPoolTime="10000"
	userName="system"
	userPass="system"
        DataChangedByAnotherUserRetryCount="5"
        DisableMainRecordLockOnSave="false"
      >
    </EventProcess>
     <exportimport
        LogMaxSize="3000"
      >
    </exportimport>

General Interface - Import / Export configuration

    <HistoryMaintenance Enabled="True" Interval = "30">
		<StatusFlowLog
		 Enabled = "true"
		 LogMaxSizePerObject = "100"
		 DeleteTopXPerBatch = "1000"
		 DeleteTopXPerLoop = "250"
                 DelayLength = "00:00:00"/>
	
  	        <RequestLog
		 Enabled = "true"
		 OlderThanDays = "1"
		 DeleteTopXPerBatch = "1000"
		 DeleteTopXPerLoop = "250"
                 DelayLength = "00:00:00"/>
				
			<GeneralInterfaceQueue
				Enabled = "true"
				RemoveLogAfterDays = "1"
				RemoveAllLogAfterDays = "5"
				DeleteTopXPerBatch = "1000"
				DeleteTopXPerLoop = "250"
                                DelayLength = "00:00:00"/>
				
			<ImportExportQueue
				Enabled = "true"
				RemoveLogAfterDays = "1"
				RemoveAllLogAfterDays = "5"
				DeleteTopXPerBatch = "1000"
				DeleteTopXPerLoop = "250"
                                DelayLength = "00:00:00"/>
				
			<AuditLog
				Enabled = "false"
				OlderThanDays = "7"
				DeleteTopXPerBatch = "1000"
				DeleteTopXPerLoop = "250"
                                DelayLength = "00:00:00"/>
		</HistoryMaintenance>
  </background>

Smtp server configuration for email notifications

  <mail
	smtpServer="" 
        smtpServerPort="25" 
        smtpUserName=""
        smtpUserPassword="" 
        smtpUseSSL="FALSE" 
        sender="EMAILSENDER"
        alternativeMail="true"
		smtpTimeoutSeconds="30">
  </mail>

Incab section - currently not used

  <!--
	Incab 
	   Mode: [Disabled | Client | Provider ] 
	   
	   Parameters: 
		  Labour,WSUrl,WSUser,WSPassword,GIFastNetUser,GIFastNetPassword
		  are required only in 'Client' mode.
  -->

  <Incab
 	Mode = "Disabled"
 	Labour="Emp0001"
	 WSUrl="http://localhost:1298/Web/Services/GeneralInterface.asmx"
	 WSUser=""
	 WSPassword=""
	 GIFastNetUser="admin"
	 GIFastNetPassword="admin"
  />

  <GPS
       Enabled="true"
       Simulator="true"
       PositionChangedMargin="0.005"
       PositionChangedSecondsInterval="2"
       MovementStoppedMargin="0.1"
       ComunicationPort="COM13"
       ComunicationBaudRate="4800"
       Area="Great Britain"
       SystemCoordinateType="cartesian"
       GPSReadType="geodetic"
       DataPath="C:\artura\vs2005proj\FastNET2Artur\Common\Utilities\"
       UTMZone=""
       VertDatum="">
  </GPS>
	-->
 	<FileConvert WaitForExit="10000">
		<MigraDocConv>
		<pdf 
				ConvertFrom="txt; bmp; emf; exif; gif; ico; jpeg; jpg; png; tif; wmf" 
				FontEmbedding="false"
				FontSize="10pt"
				FontName="Lucida Console"
				PageFormat="A4"
				Orientation="Portrait"
			/>
		</MigraDocConv>
    <!--
		<CmdLinePdfConv Path="D:\Agility\Agility2.9.5\LiveSystem\bin\Others\TxtToPDF" BaseCmdLine="{in} {out}">
			<pdf ConvertFrom="txt"/>
		</CmdLinePdfConv>

		<Convert_Doc Path="C:\Program Files\Softinterface, Inc\Convert Doc\ConvertDoc.exe">
			<pdf ConvertFrom="doc; html; rtf; txt" />
		</Convert_Doc>

		<Convert_ITP Path="c:\Program Files\Softinterface, Inc\Convert Image To PDF\ConvertITP.exe">
			<pdf ConvertFrom="bmp; ico; jpeg; gif; koa; lbm; pcd; pcx; png; ras; tga; tif; psd" />
		</Convert_ITP>
    
		<Total_Excel_Converter Path="C:\Program Files\TotalExcelConverter\ExcelConverter.exe">
			<pdf ConvertFrom="xls" />
		</Total_Excel_Converter>
    
		<Document2PDF Path="C:\Program Files\Two Pilots\Document2PDF Pilot 2.2 TRIAL\Document2PDF_Pilot.exe">
			<pdf ConvertFrom="doc; xls"  />
		</Document2PDF>
    -->
	</FileConvert>
	<!--
	<timezone
		LocalTimeInDatabase="True"
		TimeZoneName="Central European"
		DaylightTimeZoneName="Central European Daylight"
		UTCOffset="120"
		DaylightStart="01/01/2003"
		DaylightEnd="01/06/2003"
		DaylightOffset="60">
	</timezone>
	-->
 	<!-- Licensing Options -->
 	<!--
	<AgilitySupport>
			<Licensing 
				SignLicenseFile="" 
				LicensingWebService="" 
				LicensingWWW="" 
				LicensingMail=""
			/>




	</AgilitySupport>
	-->
</configuration>