Extract Usergroups information using java program objects

[Former Member]

In this blog, I will be demonstrating a program object to export the details of usergroups in a Business Objects environment.

Prerequisites:

1. BusinessObjects Enterprise System
2. BusinessObjects Enterprise Java SDKs

Creation of a Java Program Object:

• For creating a java program object, you need to write a java class which has to implement the interface IProgramBase.
• Once you create the java file, you would then need to create a jar file for the java class by setting all the required jars in your classpath.
• Below is a sample java file to export the details of usergroups in a BusinessObjects environment

import com.crystaldecisions.sdk.plugin.desktop.program.*;

import com.crystaldecisions.sdk.framework.*;

import com.crystaldecisions.sdk.framework.*;

import com.crystaldecisions.sdk.exception.*;

import com.crystaldecisions.sdk.occa.infostore.*;

import com.crystaldecisions.sdk.plugin.desktop.server.IServer;

import com.crystaldecisions.sdk.occa.infostore.CePropertyID;

import com.crystaldecisions.sdk.plugin.desktop.user.*;

import com.crystaldecisions.sdk.properties.*;

import org.apache.poi.xssf.usermodel.XSSFSheet;

import org.apache.poi.xssf.usermodel.XSSFWorkbook;

import org.apache.poi.xssf.usermodel.XSSFCell;

import org.apache.poi.xssf.usermodel.XSSFRow;

import java.io.*;

import java.util.*;

public class Usergroup implements IProgramBase

{

public void run(IEnterpriseSession enterprisesession,IInfoStore infostore,String str[]) throws SDKException

{

  System.out.println("Connected to " + enterprisesession.getCMSName() + "CMS");

        System.out.println("Using the credentials of " + enterprisesession.getUserInfo().getUserName() );

  int index=1;

  int j =1;

  XSSFWorkbook wb = new XSSFWorkbook();

  XSSFSheet sheet = wb.createSheet("new sheet");

  XSSFRow rowhead = sheet.createRow((short)0);

  rowhead.createCell((short) 0).setCellValue("Sr No.");

  rowhead.createCell((short) 1).setCellValue("User Group");

  rowhead.createCell((short) 2).setCellValue("Description");

  try

  {

  infostore = (IInfoStore) enterprisesession.getService("", "InfoStore");             

  IInfoObjects infoobjects = infostore.query("Select * From CI_SYSTEMOBJECTS Where SI_Kind='Usergroup'");

  for(int i=0;i<infoobjects.size();i++)

  {

  IInfoObject user = (IInfoObject) infoobjects.get(i);

  XSSFRow row = sheet.createRow((short)index);

  row.createCell((short) 0).setCellValue(j);

  row.createCell((short) 1).setCellValue(user.getTitle());

  row.createCell((short) 2).setCellValue(user.getDescription());

  j++;

  index++;

  }

  Date date=new Date();

  String date1= date.toString();

  String date2=date1.replaceAll("\\W", "_");

  FileOutputStream fileOut = new FileOutputStream(str[0]+"_"+date2 +".xlsx");

  wb.write(fileOut);

  fileOut.close();

  System.out.println(" Excel file created successfully");

    }

    catch(Exception e)

  {

  System.out.println(e.getMessage());

  }

}

}

• Copy the above code into a text file and save it as Usergroup.java. Please make sure that your java class name and file name should exactly be the same (case sensitive).
• Compile the above java class by having all the jars required to run the file in the classpath. You can also use eclipse IDE to compile and create jar file. The list of jars can be found from the developers guide available at below links:
  • For BI 4.0:

               http://help.sap.com/businessobject/product_guides/boexir4/en/xi4_boejava_dg_en.zip

• For XI 3.1

               http://help.sap.com/businessobject/product_guides/boexir31/en/boesdk_java_dg_12_en.zip

• Refer to the section 'JAR files needed for deployment of Business Objects Software' from the above guides to get the list of jar files.
• You would specifically need the jar files listed under 'BusinessObjects Enterprise Java SDK'
• Once you have compiled the code, create a jar file for your compiled .class file.

Publishing the Java Program Object to the Enterprise System:

1. In the CMC, go to Folders and create new folder "Objects" or navigate to an existing folder where you want to publish the program object
2. Select the folder "Objects" and click on Manage | Add | Program File
3. Choose as Program Type Java and add Usergroup.jar
4. Right Click on ServerStatus within your Objects folder and choose Properties | Default Settings | Program Parameters
5. Specify as "Class to run:" Usergroup.
6. In the Arguments pass the the location along with excel file name where you want the excel file to be generated(eg. c:/failedinstances.xls).
7. Test "Run Now" and schedule the Program Object.

You would then have an excel file generated at the above specified location with the details of usergroups in a Business Objects environment.