> For the complete documentation index, see [llms.txt](https://docs.geoprismregistry.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.geoprismregistry.com/version/v2.0.0/external-system-integration/synchronize-an-external-system/apache-jena-synchronization.md).

# Apache Jena Synchronization

{% hint style="info" %}
Registry Administrators and System Administrators can create synchronizations. You need a registered [Apache Jena external system](/version/v2.0.0/external-system-integration/register-an-external-system/apache-jena-external-system.md) and a published [Spatial Knowledge Graph](/version/v2.0.0/explore/spatial-knowledge-graphs-skg.md).
{% endhint %}

An Apache Jena synchronization sends a published Spatial Knowledge Graph to a Jena triple store. Each run updates the data in the external system, rather than deleting and replacing the whole Jena database.

1. Go to the **Settings** page. Find the **External System Synchronizations** section.

   <figure><img src="https://3732932512-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9giVyCrmTxAs33YrSRbJ%2Fuploads%2F3yuCmLv66V1q5vaNeDOL%2Fimage.png?alt=media&amp;token=552d1832-6995-48f5-a951-7452f4263a9c" alt=""><figcaption></figcaption></figure>
2. Click **Register Synchronization** to open the **Synchronization Configurations** page.

   <figure><img src="https://3732932512-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9giVyCrmTxAs33YrSRbJ%2Fuploads%2FK8T7KQfGKNF5yYpIZCDn%2Fimage.png?alt=media&amp;token=f189b2ae-876b-4ddc-ada5-fb68ee4d1581" alt=""><figcaption></figcaption></figure>
3. Click **Create** to open the **Synchronization Configuration** form, and fill it out:

   <figure><img src="https://3732932512-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9giVyCrmTxAs33YrSRbJ%2Fuploads%2FjtzTCjScS6Ma1jXJsAvz%2Fimage.png?alt=media&amp;token=c9738df3-1d05-49b4-91c3-288f0338b8d6" alt=""><figcaption></figcaption></figure>

   | Field name              | Description                                                                                                                                                                                                                                                                                                                   | Required? |
   | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- |
   | Label                   | The label of the synchronization profile.                                                                                                                                                                                                                                                                                     | Yes       |
   | Organization            | The organization the user belongs to. A synchronization profile will only be available to data and users within this organization.                                                                                                                                                                                            | Yes       |
   | External System         | <p>The registered external system configuration that will be used to configure this synchronization. This must be registered before creating a synchronization.</p><p>See <a data-mention href="/version/v2.0.0/external-system-integration/register-an-external-system.md">/pages/eJKPtSqWQxaS11LWDCls</a></p>               | Yes       |
   | Spatial Knowledge Graph | <p>The published spatial knowledge graphs from the system. The published graph that is selected will be used for pushing data to the external system.</p><p>See <a data-mention href="/version/v2.0.0/explore/spatial-knowledge-graphs-skg.md">/pages/nKge6NsZMvDgHt5iB4HT</a></p>                                            | Yes       |
   | Namespace               | <p>The base URI that begins the identifier of every resource in the published graph (e.g., <code><https://data.example.gov/gpr/></code>). This is the root descriptor of all the graph data.<br><br>Use a domain your organization controls, and avoid changing it after publishing, since that changes every identifier.</p> | Yes       |
   | Graph                   | The name of the graph in the triple store that this synchronization populates. Named graphs keep each published SKG separate, so it can be queried, updated, or removed on its own.                                                                                                                                           | Yes       |
4. Click **Submit** to save the configuration.

   <figure><img src="https://3732932512-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9giVyCrmTxAs33YrSRbJ%2Fuploads%2FRLVPFEIQJi5FGg7PtAJ2%2Fimage.png?alt=media&amp;token=40ae5e90-705b-4c70-8526-2afa431e18e5" alt=""><figcaption></figcaption></figure>
5. Click **View** next to the configuration.
6. Click **Run now** to push the selected SKG to Jena. Its progress appears under **Jobs**.

   <figure><img src="https://3732932512-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9giVyCrmTxAs33YrSRbJ%2Fuploads%2FWzWtgIWlaVvLSkV8NHC1%2Fimage.png?alt=media&amp;token=6434e0e9-4613-45ef-940b-d61606bfe403" alt=""><figcaption></figcaption></figure>
