221 lines
12 KiB
JavaScript
221 lines
12 KiB
JavaScript
|
|
// Gestión de UNA actividad (completar, reprogramar, cancelar, deshacer) — solo servidor. Todo con el token
|
||
|
|
// del usuario conectado (derechos del propio usuario) y SIN caché: se valida con el estado de este momento.
|
||
|
|
// Diseño y decisiones: Proyectos/Análisis e Informes/Analitica de CRM/egm/concepts_brief.md
|
||
|
|
import { dvFresh, dvWrite, odataString } from "./dataverse";
|
||
|
|
import { ENTIDAD_TIPO, aUtc, minAHora, horaAMin, localDeIso, AGENDADOR } from "./agendador";
|
||
|
|
import { GC, parseCodigos, formatCodigos } from "./participantes";
|
||
|
|
|
||
|
|
// [statecode, statuscode] de cada estado, por tipo (cancelar ya probado el 2026-10-27; completar y reabrir se
|
||
|
|
// prueban en la oportunidad KUAI antes de publicar — ver sesion.md del 2026-11-06).
|
||
|
|
const ESTADOS = {
|
||
|
|
Llamada: { completada: [1, 2], cancelada: [2, 3] },
|
||
|
|
Cita: { completada: [1, 3], cancelada: [2, 4] },
|
||
|
|
Tarea: { completada: [1, 5], cancelada: [2, 6] },
|
||
|
|
};
|
||
|
|
// Citas: statecode 0 (Abierta) y 3 (Programada) cuentan como abiertas.
|
||
|
|
const abierta = (statecode) => statecode === 0 || statecode === 3;
|
||
|
|
|
||
|
|
const esc = (s) => String(s).replace(/&/g, "&").replace(/</g, "<").replace(/>/g, ">");
|
||
|
|
|
||
|
|
function selectDe(tipo) {
|
||
|
|
const base = ["activityid", "subject", "statecode", "statuscode", "scheduledstart", "scheduledend", "_ownerid_value", "_regardingobjectid_value", "description", "actualend"];
|
||
|
|
if (tipo === "Cita") base.push("alfa_resultadodelavisita", "location", "alfa_participantes");
|
||
|
|
if (tipo === "Tarea") base.push("percentcomplete");
|
||
|
|
return base.join(",");
|
||
|
|
}
|
||
|
|
|
||
|
|
// Lee la actividad con datos de este momento. Para citas cuenta los invitados (asistentes requeridos u
|
||
|
|
// opcionales): reprogramar o cancelar una cita con invitados puede mandarles avisos, y eso no se deshace.
|
||
|
|
export async function leerActividad(token, tipo, id) {
|
||
|
|
const ent = ENTIDAD_TIPO[tipo];
|
||
|
|
const NAV_OBJ = { Llamada: "alfa_ObjetivodeActividad_PhoneCall", Cita: "alfa_ObjetivodeActividad_Appointment", Tarea: "alfa_ObjetivodeActividad_Task" }[tipo];
|
||
|
|
const expand = `&$expand=${tipo === "Cita" ? "appointment_activity_parties($select=participationtypemask)," : ""}${NAV_OBJ}($select=alfa_objetivo)`;
|
||
|
|
const d = await dvFresh(`${ent}(${odataString(id)})?$select=${selectDe(tipo)}${expand}`, token);
|
||
|
|
const invitados = tipo === "Cita" ? (d.appointment_activity_parties || []).filter((p) => p.participationtypemask === 5 || p.participationtypemask === 6).length : 0;
|
||
|
|
return {
|
||
|
|
id: d.activityid,
|
||
|
|
tipo,
|
||
|
|
etag: d["@odata.etag"] || null,
|
||
|
|
asunto: d.subject || "(sin asunto)",
|
||
|
|
statecode: d.statecode,
|
||
|
|
statuscode: d.statuscode,
|
||
|
|
estado: d.statecode === 1 ? "completada" : d.statecode === 2 ? "cancelada" : "abierta",
|
||
|
|
scheduledstart: d.scheduledstart || null,
|
||
|
|
scheduledend: d.scheduledend || null,
|
||
|
|
ownerId: d._ownerid_value || null,
|
||
|
|
owner: d["_ownerid_value@OData.Community.Display.V1.FormattedValue"] || "",
|
||
|
|
referente: d["_regardingobjectid_value@OData.Community.Display.V1.FormattedValue"] || null,
|
||
|
|
// Solo si «Referente a» es una oportunidad (también puede ser cuenta o caso): ahí se suma la participación.
|
||
|
|
oppId: d["_regardingobjectid_value@Microsoft.Dynamics.CRM.lookuplogicalname"] === "opportunity" ? d._regardingobjectid_value : null,
|
||
|
|
participantes: parseCodigos(d.alfa_participantes),
|
||
|
|
description: d.description ?? null,
|
||
|
|
resultadoVisita: d.alfa_resultadodelavisita ?? null,
|
||
|
|
actualend: d.actualend || null,
|
||
|
|
percentcomplete: d.percentcomplete ?? null,
|
||
|
|
invitados,
|
||
|
|
objetivo: d[NAV_OBJ]?.alfa_objetivo ? String(d[NAV_OBJ].alfa_objetivo).trim() : null,
|
||
|
|
};
|
||
|
|
}
|
||
|
|
|
||
|
|
// Dónde va la nota de cada tipo. Cita → «Resultado de la visita» (texto enriquecido, HTML): NUNCA la
|
||
|
|
// descripción, que lleva la invitación de Teams/Outlook que se envía al contacto. Llamada y tarea → descripción.
|
||
|
|
// Siempre se ANTEPONE: lo que el ejecutivo ya había escrito no se pierde.
|
||
|
|
function camposDeNota(act, nota) {
|
||
|
|
const t = String(nota || "").trim();
|
||
|
|
if (!t) return {};
|
||
|
|
if (act.tipo === "Cita") {
|
||
|
|
const previo = act.resultadoVisita || "";
|
||
|
|
return { alfa_resultadodelavisita: `<p>${esc(t).replace(/\n/g, "<br>")}</p>${previo}` };
|
||
|
|
}
|
||
|
|
return { description: act.description ? `${t}\n\n${act.description}` : t };
|
||
|
|
}
|
||
|
|
|
||
|
|
const sinInvitados = (act) => (act.tipo === "Cita" && act.invitados > 0 ? "CON_INVITADOS" : null);
|
||
|
|
|
||
|
|
// Valida que la actividad se pueda tocar. Devuelve un código de error o null.
|
||
|
|
export function problemaPara(act, accion) {
|
||
|
|
if (!abierta(act.statecode)) return "CERRADA";
|
||
|
|
if ((accion === "reprogramar" || accion === "cancelar") && sinInvitados(act)) return "CON_INVITADOS";
|
||
|
|
return null;
|
||
|
|
}
|
||
|
|
|
||
|
|
// Foto de lo que se va a cambiar, para poder deshacerlo.
|
||
|
|
const fotoDe = (act) => ({
|
||
|
|
statecode: act.statecode,
|
||
|
|
statuscode: act.statuscode,
|
||
|
|
scheduledstart: act.scheduledstart,
|
||
|
|
scheduledend: act.scheduledend,
|
||
|
|
description: act.description,
|
||
|
|
resultadoVisita: act.resultadoVisita,
|
||
|
|
actualend: act.actualend,
|
||
|
|
percentcomplete: act.percentcomplete,
|
||
|
|
participantes: act.participantes,
|
||
|
|
});
|
||
|
|
|
||
|
|
async function cerrar(token, act, estado, nota, extra = {}) {
|
||
|
|
const ent = ENTIDAD_TIPO[act.tipo];
|
||
|
|
const url = `${ent}(${odataString(act.id)})`;
|
||
|
|
// 1) Los datos (nota, fecha real, avance) se escriben con la actividad todavía abierta y con `If-Match`:
|
||
|
|
// si el ejecutivo la cambió en Dynamics mientras tanto, falla (412) y no se pisa nada.
|
||
|
|
const campos = { ...camposDeNota(act, nota), ...extra };
|
||
|
|
if (Object.keys(campos).length) {
|
||
|
|
await dvWrite("PATCH", url, token, campos, act.etag ? { "If-Match": act.etag } : {});
|
||
|
|
}
|
||
|
|
// 2) El cambio de estado va aparte.
|
||
|
|
const [statecode, statuscode] = ESTADOS[act.tipo][estado];
|
||
|
|
await dvWrite("PATCH", url, token, { statecode, statuscode });
|
||
|
|
}
|
||
|
|
|
||
|
|
export async function completarActividad(token, act, nota, participantes = [], actualend = null) {
|
||
|
|
const extra = { actualend: actualend || new Date().toISOString() };
|
||
|
|
if (act.tipo === "Tarea") extra.percentcomplete = 100;
|
||
|
|
// Una actividad cerrada es de solo lectura en Dynamics: los participantes de la cita se escriben ANTES
|
||
|
|
// de cerrarla (junto con la nota), nunca después.
|
||
|
|
if (act.tipo === "Cita" && participantes.length) extra.alfa_participantes = formatCodigos(participantes);
|
||
|
|
await cerrar(token, act, "completada", nota, extra);
|
||
|
|
return { statecode: 1, statuscode: ESTADOS[act.tipo].completada[1] };
|
||
|
|
}
|
||
|
|
|
||
|
|
export async function cancelarActividad(token, act, nota) {
|
||
|
|
await cerrar(token, act, "cancelada", nota);
|
||
|
|
return { statecode: 2, statuscode: ESTADOS[act.tipo].cancelada[1] };
|
||
|
|
}
|
||
|
|
|
||
|
|
// Nueva fecha. Llamadas y citas conservan su duración (si no tienen, 30 y 60 min); las tareas vencen a las 16:00.
|
||
|
|
export async function reprogramarActividad(token, act, dia, hora) {
|
||
|
|
const ent = ENTIDAD_TIPO[act.tipo];
|
||
|
|
let inicio;
|
||
|
|
let fin;
|
||
|
|
if (act.tipo === "Tarea") {
|
||
|
|
inicio = aUtc(dia, minAHora(AGENDADOR.horaTarea));
|
||
|
|
fin = inicio;
|
||
|
|
} else {
|
||
|
|
let dur = AGENDADOR.duracion[act.tipo];
|
||
|
|
if (act.scheduledstart && act.scheduledend) {
|
||
|
|
const m = Math.round((new Date(act.scheduledend) - new Date(act.scheduledstart)) / 60000);
|
||
|
|
if (m > 0 && m <= 480) dur = m;
|
||
|
|
}
|
||
|
|
inicio = aUtc(dia, hora);
|
||
|
|
fin = aUtc(dia, minAHora(horaAMin(hora) + dur));
|
||
|
|
}
|
||
|
|
await dvWrite("PATCH", `${ent}(${odataString(act.id)})`, token, { scheduledstart: inicio, scheduledend: fin }, act.etag ? { "If-Match": act.etag } : {});
|
||
|
|
return { scheduledstart: inicio, scheduledend: fin };
|
||
|
|
}
|
||
|
|
|
||
|
|
// ---- Participación en la oportunidad -------------------------------------------------------------------
|
||
|
|
// Gerencia Comercial → Sí/No `alfa_participaciondegv` (alimenta la puntuación); los demás roles → el campo
|
||
|
|
// múltiple `alfa_participantes`. Solo SUMA (nunca quita ni baja un Sí a No) y se registra lo anterior para
|
||
|
|
// poder deshacerlo.
|
||
|
|
export async function leerParticipacionOpp(token, oppId) {
|
||
|
|
const d = await dvFresh(`opportunities(${odataString(oppId)})?$select=alfa_participaciondegv,alfa_participantes,statecode`, token);
|
||
|
|
return { id: oppId, etag: d["@odata.etag"] || null, gv: d.alfa_participaciondegv === true, participantes: parseCodigos(d.alfa_participantes), abierta: d.statecode === 0 };
|
||
|
|
}
|
||
|
|
|
||
|
|
export async function sumarParticipacionOpp(token, oppId, codigos) {
|
||
|
|
const o = await leerParticipacionOpp(token, oppId);
|
||
|
|
// Gerencia Comercial va SOLO en el Sí/No de la oportunidad (decisión de Marco); el campo múltiple recibe
|
||
|
|
// los demás roles.
|
||
|
|
const union = parseCodigos(formatCodigos([...o.participantes, ...codigos.filter((c) => c !== GC)]));
|
||
|
|
const cuerpo = {};
|
||
|
|
if (formatCodigos(union) !== formatCodigos(o.participantes)) cuerpo.alfa_participantes = formatCodigos(union);
|
||
|
|
if (codigos.includes(GC) && !o.gv) cuerpo.alfa_participaciondegv = true;
|
||
|
|
if (!Object.keys(cuerpo).length) return { cambio: false, yaTenia: { gv: o.gv, participantes: o.participantes } };
|
||
|
|
await dvWrite("PATCH", `opportunities(${odataString(oppId)})`, token, cuerpo, o.etag ? { "If-Match": o.etag } : {});
|
||
|
|
return {
|
||
|
|
cambio: true,
|
||
|
|
previo: { id: oppId, gv: o.gv, participantes: o.participantes },
|
||
|
|
nuevo: { id: oppId, gv: cuerpo.alfa_participaciondegv ?? o.gv, participantes: union },
|
||
|
|
};
|
||
|
|
}
|
||
|
|
|
||
|
|
// Devuelve la oportunidad a como estaba, tocando SOLO lo que la acción cambió.
|
||
|
|
export async function restaurarParticipacionOpp(token, previo, nuevo) {
|
||
|
|
const cuerpo = {};
|
||
|
|
if (previo.gv !== nuevo.gv) cuerpo.alfa_participaciondegv = previo.gv;
|
||
|
|
if (formatCodigos(previo.participantes) !== formatCodigos(nuevo.participantes)) cuerpo.alfa_participantes = previo.participantes.length ? formatCodigos(previo.participantes) : null;
|
||
|
|
if (!Object.keys(cuerpo).length) return;
|
||
|
|
await dvWrite("PATCH", `opportunities(${odataString(previo.id)})`, token, cuerpo);
|
||
|
|
}
|
||
|
|
|
||
|
|
// «Deshacer»: restaura la foto previa. Solo si la actividad sigue como la dejó la acción (si alguien la tocó
|
||
|
|
// después, no se pisa).
|
||
|
|
export async function deshacerAccion(token, tipo, id, accion, previo, nuevo) {
|
||
|
|
const act = await leerActividad(token, tipo, id);
|
||
|
|
const ent = ENTIDAD_TIPO[tipo];
|
||
|
|
const url = `${ent}(${odataString(id)})`;
|
||
|
|
if (accion === "reprogramar") {
|
||
|
|
// Se comparan como instantes: Dynamics devuelve «…:00Z» y nosotros guardamos «…:00.000Z».
|
||
|
|
const mismo = act.scheduledstart && nuevo.scheduledstart && new Date(act.scheduledstart).getTime() === new Date(nuevo.scheduledstart).getTime();
|
||
|
|
if (!abierta(act.statecode) || !mismo) return "CAMBIO";
|
||
|
|
await dvWrite("PATCH", url, token, { scheduledstart: previo.scheduledstart, scheduledend: previo.scheduledend });
|
||
|
|
return "ok";
|
||
|
|
}
|
||
|
|
// completar / cancelar: reabre (vuelve al estado previo) y devuelve la nota y la fecha real a como estaban.
|
||
|
|
if (act.statecode !== nuevo.statecode) return "CAMBIO";
|
||
|
|
await dvWrite("PATCH", url, token, { statecode: previo.statecode, statuscode: previo.statuscode });
|
||
|
|
const campos = { actualend: previo.actualend ?? null };
|
||
|
|
if (tipo === "Cita") {
|
||
|
|
campos.alfa_resultadodelavisita = previo.resultadoVisita ?? null;
|
||
|
|
if (nuevo.escribioParticipantes) campos.alfa_participantes = previo.participantes?.length ? formatCodigos(previo.participantes) : null;
|
||
|
|
} else campos.description = previo.description ?? null;
|
||
|
|
if (tipo === "Tarea") campos.percentcomplete = previo.percentcomplete ?? 0;
|
||
|
|
let resultado = "ok";
|
||
|
|
try {
|
||
|
|
await dvWrite("PATCH", url, token, campos);
|
||
|
|
} catch {
|
||
|
|
// La actividad ya quedó abierta; si no se pudo devolver la nota, no se falla el deshacer entero.
|
||
|
|
resultado = "ok_sin_nota";
|
||
|
|
}
|
||
|
|
// La participación que la acción sumó a la oportunidad también se devuelve.
|
||
|
|
if (previo.opp && nuevo.opp) {
|
||
|
|
try {
|
||
|
|
await restaurarParticipacionOpp(token, previo.opp, nuevo.opp);
|
||
|
|
} catch {
|
||
|
|
resultado = "ok_sin_opp";
|
||
|
|
}
|
||
|
|
}
|
||
|
|
return resultado;
|
||
|
|
}
|
||
|
|
|
||
|
|
export { fotoDe, localDeIso };
|