Create an Entity Using Gradle
You must create an entity before you can define the mappings between your source data and the publicly accessible data.
Before you begin
- Open a command-line window, and go to your project root directory.
- At your project root, run the Gradle task hubCreateEntity.
./gradlew hubCreateEntity -PentityName=your-entity-name -i gradlew.bat hubCreateEntity -PentityName=your-entity-name -i
- Edit the new entity definition in your-project-root/entities/your-entity-name.entity.json.
Important: By default, the entity type name is added to its file name at your-entity-name.entity.json. In the file, the entity type name is used for the entity type definition name and the value of
If you plan to use Hub Central, the file name, entity type definition name, and value of
$.info.titlemust use the same entity type name. Otherwise, you will be unable to view the properties for that entity type in Hub Central.Note: If a property is added to the value of
$.definitions.your-entity-name.required, the property should have a value; otherwise, the property will have a null value. If a property is required and has a null value, the property will not be indexed by SQL views.
Range indexes can be configured in entity definitions to improve performance. Learn more: Indexing in MarkLogic