{"type":"doc","content":[{"type":"paragraph","content":[{"text":"The yellow pages 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 yellow pages feature allows the user to display a graphical widget related to user information like from a directory.","type":"text"}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":250,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":250,"id":"0bff2c1e-87e7-4b30-a4e9-9fecf2cd6ae9","collection":"contentId-3399450625","type":"file","height":232}}]},{"type":"paragraph"},{"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_directory","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\":\"directory_name\",\n \"type\":\"text_fr\",\n \"indexed\": true,\n \"stored\":true \n}\n&&\n{\n \"name\":\"directory_firstnames\",\n \"type\":\"text_fr\",\n \"indexed\": true,\n \"stored\":true\n}\n&&\n{\n \"name\":\"directory_role\",\n \"type\":\"text_fr\",\n \"indexed\": true,\n \"stored\":true \n}\n&&\n{\n \"name\":\"directory_phone\",\n \"type\":\"text_fr\",\n \"indexed\": true,\n \"stored\":true \n}\n&&\n{\n \"name\":\"directory_email\",\n \"type\":\"text_fr\",\n \"indexed\": true,\n \"stored\":true \n}\n&&\n{\n \"name\":\"directory_picture\",\n \"type\":\"text_fr\",\n \"indexed\": true,\n \"stored\":true \n}\n&&\n{\n \"name\":\"directory_expertise\",\n \"multiValued\":true,\n \"type\":\"text_fr\",\n \"indexed\": true,\n \"stored\":true \n}\n&&\n{\n \"name\":\"directory_socialnetworks\",\n \"multiValued\":true,\n \"type\":\"text_fr\",\n \"indexed\": true,\n \"stored\":true \n}\n&&\n{\n \"name\":\"directory_department\",\n \"type\":\"text_fr\",\n \"indexed\": true,\n \"stored\":true \n}\n&&\n{\n \"name\":\"directory_location\",\n \"type\":\"text_fr\",\n \"indexed\": true,\n \"stored\":true \n}\n&&\n{\n \"name\":\"directory_type\",\n \"type\":\"text_fr\",\n \"indexed\": true,\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","marks":[{"type":"breakout","attrs":{"mode":"wide"}}],"content":[{"text":"\n \n explicit\n edismax\n directory_name directory_firstnames directory_role directory_phone directory_email directory_expertise directory_socialnetworks directory_department directory_location\n directory_name directory_firstnames directory_role directory_phone directory_email directory_expertise directory_socialnetworks directory_department directory_location\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:directory\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":"aa5db857-5212-44cc-ad22-3cee1bb03c43","collection":"contentId-3399450625","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":"c3914c83-6480-4cf0-91b5-fac57dacd779","collection":"contentId-3399450625","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:directory","type":"text"}]},{"type":"paragraph","content":[{"text":"So all the section is like that : ","type":"text"}]},{"type":"codeBlock","content":[{"text":" \n {!manifoldCFSecurity}\n -repo_source:directory\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":1216,"id":"dbab842e-6cd5-4ca0-8d96-022d6244c906","collection":"contentId-3399450625","type":"file","height":804}}]},{"type":"paragraph"},{"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":"2b1f3f8c-de37-4f64-ac49-069347efa1bc","collection":"contentId-3399450625","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":"f1704431-6c2c-4233-98ed-989d4e2baf8d","collection":"contentId-3399450625","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/directory.csv","type":"text"}]},{"type":"paragraph","content":[{"text":"This is an example of data : ","type":"text"}]},{"type":"codeBlock","content":[{"text":"id,title,content_fr,url,directory_name,directory_firstnames,directory_role,directory_phone,directory_email,directory_picture,directory_expertise,directory_socialnetworks,directory_department,directory_location,directory_type,repo_source,content,content_en,preview_content,exactContent\ndirectory1,directory1,directory1,directory1,durand,jean,CEO,0111223344,jean.durand@acme.company,https://www.acme.com/1,business,durand1,CEO,Paris,personne,directory,notext,notext,notext,notext\ndirectory2,directory2,directory2,directory2,bertrand,eric,ingenieur,0233445566,eric.bertrand@acme.company,https://www.acme.com/2,business,bertranddu69,informatique,Nice,personne,directory,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 @./directory.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 yellow pages widget : ","type":"text"}]},{"type":"codeBlock","content":[{"text":" {\n \"type\": \"YellowPagesWidget\",\n \"title\": \"Yellow Pages\",\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":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1683,"id":"27db8adf-48d4-4c45-9bc7-4ff90f752e39","collection":"contentId-3399450625","type":"file","height":814}}]},{"type":"paragraph"}],"version":1}