Enum BlockOp 

pub enum BlockOp {
    InsertDeleteLines,
    RemoveBlock,
    ModifySchema,
    CellInput,
    SortByField,
    ModifyDescription,
    OverrideValidation,
}

The operations a block’s permissions can speak about separately.

One policy for the whole block is too blunt for the case this exists to serve: a block a craft or Watson built usually wants the user to keep typing into it while refusing to let them pull rows out from under it or re-point its schema, which would take the block out of the owner’s control for good.

Variants

InsertDeleteLines

Insert or delete rows/columns inside the block.

RemoveBlock

Delete the whole block. Kept apart from the rest because it is the one operation there is no recovering from by editing: the records, the schema and this policy itself all go at once.

ModifySchema

Bind a different schema, or change the fields of the current one.

CellInput

Write a value into one of the block’s cells.

SortByField

Reorder the records by one of the fields.

ModifyDescription

Rewrite the prose description.

OverrideValidation

Write a value into a block cell that its field’s validation rule rejects.

Distinct from CellInput because the two answer different questions: CellInput is “may this actor write here at all”, this one is “may this actor write something the schema says is wrong”. A craft that maintains a table often has to seed a row it knows is incomplete — a required field it fills in on the next round — while a person typing into the same block should be held to the rule. Left at All (the default), a violating write lands and is flagged, which is what every block did before this op existed.

Implementations

impl BlockOp

pub const ALL: [BlockOp; 7]

Every operation, so a caller can render or check the whole set without having to keep its own list in step with this one.

pub fn for_payload_type(payload_type: &str) -> Option<BlockOp>

Which operation a payload counts as, keyed by the payload’s wire type name (EditPayload’s type tag). None when the payload is not something a block can single out.

The mapping belongs to the engine because the engine defines the operations. Every host that enforces a policy needs it — the app, the craft runtime, Watson — and each keeping its own table is how the same payload comes to be governed differently in different hosts. A payload this returns None for is not unguarded: the caller falls back to its owner check, which is what the app already did.

pub fn as_wire_str(&self) -> &'static str

Attribute name used for .xlsx persistence.

Trait Implementations

impl Clone for BlockOp

fn clone(&self) -> BlockOp

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for BlockOp

impl Debug for BlockOp

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BlockOp

fn deserialize<D>( deserializer: D, ) -> Result<BlockOp, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for BlockOp

impl PartialEq for BlockOp

fn eq(&self, other: &BlockOp) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for BlockOp

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for BlockOp

impl TS for BlockOp

fn _register(manager: &mut DescriptorManager, generic_base: bool) -> usize

fn _ts_name() -> String

fn _is_optional() -> bool

fn _tag() -> Option<&'static str>