OKMBookmark
Se utiliza para gestionar los marcadores de los usuarios. Por ejemplo, añadir o eliminar el marcador de un nodo para un usuario.
Conceptos básicos
Sección titulada «Conceptos básicos»En casi todos los métodos verá un parámetro llamado “nodeId”. El valor de este parámetro puede ser el UUID de un nodo válido (carpeta, documento, correo, registro) o la ruta del nodo.
Además, en todos los métodos verá un parámetro llamado “token”. Dado que las tareas cron se ejecutan en segundo plano sin autenticación, los métodos utilizados en este escenario pueden usar el parámetro token. Desde el contexto de ejecución predeterminado de la aplicación debe utilizar el valor “null”, que indica que la aplicación debe usar la “sesión de usuario”.
Métodos
Sección titulada «Métodos»Descripción:
| Método | Valores devueltos | Descripción |
|---|---|---|
| add(String token, String nodeId, String name) | Bookmark | Añade un nuevo marcador de un nodo. |
Ejemplo:
package com.openkm;
import com.openkm.api.OKMBookmark;import com.openkm.db.bean.Bookmark;import com.openkm.util.ContextWrapper;
public class Test {
public static void main(String[] args) { try { OKMBookmark okmBookmark = ContextWrapper.getContext().getBean(OKMBookmark.class); Bookmark bookmark = okmBookmark.add(null, "3887ae75-dd67-4019-b4d1-2f6962815403", "document.doc"); System.out.println(bookmark); } catch (Exception e) { e.printStackTrace(); } }}Descripción:
| Método | Valores devueltos | Descripción |
|---|---|---|
| get(String token, int bmId) | Bookmark | Obtiene los datos del marcador. |
Ejemplo:
package com.openkm;
import com.openkm.api.OKMBookmark;import com.openkm.db.bean.Bookmark;import com.openkm.util.ContextWrapper;
public class Test {
public static void main(String[] args) { try { OKMBookmark okmBookmark = ContextWrapper.getContext().getBean(OKMBookmark.class); int bmId = 2; Bookmark bookmark = okmBookmark.get(null, bmId); System.out.println(bookmark); } catch (Exception e) { e.printStackTrace(); } }}Descripción:
| Método | Valores devueltos | Descripción |
|---|---|---|
| remove(String token, int bmId) | void | Elimina un marcador. |
Ejemplo:
package com.openkm;
import com.openkm.api.OKMBookmark;
public class Test { public static void main(String[] args) { try { int bmId = 23; OKMBookmark.getInstance().remove(null, bmId); } catch (Exception e) { e.printStackTrace(); } }}Descripción:
| Método | Valores devueltos | Descripción |
|---|---|---|
| rename(String token, int bmId, String newName | Bookmark | Renombra un marcador. |
Ejemplo:
package com.openkm;
import com.openkm.api.OKMBookmark;import com.openkm.db.bean.Bookmark;import com.openkm.util.ContextWrapper;
public class Test {
public static void main(String[] args) { try { OKMBookmark okmBookmark = ContextWrapper.getContext().getBean(OKMBookmark.class); int bmId = 2; Bookmark bookmark = okmBookmark.rename(null, bmId, "newname.doc"); System.out.println(bookmark); } catch (Exception e) { e.printStackTrace(); } }}Descripción:
| Método | Valores devueltos | Descripción |
|---|---|---|
| getAll(String token) | List |
Obtiene todos los marcadores del usuario conectado. |
Ejemplo:
package com.openkm;
import com.openkm.api.OKMBookmark;import com.openkm.db.bean.Bookmark;import com.openkm.util.ContextWrapper;
public class Test {
public static void main(String[] args) { try { OKMBookmark okmBookmark = ContextWrapper.getContext().getBean(OKMBookmark.class); for (Bookmark bookmark : okmBookmark.getAll(null)) { System.out.println(bookmark); } } catch (Exception e) { e.printStackTrace(); } }}