L’exemple de script suivant montre comment utiliser getCopyApi() pour obtenir un objet CopyDynamicSchemaAPI qui vous permet de dupliquer une catégorie existante. Pour ce faire, l’exemple appelle getCopyApi() avec le nom avec espace de noms de la catégorie cible (tech_store/u_device_specs) où u_mobile_devices est le nom, et avec une clé de vérification (verification_key).

var api = DynamicSchemaAPI.get().getCopyApi("tech_store/u_device_specs/u_mobile_devices", "verification_key"); 

api.runAsync();

Ce script renvoie un objet CopyDynamicSchemaAPI . Sortie :

{CopyDynamicSchemaAPI@13721}

Cet objet vous permet de surveiller l’opération, de configurer des paramètres prédéfinis selon vos besoins et d’initier le processus de copie à l’aide de méthodes d’API copyDynamicSchema supplémentaires.

L’exemple suivant montre comment utiliser skipAttributes() pour ignorer la copie d’attributs. Les membres de la catégorie sont toujours copiés, mais lient à l’attribut d’origine, car les attributs eux-mêmes ne sont pas copiés. En outre, les choix ou remplacements de choix associés uniquement à des attributs ne sont pas inclus.

var api = DynamicSchemaAPI.get().getCopyApi("tech_store/u_device_specs/u_mobile_devices", "verification_key"); 

api.skipAttributes().runAsync(); 

Sortie :

{CopyDynamicSchemaAPI@13721}

L’exemple suivant montre comment utiliser skipChoiceOverrides(). Lorsque ce paramètre prédéfini est appliqué, aucun remplacement de choix n’est copié.

var api = DynamicSchemaAPI.get().getCopyApi("tech_store/u_device_specs/u_mobile_devices", "verification_key"); 

api.skipChoiceOverrides().runAsync();

Sortie :

{CopyDynamicSchemaAPI@13721}

L’exemple suivant montre comment utiliser skipChoiceSets(). Lorsque ce paramètre prédéfini est appliqué pour ignorer les ensembles de choix ou les choix dans l’opération de copie. Les remplacements de choix sont toujours copiés, mais liés au choix d’origine, car les choix eux-mêmes ne sont pas copiés.

var api = DynamicSchemaAPI.get().getCopyApi("tech_store/u_device_specs/u_mobile_devices", "verification_key"); 

api.skipChoiceSets().runAsync();

Sortie :

{CopyDynamicSchemaAPI@13721}

L’exemple suivant montre comment utiliser getTransactionId() pour récupérer et stocker un ID de transaction avant de copier un schéma dynamique. L’utilisateur appelle getTransactionId() pour obtenir l’ID de transaction et le stocker dans une table personnalisée. Lorsque l’implémentation du point d’extension est appelée pendant le processus de copie, elle peut vérifier par rapport aux ID de transaction stockés pour déterminer si elle doit fournir une logique de dénomination personnalisée ou retourner null pour ignorer la transaction.

var api = DynamicSchemaAPI.get().getCopyApi("tech_store/u_device_specs/u_mobile_devices", "verification_key"); 
var id = api.getTransactionId(); 

var gr = new GlideRecord("u_copy_transactions"); 
gr.initialize(); 
gr.setValue("u_transaction_id", id); 
gr.insert(); 

api.runAsync(); 

La sortie renvoie l’ID unique de transaction :

“9a8e0f92ff5032103c16ffffffffff82”

L’exemple de script suivant montre comment lancer une opération de copie de schéma dynamique à l’aide de la méthode runAsync() où tech_store/u_device_specs/u_mobile_devices est le nom unique de la catégorie à copier et verification_key est une clé de vérification. Après avoir obtenu l’instance d’API de copie et stocké l’ID de transaction pour la référence du point d’extension, runAsync() commence le processus de copie pour tous les composants de schéma (catégories, membres de catégorie, attributs, ensembles de choix, choix et remplacements de choix).

var api = DynamicSchemaAPI.get().getCopyApi("tech_store/u_device_specs/u_mobile_devices", "verification_key"); 

api.runAsync();

Génère l’ID de transaction :

“9a8e0f92ff5032103c16ffffffffff82”

Cet exemple montre une implémentation du point d’extension. Une fois que la méthode shouldCopy() renvoie la valeur vrai pour confirmer l’intention de l’utilisateur de copier l’enregistrement, l’utilisateur fournit un nom personnalisé pour la copie en définissant getCopyName(). Par exemple, l’utilisateur peut ajouter « _copy » au nom d’origine en tant qu’étiquette choisie, ou autoriser le système à générer automatiquement un nom.

var DynamicSchemaCopyController = Class.create(); 
DynamicSchemaCopyController.prototype = { 
 
    initialize: function() {}, 

    verifyCopyOperation: function(transactionId) { 
        var transactionIdExist = new GlideRecord('u_copy_transactions'); 
        transactionIdExist.addQuery('u_transaction_id', transactionId); 
        transactionIdExist.query(); 
 
        if (transactionIdExist.hasNext()) { 
            return 'verification_key'; 
        } 
        else { 
            return null; 
        } 
    }, 
 
    shouldCopy: function(recordData) { 
        var namespacedNameSkip = [ 
            'tech_store/u_device_specs/u_phone', 
            'tech_store/u_device_specs/u_storage' 
        ]; 
        var recordNamespacedName = String(recordData.get('namespaced_name')); 
        if (namespacedNameSkip.includes(recordNamespacedName)) { 
            return false; 
        } 
        return true; 
    }, 
 
    getCopyName: function(recordData) { 
        return String(recordData.get('name') + '_copy'); 
    }, 
 
    type: 'DynamicSchemaCopyController' 

};

Record's name + "_copy"

Cet exemple montre une implémentation du point d’extension shouldCopy(). Une fois la vérification terminée, la méthode permet aux utilisateurs d’implémenter une logique de copie personnalisée, ce qui leur permet d’ignorer des enregistrements en fonction de critères tels que le nom, le namespaced_name, la table ou sys_id.

var DynamicSchemaCopyController = Class.create(); DynamicSchemaCopyController.prototype = { 
 
    initialize: function() {}, 

    verifyCopyOperation: function(transactionId) { 
        var transactionIdExist = new GlideRecord(‘u_copy_transactions’); 
        transactionIdExist.addQuery(‘u_transaction_id’, transactionId); 
        transactionIdExist.query(); 
 
        if (transactionIdExist.hasNext()) { 
            return ‘verification_key’; 
        } 
        else { 
            return null; 
        } 
    }, 
 
    shouldCopy: function(recordData) { 
        var namespacedNameSkip = [ 
            ‘tech_store/u_device_specs/u_phone’, 
            ‘tech_store/u_device_specs/u_storage’ 
        ]; 
        var recordNamespacedName = String(recordData.get(‘namespaced_name’)); 
        if (namespacedNameSkip.includes(recordNamespacedName)) { 
            return false; 
        } 
        return true; 
    }, 
 
    getCopyName: function(recordData) { 
        return String(recordData.get(‘name’) + ‘_copy’); 
    }, 
 
    type: 'DynamicSchemaCopyController' 

};

Renvoie la valeur true si la namespaced_name n’est pas égale à tech_store/u_device_specs/u_phone ou tech_store/u_device_specs/u_storage.

Cet exemple montre une implémentation du point d’extension verifyCopyOperation(). L’utilisateur doit vérifier l’ID de transaction associé à l’opération de copie avant de renvoyer la clé de vérification. La clé de vérification doit correspondre à la valeur fournie en tant qu’argument à la méthode getCopyApi( ).

var DynamicSchemaCopyController = Class.create(); DynamicSchemaCopyController.prototype = { 
 
    initialize: function() {}, 

    verifyCopyOperation: function(transactionId) { 
        var transactionIdExist = new GlideRecord(‘u_copy_transactions’); 
        transactionIdExist.addQuery(‘u_transaction_id’, transactionId); 
        transactionIdExist.query(); 
 
        if (transactionIdExist.hasNext()) { 
            return ‘verification_key’; 
        } 
        else { 
            return null; 
        } 
    }, 
 
    shouldCopy: function(recordData) { 
        var namespacedNameSkip = [ 
            ‘tech_store/u_device_specs/u_phone’, 
            ‘tech_store/u_device_specs/u_storage’ 
        ]; 
        var recordNamespacedName = String(recordData.get(‘namespaced_name’)); 
        if (namespacedNameSkip.includes(recordNamespacedName)) { 
            return false; 
        } 
        return true; 
    }, 
 
    getCopyName: function(recordData) { 
        return String(recordData.get(‘name’) + ‘_copy’); 
    }, 
 
    type: 'DynamicSchemaCopyController' 

}; 

Sortie :

“verification_key”