The subject technology relates generally to content management, and more particularly to migrate configuration changes in enterprise content management.
Enterprise content management systems are highly configurable. Before starting to use an enterprise content management system, a customer may configure it per its business requirements, or business processes, by creating some customizations on top of out of the box features. The customizations may be, e.g., adding document types or creating custom objects. The customized content management system may be tested in a sandbox environment, and then be cloned into a production environment. When new business requirements come in, the customer needs to determine how to change the configuration of the existing content management system to satisfy the new business requirements, and implement new configurations on top of the existing content management system in a test environment. The customer then needs to test and validate the new configurations, and migrate the new configurations to the actual production system. At this point, the customer can no longer clone the new configurations, since that may disturb operation of the actual production system and overwrite data in the actual production system. Therefore, it is desirable to provide a method to migrate the configuration changes over to the actual production system in a way that preserves the production data.
The disclosed subject matter relates to a method for migrating configuration changes to a target content management system. The method comprises: generating a source component directory for a source system, wherein the source component directory comprises configuration objects in the source system. The method further comprises: determining configuration changes from the source system by identifying differences between the source component directory and a target component directory, wherein the target component directory comprises configuration objects in the target system. The method further comprises: generating a changed component package based on the differences between the source component directory and the target component directory; and sending the changed component package from the source system to the target system.
The detailed description set forth below is intended as a description of various configurations of the subject technology and is not intended to represent the only configurations in which the subject technology may be practiced. The appended drawings are incorporated herein and constitute a part of the detailed description. The detailed description includes specific details for the purpose of providing a thorough understanding of the subject technology. However, the subject technology is not limited to the specific details set forth herein and may be practiced without these specific details. In some instances, well-known structures and components are shown in block diagram form in order to avoid obscuring the concepts of the subject technology.
The user computing devices 120a-120n may be any machine or system that is used by a user to access the content management system 110 via the network 150, and may be any commercially available computing devices including laptop computers, desktop computers, mobile phones, smart phones, tablet computers, netbooks, and personal digital assistants (PDAs).
The content management server 112 is typically a remote computer system accessible over a remote or local network, such as the network 150. Various code in the content management server 112 may commit data (e.g., customer data) to the search platform 113 to make the data visible to users of the content management system 110. The content management server 112 may have a production system 115 for running the actual existing content management configurations, a test system 116 for testing new content management configurations, and/or a configuration migration controller 117 for controlling the configuration migration from the test system 116 to the production system 115. The configurations are metadata and may comprise one or more applications. It should be appreciated that the production system 115, the test system 116 and the migration controller 117 may be in separate servers. A user may test and validate new configurations in the test system 116, and the migration controller 117 may control migration of the new configurations from the test system 116 to the production system 115.
The database management system 111 may be a relational database management system, and may store data and metadata of documents and/or objects in the file storage system 114. Data may be taken out of the database management system 111, processed and sent to a denormalized dataset store (e.g., the search platform 113) to make it easier to search and retrieve. Consequently, the content management server 112 may interact with the persistent data, which is a combination of the database management system 111 and the search platform 113. In one implementation, the database management system 111 may be a MySQL system.
The file storage system 114 may store documents and/or objects.
In one implementation, the content management system 110 may be a multi-tenant system where various elements of hardware and software may be shared by one or more customers. For instance, a server may simultaneously process requests from a plurality of customers, and the content management system 110 may store content for a plurality of customers. In a multi-tenant system, a user is typically associated with a particular customer. In one example, a user could be an employee of one of a number of pharmaceutical companies which are tenants, or customers, of the content management system 110.
In one embodiment, the content management system 110 may run on a cloud computing platform. Users can access content on the cloud independently by using a virtual machine image, or purchasing access to a service maintained by a cloud database provider.
In one embodiment, the content management system 110 may be provided as Software as a Service (“SaaS”) to allow users to access the content management system 110 with a thin client.
The processing unit 201 may be configured to execute computer instructions that are stored in a computer-readable medium, for example, the system memory 202. The processing unit 201 may be a central processing unit (CPU).
The system memory 202 typically includes a variety of computer readable media which may be any available media accessible by the processing unit 201. For instance, the system memory 202 may include computer storage media in the form of volatile and/or nonvolatile memory such as read only memory (ROM) and/or random access memory (RAM). By way of example, but not limitation, the system memory 202 may store instructions and data, e.g., an operating system, program modules, various application programs, and program data.
A user can enter commands and information to the computing device 200 through the input device 203. The input device 203 may be, e.g., a keyboard, a touchscreen input device, a touch pad, a mouse, a microphone, and/or a pen.
The computing device 200 may provide its output via the output device 204 which may be, e.g., a monitor or other type of display device, a speaker, or a printer.
The computing device 200, through the network interface 205, may operate in a networked or distributed environment using logical connections to one or more other computing devices, which may be a personal computer, a server, a router, a network PC, a peer device, a smart phone, or any other media consumption or transmission device, and may include any or all of the elements described above. The logical connections may include a network (e.g., the network 150) and/or buses. The network interface 205 may be configured to allow the computing device 200 to transmit and receive data in a network, for example, the network 150. The network interface 205 may include one or more network interface cards (NICs).
The present invention uses a metadata definition language (“MDL”) to configure content management systems without disturbing operation of the content management system. Main functions of the MDL may include: providing a list of MDL enabled components, with each of the components the MDL functions described below can be invoked; describing an MDL component; define the metadata for each MDL component; exporting an MDL component by retrieving its definition; and importing configuration of one or more components by manipulating their definitions.
MDL components define the model that holds the data for content management system configurations. Each component may contain a set of attributes and optionally further sub-components. The attributes define the data type and validation rules which are enforced when values are set into the attributes. The present invention provides a component metadata framework with which the components could get annotated and the shape and validation rules of the components could be dynamically acquired by client applications and an MDL parser. In one implementation, the component metadata framework may define the metadata for each component consisting of the following:
The framework defines the metadata for each of the component attributes consisting of the following:
The framework may define the metadata for each component's sub-components consisting of the following:
Table 4 shows an example of an MDL component, Doctype.
The present invention may retrieve the definition of a component by requesting the associated RECREATE statement for a component. The content management configuration may include other components, e.g., Document Attributes, Lifecycle, Workflows and Objects.
Below is an example of component metadata for the Docfield component type:
MDL provides a number of application programming interfaces (“APIs”) as tools. One API may have a Describe function for generating information about the existing configuration in order for the API to generate or create a command. One example Execute API may allow the user to execute a command or a set of commands grouped together into a script. Other APIs may include a Component Shape API, an Error API, and a directory of component API.
MDL provides a number of commands, including RECREATE, CREATE, ALTER, DROP, RENAME, or COMMIT, as will be discussed in detail below.
RECREATE is a command to recreate a source system (e.g., the test system 140) component on the target system (e.g., the production system 160). When there is a description of a source system component and the same component has been deployed to the target system, and the source system makes some modifications to the source system component (e.g., adding a couple of new fields, removing a couple of existing fields, and changing the configuration of one of the existing fields), the RECREATE command may be created and applied to make sure that the target system looks exactly the same as the source system after the migration. In one implementation, the RECREATE statement syntax is as follows:
RECREATE Componenttype may either create a new component instance or alter an existing component instance (identified by the name) such that the final component instance contains the exact data as specified in the RECREATE command.
The attribute_value is represented depending on the datatype it stores. For example, the number values are represented as attribute_name(37):
Supported Data Type for Attribute Values:
String: (‘string value’)
Number: (37)
Boolean: (true)
List/Array: (‘elem1’, ‘elem2’)
Component Reference: (Objectproduc_v)
Below is an example syntax for a basis component RECREATE:
CREATE is a command to create a new component on the target system. In one implementation, the CREATE statement syntax is as follows:
CREATE Componenttype may create a new component instance. If the component with indicated name already exists, an error is returned.
The attribute value is represented depending on the datatype it stores. For example, the number values are represented as attribute_name(37)
Supported Data Type for Attribute Values:
String: (‘string value’)
Number: (37)
Boolean: (true)
List/Array: (‘elem1’, ‘elem2’)
Component Reference: (Objectproduct_v)
Below is an example syntax for a basis component CREATE:
ALTER is a command to alter an existing component (e.g., adding a new field, changing the configuration of an existing field, or changing the label). In one example, when the command is to change a label from application row to something else, the command may say “Alter application row name.” The command may update the metadata on the target system to change the label of a particular component. In one implementation, the ALTER statement syntax is as follows:
ALTER Componenttype may update the component instance by changing attribute values at the component or sub-component level, or by adding, modifying or dropping sub-components.
Below is an example syntax for component ALTER:
It may be possible to ADD or DROP one or more values from a multi-value attribute:
ALTER may also support ADD FIRST and ADD AFTER attribute syntax. This may allow ALTER to control the position of the value inside a multi-value attribute. A specific example is an ordinal position of the field inside a section. For example:
ALTER Docfieldlayout general_section_c ( fields(‘Docfield.field3_v’,‘Docfield.field5_v’) );
To insert field(s) into the list starting at the position 1:
To insert field(s) after Docfield.field3_v:
By default, ADD may insert the value(s) at the last position of the list:
DROP is a command to delete a component. In one implementation, the DROP statement syntax is as follows:
DROP Componenttype name_{namespace suffix};
DROP Componentype deletes a component instance identified by its name. (4)
An example of the DROP command is as follows:
DROP Object my_product_c;
RENAME is a command to rename a component. In one implementation, the RENAME statement syntax is as follows:
RENAME Componentype name_{old namespace suffix}TO name_{new namespace suffix}; (5)
RENAME Componenttype may rename the component instance from one name to another.
START TRANSACTION/COMMIT are commands to commit the changes to the target system.
START TRANSACTION:
[mdl_statement[,mdl_statement] . . . ]
COMMIT; (6)
The START TRANSACTION/COMMIT commands may allow executing several migration statements in a transaction.
The user may put in as many detailed statements as he wants, and each one may accomplish a task, e.g., DROP, or RENAME. The user may fill out this very elaborate script very quickly, and modify the entire configuration of the target system in one execution. For example, a user wants to:
The present invention may provide a robust error framework in the execution part. When it executes a migration statement, it may analyze what the user is trying to do, e.g., recreating a particular component. If there is an error, the error framework may generate an error code to indicate where the error occurred, the line number, the component that generates the error, the operation that generates the error, and what was trying to do when that error occurred. Based on the error code, the user may determine if there is a warning or failure. The error code may also indicate the reason type, the actual cause, and the classification of error, e.g., permission denied, invalid input, or parameter that was not supplied. When the user is executing a script consisting of mini commands, the error code may indicate which particular command within the script that causes the error.
With the migration statements, the user may define transactional boundaries. For example, if the user wants two components to execute, and wants to insure that both of them are executed successfully, the user may put them into a transactional boundary, so that if at least one of them fails, the whole thing fails, like all or none.
With the migration statements, users may build components in a very consistent way. Components, by default, become migratable. With this set of APIs, users can create migration scripts that will exercise the commands, to extract configuration, and deploy configuration into the target system. In one implementation, old components may become migratable if they are enabled retroactively.
With the migration statements, user may describe the configuration, and then deploy the configuration to the target system. The configuration is metadata, and the commands operate on the metadata level. In one implementation, one script may be sent to multiple target systems to deploy configuration.
At 503, a source component directory may be generated for the source system, e.g., by the source system migration controller 145. In one implementation, the source component directory may be a table that includes configuration objects in the source system.
At 505, a target component directory may be generated for the target system, e.g., by the target system migration controller 165. In one implementation, the target component directory may be a table that includes configuration objects in the target system.
At 507, changes on the components may be identified and tracked, e.g., when a component is created, altered, dropped or renamed in the source system and/or the target system. In one implementation, the source component directory and the target component directory may be queried and compared, e.g., by the source system migration controller 145, to find out what components are the same, what components exist in both systems but have differences, and what components exist in one system but not the other. In one implementation, a hash of current definitions of the components may be created for the comparison. In one example, the user may search the object Doctype in the source component directory and target component directory to compare these objects. In one example, the user may search for all changes within the last week.
At 509, the comparison result may be displayed on a user interface, e.g., a user interface 600 shown in
At 511, a user interface 700 may be displayed to enable creation of a package to collect the changed components together. As shown, the user interface 700 may have basic information of the package and allow the administrative user to add changed components to the package, e.g., by dropping a component in the area 701. The administrative user may select a subset of changed components.
At 513, a changed component package 710 may be generated, e.g., by the source system migration controller 145. The changed component package 710 may be a file-based transport that makes it easy to move configuration between the source system and the target system, and to deliver a set of configuration changes. In one example, the changed component package 710 is a zip archive file that has two high level sections. The first is a manifest file, which provides header information about the package. As show in
At 515, the component package 710 may be exported from the source system, e.g., by the source system migration controller 145. In one example, the user may download the file.
When the user logs in to the target system, a user interface may be displayed at 517 to enable the user to locate the file.
At 519, the changed component package may be verified, e.g., by the administrative user.
At 521, the changed component package 710 may be imported to the target system. In one example, the user may take that package file he just exported and downloaded, and then send that to the target system. In one implementation, the zip archive of components may be broken apart, and the components may be pulled into a set of tables or objects inside of the target system.
At 523, the component package 710 may be displayed on a user interface 900 in
At 525, the changes may be deployed and applied to the target system, e.g., by the target system migration controller 165. In one example, the changed component package 710 may be automatically deployed. In one example, the user interface 900 may allow the administrative user to choose the components he wants to deploy.
At 527, the source component directory and the target component directory may be queried and compared again to verify the changes, e.g., by the source system migration controller 145 or the target system migration controller 165.
At 529, a user interface 1000 in
527 and 529 may be repeated until all changes are deployed successfully. In one implementation, the deployment of changes in one package may be repeated to make sure that all changes are applied to the target system.
At 531, a user interface 1100 in
Although the embodiments are described with migrating configuration changes from the test system to the production system in a content management system, the present invention may be used in other situations. In one implementation, the migration statements may be used to migrate configuration changes between two content management systems. In one implementation, the migration statements may be used as an application deployer, not just a single configuration deployer, by configuring the target system to enable a new set of features. Users may create their own application package by putting some migration commands together, which may create metadata configuration for that application.
The above-described features and applications can be implemented as software processes that are specified as a set of instructions recorded on a computer readable storage medium (also referred to as computer readable medium). When these instructions are executed by one or more processing unit(s) (e.g., one or more processors, cores of processors, or other processing units), they cause the processing unit(s) to perform the actions indicated in the instructions. Examples of computer readable media include, but are not limited to, CD-ROMs, flash drives, RAM chips, hard drives, EPROMs, etc. The computer readable media does not include carrier waves and electronic signals passing wirelessly or over wired connections.
These functions described above can be implemented in digital electronic circuitry, in computer software, firmware or hardware. The techniques can be implemented using one or more computer program products. Programmable processors and computers can be included in or packaged as mobile devices. The processes and logic flows can be performed by one or more programmable processors and by one or more programmable logic circuitry. General and special purpose computing devices and storage devices can be interconnected through communication networks.
In this specification, the term “software” is meant to include firmware residing in read-only memory or applications stored in magnetic storage, which can be read into memory for processing by a processor. Also, in some implementations, multiple software technologies can be implemented as sub-parts of a larger program while remaining distinct software technologies. In some implementations, multiple software technologies can also be implemented as separate programs. Finally, any combination of separate programs that together implement a software technology described here is within the scope of the subject technology. In some implementations, the software programs, when installed to operate on one or more electronic systems, define one or more specific machine implementations that execute and perform the operations of the software programs. Examples of computer programs or computer code include machine code, for example is produced by a compiler, and files including higher-level code that are executed by a computer, an electronic component, or a microprocessor using an interpreter.
A computer program (also known as a program, software, software application, script, or code) can be written in any form of programming language, including compiled or interpreted languages, declarative or procedural languages, and it can be deployed in any form, including as a stand alone program or as a module, component, subroutine, object, or other unit suitable for use in a computing environment. A computer program may, but need not, correspond to a file in a file system. A program can be stored in a portion of a file that holds other programs or data (e.g., one or more scripts stored in a markup language document), in a single file dedicated to the program in question, or in multiple coordinated files (e.g., files that store one or more modules, sub programs, or portions of code). A computer program can be deployed to be executed on one computer or on multiple computers that are located at one site or distributed across multiple sites and interconnected by a communication network.
As used in this specification and any claims of this application, the terms “computer”, “server”, “processor”, and “memory” all refer to electronic or other technological devices. These terms exclude people or groups of people. For the purposes of the specification, the terms display or displaying means displaying on an electronic device. As used in this specification and any claims of this application, the terms “computer readable medium” and “computer readable media” are entirely restricted to tangible, physical objects that store information in a form that is readable by a computer. These terms exclude any wireless signals, wired download signals, and any other ephemeral signals.
It is understood that any specific order or hierarchy of steps in the processes disclosed is an illustration of example approaches. Based upon design preferences, it is understood that the specific order or hierarchy of steps in the processes may be rearranged, or that all illustrated steps be performed. Some of the steps may be performed simultaneously. For example, in certain circumstances, multitasking and parallel processing may be advantageous. Moreover, the separation of various system components illustrated above should not be understood as requiring such separation, and it should be understood that the described program components and systems can generally be integrated together in a single software product or packaged into multiple software products.
Various modifications to these aspects will be readily apparent, and the generic principles defined herein may be applied to other aspects. Thus, the claims are not intended to be limited to the aspects shown herein, but is to be accorded the full scope consistent with the language claims, where reference to an element in the singular is not intended to mean “one and only one” unless specifically so stated, but rather “one or more.” Unless specifically stated otherwise, the term “some” refers to one or more.
The present application is a continuation-in-part of U.S. nonprovisional patent application Ser. No. 15/228,968, filed on Aug. 4, 2016, entitled Configuring Content Management Systems, which is hereby incorporated by reference herein for all purposes.
Number | Date | Country | |
---|---|---|---|
Parent | 15228968 | Aug 2016 | US |
Child | 15239582 | US |