Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Instruction

Table of Contents

Prerequisites

  1. The recommended target platform for your Windows Application or Web Service is x64.
  2. Your application must have read/write access to the Windows registry to the registry key 'HKEY_CURRENT_USER\Software\Classes\CLSID', and all its subkeys.

Installation instructions

Instructions how to configure Greenrain MNC API is are provided below:

  1. Download the API from this link: httpshttp://wwwgreenrain.dropbox.combiz/sdownload/2xmi3ot7tf4ztj7Frigg/FriggOutput.zip?dl=0.
  2. Move file FriggOutput.zip\C_Users_Public_Documents\Greenrain\MNC Framework\Edit\edits.frg to C:\Users\Public\Documents\Greenrain\MNC Framework\Edit\.
    1. You can also use Windows Environment Variable CSIDL_COMMON_DOCUMENTS that refers to the file-system directory that contains documents that are common to all users. A typical path is C:\Users\Public\Documents.
    2. In C#, you can use this variable to refer to this folder: Environment.SpecialFolder.CommonDocuments\Greenrain\MNC Framework\Edits.
  1. Add external binaries from the "External binaries" directory to the project.
  2. Copy dependency binaries from the "Bin" directory to "Release" or "Bin" directory to the project.
  3. Configure App.config or Web.config file for logging.
    1. Add this line to section <configSections>: 

      1. Code Block
        languagec#xml
        <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler,log4net" />


    2. Insert Add the below sample to section <configuration>:

      1. Code Block
        languagec#xml
          <!--Log4net configuration settings start-->
          <log4net>
            <appender name="Greenrain MNC Framework" type="log4net.Appender.RollingFileAppender">
              <file type="log4net.Util.PatternString"
                    value="%envFolderPath{CommonDocuments}\\Greenrain\\MNC Framework\\Log\\Greenrain MNC Framework %date{yyyy-MM-dd}.%processid.log" />
              <appendToFile value="true" />
              <maximumFileSize value="1048576KB" />
              <layout type="log4net.Layout.PatternLayout">
                <conversionPattern value="%date{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %C{1}.%M (%F:%L) - %m%n" />
              </layout>
            </appender>
            <root>
              <level value="WARN" />
              <appender-ref ref="Greenrain MNC Framework" />
            </root>
          </log4net>


    3. For example:

      1. Code Block
        languagec#xml
        <?xml version="1.0" encoding="utf-8"?>
        
        <configuration>
          <configSections>
            <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler,log4net" />
            <section name="oracle.manageddataaccess.client"
                     type="OracleInternal.Common.ODPMSectionHandler, Oracle.ManagedDataAccess, Version=4.121.2.0, Culture=neutral, PublicKeyToken=89b483f429c47342" />
          </configSections>
          <!--Log4net configuration settings start-->
          <log4net>
            <appender name="Greenrain MNC Framework" type="log4net.Appender.RollingFileAppender">
              <file type="log4net.Util.PatternString"
                    value="%envFolderPath{CommonDocuments}\\Greenrain\\MNC Framework\\Log\\Greenrain MNC Framework %date{yyyy-MM-dd}.%processid.log" />
              <appendToFile value="true" />
              <maximumFileSize value="1048576KB" />
              <layout type="log4net.Layout.PatternLayout">
                <conversionPattern value="%date{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %C{1}.%M (%F:%L) - %m%n" />
              </layout>
            </appender>
            <root>
              <level value="WARN" />
              <appender-ref ref="Greenrain MNC Framework" />
            </root>
          </log4net>
          ...
        </configuration>


  4. Use Source Code Example to implement Greenrain MNC API in your system.

...