Alcances

Dos preguntas deciden quién puede ver algo en Epismo: dónde vive (su alcance) y con quién más se comparte. Hacerlos correctamente es la forma de mantener la privacidad de los borradores, compartir el trabajo con un equipo y evitar exponer datos accidentalmente.

• scope: donde reside un registro privado, en su espacio personal o en uno o más proyectos de espacio de trabajo.
• sharedWith: personas específicas que obtienen acceso por encima del alcance.
• visibility (solo paquetes): si el paquete también es visible públicamente.

Dónde vive un registro: alcance

Utilice scope al crear o actualizar un paquete o pista privada. Guárdelo para usted con alcance personal:

{ "scope": { "type": "personal" } }

O colóquelo en uno o más proyectos del espacio de trabajo para que los miembros del proyecto puedan verlo:

{ "scope": { "type": "projects", "ids": ["project-id"] } }

Durante la actualización, omitir scope preserva el alcance existente; no es necesario reenviarlo solo para cambiar un título.

El alcance del proyecto es válido solo en el contexto del espacio de trabajo. Si no se selecciona ningún espacio de trabajo, utilice el ámbito personal.

Búsqueda en todas las ubicaciones: ámbitos

Un único registro se encuentra en un ámbito, pero una búsqueda a menudo necesita realizarse en varios lugares a la vez. Por eso la búsqueda utiliza scopes (plural):

{
	"scopes": [{ "type": "personal" }, { "type": "projects", "ids": ["project-id"] }]
}

Esto busca su espacio personal y el proyecto listado juntos en una sola llamada.

El alcance de la búsqueda es un filtro, no un movimiento. Pasar scopes decide dónde buscar; no cambia dónde se encuentran los registros coincidentes.

Otorgar acceso adicional: compartidoCon

sharedWith agrega personas específicas además del alcance, lo que resulta útil cuando un compañero de equipo necesita acceso pero no pertenece al proyecto.

{
	"sharedWith": {
		"userIds": ["user-id"],
		"emails": ["teammate@example.com"]
	}
}

Durante la actualización, omitir sharedWith conserva el valor existente.

sharedWith otorga acceso adicional, pero no mueve el registro a un ámbito diferente. Si luego elimina a una persona de sharedWith, se elimina su acceso adicional a menos que todavía pueda ver el registro a través del alcance.

Visibilidad pública de las manadas

visibility se aplica solo a paquetes.

La visibilidad pública no hace que las vías sean públicas, porque las vías no soportan la visibilidad pública. Tampoco hace que la pertenencia al proyecto sea irrelevante para los flujos de trabajo de colaboración privada; utilice scope y sharedWith para modelar quién debería colaborar en el registro de origen.

Juntándolo

Imagine un paquete de contexto con scope: { "type": "projects", "ids": ["proj-1"] } y sharedWith: { "emails": ["lead@example.com"] }:

• Los miembros de proj-1 pueden verlo (desde el alcance).
• lead@example.com también pueden verlo, incluso si no están en proj-1 (de sharedWith).
• Nadie más puede hacerlo, a menos que el visibility del paquete esté configurado en public, lo que lo hace reconocible en el concentrador independientemente del alcance. Las pistas no tienen visibilidad pública; siempre son privados.

En caso de duda, comience con un alcance personal para realizar pruebas de forma privada y luego amplíe el acceso una vez que el contenido esté listo para compartir.