Note: You are currently viewing documentation for Moodle 3.11. Up-to-date documentation for the latest stable version of Moodle may be available here: Import glossary entries.

Import glossary entries: Difference between revisions

From MoodleDocs
Main page ► Managing a Moodle course ► Activities ► Glossary activity ► Import glossary entries
Glossary activity
(content moved from Importing/exporting glossaries)
 
 
(53 intermediate revisions by 15 users not shown)
Line 1: Line 1:
{{Glossaries}}
{{Glossary}}Glossary entries can be exported and then imported into another glossary via an XML file.
This allows you to import glossaries that have been exported from other glossaries. To import entries, select the XML file on your own computer which contains the entries to import (using the Browse button).
==Importing glossary entries==
*As an editing teacher (or administrator or manager), access your glossary
*With the Boost theme, click the cog/gear icon on the right and then click 'Import entries'. With non-Boost themes such as Classic, go to ''Administration > Glossary administration > Import entries


The Destination field allows you to define the destination of imported entries. You can specify whether you want to import entries to ''Current Glossary'' (which will append the imported entries to the currently open glossary) or ''New Glossary'' (which will create a new glossary based on the information found in the selected import file and will insert the new entries into it).  
*Click the "Choose a file" button and browse for the exported entries XML file on your computer
*Select the destination for the new entries: either the current glossary or a new one
*If you want to import category information, click the checkbox.
*Click the "Submit" button.
[[File:ImportGlossaryEntries.jpg]]


If you check the Import categories box, you will import not only the entries but also the categories the new entries will be assigned to.
You'll then see a report of the entries and categories added to the glossary. If you enabled duplicate entries when you created the glossary, the import process will add all of the new definitions. Otherwise, it will not allow you to import any duplicate entries.


Import format example:
You will be listed as author of all the entries.
 
<pre><?xml version="1.0" encoding="utf-8"?>
<GLOSSARY>
    <INFO>
        <NAME>Latest Glossary</NAME>
        <INTRO>Glossary of topics relevant to all Students and Staff</INTRO>
        <STUDENTCANPOST>0</STUDENTCANPOST>
        <ALLOWDUPLICATEDENTRIES>0</ALLOWDUPLICATEDENTRIES>
        <DISPLAYFORMAT>dictionary</DISPLAYFORMAT>
        <SHOWSPECIAL>1</SHOWSPECIAL>
        <SHOWALPHABET>1</SHOWALPHABET>
        <SHOWALL>1</SHOWALL>
        <ALLOWCOMMENTS>0</ALLOWCOMMENTS>
        <USEDYNALINK>1</USEDYNALINK>
        <DEFAULTAPPROVAL>1</DEFAULTAPPROVAL>
        <GLOBALGLOSSARY>1</GLOBALGLOSSARY>
        <ENTBYPAGE>20</ENTBYPAGE>
        <ENTRIES>
                <ENTRY>             
                <CONCEPT>Bullying</CONCEPT>
                <DEFINITION>Bullying is bad</DEFINITION>
                <FORMAT>1</FORMAT>
                <USEDYNALINK>0</USEDYNALINK>
                <CASESENSITIVE>0</CASESENSITIVE>
                <FULLMATCH>0</FULLMATCH>
                <TEACHERENTRY>1</TEACHERENTRY>
                <ALIASES>
                    <ALIAS>
                        <NAME>harrassment</NAME>
                    </ALIAS>
                </ALIASES>
                <CATEGORIES>
                    <CATEGORY>
                        <NAME>Behaviour</NAME>
                        <USEDYNALINK>1</USEDYNALINK>
                    </CATEGORY>
                </CATEGORIES>
            </ENTRY>
            <ENTRY>
                <CONCEPT>Friendship</CONCEPT>
                <DEFINITION>Friendship is good</DEFINITION>
                <FORMAT>1</FORMAT>
                <USEDYNALINK>0</USEDYNALINK>
                <CASESENSITIVE>0</CASESENSITIVE>
                <FULLMATCH>0</FULLMATCH>
                <TEACHERENTRY>1</TEACHERENTRY>
                <ALIASES>
                    <ALIAS>
                        <NAME>friend</NAME>
                    </ALIAS>
                </ALIASES>
                <CATEGORIES>
                    <CATEGORY>
                        <NAME>Social</NAME>
                        <USEDYNALINK>1</USEDYNALINK>
                    </CATEGORY>
                </CATEGORIES>
            </ENTRY>
        </ENTRIES>
    </INFO>
</GLOSSARY></pre>
 
Copy each section beginning <ENTRY> and ending with </ENTRY> and edit the entry.
 
Notes:
 
*You can only import the XML file from within a glossary that already exists but you can import to a new glossary.
*In experimenting with import I have found that the import will fail often. Some reasons appear to be:-
**If there are mistakes in the XML file such as the <entries> tag being missing or the <info> tag being in the wrong place. May happen if you have constructed the XML file manually or with some sort of tool like mailmerge in Word and your template is wrong.
**If there are top bit set characters in the text of the entities like concepts, definitions or keywords. Replace things like & with &amp;amp;
**If there are tabs or spaces between entries. Not sure if spaces cause problems but best to remove any between the end of one tag and start of the next. e.g. Search and replace > < with >< via a text editor.
*In most cases the import is halted if any of these errors occur.
*Duplicates in the entries which clash with entries already when merging a glossary is usually not a problem.
*Warnings like <code>Warning: exec() has been disabled for security reasons in /moodle/lib/uploadlib.php on line 603</code> may not be the problem when importing but may distract one from dealing with problems with the format of the XML file.
 
There are two ways to import glossaries:
 
#Restoring the glossaries from a Moodle course backup file containing the glossary. This method includes categories, images and attachments within glossary entries and if you also select users then the authors of entries are also imported if they were originally included in the backup.
#Importing a specially formatted XML file in glossary format. This method only imports text, some HTML formatting and switches such as auto-linking, case specific and whole words linking. There is also a switch to import categories into which entries are automatically included.


If your exported glossary included embedded images and/or attached files, these will also be imported into the new glossary.
== Troubleshooting ==
Possible causes of problems importing entries:
* If there are mistakes in the XML file such as the <entries> tag being missing or the <info> tag being in the wrong place. May happen if you have constructed the XML file manually or with some sort of tool like mailmerge in Word and your template is wrong.
* If there are top bit set characters in the text of the entities like concepts, definitions or keywords. Replace things like & with &amp;amp;
* If there are tabs or spaces between entries. Not sure if spaces cause problems but best to remove any between the end of one tag and start of the next. e.g. Search and replace > < with >< via a text editor.
* In most cases the import is halted if any of these errors occur.
* Duplicates in the entries which clash with entries already when merging a glossary is usually not a problem.
* Warnings like <code>Warning: exec() has been disabled for security reasons in /moodle/lib/uploadlib.php on line 603</code> may not be the problem when importing but may distract one from dealing with problems with the format of the XML file.
* HTML and XHTML tags written within CONCEPT or DEFINITION elements will fail on import, showing "Array" instead of the desired content. To remedy this, try writing the (X)HTML tags within <![CDATA[ ]]> markup.
* If the glossary entries contain images, image paths will need amending by doing a search and replace in the XML file in order for the images to be displayed when the file is imported.
==Restoring a glossary activity backup==
An alternative method of importing glossary entries is to restore a glossary [[Activity backup|activity backup]] containing enrolled users. This method includes categories, images and attachments within glossary entries. When the glossary is restored, the authors of the entries will be the same as in the original glossary.
== See also ==
== See also ==
 
* [https://vletools.herokuapp.com/converter/glossary Moodle Glossary XML Convertor]
*[http://moodle.org/mod/forum/discuss.php?d=10570 Importing glossaries in WebCT format] forum discussion
* Glossary - Excel to XML converter [http://www.eaglesvn.com/xml.html]
 
* [http://moodle.org/mod/glossary/view.php?id=851 Glossary of common terms] with entries download link for importing to other Moodle sites
* [[Import and export FAQ]]
* [[Moodle glossary entries format]] can use the question bank to convert a variety of formats into an xml glossary file for import
Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=79120 Excel to Glossaries]
*[http://moodle.org/mod/forum/discuss.php?d=142346 Backup a glossary]
*[http://moodle.org/mod/forum/discuss.php?d=123277 Importing into Moodle] contains an explanation of how to manually create an XML file from an Excel spreadsheet
[[de:Glossar erstellen#Glossareinträge_importieren]]
[[es:Importar entradas del glosario]]
[[fr:Importer/exporter un glossaire]]
[[fr:Importer/exporter un glossaire]]

Latest revision as of 13:29, 15 February 2022

Glossary entries can be exported and then imported into another glossary via an XML file.

Importing glossary entries

  • As an editing teacher (or administrator or manager), access your glossary
  • With the Boost theme, click the cog/gear icon on the right and then click 'Import entries'. With non-Boost themes such as Classic, go to Administration > Glossary administration > Import entries
  • Click the "Choose a file" button and browse for the exported entries XML file on your computer
  • Select the destination for the new entries: either the current glossary or a new one
  • If you want to import category information, click the checkbox.
  • Click the "Submit" button.

ImportGlossaryEntries.jpg

You'll then see a report of the entries and categories added to the glossary. If you enabled duplicate entries when you created the glossary, the import process will add all of the new definitions. Otherwise, it will not allow you to import any duplicate entries.

You will be listed as author of all the entries.

If your exported glossary included embedded images and/or attached files, these will also be imported into the new glossary.

Troubleshooting

Possible causes of problems importing entries:

  • If there are mistakes in the XML file such as the <entries> tag being missing or the <info> tag being in the wrong place. May happen if you have constructed the XML file manually or with some sort of tool like mailmerge in Word and your template is wrong.
  • If there are top bit set characters in the text of the entities like concepts, definitions or keywords. Replace things like & with &amp;
  • If there are tabs or spaces between entries. Not sure if spaces cause problems but best to remove any between the end of one tag and start of the next. e.g. Search and replace > < with >< via a text editor.
  • In most cases the import is halted if any of these errors occur.
  • Duplicates in the entries which clash with entries already when merging a glossary is usually not a problem.
  • Warnings like Warning: exec() has been disabled for security reasons in /moodle/lib/uploadlib.php on line 603 may not be the problem when importing but may distract one from dealing with problems with the format of the XML file.
  • HTML and XHTML tags written within CONCEPT or DEFINITION elements will fail on import, showing "Array" instead of the desired content. To remedy this, try writing the (X)HTML tags within <![CDATA[ ]]> markup.
  • If the glossary entries contain images, image paths will need amending by doing a search and replace in the XML file in order for the images to be displayed when the file is imported.

Restoring a glossary activity backup

An alternative method of importing glossary entries is to restore a glossary activity backup containing enrolled users. This method includes categories, images and attachments within glossary entries. When the glossary is restored, the authors of the entries will be the same as in the original glossary.

See also

Using Moodle forum discussions:

Retrieved from "https://docs.moodle.org/311/en/index.php?title=Import_glossary_entries&oldid=143123"
Powered by MediaWiki