Developing Apama Applications > Using Apama Studio > File Definition Formats > Block definition file format > Block definition file DTD
Block definition file DTD
The document must comply with the XML Document Type Definition bdf.dtd. This file is included in the Apama installation’s etc directory. This description of the file format is presented for troubleshooting purposes and general background information.
When you create a new block as part of a project in Apama Studio, the best practice is to locate it in the project’s default blocks directory. This directory is found in the project’s catalogs directory. The block directory has a name in the form <project_name> blocks. So, for example, the default block directory of a project named My_Project will be catalogs\My_Project blocks.
If you place your block in the Apama Studio project’s default block directory, scenarios created in the project will automatically find them and make them available in Event Modeler when you are displaying the scenario.
Apama Studio assigns the name of the file as follows:

Block Name v version_number.bdf
For example, the block whose <name> attribute is Database Retrieval would be defined in the file Database Retrieval v1.0.bdf and stored in a folder called Database Retrieval.bdf. This convention makes it easy to browse multiple versions of the block within a block catalog when using the Event Modeler. Note that this naming and folder placement (and creation) is all done automatically by Apama Studio.
Copyright © 2013 Software AG, Darmstadt, Germany and/or Software AG USA Inc., Reston, VA, USA, and/or Terracotta Inc., San Francisco, CA, USA, and/or Software AG (Canada) Inc., Cambridge, Ontario, Canada, and/or, Software AG (UK) Ltd., Derby, United Kingdom, and/or Software A.G. (Israel) Ltd., Or-Yehuda, Israel and/or their licensors.