• Make and entry for the new column "EXTN_PREFERENCE" for the ITEM table in the ....../extensions/global/entities/Extensions.xml. If this file is not there create a new file taking a copy from ...../runtime/repository/entity/extensions/Extensions.xml.Sample
• Start Database instance if it's not running.
  

  				cd /oms/devtoolkit_docker/compose 
  				./om-compose.sh start <databse server> (e.g; oracleserver, db2server)
  				

• Build extension jar. Execute following command :

  				cd /oms/devtoolkit_docker/runtime/bin
  				./sci_ant.sh -f ../devtoolkit/devtoolkit_extensions.xml importfromproject -Dprojectdir=/oms/project
  				
  				

• Deploy Extension Jar
  

  				cd /oms/devtoolkit_docker/compose 
  				./om-compose.sh update-extn /oms/devtoolkit_docker/extensions.jar 
  				

• Stop the database server instance and Start entire applic ation instan ce
• Check the ITEM table. You should see the new column.
  Open https://localhost:9443/smcfs/yfshttpdbi/sterlingdbqueryclient.jsp
  to check the new column.

1. Write a Java Class It may extends YIF Custom Api have a public method which returns document and it accept YFS environment object and document object
2. Create a folder/directory named 'project'.

   				 cd /oms 
   				 md project
   				 chmod 777 project
   				

3. Create src and lib folder inside project directory.

   				cd /oms/project
   				md lib
   				md src
   				chmod 777 lib
   				chmod 777 src
   				

4. put/upload your java file in /oms/project/src folder. Example: If your package name is com.easy. You need put the file in /oms/project/src/com/easy folder
5. If you are using any 3rd party jar files, upload them in /oms/project/lib folder. Example:- My java code uses 3rd party class StrUtil.class and its in easycommon.jar. I should upload the easycommon.jar file in /oms/project/lib folder
6. Stop the server if its running. Execute following command :

   				cd /oms/devtoolkit_docker/compose 
   				./om-compose.sh stop
   				

7. Start only Database server as it's required during entity build.

   				cd /oms/devtoolkit_docker/compose 
   				./om-compose.sh start db2server ( or oracleserver for oracle)
   				

8. Build extension jar. Execute following command :

   				cd /oms/devtoolkit_docker/runtime/bin
   				./sci_ant.sh -f ../devtoolkit/devtoolkit_extensions.xml importfromproject -Dprojectdir=/oms/project
   				
   				

9. Update extension jar. Execute following command from :

   				cd /oms/devtoolkit_docker/compose
   				./om-compose.sh update-extn /oms/devtoolkit_docker/extensions.jar 
   				
   				

 
package com.easy;
import java.util.Properties;
import org.w3c.dom.Document;
public class TestService implements YIF CustomApi {

	public Document testMethod(Environment env, Document doc) {
		doc.getDocumentElement().setAttribute("Training", "EasyCodeForAll");
		return doc;
	}

	@Override
	public void setProperties(Properties arg0) throws Exception {

	}

}

1. Write a Java Class which extends YIF Custom Api
2. It should have a public method which returns document and it accept YFS environment object and document object
3. Open Application Manager. Go to any process type and service tab. Create a new service of type extended api.
4. Provide the Java class name with package name and method name. Api name can be given same as method name..
5. Add your java class in your project folder and do a build and deployment.
6. Test the service with API tester - Invoke the service from API tester with a sample XML
7. You should get an XML as output of the service

 
package com.easy;

import java.util.Properties;
import org.w3c.dom.Document;
import com.easy.StrUtil;

public class TestServiceEasyK implements YIF Custom Api {
	Properties prop;
	public Document testMethod(Environment env, Document doc) {
		doc.getDocumentElement().setAttribute("Training", "EASY_CODE");
		System.out.println("TESTING_CUSTOM CODE DEPLOYMENT WITH 3RD PARTY DEPENDANT JAR");
		return doc;
	}

	@Override
	public void setProperties(Properties arg0) throws Exception {
		prop = arg0;
	}

}

1. Write a Java Class which implements UE interface (e.g. beforeCreateOrderUE)/li>
2. Implement the interface methods (unimplemented)
3. In the method body. put your custom logic. Process the input XML and after processing return the input XML as output. check the API java doc to find out what kind of value UE method takes and what kind of value UE returns
4. If you add any new attribute which is not there in the UE input XML structure, it will not be passed to the UE.
5. If you add any new attribute which is not there in the UE output XML structure, it will not be available to transaction.
6. Configure the UE implementation in Application Manager (Configurator)
7. Invoke API/Transaction with API tester to test the UE

 
package com;

import org.w3c.dom.Document;



public class UEImpl implements BeforeCreateOrderUE {

	@Override
	public String beforeCreateOrder(Environment arg0, String arg1) throws UserExitException {
		return arg1;
	}

	@Override
	public Document beforeCreateOrder(Environment env, Document doc) throws UserExitException {
		doc.getDocumentElement().setAttribute("OrderName", "EASY_ORDER");
		System.out.println("UE INVOKED");
		return doc;
	}

}

1. Write a Java Class which implements DynamicConditionEx (e.g. beforeCreateOrderUE)
2. Implement the evalueCaondtion methods (unimplemented methods). It should return boolean value.
3. In the evalueCaondtion method body. put your custom logic. Process the input XML and after processing and finally return a boolean value
4. If your code raise any exception, wrap it with try/catch block. Do not throw any exception. .
5. Configure the condition in Application Manager (Configurator)

 
package com;

import java.util.Map;

import org.w3c.dom.Document;


public class TestDynamicCondition implements DynamicConditionEx {

	Map prop = null;

	@Override
	public boolean evaluateCondition(Environment arg0, String arg1, Map arg2, Document arg3) {
		boolean conditionValue = true;
		try {
			String attrValue = arg3.getDocumentElement().getAttribute("CarrierServiceCode");
			if (attrValue == null)
				conditionValue = false;
		} catch (Exception ex) {
			conditionValue = false;
		}
		System.out.println("conditionValue=" + conditionValue);
		return conditionValue;
	}

	@Override
	public void setProperties(Map arg0) {
		prop = arg0;

	}

}