Options de personnalisation pour la console OCI

Le tableau ci-dessous présente les préférences qui tirent parti de la capacité offerte par Oracle Cloud Infrastructure de gérer les préférences par défaut pour 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 de la location, assurez-vous de fournir des autorisations aux groupes d'utilisateurs et aux utilisateurs avec les énoncés de politique IAM recommandés.
Configurer la personnalisation de la console OCI à l'aide de l'API REST : Pour configurer les préférences à l'aide de l'API REST pour les valeurs par défaut globales du locataire ou les valeurs par défaut de l'utilisateur

Où	Quoi	Espace de noms	Type de schéma	Touche	Description
Page Détails du service et page d'accueil par défaut	Accueil	`homepage`	`string`	`default_dashboard`	Votre sélection de la page d'accueil est enregistrée pour une utilisation future.
Explorateur de journaux et tableaux de bord	Fuseau horaire	`explorer`	`string`	`last_timezone`	Votre 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 journaux	Champ Épinglé	`explorer`	`json`	`pinned_fields`	Après avoir ajouté des champs à la section Épinglé, vous pouvez y accéder plus tard lorsque vous retournez à l'explorateur de journaux.
Explorateur de journaux	Tri des champs Autres	`explorer`	`string`	`other_field_ordering`	L'ordre de tri que vous définissez dans les champs de la section Autre est enregistré pour référence ultérieure.
Explorateur de journaux	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 des enregistrements) sont enregistrés pour une utilisation future dans les visualisations Table ou Enregistrements.
Filtre de portée	Compartiment du groupe de journaux	`explorer`	`string`	`default_loggroup_compartment`	Votre dernier compartiment de groupe de journaux utilisé dans le filtre de portée est enregistré pour plusieurs visites et utilisations.
Filtre de portée	Jeu de journaux	`explorer`	`string`	`last_logset`	Si vous utilisez la fonction de partitionnement de journaux et spécifiez un jeu de journaux dans le filtre de portée, le dernier jeu de journaux utilisé est mémorisé. Cela ne s'applique pas à l'utilisation de la valeur du jeu de journaux `*` avec caractère générique.
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 future. Les champs peuvent être ajoutés ou supprimés des filtres de portée dans l'explorateur de journaux à l'aide du menu Actions à côté 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 comme champ d'affichage principal (s'applique uniquement aux enregistrements)
fields : (Tableau<Chaîne>) Tableau des noms de champ d'affichage qui doivent être affichés 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.
La propriété visible de l'objet fieldId ne doit généralement être utilisée que pour le champ Entité et réglée à false. Le champ Entité est inclus par défaut 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 réglée à false.

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

Les autorisations suivantes doivent être fournies 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'énoncé de politique suivant peut être utilisé 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

Configurer 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 du locataire ou les valeurs par défaut de l'utilisateur, voir ci-dessous :

Note

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 des données utiles JSON à une taille inférieure à 10 Ko.

Créer des préférences

Configurez l'URL CURL OCI pour utiliser les API REST de personnalisation. Pour définir les préférences au niveau de la location, assurez-vous que l'utilisateur dispose de l'autorisation tenancy-preferences (Préférences de location) 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 des données utiles 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 des données utiles JSON :

your_profile : Obtenir la valeur de votre profil en cliquant sur l'icône Profil dans le coin supérieur droit de la console OCI.
my_preference.json : Remplacez cette valeur par le nom de votre fichier de données utiles JSON.
région : Spécifiez la région, par exemple us-phoenix-1.
your_namespace : Espace de noms de votre 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 : Spécifiez 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 des données utiles JSON my_preference.json :

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

Dans les formats ci-dessus de la commande CURL et des données utiles JSON :

your_profile : Obtenir la valeur de votre profil en cliquant sur l'icône Profil dans le coin supérieur droit de la console OCI.
my_preference.json : Remplacez cette valeur par le nom de votre fichier de données utiles JSON.
région : Spécifiez la région, par exemple us-phoenix-1.
preference_value : Valeur de la préférence.
preference_OCID : OCID de la préférence qui doit être mise à jour.
compartment_OCID : OCID du compartiment dans lequel la préférence doit être stockée.
preference_level : Spécifiez 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 spécifiez dans l'appel PUT.

Note

Pour supprimer un champ des champs épinglés par défaut, réglez la valeur épingler à false au lieu de true.

Exemple de commande CURL et de données utiles JSON : Créer une préférence de jeu 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 données utiles 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 données utiles JSON : Préférence Créer des 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 données utiles 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 données utiles JSON : Mettre à jour la préférence des 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 données utiles 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 sur Oracle Cloud Infrastructure

Options de personnalisation pour la console OCI

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

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