Options de personnalisation pour la console OCI

Le tableau ci-dessous présente les préférences qui exploitent la fonctionnalité offerte par Oracle Cloud Infrastructure pour gérer les préférences par défaut de la location :

Rubriques :

Autoriser les utilisateurs à gérer la personnalisation de la console OCI dans la location : pour pouvoir effectuer toutes les opérations sur les préférences par défaut dans la location, veillez à accorder des droits d'accès aux groupes d'utilisateurs et aux utilisateurs avec les instructions de stratégie IAM recommandées.
Configuration de la personnalisation de la console OCI à l'aide de l'API REST : permet de configurer les préférences à l'aide de l'API REST pour les valeurs par défaut globales de locataire ou les valeurs par défaut utilisateur

Où	Description	Espace de noms	Type de schéma	Touche	Description
Page Détails du service et page d'accueil par défaut	Page d'accueil	`homepage`	`string`	`default_dashboard`	Votre sélection de la page d'accueil est enregistrée pour une utilisation ultérieure.
Explorateur de journal et tableaux de bord	Fuseau horaire	`explorer`	`string`	`last_timezone`	Le dernier paramètre de fuseau horaire utilisé dans le sélecteur d'heure est enregistré dans l'explorateur de journaux et les tableaux de bord.
Explorateur de journal	Champ Epinglé	`explorer`	`json`	`pinned_fields`	Une fois que vous avez ajouté des champs à la section Epinglé, vous pouvez y accéder ultérieurement lorsque vous revenez à l'explorateur de journaux.
Explorateur de journal	Ordre des champs Autres	`explorer`	`string`	`other_field_ordering`	L'ordre de tri que vous avez défini dans les champs de la section Autre est enregistré pour référence ultérieure.
Explorateur de journal	Champs d'affichage Table et Enregistrements	`explorer`	`json`	`table_display_fields`	Si vous sélectionnez Mémoriser les champs d'affichage, les champs d'affichage sélectionnés (y compris le champ d'affichage principal dans la visualisation d'enregistrements) sont enregistrés pour une utilisation future dans les visualisations de tableau ou d'enregistrements.
Filtre de portée	Compartiment de groupe de journaux	`explorer`	`string`	`default_loggroup_compartment`	Le dernier compartiment de groupe de journaux utilisé dans le filtre de portée est enregistré pour plusieurs visites et utilisations.
Filtre de portée	Ensemble de journaux	`explorer`	`string`	`last_logset`	Si vous utilisez la fonctionnalité de partitionnement de journal et que vous indiquez un ensemble de journaux dans le filtre de portée, le dernier ensemble de journaux utilisé est mémorisé. Cela ne s'applique pas à l'utilisation de la valeur d'ensemble de journaux `*` avec caractères génériques.
Filtre de portée	Champs de journal	`explorer`	`json`	`scope_field_filters`	La liste des champs inclus dans le filtre de portée pour l'explorateur de journaux et les widgets de tableau de bord est enregistrée pour une utilisation ultérieure. Les champs peuvent être ajoutés ou supprimés des filtres de portée dans l'explorateur de journaux à l'aide du menu Actions en regard de chaque champ.

Exemple json pour la clé table_display_fields :

{
  "savePreferences":true,
  "primary":"Original Log Content”,
  "fields":[
        "Entity","Entity Type","Log Source","Host Name (Server)","Problem Priority","Label"]}

Dans l'exemple ci-dessus :

primary : (chaîne) nom d'affichage du champ à afficher en tant que champ d'affichage principal (s'applique uniquement aux enregistrements)
fields : (Tableau<String>) tableau de noms de champ d'affichage qui doit être affiché en tant que champs d'affichage

Exemple json pour la clé scope_field_filters :

{
  "fields":[
    {"fieldDName":"Severity"},
    {"fieldDName":"Log Source"},
    {"fieldDName":"Label"},
    {"fieldDName":"Action"},
    {"fieldDName":"Entity","visible":false}]}

Dans l'exemple ci-dessus :

fields : (tableau<FieldId>) objet fieldId
fieldDName : (chaîne) nom d'affichage du champ à inclure en tant que champ de filtre de portée
visible : (booléen) si le champ identifié doit être affiché en tant que filtre de portée ou non.
En règle générale, la propriété visible de l'objet fieldId doit uniquement être utilisée pour le champ Entité et définie sur false. Par défaut, le champ Entité est inclus en tant que filtre de portée. S'il doit être supprimé et ne pas utiliser de filtre d'étendue, une entrée est requise avec la propriété visible définie sur false.

Autoriser les utilisateurs à gérer la personnalisation de la console OCI dans la location

Les droits d'accès suivants doivent être fournis au groupe d'utilisateurs pour effectuer toutes les opérations sur les préférences par défaut de la location, telles que read, create, update et delete :

L'instruction de stratégie suivante peut être utilisée par les administrateurs pour définir les valeurs par défaut à l'échelle de la location pour les utilisateurs :

allow group <user_group_name> to manage tenancy-preferences in tenancy

Configuration de la personnalisation de la console OCI à l'aide de l'API REST

La personnalisation ci-dessus est stockée automatiquement pour les utilisateurs. Si vous voulez le configurer à l'aide de l'API REST pour les valeurs par défaut globales ou utilisateur du locataire, reportez-vous aux sections suivantes :

Remarque

Si vous effectuez une opération PUT ou POST sur les préférences par défaut à l'aide de l'API REST, limitez la taille de la charge utile JSON à moins de 10 ko.

Créer les préférences

Configurez OCI CURL pour utiliser les API REST de personnalisation. Pour définir les préférences de niveau location, assurez-vous que l'utilisateur dispose du droit d'accès tenancy-preferences dans OCI CURL.

Format de la commande curl :

sh ~/oci-curl.sh --oci-config-file ~/.oci/config --oci-profile <your_profile> --data-binary @/<my_preference.json> -X POST 'https://personalization.<region>.oci.oraclecloud.com/20200715/preferences' -i

Créez le fichier JSON dans le même répertoire que oci-curl.sh. Format de la charge utile JSON my_preference.json :

{
    "serviceName" : "logginganalytics",
    "namespace" : "<your_namespace>",
    "key" : "<preference_key>",
    "value": "<preference_value>",
    "type": "<preference_value_type>",
    "compartmentId" : "<compartment_OCID>",
    "level" : "<preference_level>"
}

Dans les formats ci-dessus de la commande CURL et de la charge utile JSON :

your_profile : obtenez la valeur de votre profil en cliquant sur l'icône Profil dans l'angle supérieur droit de la console OCI.
my_preference.json : remplacez-le par le nom du fichier de charge utile JSON.
Région : indiquez la région, par exemple, us-phoenix-1.
your_namespace : espace de noms de personnalisation. Reportez-vous aux valeurs du tableau ci-dessus.
preference_key : clé de la préférence à spécifier. Reportez-vous aux valeurs du tableau ci-dessus.
preference_value : valeur de la préférence.
preference_value_type : type de schéma de la valeur de préférence fournie. Reportez-vous aux valeurs du tableau ci-dessus.
compartment_OCID : OCID du compartiment dans lequel la préférence doit être stockée.
preference_level : indiquez TENANCY ou USER.

Mettre à jour les préférences

Utilisez la méthode PUT pour envoyer l'OCID de préférence dans l'API REST afin de mettre à jour une préférence existante.

Format de la commande curl :

sh ~/oci-curl.sh --oci-config-file ~/.oci/config --oci-profile <your_profile> --data-binary @/<my_preference.json> -X POST 'https://personalization.<region>.oci.oraclecloud.com/20200715/preferences/<preference_OCID>/<tenancy_OCID>' -i

Créez le fichier JSON dans le même répertoire que oci-curl.sh. Format de la charge utile JSON my_preference.json :

{
    "value": "<preference_value>",
    "level" : "<preference_level>"
}

Dans les formats ci-dessus de la commande CURL et de la charge utile JSON :

your_profile : obtenez la valeur de votre profil en cliquant sur l'icône Profil dans l'angle supérieur droit de la console OCI.
my_preference.json : remplacez-le par le nom du fichier de charge utile JSON.
Région : indiquez la région, par exemple, us-phoenix-1.
preference_value : valeur de la préférence.
preference_OCID : OCID de la préférence à mettre à jour.
compartment_OCID : OCID du compartiment dans lequel la préférence doit être stockée.
preference_level : indiquez TENANCY ou USER.

Les autres détails de la préférence sont récupérés à l'aide de l'OCID de préférence que vous indiquez dans l'appel PUT.

Remarque

Pour enlever un champ des champs épinglés par défaut, définissez la valeur pin sur false au lieu de true.

Exemple de commande CURL et de charge utile JSON : Créer une préférence d'ensemble de journaux

Exemple de commande CURL :

sh ~/oci-curl.sh --oci-config-file ~/.oci/config --oci-profile logan_profile --data-binary @/logset.json -X POST 'https://personalization.us-phoenix-1.oci.oraclecloud.com/20200715/preferences' -i

Exemple de charge utile JSON logset.json :

{
   "serviceName": "logginganalytics",
   "namespace": "explorer",
   "key": "last_logset",  
   "value": "testlogset1",
   "type": "STRING",
   "compartmentId": "ocid1.compartment.oc1..aaa...",  
   "level": "TENANCY"
}

Exemple de commande CURL et de charge utile JSON : Préférence de création de champs épinglés

Exemple de commande CURL :

sh ~/oci-curl.sh --oci-config-file ~/.oci/config --oci-profile logan_profile --data-binary @/pinned_field_value.json -X POST 'https://personalization.us-ashburn-1.oci.oraclecloud.com/20200715/preferences' -i

Exemple de charge utile JSON pinned_field_value.json :

{
  "serviceName": "logginganalytics",
  "namespace": "explorer", 
  "key": "pinned_fields",
  "value": "{\"fields\":[{\"pin\":true,\"iname\":\"acclvl\",\"dname\":\"Access Level\",\"dataType\":\"STRING\",\"tableEl\":true,\"facetEl\":true,\"summ\":true,\"group\":true},{\"pin\":true,\"iname\":\"zone\",\"dname\":\"Zone\",\"dataType\":\"STRING\",\"tableEl\":true,\"facetEl\":true,\"summ\":true,\"group\":true},{\"pin\":true,\"iname\":\"usrname\",\"dname\":\"User Name\",\"dataType\":\"STRING\",\"tableEl\":true,\"facetEl\":true,\"summ\":true,\"group\":true}]}", 
  "type": "JSON",
  "compartmentId": "ocid1.compartment.oc1..ccc...", 
  "level": "USER"
}

Exemple de commande CURL et de charge utile JSON : préférence Mettre à jour les champs épinglés

Exemple de commande CURL :

sh ~/oci-curl.sh --oci-config-file ~/.oci/config --oci-profile logan_profile --data-binary @/pinned_field_value.json -X PUT 'https://personalization.us-phoenix-1.oci.oraclecloud.com/20200715/preferences/ocid1.personalizationpreference.oc1.phx.amaaaaaa...?compartmentId=ocid1.tenancy.oc1..aaaaaaaa...' -i

Exemple de charge utile JSON pinned_field_value.json :

{
    "value":"{\"fields\":[{\"pin\":true,\"iname\":\"cipher\",\"dname\":\"Cipher\",\"dataType\":\"STRING\",\"tableEl\":true,\"facetEl\":true,\"summ\":true,\"group\":true},{\"pin\":true,\"iname\":\"actn\",\"dname\":\"Action\",\"dataType\":\"STRING\",\"tableEl\":true,\"facetEl\":true,\"summ\":true,\"group\":true}]}",
    "level":"USER"
}

Documentation Oracle Cloud Infrastructure