...
Still, in your command prompt or terminal, pull the latest version of ENAPSO together free:
| Infonote |
|---|
When running the pull command, please note that if an image is already running and you pull the latest one, it will overwrite existing data in the knowledge graph repository, resetting it to the default state. To avoid losing your data, follow the guidelines on the provided /wiki/spaces/ENAPSODOCS/pages/2239528974 to create a backup before pulling the latest image, and then restore your data afterward. |
Here we already need to add that a backup is required, since a new pull overwrites existing data!
| Code Block |
|---|
|
docker pull registry.innotrade.com/innotrade/enapso-together-free |
...
This maps the container's port 80 to your local machine's port 80.
If you encounter a port conflict when attempting to run the Docker container for the ENAPSO together Free platform, you have an option to resolve it and access the service:
Change the Host Port
If port 80 is already in use on your machine, you can map the container's internal port (80) to a different port on your host. For example, if you choose to use port 8080 on your host, you can modify your Docker run command like this:
...
This guide outlines the steps to upload the pre-formatted Turtle (TTL) demo data for the EditorialObject to your graph database. Follow these instructions to effectively populate your graph databases with instances of the EditorialObject within the EBUCorePlus ontology, using the GraphDB Management Service's provided API endpoints.
Caution! Re-Pulling Docker Images leads to data loss!
Access Swagger Documentation: Navigate to the GraphDB Management Service documentation in your web browser.
Editorial Object Demo Data: Below is the provided Turtle-formatted demo data for the Editorial Object. This data includes predefined instances that demonstrate the use and structure of the Editorial Object within ebucoreplus ontology.
| Expand |
|---|
| title | EditorialObject Escaped Demo Data |
|---|
|
<http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus\/data\/| Note |
|---|
When running the pull command, please note that if an image is already running and you pull the latest one, it will overwrite existing data in the knowledge graph repository, resetting it to the default state. To avoid losing your data, follow the guidelines on the provided /wiki/spaces/ENAPSODOCS/pages/2239528974 to create a backup before pulling the latest image, and then restore your data afterward. |
Caution! Re-Pulling Docker Images leads to data loss!
Access Swagger Documentation: Navigate to the GraphDB Management Service documentation in your web browser.
Editorial Object Demo Data: Below is the provided Turtle-formatted demo data for the Editorial Object. This data includes predefined instances that demonstrate the use and structure of the Editorial Object within ebucoreplus ontology.
| Expand |
|---|
| title | EditorialObject Escaped Demo Data |
|---|
|
<http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus\/data\/EditorialObject_7cdb7f1d-89e6-4cd7-8282-2740a43bf8e0>\r\n a <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#EditorialObject>;\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#contentDescription> \"In 1989, a young man must protect his fragile mother, who just awoke from a coma, from learning that her beloved East Germany as she knew it has disappeared.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#productionSynopsis> \"The film combines comedy and drama elements, capturing the fall of the Berlin Wall and the transformation of East Germany through personal and poignant moments.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#shotLog> \"Various scenes depicting the comedic efforts to recreate East Germany in an apartment.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#title> \"Good Bye Lenin!\".\r\n\r\n<http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus\/data\/EditorialObject_da44ec80-754e-436c-b4f8-322da13e00a1>\r\n a <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#EditorialObject>;\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#contentDescription> \"A thrilling race against time, Lola has 20 minutes to find a large sum of money to save her boyfriend s life.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#productionSynopsis> \"The movie employs a ground-breaking narrative structure of three different outcomes based on the slightest changes in Lola s actions.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#shotLog> \"Fast-paced sequences with multiple repetitions of the 20-minute loop.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#title> \"Run Lola Run\".\r\n\r\n<http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus\/data\/EditorialObject_26950b42-bea9-432c-bffc-a1b7eb9c25cf>\r\n a <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#EditorialObject>;\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#contentDescription> \"In 1984 East Berlin, an agent of the secret police conducts surveillance on a writer and his lover but finds himself becoming increasingly absorbed by their lives.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#productionSynopsis> \"This drama explores themes of surveillance, privacy, and the moral decisions faced by individuals in a totalitarian state.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#shotLog> \"Intense surveillance scenes and emotional character development.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#title> \"The Lives of Others\".\r\n\r\n<http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus\/data\/EditorialObject_9fe17ffb-afa1-4914-ab64-a8f41148b560>\r\n a <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#EditorialObject>;\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#contentDescription> \"A historical drama detailing the rise and fall of the Red Army Faction, a radical left-wing terrorist group in 1970s West Germany.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#productionSynopsis> \"The film dives deep into the political climate of Germany during the time, portraying the motivations and consequences of radical activism.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#shotLog> \"Action-packed scenes of protests and confrontations with police.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#title> \"The Baader Meinhof Complex\".\r\n\r\n<http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus\/data\/EditorialObject_f94cdb34-11c4-42b2-b992-b57384153827>\r\n a <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#EditorialObject>;\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#contentDescription> \"A pioneering silent sci-fi film about a futuristic urban dystopia, where the wealthy elite live above ground while workers toil below.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#productionSynopsis> \"This 1927 film directed by Fritz Lang is known for its revolutionary visual style and special effects, setting standards for the science fiction genre.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#shotLog> \"Iconic scenes of the massive cityscapes and the robot transformation.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#title> \"Metropolis\".\r\n\r\n<http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus\/data\/EditorialObject_a6769040-b5b0-4b08-a0a7-5992b71d710f>\r\n a <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#EditorialObject>;\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#contentDescription> \"The crew of a German submarine during WWII experience the boredom, filth, and sheer terror of war beneath the waves.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#productionSynopsis> \"This intense submarine thriller is acclaimed for its realistic portrayal of the claustrophobic life of a wartime submarine crew.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#shotLog> \"Tense underwater sequences and the psychological strain on the crew.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#title> \"Das Boot\".\r\n\r\n<http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus\/data\/EditorialObject_fd9e3d6c-2f46-411a-85b3-12053975f555>\r\n a <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#EditorialObject>;\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#contentDescription> \"Depicts the final days of Adolf Hitler as seen through the eyes of his secretary, during the last days of the Third Reich in the bunker beneath Berlin.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#productionSynopsis> \"The film provides a detailed and harrowing look at the collapse of Hitler\u2019s regime and is renowned for Bruno Ganz s performance as Hitler.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#shotLog> \"Intense bunker scenes and the collapse of Berlin.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#title> \"Downfall\".\r\n\r\n<http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus\/data\/EditorialObject_fd617f4d-cb77-4757-915d-8cce1043d52a>\r\n a <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#EditorialObject>;\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#contentDescription> \"An angel in Berlin decides to become mortal after falling in love with a beautiful trapeze artist.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#productionSynopsis> \"This poetic film by Wim Wenders blends fantasy, romance, and philosophical musings on the human condition.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#shotLog> \"Scenes of angels observing the mundane and beautiful moments of human life.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#title> \"Wings of Desire\".\r\n\r\n<http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus\/data\/EditorialObject_8ddb1303-3560-4878-899d-ada16657239b>\r\n a <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#EditorialObject>;\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#contentDescription> \"This tragicomedy follows a day in the life of Niko, a college dropout, who navigates various social milieus and struggles with his direction in life.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#productionSynopsis> \"The film is shot in black and white, capturing the essence of contemporary Berlin while exploring themes of alienation and self-discovery.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#shotLog> \"Niko s wanderings through Berlin, encountering different people and situations.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#title> \"A Coffee in Berlin\".\r\n\r\n<http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus\/data\/EditorialObject_b42a73b3-2018-4e44-82d2-31df4328b870>\r\n a <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#EditorialObject>;\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#contentDescription> \"In a small German village before World War I, a series of disturbing events take place, hinting at the origins of fascism.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#productionSynopsis> \"This austere black-and-white film by Michael Haneke explores the roots of evil in a society poised on the brink of war.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#shotLog> \"Tension-filled scenes depicting mysterious accidents and the oppressive atmosphere of the village.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#title> \"The White Ribbon\".\r\n\r\n<http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus\/data\/EditorialObject_052d0a16-4bfe-41db-a814-62e77cac76b6>\r\n a <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#EditorialObject>;\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#contentDescription> \"A father tries to reconnect with his workaholic daughter by creating an outrageous alter ego and posing as her CEO s life coach.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#productionSynopsis> \"The film is a unique blend of comedy and drama, offering a poignant look at family relationships and personal priorities.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#shotLog> \"Humorous yet heartfelt encounters between the father in disguise and his daughter.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#title> \"Toni Erdmann\".\r\n\r\n<http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus\/data\/EditorialObject_775a4b5a-83f9-4220-8296-6a177547fbba>\r\n a <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#EditorialObject>;\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#contentDescription> \"A young Spanish woman who has newly moved to Berlin finds her flirtation with a local man turned potentially deadly as their night out with his friends reveals a dangerous secret.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#productionSynopsis> \"The entire film is famously shot in one single, continuous take, offering an immersive experience that heightens the tension and realism.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#shotLog> \"The continuous shot that captures the escalating night from fun to danger.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#title> \"Victoria\".\r\n\r\n<http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus\/data\/EditorialObject_2eef8910-1ff0-45ec-a66e-14b6068947cd>\r\n a <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#EditorialObject>;\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#contentDescription> \"Three young anti-capitalist activists break into wealthy homes as a form of protest, leaving behind messages for the homeowners, until one heist goes wrong.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#productionSynopsis> \"This film combines elements of drama, romance, and political activism, exploring the consequences of idealism in a capitalist society.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#shotLog> \"Scenes of the activists planning and executing their unique form of protest.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#title> \"The Edukators\".\r\n\r\n<http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus\/data\/EditorialObject_4ae1e5dd-58df-40bc-b413-42acfa733e34>\r\n a <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#EditorialObject>;\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#contentDescription> \"True story of Sophie Scholl, a member of the non-violent anti-Nazi resistance group The White Rose, focusing on her arrest and trial in 1943.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#productionSynopsis> \"The film is a gripping narrative of courage and conviction in the face of totalitarian oppression.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#shotLog> \"Dramatic courtroom scenes and the portrayal of Sophie s defiance.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#title> \"Sophie Scholl \u2013 The Final Days\".\r\n\r\n<http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus\/data\/EditorialObject_789eced0-aa96-491c-80c9-b9914791f213>\r\n a <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#EditorialObject>;\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#contentDescription> \"In 1980s East Germany, a doctor is banished to a small country hospital as punishment for applying for an exit visa. As she plans her escape to the West, she becomes entangled with another doctor.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#productionSynopsis> \"This film delicately explores the theme of freedom versus responsibility in a tightly controlled society.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#shotLog> \"Scenes highlighting the tension between the doctors and the oppressive surveillance.\";\r\n <http:\/\/www.ebu.ch\/metadata\/ontologies\/ebucoreplus#title> \"Barbara\".\r\n
|
...
Creating a New Instance
To create a new instance of the EditorialObject class, follow these instructions:instance of the EditorialObject class, you'll need to understand the IRI (Internationalized Resource Identifier), a unique identifier that ensures each instance is distinct and aligns with global web standards. If an IRI is not provided, it automatically generates one to guarantee each instance's uniqueness. Alternatively, you can specify your own IRI to maintain control over the identifier of your instance, adhering to standard HTTP practices.
Set Up Creation Request:
Go back to the execute-template-by-name endpoint if you aren't already there.
Click Try it out button again to set up a new request.
Enter createEditorialObject against the templateName key, which is the name of the create template for the EditorialObject class.
Provide necessary variables for the new instance. Typically, this would be in JSON format in the request's body of the request, for example.
| Code Block |
|---|
{
"title": "M - A City Hunts a Murderer",
"productionSynopsis": "Directed by Fritz Lang, this thriller is one of the earliest masterpieces of sound cinema, exploring themes of justice, vigilance, and societal response to crime.",
"shotLog": "Iconic scenes using shadows and sound to create suspense, notably the murderers earliesteerie masterpieceswhistling of soundIn cinema, exploring themesthe Hall of justice,the vigilance, and societal response to crime.",
"shotLog": "Iconic scenes using shadows and sound to create suspense, notably the murderers eerie whistling of In the Hall of the Mountain King."
}Mountain King."
} |
When you send a request to create a new instance, a unique IRI (Internationalized Resource Identifier) is involved. This IRI acts like a unique id for your instance that complies with global web standards.
If you do not provide an IRI, it automatically generates one for you, ensuring that each instance is uniquely identified. However, if you have a specific IRI you wish to use, you can include it in your variables JSON object. This allows you to control the unique identifier of your instance, following the standard HTTP practices.
Click the Execute button to send the creation request.
The response will confirm that the new instance has been successfully created. Look for a success message and any details provided about the newly created instance.
...
After creating a new instance of the EditorialObject class, it's important to confirm that if the instance record has indeed been added to the graph database. Follow been successfully created, you can follow these steps to verify the creationaddition to the graph database:
Re-execute the Read Template:
Navigate back to the execute-template-by-name endpoint in the View Management Service documentation.
Click the Try it out button to enable input for a new request.
Against the templateName key, enter readEditorialObject again. This is the same read template you used earlier to view instances.
Click the Execute button to send the request once more.
The response will now include the list of all current instances of the EditorialObject class. Look through the list to find the newly created instance. You should see the details you entered for the instance, such as the label or any other identifiers, confirming that it has been successfully persisted in the database.
This process of reRe-executing the read template serves as a straightforward method to ensure that your CRUD operations are impacting the graph database as expected, providing clear evidence of successful data management within the ENAPSO platformafter performing CRUD operations provides an option to transparently verify the changes made to the graph database. This process offers an additional way to demonstrate the effectiveness of your data management practices, confirming that operations have been executed as expected.
Updating an Instance
To update an existing instance within your graph database, you need to specify which instance to update and what changes to make:database, you first need to know which instance you're targeting. This is where the IRI (Internationalized Resource Identifier) comes in—it acts as a unique identifier, much like an id for each instance. You can find the IRI by reading the instances of the class you're interested in. Once you have the IRI, it serves as an identifier to specify which instance to update. Along with the IRI, you need to pass the properties and their new values that you want to update.
Access Update Template Execution:
Navigate to the execute-template-by-name endpoint in the View Management Service documentation.
Click the Try it out button.
Enter the name of the update template (e.g., updateEditorialObject) against the templateName key.
In the variables object, specify the iri of the instance you wish to update and , which you can obtain through reading the instance data. Also, include the properties and their values you want to change. For example,
| Code Block |
|---|
{
"iri": "http://ont.enapso.com/sparql-template#EditorialObject_bf161f6f-4b89-431f-8f83-eb7b51b9a89f",
"contentDescription": "In Berlin during the Weimar Republic, the police and the criminal underworld scramble to capture a child murderer who has caused panic across the city."
} |
Click the Execute button to send the update request.
The response should indicate whether the update was successful, including confirmation of the changes.
...
To delete an instance from your ontology, you need to specify which instance to remove by using its IRI (Internationalized Resource Identifier). The IRI serves as a unique identifier for each instance and can be obtained by reading the instance data beforehand. Once you have the IRI, use it to indicate which instance you wish to delete.:
Access Delete Template Execution:
Go to the execute-template-by-name endpoint in the View Management Service documentation.
Click the Try it out button.
Enter the name of the delete template (e.g., deleteEditorialObject) against the templateName key.
In the variables object, provide the IRI of the instance you wish to delete. For example,
| Code Block |
|---|
{
"iri": "http://ont.enapso.com/sparql-template#EditorialObject_bf161f6f-4b89-431f-8f83-eb7b51b9a89f"
} |
Click the Execute button to send the delete request.
The response should confirm that the instance has been successfully deleted from the database.
...