{"type":"doc","content":[{"type":"paragraph","content":[{"text":"The direct links feature is not integrated by default into Datafari. You have to activate it by doing few steps that we will explain here.","type":"text"}]},{"type":"paragraph","content":[{"text":"The direct link feature allows the user to display a graphical widget related to his query.","type":"text"}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":325,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":325,"id":"a5fba970-cf9a-4c7b-b99a-a4c6ed8da177","collection":"contentId-3398008836","type":"file","height":227}}]},{"type":"paragraph","content":[{"text":"To activate it, you have to do modifications into Datafari, Solr and activate the widget into DatafariUI.","type":"text"}]},{"type":"paragraph","content":[{"text":"1.Datafari part","type":"text"}]},{"type":"paragraph","content":[{"text":"First you have to authorize a new search handler into the datafari.properties file. So edit the file : ","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"nano $DATAFARI_HOME/tomcat/conf/datafari.properties","type":"text"}]},{"type":"paragraph","content":[{"text":"And add ","type":"text"},{"text":"/select_directlinks ","type":"text","marks":[{"type":"em"}]},{"text":"into the userAllowedHandlers property : ","type":"text"}]},{"type":"codeBlock","content":[{"text":"userAllowedHandlers=/select_directlinks","type":"text"}]},{"type":"paragraph","content":[{"text":"You need to restart Datafari : ","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"cd $DATAFARI_HOME/bin\nbash restart-datafari.sh","type":"text"}]},{"type":"paragraph"},{"type":"orderedList","attrs":{"order":2},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Solr part","type":"text"}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add fields into the schema","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"To do that, you need to edit the file custom_fields.incl into $DATAFARI_HOME/solr/solrcloud/FileShare/conf/customs_schema : ","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"nano $DATAFARI_HOME/solr/solrcloud/FileShare/conf/customs_schema/custom_fields.incl ","type":"text"}]},{"type":"paragraph","content":[{"text":"And add : ","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"name\":\"directlinks_title\",\n \"type\":\"text_fr\",\n \"indexed\":true,\n \"stored\":true\n}\n&&\n{\n \"name\":\"directlinks_link\",\n \"type\":\"text_fr\",\n \"indexed\":true,\n \"stored\":true\n}\n&&\n{\n \"name\":\"directlinks_description\",\n \"type\":\"text_fr\",\n \"multiValued\":true,\n \"indexed\":true\n \"stored\":true\n}\n&&\n{\n \"name\":\"directlinks_icon\",\n \"type\":\"string\",\n \"stored\":true\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Then you need to send the modifications the changes to Solr by executing the script addCustomSchemaInfo.sh into the same folder : ","type":"text"}]},{"type":"codeBlock","content":[{"text":"cd $DATAFARI_HOME/solr/solrcloud/FileShare/conf/customs_schema\nbash addCustomSchemaInfo.sh","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"We did the modifications on the schema we can now do the modifications into solrconfig. ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add the configuration of a new handler","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Edit the file custom_search_handler.incl into $DATAFARI_HOME/solr/solrcloud/FileShare/conf/customs_solrconfig : ","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"nano $DATAFARI_HOME/solr/solrcloud/FileShare/conf/customs_solrconfig/custom_search_handler.incl","type":"text"}]},{"type":"paragraph","content":[{"text":"And add this handler : ","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n explicit\n edismax\n directlinks_title^50 directlinks_description^30 directlinks_link^20\n directlinks_title^500 directlinks_description^300 directlinks_link^200\n 10\n true\n true\n 1\n true\n 1\n true\n on\n unified\n false\n <span class=\"em\">\n </span>\n content_fr content_en content_de content_es exactContent\n true\n WORD\n html\n 200\n 51200\n 1\n \n \n\n \n spellcheck\n elevator\n \n \n\n \n {!manifoldCFSecurity}\n repo_source:directlinks\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"You can customize the configuration if you need to.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Modify the main search handler configuration (/select) : ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":" – Comment or Delete the /select configuration into solrconfig.xml located into $DATAFARI_HOME/solr/solrcloud/FileShare/conf","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"nano $DATAFARI_HOME/solr/solrcloud/FileShare/conf/solrconfig.xml","type":"text"}]},{"type":"paragraph","content":[{"text":"Copy all the /select handler section into the file and comment it or delete it : ","type":"text"}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1016,"id":"9bc7813a-9c7c-4b3b-a6f5-56e8c5f59ce8","collection":"contentId-3398008836","type":"file","height":99}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":" – Copy the select handler configuration that you just commented or deleted and paste it into the file custom_search_handler.incl located into $DATAFARI_HOME/solr/solrcloud/FileShare/conf/customs_solrconfig :","type":"text"}]},{"type":"codeBlock","content":[{"text":"nano $DATAFARI_HOME/solr/solrcloud/FileShare/conf/customs_solrconfig/custom_search_handler.incl","type":"text"}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1247,"id":"e5049cc0-d287-49b8-8b88-49f80e4e6eab","collection":"contentId-3398008836","type":"file","height":759}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":" – Do a change into this configuration before saving the file : ","type":"text"}]},{"type":"paragraph","content":[{"text":"You need to add a fq line into appends section of the file : ","type":"text"}]},{"type":"codeBlock","content":[{"text":"-repo_source:directlinks","type":"text"}]},{"type":"paragraph","content":[{"text":"So all the section is like that : ","type":"text"}]},{"type":"codeBlock","content":[{"text":" \n {!manifoldCFSecurity}\n -repo_source:directlinks\n ","type":"text"}]},{"type":"paragraph","content":[{"text":"This is now the entire file : ","type":"text"}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1221,"id":"0c823b9b-c7c4-498a-acd8-b287e81b1357","collection":"contentId-3398008836","type":"file","height":771}}]},{"type":"paragraph","content":[{"text":"We have now to push this configuration to Solr, for this use the Datafari admin UI : ","type":"text"},{"type":"hardBreak"},{"text":" - Go to Search Engine Configuration → System Configuration Manager","type":"text"}]},{"type":"paragraph","content":[{"text":"Then click into Push button then Apply button : ","type":"text"}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1792,"id":"84a7964b-30e8-41d4-a3d0-00448d782196","collection":"contentId-3398008836","type":"file","height":889}}]},{"type":"paragraph","content":[{"text":" – Check the Solr admin UI to see if there are any errors : ","type":"text"}]},{"type":"paragraph","content":[{"text":"Go to Solr admin UI then into Logging menu : ","type":"text"}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1784,"id":"ad54ae1b-9cdf-4355-9caa-8501e5a60c2d","collection":"contentId-3398008836","type":"file","height":432}}]},{"type":"paragraph","content":[{"text":"If all seems correct, we can add some data now !","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add some data for direct links","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The easiest is to use CSV format. Create a CSV file with the data and upload it to Solr.","type":"text"}]},{"type":"paragraph","content":[{"text":" – Create the CSV file","type":"text"}]},{"type":"paragraph","content":[{"text":"Create the file whereever you want into the Datafari server. In our example it will be into /var/datafari : ","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"nano /var/datafari/directlinks.csv","type":"text"}]},{"type":"paragraph","content":[{"text":"This is an example of data : ","type":"text"}]},{"type":"codeBlock","content":[{"text":"id,title,content_fr,url,directlinks_title,directlinks_link,directlinks_description,directlinks_icon,repo_source,content,content_en,preview_content,exactContent\ndirectlinks1,directlinks1,directlinks1,directlinks1,Titre du lien 1,https://www.francelabs.com,Description de France Labs,https://localhost/datafariui/images/logo.png,directlinks,notext,notext,notext,notext\ndirectlinks2,directlinks2,directlinks2,directlinks2,Titre du lien 2,https://www.datafari.com,Description de Datafari,https://localhost/datafariui/images/logo.png,directlinks,notext,notext,notext,notext","type":"text"}]},{"type":"paragraph","content":[{"text":" – Then send it to Solr : ","type":"text"}]},{"type":"codeBlock","content":[{"text":"cd /var/datafari\ncurl 'http://localhost:8983/solr/FileShare/update?commit=true&escape=\\' --data-binary @./directlinks.csv -H 'Content-type:application/csv'","type":"text"}]},{"type":"paragraph","content":[{"text":"You need to adapt the Solr URL if you are into multiservers mode into Datafari EE.","type":"text"}]},{"type":"paragraph"},{"type":"orderedList","attrs":{"order":3},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DatafariUI part","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"It is the simplest part, you just have to activate the widget into your ui-config.json file located into $DATAFARI_HOME/www/ : ","type":"text"}]},{"type":"codeBlock","content":[{"text":"nano $DATAFARI_HOME/www/ui-config.json","type":"text"}]},{"type":"paragraph","content":[{"text":"And change the property show to true instead of false for the direct links widget : ","type":"text"}]},{"type":"codeBlock","content":[{"text":" {\n \"type\": \"DirectLinksWidget\",\n \"title\": \"Direct Links\",\n \"show\": true,\n \"visible\": 1\n }, ","type":"text"}]},{"type":"paragraph","content":[{"text":"And voilà ! Your widget should be displayed into your Datafari UI now : ","type":"text"}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1780,"id":"6092fe63-acf4-4de6-8ec1-69a801374a29","collection":"contentId-3398008836","type":"file","height":352}}]},{"type":"paragraph"}],"version":1}

Browser not supported