{"id":54,"date":"2020-12-29T12:17:38","date_gmt":"2020-12-29T12:17:38","guid":{"rendered":"https:\/\/heal-the.earth\/?page_id=54"},"modified":"2022-03-17T08:52:03","modified_gmt":"2022-03-17T08:52:03","slug":"ral-regenerative-agriculture-language","status":"publish","type":"page","link":"https:\/\/heal-the.earth\/de\/ral-regenerative-agriculture-language","title":{"rendered":"RAL &#8211; Regenerative Agriculture Language"},"content":{"rendered":"\t\t<div data-elementor-type=\"wp-page\" data-elementor-id=\"54\" class=\"elementor elementor-54\">\n\t\t\t\t\t\t<section class=\"elementor-section elementor-top-section elementor-element elementor-element-0710404 elementor-section-boxed elementor-section-height-default elementor-section-height-default\" data-id=\"0710404\" data-element_type=\"section\" data-e-type=\"section\">\n\t\t\t\t\t\t\t<div class=\"elementor-background-overlay\"><\/div>\n\t\t\t\t\t\t\t<div class=\"elementor-container elementor-column-gap-default\">\n\t\t\t\t\t<div class=\"elementor-column elementor-col-100 elementor-top-column elementor-element elementor-element-42cbdbe\" data-id=\"42cbdbe\" data-element_type=\"column\" data-e-type=\"column\">\n\t\t\t<div class=\"elementor-widget-wrap elementor-element-populated\">\n\t\t\t\t\t\t<div class=\"elementor-element elementor-element-5869bb2 elementor-nav-menu--indicator-classic elementor-nav-menu__text-align-aside elementor-nav-menu--toggle elementor-nav-menu--burger elementor-widget elementor-widget-nav-menu\" data-id=\"5869bb2\" data-element_type=\"widget\" data-e-type=\"widget\" data-settings=\"{&quot;layout&quot;:&quot;dropdown&quot;,&quot;toggle&quot;:&quot;burger&quot;}\" data-widget_type=\"nav-menu.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<div class=\"elementor-menu-toggle\" role=\"button\" tabindex=\"0\" aria-label=\"Menu Toggle\" aria-expanded=\"false\">\n\t\t\t<i class=\"eicon-menu-bar\" aria-hidden=\"true\"><\/i>\n\t\t\t<span class=\"elementor-screen-only\">Menu<\/span>\n\t\t<\/div>\n\t\t\t<nav class=\"elementor-nav-menu--dropdown elementor-nav-menu__container\" role=\"navigation\" aria-hidden=\"true\"><ul id=\"menu-2-5869bb2\" class=\"elementor-nav-menu\"><li class=\"menu-item menu-item-type-post_type menu-item-object-page menu-item-home menu-item-287\"><a href=\"https:\/\/heal-the.earth\/de\/\" class=\"elementor-item\">HOME<\/a><\/li>\n<li class=\"menu-item menu-item-type-post_type menu-item-object-page menu-item-283\"><a href=\"https:\/\/heal-the.earth\/de\/aboutus\" class=\"elementor-item\">ABOUT US<\/a><\/li>\n<li class=\"menu-item menu-item-type-post_type menu-item-object-page menu-item-56\"><a href=\"https:\/\/heal-the.earth\/de\/ral-regenerative-agriculture-language\" class=\"elementor-item\">RAL \u2013 Regenerative Agriculture Language<\/a><\/li>\n<li class=\"menu-item menu-item-type-post_type menu-item-object-page menu-item-489\"><a href=\"https:\/\/heal-the.earth\/de\/codersforfarmers\" class=\"elementor-item\">Coders for Farmers<\/a><\/li>\n<li class=\"menu-item menu-item-type-post_type menu-item-object-page menu-item-57\"><a href=\"https:\/\/heal-the.earth\/de\/donate\" class=\"elementor-item\">DONATE<\/a><\/li>\n<\/ul><\/nav>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t<section class=\"elementor-section elementor-top-section elementor-element elementor-element-532e6c9 elementor-section-height-min-height elementor-section-stretched elementor-section-full_width elementor-section-height-default elementor-section-items-middle\" data-id=\"532e6c9\" data-element_type=\"section\" data-e-type=\"section\" data-settings=\"{&quot;stretch_section&quot;:&quot;section-stretched&quot;}\">\n\t\t\t\t\t\t\t<div class=\"elementor-background-overlay\"><\/div>\n\t\t\t\t\t\t\t<div class=\"elementor-container elementor-column-gap-default\">\n\t\t\t\t\t<div class=\"elementor-column elementor-col-100 elementor-top-column elementor-element elementor-element-e3672fd\" data-id=\"e3672fd\" data-element_type=\"column\" data-e-type=\"column\">\n\t\t\t<div class=\"elementor-widget-wrap elementor-element-populated\">\n\t\t\t\t\t\t<section class=\"elementor-section elementor-inner-section elementor-element elementor-element-2b22693 elementor-section-full_width elementor-section-height-default elementor-section-height-default\" data-id=\"2b22693\" data-element_type=\"section\" data-e-type=\"section\">\n\t\t\t\t\t\t<div class=\"elementor-container elementor-column-gap-default\">\n\t\t\t\t\t<div class=\"elementor-column elementor-col-50 elementor-inner-column elementor-element elementor-element-6298d75\" data-id=\"6298d75\" data-element_type=\"column\" data-e-type=\"column\">\n\t\t\t<div class=\"elementor-widget-wrap elementor-element-populated\">\n\t\t\t\t\t\t<div class=\"elementor-element elementor-element-4036ee1 elementor-widget elementor-widget-text-editor\" data-id=\"4036ee1\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p><a href=\"https:\/\/heal-the.earth\">heal-the-earth<\/a><\/p>\n<p><a href=\"https:\/\/heal-the.earth\">foundation<\/a><\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-b0705a4 elementor-widget elementor-widget-text-editor\" data-id=\"b0705a4\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p>building partnerships to regenerate soils<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t<div class=\"elementor-column elementor-col-50 elementor-inner-column elementor-element elementor-element-6546348\" data-id=\"6546348\" data-element_type=\"column\" data-e-type=\"column\">\n\t\t\t<div class=\"elementor-widget-wrap elementor-element-populated\">\n\t\t\t\t\t\t<div class=\"elementor-element elementor-element-d12129e elementor-widget elementor-widget-heading\" data-id=\"d12129e\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h2 class=\"elementor-heading-title elementor-size-default\">RAL - a digital language for regenerative agriculture<\/h2>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t<section class=\"elementor-section elementor-top-section elementor-element elementor-element-c069296 elementor-section-boxed elementor-section-height-default elementor-section-height-default\" data-id=\"c069296\" data-element_type=\"section\" data-e-type=\"section\">\n\t\t\t\t\t\t\t<div class=\"elementor-background-overlay\"><\/div>\n\t\t\t\t\t\t\t<div class=\"elementor-container elementor-column-gap-default\">\n\t\t\t\t\t<div class=\"elementor-column elementor-col-100 elementor-top-column elementor-element elementor-element-6adb82c\" data-id=\"6adb82c\" data-element_type=\"column\" data-e-type=\"column\">\n\t\t\t<div class=\"elementor-widget-wrap elementor-element-populated\">\n\t\t\t\t\t\t<div class=\"elementor-element elementor-element-99431de elementor-widget elementor-widget-heading\" data-id=\"99431de\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h1 class=\"elementor-heading-title elementor-size-default\">Intention<\/h1>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-f359bab elementor-widget elementor-widget-text-editor\" data-id=\"f359bab\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p style=\"color: #f2b776; font-size: 17px;\">We believe that sustainable partnerships for the support of\u00a0<span style=\"color: #ffffff;\"><strong>EarthHealers<\/strong><\/span> need a freely accessible, shared digital language. Therefore, we developed and host\u00a0<span style=\"font-weight: bolder;\"><span style=\"color: #ffffff;\">RAL &#8211; the regenerative agriculture language &#8211;<\/span><\/span>\u00a0as non-commercial, open access project.\u00a0<\/p><p style=\"color: #f2b776; font-size: 17px;\">This language is an ontology-like knowledge representation that enables farmers, regulatory entities, scientists, but also software, AI, and machines to exchange information as structured data. This allows partners to develop interconnected software and machines easily. In contrast to real ontologies, the data structure is lightweight and purely oriented towards ease-of-use, speed, and low demand on computing power.<\/p><p style=\"color: #f2b776; font-size: 17px;\">At the same time, data encoded in RAL is stored at the users site enabling a maximum of data sovereignty and minimum of dependency on centralized structures.<\/p><p style=\"color: #f2b776; font-size: 17px;\">This will optimize workflows and reduces or avoids human mistakes often occurring in complex systems such as the restoration of soil ecosystems. It also allows a high transparency of data to continuously ask the most important question: &#8220;Are we really on the right way towards healing the earth?&#8221;<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t<section class=\"elementor-section elementor-top-section elementor-element elementor-element-fb924e3 elementor-section-boxed elementor-section-height-default elementor-section-height-default\" data-id=\"fb924e3\" data-element_type=\"section\" data-e-type=\"section\">\n\t\t\t\t\t\t\t<div class=\"elementor-background-overlay\"><\/div>\n\t\t\t\t\t\t\t<div class=\"elementor-container elementor-column-gap-default\">\n\t\t\t\t\t<div class=\"elementor-column elementor-col-100 elementor-top-column elementor-element elementor-element-a8b8995\" data-id=\"a8b8995\" data-element_type=\"column\" data-e-type=\"column\">\n\t\t\t<div class=\"elementor-widget-wrap elementor-element-populated\">\n\t\t\t\t\t\t<div class=\"elementor-element elementor-element-5def101 elementor-widget elementor-widget-heading\" data-id=\"5def101\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h1 class=\"elementor-heading-title elementor-size-default\">Building Blocks<\/h1>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-017acfe elementor-widget elementor-widget-text-editor\" data-id=\"017acfe\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p style=\"color: #f2b776; font-size: 17px;\">RAL is a hierarchy of object- and method-templates describing all possible things and processes in the regenerative agriculture value creation chain.\u00a0\u00a0<\/p><p style=\"color: #f2b776; font-size: 17px;\">To make sure that a digital representation of an\u00a0<i>object<\/i>\u00a0or <i>method<\/i> is unique, you can either request an UID from the RAL host via the API call for the template of this object\/method OR you generate your own UID after getting the template from the RAL host using your\u00a0<i>sitetag <\/i>as prefix.<span style=\"color: #ffffff;\"><strong><br \/><\/strong><\/span><\/p><p style=\"color: #f2b776; font-size: 17px;\">The main blocks are objects and methods which itself consist of a set of mandatory blocks that describe the individual object or method.<\/p><pre style=\"color: #f2b776; font-size: 17px;\"><span style=\"color: #ffffff;\"><strong>1. Objects<\/strong><\/span><\/pre><p style=\"color: #f2b776; font-size: 17px;\">An <i>object<\/i> is a description of a real-world or digital object.\u00a0<\/p><p style=\"color: #f2b776; font-size: 17px;\">All <i>objects <\/i>consist of the same building blocks:<\/p><p style=\"color: #f2b776; font-size: 17px;\"><span style=\"color: #ffffff;\">a) identity (UID, name, siteTag, alternateUIDs)<\/span><\/p><p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">This block contains the information that makes the individual object unique. It get&#8217;s an UID, a name, and contains the siteTag it was generated on. Alternate UID is an array of UIDs that might have been given to the object by others.<\/p><p style=\"color: #f2b776; font-size: 17px;\"><span style=\"color: #ffffff;\">b) definition (definitionText, definitionURL)<\/span><\/p><p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">This block contains the definition of the object in plain text and as URL linking to a valid definition source.<\/p><p style=\"color: #f2b776; font-size: 17px;\"><span style=\"color: #ffffff;\">c) template (<i>RALType<\/i>, version, objectStateTemplates)<\/span><\/p><p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">The template information contains data about the type of this object and the version of the template that was used. Note that by calling the API without the optional parameter\u00a0<i>templateVersion<\/i>, you will always get the most recent version of this object template.<\/p><p style=\"color: #f2b776; font-size: 17px;\"><span style=\"color: #ffffff;\">d) specificProperties<\/span><\/p><p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">This is a list of properties that are unique to this object like a storage path property, a temperature property, an amount property&#8230;\u00a0<\/p><p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">Each property consists of KEY, VALUE, UNIT (from <i>unitType<\/i>), RALType, minItems, maxItems<\/p><p style=\"color: #f2b776; font-size: 17px;\"><span style=\"color: #ffffff;\">e) currentGeolocation<\/span><\/p><p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">This block describes the geolocation of the object, in case locatioHistory is not informative about it&#8217;s real-world location. It can contain longitude, latitude, postal address, 3WordAddress, Plus Code.<\/p><p style=\"color: #f2b776; font-size: 17px;\"><span style=\"color: #ffffff;\">e) locationHistoryRef (past, present, future)<\/span><\/p><p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">This is a list of location objects (object references [UID, <i>RALtype<\/i>, timestamp of moving to this location, past\/present\/future tag]) the object was\/is\/will be located at in a chronological order.<\/p><p style=\"color: #f2b776; font-size: 17px;\"><span style=\"color: #ffffff;\">f) roleHistoryRef (past present, future)<\/span><\/p><p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">This is a list of roles the object had (<i>roleType, <\/i>timestamp of attribution of this role, past\/present\/future tag) in a chronological order.<\/p><p><span style=\"color: #ffffff;\">g) ownerHistoryRef (past present, future)<\/span><\/p><p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">This is a list of object references of owners of this object (UID, <i>RALType,<\/i> timestamp of start of ownership, past\/present\/future tag) in a chronological order.<\/p><p style=\"color: #f2b776; font-size: 17px;\"><span style=\"color: #ffffff;\">h) methodHistoryRef<\/span><\/p><p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">This is a list of method references (UID, <i>RALType<\/i>), which have been executed using this object in a chronological order.<\/p><p style=\"color: #f2b776; font-size: 17px;\"><span style=\"color: #ffffff;\">i) linkedObjectRef (as <i>object<\/i> or <i>objectReference<\/i>)<\/span><\/p><p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">This is a list of objects that are nested inside this object. This is needed for special relations between object that are not related to location or ownership. The can be either be provided as complete objects or as objectReference (UID, RALType, timestamp of start of nesting, past\/present\/future tag)<\/p><p style=\"color: #f2b776; font-size: 17px;\"><span style=\"color: #ffffff;\">j) objectState<\/span><\/p><p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">The state the object is current in, selected from objectState childs in objects hierarchy<\/p><p style=\"padding-left: 40px;\">\u00a0<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-29ed610 elementor-widget elementor-widget-text-editor\" data-id=\"29ed610\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<pre style=\"color: #f2b776; font-size: 17px;\"><span style=\"color: #ffffff;\"><b>2. Methods<\/b><\/span><\/pre>\n<p style=\"color: #f2b776; font-size: 17px;\">A <i>method<\/i> is a description of a process that uses 1-to-many input<i> objects<\/i>&nbsp;and 1-to-many output objects. It can contain a number of nested methods that describe subprocesses. The connection between the single objects of the main and the nested methods are described using <i>objectConnectors.<\/i><\/p>\n<p style=\"color: #f2b776; font-size: 17px;\">Therefore, all <i>methods <\/i>consist of the following building blocks:<\/p>\n<p style=\"color: #f2b776; font-size: 17px;\"><span style=\"color: #ffffff;\">a) identity (UID, name, site tag)<\/span><\/p>\n<p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">This block contains the information that makes the individual object unique. It get&#8217;s an UID, a name, and contains the siteTag it was generated on.<\/p>\n<p style=\"color: #f2b776; font-size: 17px;\"><span style=\"color: #ffffff;\">b) definition (definitionText, definitionURL)<\/span><\/p>\n<p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">This block contains the definition of the method in plain text and as URL linking to a valid definition source.<\/p>\n<p style=\"color: #f2b776; font-size: 17px;\"><span style=\"color: #ffffff;\">c) template (<i>RALType<\/i>, version)<\/span><\/p>\n<p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">The template information contains data about the type of this method and the version of the template that was used. Note that by calling the API without the optional parameter <i>templateVersion<\/i>, you will always get the most recent version of this method template.<\/p>\n<p style=\"color: #f2b776; font-size: 17px;\"><span style=\"color: #ffffff;\">d) specificProperties<\/span><\/p>\n<p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">This is a list of properties that are unique to this method like environmental parameters during execution.<\/p>\n<p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">Each property consists of KEY, VALUE, UNIT (from&nbsp;<i>unitType<\/i>), RALType, minItems, maxItems<\/p>\n<p style=\"color: #f2b776; font-size: 17px;\"><span style=\"color: #ffffff;\">e) inputObjects<\/span><\/p>\n<p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">All objects that are used by the method (status prior to execution).<\/p>\n<p style=\"color: #f2b776; font-size: 17px;\"><span style=\"color: #ffffff;\">f) outputObjects<\/span><\/p>\n<p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">All objects that are generated or modified by the method (status after execution).<\/p>\n<p style=\"color: #f2b776; font-size: 17px;\"><span style=\"color: #ffffff;\">g) nestedMethods<\/span><\/p>\n<p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">Each method (also already nested methods) can have an unlimited number of methods nested to it.<\/p>\n<p style=\"color: #f2b776; font-size: 17px;\"><span style=\"color: #ffffff;\">h) objectConnectors<\/span><\/p>\n<p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">Input- and output objects of the main- and nested methods are connected to each other using information inside this block. The block consists of a list of object connectors consisting of sourceObject [methodNb, objectNb], targetObject [methodNb, objectNb].<\/p>\n<p style=\"color: #f2b776; font-size: 17px;\"><span style=\"color: #ffffff;\">i) methodState<\/span><\/p>\n<p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">The state the method is currently in, selected from methodState in objects hierachy<\/p>\n<p style=\"color: #f2b776; font-size: 17px;\"><span style=\"color: #ffffff;\">j) methodDuration<\/span><\/p>\n<p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">The duration of the execution of this method. Has to be provided in&nbsp; ISO 8601 format.<\/p>\n<p style=\"color: rgb(242, 183, 118); font-size: 17px;\"><span style=\"color: rgb(255, 255, 255);\">j) executor<\/span><\/p>\n<p style=\"color: rgb(242, 183, 118); font-size: 17px; padding-left: 40px;\">This block contains information about the (future) executor of the method as en encapsulated object.<\/p>\n<p style=\"color: #f2b776; font-size: 17px;\">\n<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-46a4ae4 elementor-widget elementor-widget-text-editor\" data-id=\"46a4ae4\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p style=\"color: #f2b776; font-size: 17px;\"><span style=\"color: #ffffff;\">3.<b> Method Processors<\/b><\/span><\/p><p style=\"color: #f2b776; font-size: 17px;\">Method processors are software that can take a method as input and computes the resulting output objects based on the provided input objects, object connectors and other specific information provided inside the method.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-35005fe elementor-widget elementor-widget-text-editor\" data-id=\"35005fe\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p style=\"color: #f2b776; font-size: 17px;\"><span style=\"color: #ffffff;\"><b>4. Translators<\/b><\/span><\/p><p style=\"color: #f2b776; font-size: 17px;\">Since not all preexisting data is stored in RAL format, we need translators that take existing data and transform them into consistent RAL data format.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t<section class=\"elementor-section elementor-top-section elementor-element elementor-element-a9e365d elementor-section-boxed elementor-section-height-default elementor-section-height-default\" data-id=\"a9e365d\" data-element_type=\"section\" data-e-type=\"section\">\n\t\t\t\t\t\t\t<div class=\"elementor-background-overlay\"><\/div>\n\t\t\t\t\t\t\t<div class=\"elementor-container elementor-column-gap-default\">\n\t\t\t\t\t<div class=\"elementor-column elementor-col-100 elementor-top-column elementor-element elementor-element-c8dad38\" data-id=\"c8dad38\" data-element_type=\"column\" data-e-type=\"column\">\n\t\t\t<div class=\"elementor-widget-wrap elementor-element-populated\">\n\t\t\t\t\t\t<div class=\"elementor-element elementor-element-39bab4b elementor-widget elementor-widget-heading\" data-id=\"39bab4b\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h1 class=\"elementor-heading-title elementor-size-default\">API calls<\/h1>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-1a4f27d elementor-widget elementor-widget-text-editor\" data-id=\"1a4f27d\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p style=\"color: #f2b776; font-size: 17px;\">There are 2 general API calls to the RAL host:<\/p><p style=\"color: #f2b776; font-size: 17px;\"><span style=\"color: #ffffff;\"><strong>1. getHierarchy<\/strong><\/span><\/p><p style=\"color: #f2b776; font-size: 17px;\">This call sends back a JSON or XML of the RAL hierarchy &#8211; a tree structure of all object- and method- templates used by RAL. Based on the names of the items, you can request a template of such an item (see getTemplate)<\/p><p style=\"color: #f2b776; font-size: 17px;\"><b>Parameters<\/b>\u00a0<\/p><p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">a) hierarchyType: &#8220;object&#8221; or &#8220;method&#8221;<\/p><p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">b) returnAs: &#8220;JSON&#8221; or &#8220;XML&#8221;<\/p><p style=\"color: #f2b776; font-size: 17px;\"><b>Returned Data<\/b><\/p><p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">A string containing JSON or XML of the object- or method-hierarchy as requested. In case of an error, a JSON string describing the error is returned.<\/p><p style=\"color: #f2b776; font-size: 17px;\"><b>Example call<\/b><\/p><p style=\"color: #f2b776; font-size: 17px;\">***<\/p><p style=\"color: #f2b776; font-size: 17px;\"><span style=\"font-weight: bolder; color: #ffffff;\">2. getTemplate<\/span><\/p><p style=\"color: #f2b776; font-size: 17px;\">This call sends back a JSON or XML of the requested <i>object<\/i> or <i>method<\/i><\/p><p style=\"color: #f2b776; font-size: 17px;\"><b>Parameters<\/b><\/p><p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">a) hierarchyType: &#8220;object&#8221; or &#8220;method&#8221;<\/p><p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">b) returnAs: &#8220;JSON&#8221; or &#8220;XML&#8221;<\/p><p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">c) templateName: name of the requested template<\/p><p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">d) siteTag: the sitetag you registered at the RAL host [register here]<\/p><p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">e) getUID: &#8220;true&#8221; or &#8220;false&#8221; &#8211; dependent on whether you would like to get a central UID from us or not<\/p><p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">f) (optional) templateVersion: if provided, the call returns the requested version of the template. Otherwise, it will return the most current version.<\/p><p style=\"color: #f2b776; font-size: 17px;\"><b>Returned Data<\/b><\/p><p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">A string containing JSON or XML of the\u00a0requested template. In case of an error, a JSON string describing the error is returned.<b><br \/><\/b><\/p><p style=\"color: #f2b776; font-size: 17px;\">\u00a0<\/p><p style=\"color: #f2b776; font-size: 17px;\"><b>Example call<\/b><\/p><p style=\"color: #f2b776; font-size: 17px;\"><b>***<\/b><\/p><p style=\"color: #f2b776; font-size: 17px;\">\u00a0<\/p><p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">\u00a0<\/p><p style=\"padding-left: 40px;\">\u00a0<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t<section class=\"elementor-section elementor-top-section elementor-element elementor-element-eee997b elementor-section-boxed elementor-section-height-default elementor-section-height-default\" data-id=\"eee997b\" data-element_type=\"section\" data-e-type=\"section\">\n\t\t\t\t\t\t\t<div class=\"elementor-background-overlay\"><\/div>\n\t\t\t\t\t\t\t<div class=\"elementor-container elementor-column-gap-default\">\n\t\t\t\t\t<div class=\"elementor-column elementor-col-100 elementor-top-column elementor-element elementor-element-233a7bf\" data-id=\"233a7bf\" data-element_type=\"column\" data-e-type=\"column\">\n\t\t\t<div class=\"elementor-widget-wrap elementor-element-populated\">\n\t\t\t\t\t\t<div class=\"elementor-element elementor-element-92a0d6b elementor-widget elementor-widget-heading\" data-id=\"92a0d6b\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"heading.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<h1 class=\"elementor-heading-title elementor-size-default\">How to work with RAL items in your application<\/h1>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-5c35b5d elementor-widget elementor-widget-text-editor\" data-id=\"5c35b5d\" data-element_type=\"widget\" data-e-type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t\t\t<p style=\"color: #f2b776; font-size: 17px;\">Once you received the template from the API, we recommend to perform the following steps:<\/p><p style=\"color: #f2b776; font-size: 17px;\"><span style=\"color: #ffffff;\"><strong>1. (optional) generate an UID and persist inside the object\/method<\/strong><\/span><\/p><p style=\"color: #f2b776; font-size: 17px;\"><span style=\"font-family: var( --e-global-typography-text-font-family ), Sans-serif; font-weight: var( --e-global-typography-text-font-weight ); background-color: var( --e-global-color-secondary );\">***<\/span><\/p><p style=\"color: #f2b776; font-size: 17px;\"><span style=\"font-weight: bolder; color: #ffffff;\">2. fill the object\/method with all necessary individual properties<\/span><\/p><p style=\"color: #f2b776; font-size: 17px;\"><b style=\"font-family: var( --e-global-typography-text-font-family ), Sans-serif; background-color: var( --e-global-color-secondary );\">***<\/b><\/p><p style=\"color: #f2b776; font-size: 17px;\"><span style=\"font-weight: bolder; color: #ffffff;\">3. persist the individual in your database<\/span><\/p><p style=\"color: #f2b776; font-size: 17px;\"><span style=\"font-weight: bold; font-family: var( --e-global-typography-text-font-family ), Sans-serif; background-color: var( --e-global-color-secondary );\">***<\/span><\/p><p style=\"color: #f2b776; font-size: 17px;\">\u00a0<\/p><p style=\"color: #f2b776; font-size: 17px; padding-left: 40px;\">\u00a0<\/p><p style=\"padding-left: 40px;\">\u00a0<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t<\/div>\n\t\t","protected":false},"excerpt":{"rendered":"<p>heal-the-earth foundation building partnerships to regenerate soils RAL &#8211; a digital language for regenerative agriculture Intention We believe that sustainable partnerships for the support of&nbsp;EarthHealers need a freely accessible, shared digital language. Therefore, we developed and host&nbsp;RAL &#8211; the regenerative agriculture language &#8211;&nbsp;as non-commercial, open access project.&nbsp; This language is an ontology-like knowledge representation that [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":16,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"open","template":"elementor_header_footer","meta":{"footnotes":""},"class_list":["post-54","page","type-page","status-publish","has-post-thumbnail","hentry"],"_links":{"self":[{"href":"https:\/\/heal-the.earth\/de\/wp-json\/wp\/v2\/pages\/54","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/heal-the.earth\/de\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/heal-the.earth\/de\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/heal-the.earth\/de\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/heal-the.earth\/de\/wp-json\/wp\/v2\/comments?post=54"}],"version-history":[{"count":104,"href":"https:\/\/heal-the.earth\/de\/wp-json\/wp\/v2\/pages\/54\/revisions"}],"predecessor-version":[{"id":603,"href":"https:\/\/heal-the.earth\/de\/wp-json\/wp\/v2\/pages\/54\/revisions\/603"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/heal-the.earth\/de\/wp-json\/wp\/v2\/media\/16"}],"wp:attachment":[{"href":"https:\/\/heal-the.earth\/de\/wp-json\/wp\/v2\/media?parent=54"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}