lang::catalog::import_from_file (private)

 lang::catalog::import_from_file file_path

Defined in packages/acs-lang/tcl/lang-catalog-procs.tcl

Import messages for a certain locale and package from a given XML catalog file to the database. This procedure invokes lang::catalog::parse to read the catalog file and lang::message::register to register the messages with the system (updates database and cache).

The import should be considered an upgrade if the package has had messages imported before. In this case the proc lang::catalog::import_messages will be used to register the new messages with the system and handle the upgrade logic (a merge with what's in the database).

Parameters:
file_path (required)
The absolute path of the XML file to import messages from. The path must be on valid format, see apm_is_catalog_file
Returns:
An array list containing the number of messages processed, number of messages added, number of messages updated, and the number of messages deleted by the import. The keys of the array list are processed, added, updated, and deleted.
Author:
Peter Marklund
See Also:

Partial Call Graph (max 5 caller/called nodes):
%3 lang::catalog::import lang::catalog::import (public) lang::catalog::import_from_file lang::catalog::import_from_file lang::catalog::import->lang::catalog::import_from_file ad_log ad_log (public) lang::catalog::import_from_file->ad_log ad_try ad_try (public) lang::catalog::import_from_file->ad_try apm_parse_catalog_path apm_parse_catalog_path (public) lang::catalog::import_from_file->apm_parse_catalog_path lang::catalog::assert_catalog_file lang::catalog::assert_catalog_file (private) lang::catalog::import_from_file->lang::catalog::assert_catalog_file lang::catalog::import_messages lang::catalog::import_messages (private) lang::catalog::import_from_file->lang::catalog::import_messages

Testcases:
No testcase defined.
[ show source ]
Show another procedure: