Requirements for UI
To have best experience with user interface, please use hardware/software with at least next characteristics, or better.
Monitor: 1280x1024 (in some rare cases down to 1024x768)
Supported browsers:
recent Firefox - fully
recent Chrome - fully
IE8, IE9 - partially
Command Line Arguments
Bambi supports several command line arguments in order to automate the application start. The following a list of all arguments plus a short description about their usage:
Arguments | Description | Default Value | |
---|---|---|---|
Short | Long | ||
-a | --auto | Auto start | false |
-c | --context | URL Context Subpath of URL | "bambi" |
-p | --port | Port Port on which bambi server is listening. | 8080 |
Sample
Here a sample how to use the command line arguments. This leads to an automated server start. The URL of the started bambi server is http://localhost:9999/myContext
Code Block | ||||
---|---|---|---|---|
| ||||
C:\>bambi.exe -a -c myContext -p 9999 |
Device Configuration Files
Device Configuration files define the respective devices that Bambi simulates. The configuration file can be found at <base dir>/config/devices.xml One Bambi simulator can represent multiple devices. Each device is represented by one Device element in the configuration file. The following table defines some of the valid device parameters:
Configuration Parameter | Cardinality | Description |
---|---|---|
/application/@BaseDir | required | directory where all Bambi Files are stored. |
/application/@Context | required | Url base Path of the application |
/application/@Port | required | Url Port of the application |
//Device/@DeviceID | required | JDF DeviceID of the simulated device |
//Device/@TrackResource | optional | resource that is tracked with Resource Audits and Resource JMF and that defines the speed for counting status JMFs. |
//Device/@AmountResources | optional | additional resources that are tracked with Resource Audits and Resource JMF. |
//Device/@TypeExpression | optional | regular expression of types that are accepted by the simulator |
Code Block | ||||
---|---|---|---|---|
| ||||
<?xml version="1.0" encoding="UTF-8"?> <application AppDir="C:\Users\s.meissner\AppData\Local\Temp\jetty-0.0.0.0-8080-bambi.tmp.war-_context-any-\webapp" BaseDir="/bambidata/sim/" CallBackName="org.cip4.bambi.extensions.ExtensionCallback" Context="/SimWorker" JDFDir="JDFDir" JettyPort="44482" Port="8080" SenderID="SimDevice"> <Device DeviceID="SimWorkerRoot" DeviceType="Bambi Sim Device Root"/> <Device AcceptAll="true" DeviceID="sim001" DeviceType="Bambi Simulation HotFolder Device 001" ErrorHF="/BambiHF/sim001/Error" InputHF="/BambiHF/sim001/Input" OutputHF="/BambiHF/sim001/Output" ProxyURL="http://localhost:8080/BambiProxy/slavejmf/pullproxy" TrackResource="Component:Output"/> <Device DeviceID="sim002" DeviceType="Bambi Simulation HotFolder Device 002" ErrorHF="/BambiHF/sim002/Error" InputHF="/BambiHF/sim002/Input" OutputHF="/BambiHF/sim002/Output" TrackResource="Component:Output"/> <Device DeviceID="sim003" DeviceType="Bambi Push Simulation Device 003" ErrorHF="/BambiHF/sim003/Error" InputHF="/BambiHF/sim003/Input" MIMEExpansion="true" OutputHF="/BambiHF/sim003/Output" PushPull="Push" TrackResource="Component:Output"/> <Device AmountResources="Media:Input,UsageCounter" DeviceID="simIDP" DeviceType="Bambi Push Simulation IDP Device" ErrorHF="/BambiHF/simIDP/Error" InputHF="/BambiHF/simIDP/Input" MIMEExpansion="true" OutputHF="/BambiHF/simIDP/Output" PushPull="Push" TrackResource="Component:Output" TypeExpression="(.)*DigitalPrinting(.)*"/> </application> |
Code Block | ||||
---|---|---|---|---|
| ||||
<?xml version="1.0" encoding="UTF-8"?> <Employees xmlns="http://www.CIP4.org/JDFSchema_1_1"> <Employee ProductID="E1" Roles="Operator" > <Person DescriptiveName="Joe Cool" /> </Employee> <Employee ProductID="E2" Roles="Operator" > <Person DescriptiveName="Harry II" /> </Employee> <Employee ProductID="E3" Roles="Operator" > <Person DescriptiveName="John Doe" /> </Employee> <Employee ProductID="E4" Roles="Operator" > <Person DescriptiveName="Fool Hardy" /> </Employee> </Employees> |
Job Simulation Configuration Files
Job Simulation Configuration files define the respective phases of a job that Bambi simulates. The default job configuration file can be found at <base dir>/config/job.xml. Device specific configuration file can be found at <base dir>/config/job_<deviceid>.xml. Each JobPhase is iterated over individually.
Configuration Parameter | Cardinality | Description |
---|---|---|
/BambiJob/@Error | optional | % chance per iteration that a random error will be inserted |
//JobPhase/@Duration | required | maximum duration of the job phase in seconds. |
//JobPhase/@<xxx>Status | required | device and node status and stausdetails for audits and JMF that apply to this phase |
//Amount/@Resource | required | The resource that this amount applies to. |
//Amount/@Speed | optional | Speed of consumption or production in implied JDF units/hour. |
Code Block | ||||
---|---|---|---|---|
| ||||
<?xml version="1.0" encoding="UTF-8"?> <BambiJob Error="3"> <JobPhase Duration="2" DeviceStatus="Setup" DeviceStatusDetails="WarmingUp" NodeStatus="Setup" NodeStatusDetails="node warmup"> <Amount Resource="Component:Output" Speed="0" /> <Amount Resource="Media:Input" Speed="0" /> </JobPhase> <JobPhase Duration="10" DeviceStatus="Setup" DeviceStatusDetails="Waste" NodeStatus="Setup" NodeStatusDetails="node setup"> <Amount Resource="Component:Output" Speed="4000" Waste="true"/> <Amount Resource="Media:Input" Speed="4000" Waste="true" /> </JobPhase> <JobPhase Duration="99999" DeviceStatus="Running" DeviceStatusDetails="Good" NodeStatus="InProgress" NodeStatusDetails="producing node"> <Amount Resource="Component:Output" Speed="16000" /> <Amount Resource="Media:Input" Speed="16000" /> </JobPhase> <JobPhase Duration="10" DeviceStatus="Cleanup" DeviceStatusDetails="WashUp" NodeStatus="Cleanup" NodeStatusDetails="cleaning up"> <Amount Resource="Component:Output" Speed="0" /> <Amount Resource="Media:Input" Speed="0" /> </JobPhase> </BambiJob> |
Configure format Date fields
Date fields can be configured to show its value in most appropriate way. Currently, it shows in Europian way, thus "DD/MM/YYYY".
To change behaviour, user need to update next file:
- for legacy UI: "/CIP4Tools/bambi/legacy/queue2html.xsl
- "
- for new UI: "/CIP4Tools/bambi/webapp/queue2html.xsl"
In the file, near bottom of it, you will find next line:
<xsl:variable name="dateFormatter" select="'EURODate'"/>
Please, read comment in the file, about usage of the formatter and supported formats.