Base de conocimientos BCdiplomaBase de conocimientos BCdiploma
Guía del usuario
Guía técnica
API
CGU y datos
  • English
  • Français
  • Español
Guía del usuario
Guía técnica
API
CGU y datos
  • English
  • Français
  • Español
  • API

    • Cómo utilizar la API de BCdiploma
    • Automatizar el proceso de emisión
    • Eliminaciones y desactivaciones
    • Actualización
    • Gestión de plantillas
    • Gestión de rutas de aprendizaje
    • Descarga
    • Exportación de datos
    • Otras API
    • Gestión de errores

Gestión de rutas de aprendizaje

Crear o actualizar una ruta de aprendizaje

Una ruta de aprendizaje (pathway) se define directamente en la configuración de una plantilla de certificado padre. Para crear una ruta de aprendizaje, basta con añadir una entrada meta_pathway al JSON de la plantilla padre y, a continuación, actualizar dicha plantilla mediante una llamada PUT al endpoint [API-URL]/issuer/:issuer/template/:template.

Consejos

La clave "key" define el campo de unión utilizado para vincular los certificados que componen la ruta de aprendizaje. Si se omite, se utiliza automáticamente el valor predeterminado ^Email¤.

La propiedad def contiene la lista de las plantillas hijas integradas en la ruta de aprendizaje, identificadas por su id:

"meta_pathway": {
  "def": [
    {
      "id": "1x30"
    },
    {
      "id": "1x31"
    },
    {
      "id": "1x3A"
    }
  ]
}

Utilizar tablas de referencia para filtrar las plantillas de la ruta de aprendizaje

Es posible condicionar la inclusión de una plantilla hija en una ruta de aprendizaje al valor de un placeholder determinado, siempre que dicho placeholder sea una entrada de una tabla de referencia.

Por ejemplo, si la unión debe realizarse según el valor del placeholder ^formation¤, que es una entrada de la tabla ref_formation, la sintaxis pasa a ser la siguiente:

"meta_pathway": {
  "key": "^Email¤",
  "def": [
    {
      "id": "1x01",
      "formation": [
        "Australian Major Projects Leadership Academy",
        "Creativity and Design Thinking"
      ]
    },
    {
      "id": "1x02",
      "formation": [
        "Development & Marketing",
        "Digital Transformation"
      ]
    },
    {
      "id": "1x03",
      "formation": [
        "Development & Marketing",
        "Creativity and Design Thinking",
        "Catalyzing Digital Transformation"
      ]
    },
    {
      "id": "1x06",
      "formation": [
        "Catalyzing Digital Transformation",
        "Medical Statistics"
      ]
    }
  ]
}

En este ejemplo, la plantilla 1x01 se incluirá en la ruta de aprendizaje únicamente si el valor del placeholder formation es Australian Major Projects Leadership Academy o Creativity and Design Thinking.

Retirar una plantilla de una ruta de aprendizaje

Para retirar una plantilla hija de una ruta de aprendizaje, basta con eliminar su entrada de la lista def y actualizar la plantilla padre mediante una llamada PUT al endpoint [API-URL]/issuer/:issuer/template/:template.

Aviso

Cuando una plantilla se añade a una ruta de aprendizaje como hija, se le asigna automáticamente la etiqueta meta_pw_key. Esta etiqueta no se elimina si la plantilla se retira de la ruta de aprendizaje, con el fin de no invalidar los certificados ya publicados.

Prev
Gestión de plantillas
Next
Descarga