Troubleshooting

Tip: See the Support Knowledgebase for up-to-date information on active bugs and their workarounds.

I cannot modify the document URI during ingestion.

If you use the REST tier through DMSDK, Gradle, or a POST request for ingestion, the document metadata (including the URI and security permissions) cannot be modified during ingestion.

Workarounds:
  • Use MLCP to ingest.
  • Modify the metadata of the ingested record in another step (mapping or custom).

In Hub Central, I cannot view properties because the definition cannot be found for an entity type.

If an entity type definition name does not match the entity type name in $.info.title and its file name (your-entity-name.entity.json), the properties for that entity type will not display in Hub Central.

Fix:
  1. Open the *.entity.json file for the entity type whose properties do not display in Hub Central. The file is located at your-project-root/entities/your-entity-name.entity.json.
    1. Edit the value of $.info.title, entity type definition name, and file name to use the same entity type name.
      Example *.entity.json file named Customer.entity.json
       
      {
          "info": {
              "baseUri": "http://example.org/",
              "title": "Customer",
              "version": "0.0.1"
          },
          "definitions": {
              "Customer": {
                  "primaryKey": "customerId",
                  "properties": {
                      "customerId": {
                          "datatype": "integer",
                          "sortable": true
                      },
                      "name": {
                          "collation": "http://marklogic.com/collation/codepoint",
                          "datatype": "string"
                      }
                  },
                  "required": [
                      "name"
                  ]
              }
          }
      }
      
  2. Open the *.step.json files for the Mapping, Matching, Merging, and Custom steps. The files are located at your-project-root/steps/step-name.step.json.
    1. Edit the value of targetEntity to use the same entity type name as the your-entity-name.entity.json file.
  3. Deploy project artifacts to your environment.