Bruk av trait-kommandoer i bofh

Kort om traits

Traits er forhåndsdefinerte knagger eller tags som kan knyttes til objekter (entiteter) i Cerebrum. Et trait kan også inneholde ekstra informasjon i form av:

• tekst
• tall
• dato
• referanse til objekt

Traits brukes i stor grad for å markere objekter til en eller annen intern forretningsregel i Cerebrum, og hvert enkelt trait har som regel et snevert bruksområde.

Kommandoer

trait types

trait types

Lister alle forhåndsdefinerte trait-typer som finnes i Cerebrum.  Resultatet viser trait-navn og en kort beskrivelse.

trait set

trait set <entity> <trait> <trait-value+>

Legger til eller oppdaterer et trait. Eksempel:

> trait set example reserve_passw numval=3 "strval=Bruker ønsker å sperres fra passordtjeneste"
Ok, set trait reserve_passw for example

trait remove

note remove <entity> <trait>

Fjerner et trait. Eksempel:

> trait remove example reserve_passw
OK, deleted trait reserve_passw from example

trait info

trait info <entity>

Viser traits knyttet til et objekt. 

> trait info example
Entity:        example (account)
  Trait:       reserve_passw
    Numeric:   3
    String:    Bruker ønsker å sperres fra passordtjeneste

trait search

trait search [trait-filter+]

Søke eller liste opp traits. Eksempel:

> trait search trait:reserve_passw min:3 "text:*sperres fra*"
Entity Id  |       Trait        |                       Values                      
---------- + ------------------ + --------------------------------------------------
       123 | reserve_passw      | numval=3, strval='Bruker ønsker å sperres fra passordtjeneste'

Denne kommandoen har begrenset output.  Hvis det finnes flere treff vil dette vises under tabellen, slik at man får mulighet til å innsnevre søkeparameterene.

trait list

trait list <trait>

Legacy-kommando for å list alle entiteter med en gitt trait-type knyttet til seg.  Eksempel:

> trait list reserve_passw
Trait            Type             Name
…
reserve_passw    account          example
…

Merk at denne kommandoen kan ta litt tid for traits som er mye brukt.

Argumenter

trait

Unikt navn for en gitt trait-type.

help arg_help trait

entity

Finner/velger et objekt som kan ha et notat knyttet til seg. Man kan typisk oppgi et brukernavn for å velge en brukerkonto, eller oppgi oppslag:verdi for andre objekter, f.eks.:

• account:<brukernavn>
• person:<brukernavn>
• group:<gruppenavn>
• id:<entity-id>

Mer informasjon i bofh:

help arg_help id:target:entity

trait-value

En valgfri verdi å sette sammen med traitet.  Formatet er name=value, og man kan sette:

• strval
• intval
• date
• target_id

trait-filter

Filter for bruk i søk/utlisting av traits. Formatet er param:value, og man kan filtere på:

• trait-type (trait) — Traits av en gitt type
• tallverdi (min, max) — Traits med en gitt numval
• tekst (text) — Traits med en gitt strval
• dato (before, after) — Traits med en gitt date

Bofh gir mer informasjon om hvordan filter kan brukes og settes sammen:

help arg_help trait-filter

Tilgang

Funksjonaliteten er kun tilgjengelig for brukere som har fått dette tildelt gjennom bofh sitt tilgangssystem, og tilgangen skal kun gies til driftsbrukere eller driftsgrupper.

Tilgangen finnes i flere operasjonssett.  For å gi tilgang til et av disse:

> access grant <opset> <group> global_host

Enkelt-tilgangene som kan deles ut i operasjonssett er:

• set_trait (kan begrenses til en eller flere trait-typer)
• remove_trait (kan begrenses til en eller flere trait-typer)
• view_trait (kan begrenses til en eller flere trait-typer)
• list_trait

Merk at tilgangen må gjelde for objekttype host for trait-tilganger. For at tilgangen skal fungere, må derfor operasjonssettet deles ut for global_host.