OKMNote
Fundamentos
Sección titulada «Fundamentos»En la mayoría de los métodos verá un parámetro llamado “nodeId”. El valor de este parámetro puede ser un UUID válido de documento, carpeta, correo o registro.
Además, en todos los métodos verá un parámetro llamado “token”. Dado que las tareas de cron se ejecutan en segundo plano sin autenticación, los métodos usados en este escenario podrían usar el parámetro token. En el contexto de ejecución por defecto de la aplicación, debe usar 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 text) | Note | Añade una nota a un nodo y devuelve un objeto Note. |
Ejemplo:
package com.openkm;
import com.openkm.api.OKMNote;import com.openkm.bean.Note;import com.openkm.util.ContextWrapper;
public class Test {
public static void main(String[] args) { try { OKMNote okmNote = ContextWrapper.getContext().getBean(OKMNote.class); Note note = okmNote.add(null, "f123a950-0329-4d62-8328-0ff500fd42db", "the note text"); System.out.println(note); } catch (Exception e) { e.printStackTrace(); } }}Descripción:
| Método | Valores devueltos | Descripción |
|---|---|---|
| get(String token, String noteId) | Note | Recupera la nota. |
Ejemplo:
package com.openkm;
import com.openkm.api.OKMNote;import com.openkm.bean.Note;import com.openkm.util.ContextWrapper;
public class Test {
public static void main(String[] args) { try { OKMNote okmNote = ContextWrapper.getContext().getBean(OKMNote.class); for (Note note : okmNote.list(null, "f123a950-0329-4d62-8328-0ff500fd42db")) { Note data = okmNote.get(null, note.getPath()); System.out.println(data); } } catch (Exception e) { e.printStackTrace(); } }}Descripción:
| Método | Valores devueltos | Descripción |
|---|---|---|
| delete(String token, String noteId) | void | Elimina una nota. |
Ejemplo:
package com.openkm;
import com.openkm.api.OKMNote;import com.openkm.bean.Note;import com.openkm.util.ContextWrapper;
public class Test {
public static void main(String[] args) { try { OKMNote okmNote = ContextWrapper.getContext().getBean(OKMNote.class); for (Note note : okmNote.list(null, "b153c4b7-3d1c-4589-bd42-0ed0f34fd338")) { okmNote.delete(null, note.getPath()); } } catch (Exception e) { e.printStackTrace(); } }}Descripción:
| Método | Valores devueltos | Descripción |
|---|---|---|
| set(String token, String noteId, String text) | String | Cambia el texto de la nota. Devuelve el texto actualizado. |
Ejemplo:
package com.openkm;
import com.openkm.api.OKMNote;import com.openkm.bean.Note;import com.openkm.util.ContextWrapper;
public class Test {
public static void main(String[] args) { try { OKMNote okmNote = ContextWrapper.getContext().getBean(OKMNote.class); for (Note note : okmNote.list(null, "b153c4b7-3d1c-4589-bd42-0ed0f34fd338")) { String updated = okmNote.set(null, note.getPath(), "new note"); System.out.println(updated); } } catch (Exception e) { e.printStackTrace(); } }}Descripción:
| Método | Valores devueltos | Descripción |
|---|---|---|
| list(String token, String nodeId) | List |
Recupera una lista de todas las notas de un nodo. |
Ejemplo:
package com.openkm;
import com.openkm.api.OKMNote;import com.openkm.bean.Note;import com.openkm.util.ContextWrapper;
public class Test {
public static void main(String[] args) { try { OKMNote okmNote = ContextWrapper.getContext().getBean(OKMNote.class); for (Note note : okmNote.list(null, "b153c4b7-3d1c-4589-bd42-0ed0f34fd338")) { System.out.println(note); } } catch (Exception e) { e.printStackTrace(); } }}getNoteHistories
Sección titulada «getNoteHistories»Descripción:
| Método | Valores devueltos | Descripción |
|---|---|---|
| getNoteHistories(String token, String nodeId) | List |
Devuelve el histórico de notas de un nodo. |
Ejemplo:
package com.openkm;
import com.openkm.api.OKMNote;import com.openkm.bean.NoteHistory;import com.openkm.util.ContextWrapper;
public class Test {
public static void main(String[] args) { try { OKMNote okmNote = ContextWrapper.getContext().getBean(OKMNote.class); for (NoteHistory noteHistory : okmNote.getNoteHistories(null, "3c68b3a1-c65c-4b1e-84b5-9ce2712ca573")) { System.out.println(noteHistory); } } catch (Exception e) { e.printStackTrace(); } }}