OKMDashboard

Conceptos básicos

En todos los métodos verá un parámetro llamado “token”. Al acceder a la aplicación a través de SOAP, el proceso de inicio de sesión devuelve un token que se utiliza para identificar al usuario en todos los métodos expuestos. Desde el contexto de ejecución por defecto de la aplicación debe utilizar el valor “null”, que indica a la aplicación que debe utilizar la “sesión del usuario”.

Consejo

En casos especiales puede “promocionarse como Administrador” utilizando el “token de administrador”.

String systemToken = DbSessionManager.getInstance().getSystemToken();

Métodos

getUserCheckedOutDocuments

Descripción:

Método	Valores de retorno	Descripción
getUserCheckedOutDocuments(String token)	List	Obtiene la lista de documentos con checkout del usuario.

Ejemplo:

package com.openkm;

import com.openkm.api.OKMDashboard;
import com.openkm.bean.DashboardDocumentResult;

public class Test {
    public static void main(String[] args) {
        try {
            for (DashboardDocumentResult dashboardDocumentResult : OKMDashboard.getInstance().getUserCheckedOutDocuments(null)) {
                System.out.println(dashboardDocumentResult);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

getUserLastModifiedDocuments

Descripción:

Método	Valores de retorno	Descripción
getUserLastModifiedDocuments(String token)	List	Obtiene la lista de los últimos documentos modificados por el usuario.

Ejemplo:

package com.openkm;

import com.openkm.api.OKMDashboard;
import com.openkm.bean.DashboardDocumentResult;

public class Test {
    public static void main(String[] args) {
        try {
            for (DashboardDocumentResult dashboardDocumentResult : OKMDashboard.getInstance().getUserLastModifiedDocuments(null)) {
                System.out.println(dashboardDocumentResult);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

getUserLockedDocuments

Descripción:

Método	Valores de retorno	Descripción
getUserLockedDocuments(String token)	List	Obtiene la lista de los documentos bloqueados modificados por el usuario.

Ejemplo:

package com.openkm;

import com.openkm.api.OKMDashboard;
import com.openkm.bean.DashboardDocumentResult;

public class Test {
    public static void main(String[] args) {
        try {
            for (DashboardDocumentResult dashboardDocumentResult : OKMDashboard.getInstance().getUserLockedDocuments(null)) {
                System.out.println(dashboardDocumentResult);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

getUserSubscribedDocuments

Descripción:

Método	Valores de retorno	Descripción
getUserSubscribedDocuments(String token)	List	Obtiene la lista de los documentos a los que está suscrito el usuario.

Ejemplo:

package com.openkm;

import com.openkm.api.OKMDashboard;
import com.openkm.bean.DashboardDocumentResult;

public class Test {
    public static void main(String[] args) {
        try {
            for (DashboardDocumentResult dashboardDocumentResult : OKMDashboard.getInstance().getUserSubscribedDocuments(null)) {
                System.out.println(dashboardDocumentResult);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

getUserSubscribedFolders

Descripción:

Método	Valores de retorno	Descripción
getUserSubscribedFolders(String token)	List	Obtiene la lista de las carpetas a las que está suscrito el usuario.

Ejemplo:

package com.openkm;

import com.openkm.api.OKMDashboard;
import com.openkm.bean.DashboardFolderResult;

public class Test {
    public static void main(String[] args) {
        try {
            for (DashboardFolderResult dashboardFolderResult : OKMDashboard.getInstance().getUserSubscribedFolders(null)) {
                System.out.println(dashboardFolderResult);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

getUserLastUploadedDocuments

Descripción:

Método	Valores de retorno	Descripción
getUserLastUploadedDocuments(String token)	List	Obtiene la lista de los últimos documentos subidos por el usuario.

Ejemplo:

package com.openkm;

import com.openkm.api.OKMDashboard;
import com.openkm.bean.DashboardDocumentResult;

public class Test {
    public static void main(String[] args) {
        try {
            for (DashboardDocumentResult dashboardDocumentResult : OKMDashboard.getInstance().getUserLastUploadedDocuments(null)) {
                System.out.println(dashboardDocumentResult);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

getUserLastDownloadedDocuments

Descripción:

Método	Valores de retorno	Descripción
getUserLastDownloadedDocuments(String token)	List	Obtiene la lista de los últimos documentos descargados por el usuario.

Ejemplo:

package com.openkm;

import com.openkm.api.OKMDashboard;
import com.openkm.bean.DashboardDocumentResult;

public class Test {
    public static void main(String[] args) {
        try {
            for (DashboardDocumentResult dashboardDocumentResult : OKMDashboard.getInstance().getUserLastDownloadedDocuments(null)) {
                System.out.println(dashboardDocumentResult);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

getUserLastImportedMails

Descripción:

Método	Valores de retorno	Descripción
getUserLastImportedMails(String token)	List	Obtiene la lista de los últimos correos importados por el usuario.

Ejemplo:

package com.openkm;

import com.openkm.api.OKMDashboard;
import com.openkm.bean.DashboardMailResult;

public class Test {
    public static void main(String[] args) {
        try {
            for (DashboardMailResult dashboardMailResult : OKMDashboard.getInstance().getUserLastImportedMails(null)) {
                System.out.println(dashboardMailResult);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

getUserLastImportedMailAttachments

Descripción:

Método	Valores de retorno	Descripción
getUserLastImportedMailAttachments(String token)	List	Obtiene la lista de los últimos adjuntos de correo importados por el usuario.

Ejemplo:

package com.openkm;

import com.openkm.api.OKMDashboard;
import com.openkm.bean.DashboardDocumentResult;

public class Test {
    public static void main(String[] args) {
        try {
            for (DashboardDocumentResult dashboardDocumentResult : OKMDashboard.getInstance().getUserLastImportedMailAttachments(null)) {
                System.out.println(dashboardDocumentResult);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

getUserDocumentsSize

Descripción:

Método	Valores de retorno	Descripción
getUserDocumentsSize(String token)	long	Devuelve el tamaño total en bytes de los documentos del usuario.

Nota

Cuando un usuario sube o modifica un documento, el tamaño completo del contenido (y de las versiones del historial en caso de actualización) se asigna a los usuarios.

Ejemplo:

package com.openkm;

import com.openkm.api.OKMDashboard;
import com.openkm.util.FormatUtil;

public class Test {
    public static void main(String[] args) {
        try {
            long sizeInBytes = OKMDashboard.getInstance().getUserDocumentsSize(null);
            System.out.println(FormatUtil.formatSize(sizeInBytes));

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

getUserSearchs

Descripción:

Método	Valores de retorno	Descripción
getUserSearchs(String token)	List	Obtiene la lista de todas las “novedades de usuario” guardadas por el usuario.

Nota

Las búsquedas “guardadas por el usuario” se ejecutan periódicamente para obtener novedades basadas en consultas del repositorio.

Más información en las vistas Trabajar con el panel de control y Trabajar con la búsqueda.

Ejemplo:

package com.openkm;

import com.openkm.api.OKMDashboard;
import com.openkm.dao.bean.QueryParams;

public class Test {
    public static void main(String[] args) {
        try {
            for (QueryParams qp : OKMDashboard.getInstance().getUserSearchs(null)) {
                System.out.println(qp);
            }

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

find

Descripción:

Método	Valores de retorno	Descripción
find(String token, int qpId)	List	Ejecuta una “novedad de usuario”.

• El parámetro qpId es el identificador único de la búsqueda de “novedades de usuario”.

Ejemplo:

package com.openkm;

import com.openkm.api.OKMDashboard;
import com.openkm.bean.DashboardNodeResult;
import com.openkm.bean.Document;
import com.openkm.bean.Folder;
import com.openkm.bean.Mail;

public class Test {
    public static void main(String[] args) {
        try {
            int qpId = 12;
            for (DashboardNodeResult dashboardNodeResult : OKMDashboard.getInstance().find(null, qpId)) {
                if (dashboardNodeResult.getNode() instanceof Document ) {
                    Document doc = (Document) dashboardNodeResult.getNode();
                    System.out.println(doc);
                } else if (dashboardNodeResult.getNode() instanceof Folder ) {
                    Folder fld = (Folder) dashboardNodeResult.getNode();
                    System.out.println(fld);
                } else if (dashboardNodeResult.getNode() instanceof Mail ) {
                    Mail mail = (Mail) dashboardNodeResult.getNode();
                    System.out.println(mail);
                }
            }

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

getLastWeekTopDownloadedDocuments

Descripción:

Método	Valores de retorno	Descripción
getLastWeekTopDownloadedDocuments(String token)	List	Obtiene la lista de los documentos más descargados durante la última semana por todos los usuarios.

Ejemplo:

package com.openkm;

import com.openkm.api.OKMDashboard;
import com.openkm.bean.DashboardDocumentResult;

public class Test {
    public static void main(String[] args) {
        try {
            for (DashboardDocumentResult dashboardDocumentResult : OKMDashboard.getInstance().getLastWeekTopDownloadedDocuments(null)) {
                System.out.println(dashboardDocumentResult);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

getLastMonthTopDownloadedDocuments

Descripción:

Método	Valores de retorno	Descripción
getLastMonthTopDownloadedDocuments(String token)	List	Obtiene la lista de los documentos más descargados durante el último mes por todos los usuarios.

Ejemplo:

package com.openkm;

import com.openkm.api.OKMDashboard;
import com.openkm.bean.DashboardDocumentResult;

public class Test {
    public static void main(String[] args) {
        try {
            for (DashboardDocumentResult dashboardDocumentResult : OKMDashboard.getInstance().getLastMonthTopDownloadedDocuments(null)) {
                System.out.println(dashboardDocumentResult);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

getLastWeekTopModifiedDocuments

Descripción:

Método	Valores de retorno	Descripción
getLastWeekTopModifiedDocuments(String token)	List	Obtiene la lista de los documentos más modificados durante la última semana por todos los usuarios.

Ejemplo:

package com.openkm;

import com.openkm.api.OKMDashboard;
import com.openkm.bean.DashboardDocumentResult;

public class Test {
    public static void main(String[] args) {
        try {
            for (DashboardDocumentResult dashboardDocumentResult : OKMDashboard.getInstance().getLastWeekTopModifiedDocuments(null)) {
                System.out.println(dashboardDocumentResult);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

getLastMonthTopModifiedDocuments

Descripción:

Método	Valores de retorno	Descripción
getLastMonthTopModifiedDocuments(String token)	List	Obtiene la lista de los documentos más modificados durante el último mes por todos los usuarios.

Ejemplo:

package com.openkm;

import com.openkm.api.OKMDashboard;
import com.openkm.bean.DashboardDocumentResult;

public class Test {
    public static void main(String[] args) {
        try {
            for (DashboardDocumentResult dashboardDocumentResult : OKMDashboard.getInstance().getLastMonthTopModifiedDocuments(null)) {
                System.out.println(dashboardDocumentResult);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

getLastModifiedDocuments

Descripción:

Método	Valores de retorno	Descripción
getLastModifiedDocuments(String token)	List	Obtiene la lista de los últimos documentos modificados por todos los usuarios.

Ejemplo:

package com.openkm;

import com.openkm.api.OKMDashboard;
import com.openkm.bean.DashboardDocumentResult;

public class Test {
    public static void main(String[] args) {
        try {
            for (DashboardDocumentResult dashboardDocumentResult : OKMDashboard.getInstance().getLastModifiedDocuments(null)) {
                System.out.println(dashboardDocumentResult);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

getLastUploadedDocuments

Descripción:

Método	Valores de retorno	Descripción
getLastUploadedDocuments(String token)	List	Obtiene la lista de los últimos documentos subidos por todos los usuarios.

Ejemplo:

package com.openkm;

import com.openkm.api.OKMDashboard;
import com.openkm.bean.DashboardDocumentResult;

public class Test {
    public static void main(String[] args) {
        try {
            for (DashboardDocumentResult dashboardDocumentResult : OKMDashboard.getInstance().getLastUploadedDocuments(null)) {
                System.out.println(dashboardDocumentResult);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

visiteNode

Descripción:

Método	Valores de retorno	Descripción
visiteNode(String token, String source, String node, Calendar date)	void	Marca un nodo como visitado.

• Orígenes disponibles:

Nota

Desde la interfaz, los nodos se muestran en negrita hasta que el usuario los visita. Este método marca el nodo como visitado por el usuario en la base de datos.

Ejemplo:

package com.openkm;

import java.util.Calendar;

import com.openkm.api.OKMDashboard;

public class Test {
    public static void main(String[] args) {
        try {
            Calendar cal = Calendar.getInstance();
            OKMDashboard.getInstance().visiteNode(null, "LastWeekTopDownloadedDocuments", "/okm:root/sample.pdf", cal);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}