Importing Knowledge Articles from Other Systems Using the Knowledge Uploader (Knowledge Import Tool)

this topic only applies to on premise customers it does not apply to cloud customers about the knowledge uploader (knowledge import tool) docid l713tyvcvdat5tgapwxbabout installing the knowledge uploader (knowledge import tool) docid l713tyvcvdat5tgapwxbinitially configuring and logging into the nxt knowledge import tool docid l713tyvcvdat5tgapwxbusing the nxt knowledge import tool docid l713tyvcvdat5tgapwxbinitially configuring and logging into the knowledge import tool docid l713tyvcvdat5tgapwxbusing the knowledge import tool docid l713tyvcvdat5tgapwxb about the knowledge uploader (knowledge import tool) you can import knowledge articles from classic, itsm, or a local or networked file application into currently has two knowledge import tools the knowledge import tool nxt (for nxt formats such as itsm or classic) and the knowledge import tool (to use with file systems) these tools are collectively called the knowledge uploader and are also called the knowledge import tool about installing the knowledge uploader (knowledge import tool) when you install , one of the components that you can choose to install is the knowledge uploader (also called the knowledge import tool) for complete information about installing , including the knowledge uploader (also called the knowledge import tool), see the installation and deployment guide for initially configuring and logging into the nxt knowledge import tool there are two knowledge tools this topic is about the nxt knowledge import tool and not the knowledge import tool after you have installed , including the knowledge uploader (also called the knowledge import tool), do the following to initially configure and log into the knowledge import tool nxt on the application where you installed , open the application called knowledge import tool nxt the application displays the nxt knowledge server configuration dialog box nxt knowledge server configuration dialog box enter information into the fields parameter description server version the version of the nxt server that you are taking the knowledge articles from to determine the server version, open the program and find the server information you can choose from any of the following knowledge service v5 0 4003 3 knowledge service plus v9 6 1 13 knowledge service plus v9 6 1 14 server address enter the following the protocol type (uses tcp by default) the server path of the nxt server that you are taking the knowledge articles from the port (uses 2242 by default) user name the user name of a person who can access the nxt server that you are taking the knowledge articles from password the password associated with the user name save password saves the password to change these settings after the initial configuration, from the menu bar select configuration > configure nxt server click continue the application displays the login dialog box knowledge server tool login enter information into the fields parameter description user name the user name of a person who can access password the password associated with the user tenant the tenant to log into you can select either configdb to log into the configuration database or heatsm to log into save password saves the password to change these settings after the initial configuration, from the menu bar select configuration > configure application server click continue the application displays the select role dialog box select the role to log in as and click continue the application displays the knowledge base upload tool page knowledge base upload tool using the nxt knowledge import tool there are two knowledge tools this topic is about the nxt knowledge import tool and not the knowledge import tool follow these steps to import knowledge into click select articles to select the knowledge articles to import the application displays the nxt articles selection dialog box expand the list to see where knowledge articles are located, and then highlight one or more articles select the knowledge articles to import click ok the application lists the selected articles on the bottom part of the page select the articles to upload and click upload to launch the article creation wizard and start the upload process the article creation wizard page contains two main areas a selected documents area on the left containing the list of files to import, and a document properties area on the right that contains two tabs one tab is called default values and the other is called selected documents to remove a document from the selected documents section, check it and click remove selected by default, the knowledge uploader imports all of the documents in the selected documents , even if you do not select them optionally, use the document properties section to specify the properties that the knowledge uploader displays together with the files in you can specify properties for all files (using the default values tab) or for individual files (using the selected document tab after highlighting the file in the selected documents section) you can specify these properties article type the article type select from document, error message, issue resolution, patch, q\&a, or reference article status the status of the article select from approved, draft, expired, failed review, pending review, published, or submitted target collection the target select from company policy & procedure, customer knowledge, internal knowledge, it knowledge, or service desk category the category for this knowledge article subject the subject of the article resolution the resolution details if the knowledge article contains this information description a description for the knowledge article click import the application starts importing the selected knowledge articles if you select a file that has already been imported into the knowledge base, the application displays the collision warning dialog box depending on what you want to do with the file that has already been imported, click one of the following apply for all applies your choice to all previously imported files that are found during the import process update overwrites the file that already exists in the knowledge base with the file that is being imported create new does not overwrite the file being imported with the file that already exists in the knowledge base after importing, there are two knowledge articles with the same name in the knowledge base cancel cancels the import process the application displays a dialog box with the status of the import click ok optionally, do the following review the import logs by clicking the log tab you can clear or save the log review the import history by clicking the import history tab click a number in the imported column to display more information about an import session initially configuring and logging into the knowledge import tool there are two knowledge tools this topic is about the knowledge import tool and not the nxt knowledge import tool after you have installed , including the knowledge uploader (also called the knowledge import tool), do the following to initially configure and log into the knowledge import tool on the application where you installed , open the application called knowledge import tool the application displays the select role dialog box select the role to log in as and click continue the application displays the knowledge base upload tool page knowledge base upload tool using the knowledge import tool there are two knowledge tools this topic is about the knowledge import tool and not the nxt knowledge import tool follow these steps to import knowledge into specify the article file type to search for, by doing the following a click the settings icon in the looking for section the application displays the file search filters dialog box b in the add new drop down list, select one or more file types microsoft office documents files that have doc, docx, xls, and xlsx extensions pdf files files that have a pdf extension images files that have bmp, jpg, and gif extensions c optionally, you can add more file types by clicking custom the application adds a line item to the filter list called custom click the line item to open it for editing you can change the filter name and specify one or more extensions click ok the application adds the file types that you specified to the looking for section specify which local or network folders to search for knowledge articles and then perform the search a click the settings icon in the in folders section the application displays the import folders dialog box b click add new the application displays the browse for folder navigation dialog box c navigate to a folder and highlight it (to optionally add a new subfolder to the folder, click make new folder ) d click ok the application adds the folder to the list of folders to search if you created a new folder, the application adds it to the file application as an empty folder e optionally, check recursive for a folder to specify that the application should search the subfolders within the folder f optionally, check monitor for changes to configure the knowledge uploader to monitor all of the folders on the list for changes to the file types that you specified in step 1b g repeat steps b f to continue to add folders to the list as necessary h click ok the knowledge uploader performs the search and displays all of the files that meet the search criteria select the files to upload a if you think the contents of the scanned folders might have changed, click rescan folders to regenerate the file list b in the file list, check the files to upload, or click select all to upload all of the files c click upload to launch the article creation wizard and start the upload process the article creation wizard page contains two main areas a selected documents area on the left containing the list of files to import, and a document properties area on the right that contains two tabs one tab is called default values and the other is called selected documents to remove a document from the selected documents section, check it and click remove selected by default, the knowledge uploader imports all of the documents in the selected documents , even if you do not select them optionally, use the document properties section to specify the properties that the knowledge uploader displays together with the files in you can specify properties for all files (using the default values tab) or for individual files (using the selected document tab after highlighting the file in the selected documents section) you can specify these properties article type the article type select from document, error message, issue resolution, patch, q\&a, or reference article status the status of the article select from approved, draft, expired, failed review, pending review, published, or submitted target collection the target select from company policy & procedure, customer knowledge, internal knowledge, it knowledge, or service desk category the category for this knowledge article use file name as subject check to use the article file name to fill in the subject field subject only use this field if you did not check use file name as subject enter a subject for the article resolution enter the resolution if the knowledge article contains one description enter a description for the knowledge article click import the import process begins if you select a file that has already been imported into the knowledge base, the application displays the collision warning dialog box depending on what you want to do with the file that has already been imported, click one of the following apply for all applies your choice to all previously imported files that are found during the import process update overwrites the file that already exists in the knowledge base with the file that is being imported create new does not overwrite the file being imported with the file that already exists in the knowledge base after importing, there are two knowledge articles with the same name in the knowledge base cancel cancels the import process the application displays an import dialog box with the status of the import click ok optionally, do the following review the import logs by clicking the log tab you can clear or save the log review the import history by clicking the import history tab click a number in the imported column to display more information about an import session