nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

Calling a java program from the external task

dolly1

Hi,

I am creating a workflow using workflow modeler and trying not to use the perl scripts but JAVA classes for external scripts.

I have gone through the workflow modeler document and it says we can place the code in customer_src/lib... but i guess that is not the correct folder structure to place the workflow tasks files.

Can anyone please let me know where these JAVA files should be placed then in the teamsite?

Find more posts tagged with

Comments

Migrateduser

Put your jar files in:
/iw-home/local/config/lib/content_center/customer_src/lib

Put your class files in:
/iw-home/local/config/lib/content_center/customer_src/src

Be in the directory:
/iw-home/local/config/lib/content_center/customer_src
and run /iw-home/bin/make_toolkit.ipl

In your workflow model, if you are using external task, put the following in command:
/iw-home/tools/java/bin/java -cp classpath package.classname
replace the classpath with your classpath, replace the package.classname with your package.

If you are using url external task, your uri should be:
http://$IW_SERVER/iw-cc/urlexternaltask
Then add a ClassName variable and have it point to your package.classname.

Adam Stoller

Put your jar files in:
/iw-home/local/config/lib/content_center/customer_src/lib

Put your class files in:
/iw-home/local/config/lib/content_center/customer_src/src

Be in the directory:
/iw-home/local/config/lib/content_center/customer_src
and run /iw-home/bin/make_toolkit.ipl

In your workflow model, if you are using external task, put the following in command:
/iw-home/tools/java/bin/java -cp classpath package.classname
replace the classpath with your classpath, replace the package.classname with your package.

If you are using url external task, your uri should be:
http://$IW_SERVER/iw-cc/urlexternaltask
Then add a ClassName variable and have it point to your package.classname.

Note - if your class name is something like custom.corp.com.myClass - then you need to put the actual class file in the appropriate directory within customer_src/src - i.e.: customer_src/src/custom/corp/com/myClass.class

sanoboy

Put your jar files in:
/iw-home/local/config/lib/content_center/customer_src/lib

Put your class files in:
/iw-home/local/config/lib/content_center/customer_src/src

Be in the directory:
/iw-home/local/config/lib/content_center/customer_src
and run /iw-home/bin/make_toolkit.ipl

In your workflow model, if you are using external task, put the following in command:
/iw-home/tools/java/bin/java -cp classpath package.classname
replace the classpath with your classpath, replace the package.classname with your package.

If you are using url external task, your uri should be:
http://$IW_SERVER/iw-cc/urlexternaltask
Then add a ClassName variable and have it point to your package.classname.

hi,all
now, i am using the external task in wf, but i need to pass parameters to the java class, such as task attach files name. if i define it under external task variable, then how to call these variable in java class?

Jcse

hi,all
now, i am using the external task in wf, but i need to pass parameters to the java class, such as task attach files name. if i define it under external task variable, then how to call these variable in java class?

hi

you can pass any parameter by defining a task varibale (in your case it's an external task variable)

To get the value of that variable in you java class use the method

java.lang.String getVariable(java.lang.String name)
          Gets custom variable of the task.

of the class CSTask, using its object.

Same class you have to use in order to get the file attached to the task.
use the either of these two methods as per your requirement

`CSAreaRelativePath[]`	`getFiles()` Gets files attached to the task.
`CSFile[]`	`getFiles(java.lang.String query)` Gets files attached to the task, and fetch data specified in the query for the files.

Steps:

Create the java class
get the WF instance
get the Tasks List,identify your task(external task) by its name
Implement the required methods.
Read the CSSDK docs for more information.

HTH

sanoboy

hi

you can pass any parameter by defining a task varibale (in your case it's an external task variable)

To get the value of that variable in you java class use the method
java.lang.String getVariable(java.lang.String name)
          Gets custom variable of the task.  
of the class CSTask, using its object.

Same class you have to use in order to get the file attached to the task.
use the either of these two methods as per your requirement
CSAreaRelativePath[] getFiles()
Gets files attached to the task.
CSFile[] getFiles(java.lang.String query)
Gets files attached to the task, and fetch data specified in the query for the files.
Steps:
Create the java class
get the WF instance
get the Tasks List,identify your task(external task) by its name
Implement the required methods.
Read the CSSDK docs for more information.
HTH

hi, jcse
to get WF instance i need to pass workflow id, can i get the currently workflow object also task,and files directly not by passing variable?
and all those methods under CSTask class seems havn't implemented yet,so i need to implement them such as getVariable(), getFiles(),right?thx

sanoboy

hi

you can pass any parameter by defining a task varibale (in your case it's an external task variable)

To get the value of that variable in you java class use the method
java.lang.String getVariable(java.lang.String name)
          Gets custom variable of the task.  
of the class CSTask, using its object.

Same class you have to use in order to get the file attached to the task.
use the either of these two methods as per your requirement
CSAreaRelativePath[] getFiles()
Gets files attached to the task.
CSFile[] getFiles(java.lang.String query)
Gets files attached to the task, and fetch data specified in the query for the files.
Steps:
Create the java class
get the WF instance
get the Tasks List,identify your task(external task) by its name
Implement the required methods.
Read the CSSDK docs for more information.
HTH

hi, can i ask you one more question:how can i get the workflow instance?

currently, i use the workflow model. i am confuse using WFMworkflow.jar or csWorkflow.jar

Jcse

hi, jcse
to get WF instance i need to pass workflow id, can i get the currently workflow object also task,and files directly not by passing variable?
and all those methods under CSTask class seems havn't implemented yet,so i need to implement them such as getVariable(), getFiles(),right?thx

Hi
I think i have not communicated you properly.
I mean to say,the class you will call on your External Task will have an execute method,like

public void execute(CSClient client, CSExternalTask currentTask, Hashtable params) throws CSException {

.....
....

}

using this object you can also get workflow object using the method

CSWorkflow job = currentTask.getWorkflow();

Now you have your currentTask object,use this to call earlier mentioned methods.

sanoboy

Hi
I think i have not communicated you properly.
I mean to say,the class you will call on your External Task will have an execute method,like
public void execute(CSClient client, CSExternalTask currentTask, Hashtable params) throws CSException {

.....
....

}
using this object you can also get workflow object using the method
CSWorkflow job = currentTask.getWorkflow();
Now you have your currentTask object,use this to call earlier mentioned methods.

thanks very much, you mean under

public void execute(CSClient client, CSExternalTask currentTask, Hashtable params) throws CSException { }

we can use currentTask directly to get related information such as workflow instance. we needn't pass parameter pre defined in external task variable such as workflow id to get workflow then currentTask and attach files

Jcse

thanks very much, you mean under
public void execute(CSClient client, CSExternalTask currentTask, Hashtable params) throws CSException { }
we can use currentTask directly to get related information such as workflow instance. we needn't pass parameter pre defined in external task variable such as workflow id to get workflow then currentTask and attach files

of-course and that is what i want to communicate.

sanoboy

of-course and that is what i want to communicate.

hi,
orginally, i thought it will call execute() method automatically. it is reasonable to get currentTask directly. But after i tested last night, i found it will call main() method automatically when call the java class in externalTask, so how the execute() method be called? if call execute() method in main(), then how to pass the client, currentTask?

vpatel

You probably need something along these lines (see code below). Make a note that the execute method gets executed automatically when your "external" task gets invoked.
[html]public class MyExternalClass implements CSURLExternalTask {

public void execute(CSClient client, CSExternalTask currentTask, Hashtable params) throws CSException {
// you can do stuff like: currentTask.someMethodFromTheAPI();
// look at the API for available methods...

// whatever processing that you want to do...

// finally transition: currentTask.chooseTransition("", "");
}

}[/html]
HTH!

Jcse

You probably need something along these lines (see code below). Make a note that the execute method gets executed automatically when your "external" task gets invoked.
[html]public class MyExternalClass implements CSURLExternalTask {

public void execute(CSClient client, CSExternalTask currentTask, Hashtable params) throws CSException {
// you can do stuff like: currentTask.someMethodFromTheAPI();
// look at the API for available methods...

// whatever processing that you want to do...

// finally transition: currentTask.chooseTransition("", "");
}

}[/html]
HTH!

Hi sanoboy

vpatel has putted you on the right track.check the note mentioned by him.
As per my understanding of your requirement , now it's your turn to sort out the issue.

Best of Luck

sanoboy

Hi sanoboy

vpatel has putted you on the right track.check the note mentioned by him.
As per my understanding of your requirement , now it's your turn to sort out the issue.

Best of Luck

hi,all
thx for your help very much. But now the issue is when call the external class it only call the main(), it didn't call the execute() though i implemented the class as you mentioned. Since this is a native method, why execute() can't be called automatically? attach the code, is there anything wrong?

Jcse

hi,all
thx for your help very much. But now the issue is when call the external class it only call the main(), it didn't call the execute() though i implemented the class as you mentioned. Since this is a native method, why execute() can't be called automatically? attach the code, is there anything wrong?

Points need to know .

Have you placed your java file at proper location mentioned earlier in the post.
Have you run make_toolkit.ipl
What is coming in the log file iwutild_cmdout.log and servletd_out.log

Note:There is no need of implementing main method in your class,execute method is called automatically whenever ur external task is invoked..

sanoboy

Points need to know .
Have you placed your java file at proper location mentioned earlier in the post.
Have you run make_toolkit.ipl
What is coming in the log file iwutild_cmdout.log and servletd_out.log
Note:There is no need of implementing main method in your class,execute method is called automatically whenever ur external task is invoked..

hi,jcse
under iwutild_cmdout.log
if i don't implement main() then
java.lang.NoSuchMethodError: main
Exception in thread "main"
if i implement main() then no exception,only display the "entering..................".It proves only call the main() method.
additional i use the ExternalTask in workflow not urlExternalTask

gopi123

Hi,
I am also facing the same problem. If i call a java file with a main method it is executing but whenever i call a file without main and with a execute method my java file is not getting called. I have placed my file in the following location : C:\Interwoven\TeamSite\local\config\lib\content_center\customer_src\src\com\corp\custom

i have complied it and ran make_toolkit.ipl

but the file(with execute method) is not getting called. But with the same steps i can call a java file(with main method)

Can anybody please help me out with this problem?

Jcse

Hi,
I am also facing the same problem. If i call a java file with a main method it is executing but whenever i call a file without main and with a execute method my java file is not getting called. I have placed my file in the following location : C:\Interwoven\TeamSite\local\config\lib\content_center\customer_src\src\com\corp\custom

i have complied it and ran make_toolkit.ipl

but the file(with execute method) is not getting called. But with the same steps i can call a java file(with main method)

Can anybody please help me out with this problem?

Hi

The location is correct,but i am confused for :

Are you guys are placing Java file or Class file at the location.We have to place Java file not the Class file
From where you are running the build,as mentioned earlier build should be run from the
```
/iw-home/local/config/lib/content_center/customer_src
```

As the correct procedure has been told you and it has been implemented and working for many people.

sanoboy

Hi

The location is correct,but i am confused for :
Are you guys are placing Java file or Class file at the location.We have to place Java file not the Class file
From where you are running the build,as mentioned earlier build should be run from the
/iw-home/local/config/lib/content_center/customer_src
As the correct procedure has been told you and it has been implemented and working for many people.

as mentioned, in externalTask command, we define the java class path.
as general, .java is under xx_src while .class is under xx_out
so we define java class path as $IW-HOME/../customer_out/src com.xx.xx
this defination should be ok,right?
But still java.lang.NoSuchMethodError:main if we don't define main() under java class
is there other case cause this issue?

Jcse

as mentioned, in externalTask command, we define the java class path.
as general, .java is under xx_src while .class is under xx_out
so we define java class path as $IW-HOME/../customer_out/src com.xx.xx
this defination should be ok,right?
But still java.lang.NoSuchMethodError:main if we don't define main() under java class
is there other case cause this issue?

Instead of this

$IW-HOME/../customer_out/src com.xx.xx

it should be

$IW-HOME/../customer_src/src com.xx.xx

You need not to compile and place Class file at xx_out.

When you run build,it will send the class to its desired location.

sanoboy

Instead of this
$IW-HOME/../customer_out/src com.xx.xx 
it should be
$IW-HOME/../customer_src/src com.xx.xx 
You need not to compile and place Class file at xx_out.

When you run build,it will send the class to its desired location.

No, i only put the .java under customer_src,then after build, the .class will be generated under customer_out automatically.
so under ExternalTask command we should define class path like:
$IW-HOME/../customer_out/src com.xx.xx (.class file not .java class)

the main issue is can't call execute() method now

Jcse

No, i only put the .java under customer_src,then after build, the .class will be generated under customer_out automatically.
so under ExternalTask command we should define class path like:
$IW-HOME/../customer_out/src com.xx.xx (.class file not .java class)

the main issue is can't call execute() method now

ok, let me setup and test it at my end.
then i will let you know the solution probably.

vpatel

Try switching it from your External task to an URL task and your "execute" method should get executed.

In an external task it will execute main method. You'll see the almost identical user experience with either task. So unless you feel too strong about using an External task over an URL task then you should be fine by just switching it. If not, you have to do your logic in the main method.

sanoboy

ok, let me setup and test it at my end.
then i will let you know the solution probably.

hi,jcse
as vpatel mentioned,i try switch it form externalTask to urlTask. Now it works,can call execute method automatically.
It's great!

For the URL task, define URL http://servername/iw-cc/ urlexternaltask where servername is the local host on which the workflow is being run. Then add the value ClassName as a variable to the urltask.
Expect this is useful for guys need help.

Additional, for the ExternalTask, maybe we should do other modify or configure to make it also work. I will research it later. Once you get any info important, pls post it. I think it's very useful.
Anyway,i will complete the workflow asap. Otherwise, PM and client will complain.

At last, if the urlTask also can't call execute method, i had already plan to use perl to do the external task. because it is easy to get task and attach files under .ipl. Of course, it is not so convinent to do further modify to attach files using perl.
I think this is also why now interwoven are moving more support from perl to java.

Thx for your continuous help and concerning.

Migrateduser

For URL External Task, you should use the following for URI:
http://$IW_SERVER/iw-cc/urlexternaltask

If you use external task, you will need to write your own main method and whatever you want to happen in there. The first 3 arguments passed to your external task file would be:
workflow id
task id
workarea
in that order... It will be up to you to get the workflow, tasks, attached files from those arguments.

If you use a url external task, you'll get the task automatically and you can deal with that object instead of worrying about trying to get the task, workflow, etc....