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 de documento, carpeta, correo o record válido.
Además, en todos los métodos verá un parámetro llamado “token”. Como las tareas de Cron se ejecutan en segundo plano sin autenticación, los métodos usados en ese escenario pueden 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 de retorno | 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 de retorno | Descripción |
|---|---|---|
| get(String token, String noteId) | Note | Obtiene 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 de retorno | 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 de retorno | Descripción |
|---|---|---|
| set(String token, String noteId, String text) | void | Cambia el texto de 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, "b153c4b7-3d1c-4589-bd42-0ed0f34fd338")) { okmNote.set(null, note.getPath(), "new note"); } } catch (Exception e) { e.printStackTrace(); } }}Descripción:
| Método | Valores de retorno | Descripción |
|---|---|---|
| list(String token, String nodeId) | List |
Obtiene 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 de retorno | 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(); } }}