# Dynamic field behaviour

## Feature

Use dynamic fields controlled by you in code

Useful when use a unified collection and isolate your tenant by a prefix/suffix in each field

## How to

1. You need prepare your SOLR collection with dynamic fields, to do this, follow steps in [**SOLR wiki**](https://cwiki.apache.org/confluence/display/solr/Dynamic+Fields)
2. Choose one or more approachs:

   2.1. Using global settings (see \</tutorials/global-settings> to more informations), than all searchs will use **prefix** and/or **suffix** setted in global settings (useful when you know your tenant in app startup)

   2.1.1. Set global settings

   ```csharp
       services
           .AddSolrExpress<TechProduct>(builder => builder
               .UseOptions(options =>
               {
                   // ... Other settings
                   options.GlobalDynamicFieldPrefix = "my_prefix_",
                   options.GlobalDynamicFieldSuffix = "_my_suffix"
               })
               // ...  Other settings
               );
   ```

   2.1.2. Optionally, set global settings for specific field

   ```csharp
       using SolrExpress.Search.Behaviour.Extension;

       services.AddSolrExpress<TechProduct>(q => q
           .ChangeDynamicFieldBehaviour(q => q.Manufacturer, prefixName: "my_prefix_", suffixName: "_my_suffix")
           // ...  Other settings
           );
   ```

   2.1.3. Change your class that represent your collection, extend **Document** (see \</tutorials/getting-started> to more informations), set dynamic field in **SolrFieldAttribute**, like below:

   ```csharp
   public class MyDocument : Document
   {
       [SolrField("myfield_s", IsDynamicField = true)]
       public string MyField { get; set; }
   }
   ```

   2.2. Using settings to each search, than only this search will use **prefix** and/or **suffix** (useful when you know your tenant only in after some process)

   2.2.1. Set settings in your search

   ```csharp
       using SolrExpress.Search.Behaviour.Extension;

       DocumentSearch<TechProduct> documentSearch; // From your DI provider
       documentSearch
           .ChangeDynamicFieldBehaviour(q => q.Manufacturer, prefixName: "my_prefix_", suffixName: "_my_suffix")
           // ...  Other settings
           .Execute();
   ```

   2.2.2. Change your class that represent your collection, extend **Document** (see \</tutorials/getting-started> to more informations), set dynamic field in **SolrFieldAttribute**, like below:

   ```csharp
       public class MyDocument : Document
       {
           [SolrField("myfield_s", IsDynamicField = true)]
           public string MyField { get; set; }
       }
   ```

   2.3. Using settings to each field, than all searchs will use **prefix** and/or **suffix** setted in field settings (useful when you know your tenant in hard code)

   2.3.1. Change your class that represent your collection, extend **Document** (see \</tutorials/getting-started> to more informations), set settings in **SolrFieldAttribute**, like below:

   ```csharp
       public class MyDocument : Document
       {
           [SolrField("myfield_s", IsDynamicField = true, DynamicFieldPrefixName = "my_prefix_", DynamicFieldSuffixName = "_my_suffix")]
           public string MyField { get; set; }
       }
   ```

### NOTE

See another example in issue [**206**](https://github.com/solr-express/solr-express/issues/206#issuecomment-294005085);