Konfigurieren Sie das Validierungsskript

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 1 Minute Lesedauer
  • Verwenden Sie die Skripteinbindung DataImportValidationConfig, um die Validierungsregeln für die Staging-Tabelle zu konfigurieren.

    Vorbereitungen

    Erforderliche Rolle: sn_customerservice.customer_admin

    Warum und wann dieser Vorgang ausgeführt wird

    Definieren Sie die Validierungsregeln auf Feld- und Datensatzebene für die Staging-Tabellen. Diese Validierungsregeln werden ausgelöst, wenn der Service Desk-Mitarbeiter nach dem Importieren von Daten in die Staging-Tabelle auf die Schaltfläche Validieren klickt. Details siehe Importieren Sie Daten in das Playbook Lebenszyklus-Ereignisse für Accounts ..

    Prozedur

    1. Navigieren zu Alle > Administration > Skripteinbindungen.
    2. Suchen Sie nach der Anwendung Account Lifecycle Events, und wählen Sie die Skripteinbindung DataImportValidationConfig aus.
      Sie sehen die Validierungsregeln, die für die mit dem Basissystem bereitgestellten Standardtabellen definiert wurden.
    3. Sie können drei Arten von Validierungsregeln definieren:
      • Pflichtfelder: Geben Sie die Pflichtfelder an, die in der Staging-Tabelle vorhanden sein sollen.

        Beispiel: In der Tabelle „sn_acct_lc_account_onb_import_contacts“ können Sie angeben, dass die folgenden Felder obligatorisch sind:

        „u_account“, „u_email“, „u_last_name“

      • Referenzfelder: Geben Sie die Referenzfelder in der Staging-Tabelle an. Ein Referenzfeld speichert eine Referenz zu einem Feld in einer anderen Tabelle. Wenn Sie ein Referenzfeld definieren, wird eine Beziehung zwischen den beiden Tabellen erstellt.
        Beispiel: Für die Tabelle „ sn_acct_lc_account_onb_import_contacts “ können Sie die Referenzfeldvalidierung wie folgt definieren:
        "sn_acct_lc_account_onb_import_contacts": {
        		'u_account': {
        			'table_name': 'customer_account',
        			'reference_field': 'name'
        		}
        Dabei ist u_account der Name des Felds in der Bereitstellungstabelle, customer_account die Tabelle und name das Referenzfeld, dem sie zugeordnet ist.
      • Benutzerdefinierte Validierungen: Definieren Sie benutzerdefinierte Skripts, um die Datensätze der Bereitstellungstabelle zu validieren. Das folgende Beispiel zeigt ein benutzerdefiniertes Validierungsskript:
        dataImportCustomValidationForCustomerContacts: function(stagingTableGr){
        		try{
                    if(this.debuggingEnabled)
                        this.logs.push('Inside dataImportCustomValidationForCustomerContacts');
        			//Check the Account field's value coming from Excel is matching the corresponding Task or not.
        			while(stagingTableGr.next()){
        				if (global.JSUtil.notNil(stagingTableGr.task) && global.JSUtil.notNil(stagingTableGr.u_account)){
        					if (stagingTableGr.task.company.name != stagingTableGr.u_account){
        						sn_acct_lc.DataImportValidationFunctions.updateStagingTableRecordValidationComments(stagingTableGr, false, 'The Account is not matching with the Case Account.');
        					}
        				}
        			}
        		}
        		catch (err){
        			gs.error('Error while executing - dataImportCustomValidationForCustomerContacts - '+err);
        			if(this.debuggingEnabled)
        				this.logs.push('Error while executing - dataImportCustomValidationForCustomerContacts - '+err);
        			//Update the Validation Comments with the Error
        			sn_acct_lc.DataImportValidationFunctions.updateStagingTableRecordValidationComments(stagingTableGr, false, gs.getMessage('sn_acct_lc.DataImportValidationUtil.ValidationFailed', 'Custom'));
        		}
        	},

        Im vorherigen Beispiel ist dataImportCustomValidationForCustomerContacts das benutzerdefinierte Validierungsskript. Die Funktion ruft die StagingTableGr- Variable (GlideRecord-Variable) auf, die alle Datensätze enthält, die in die Staging-Tabelle hochgeladen wurden. Das Skript überprüft die angegebenen Bedingungen mit DataImportValidationFunctions und validiert die Daten.

      Sie können ein oder mehrere Skripts für neue Staging-Tabellen in dem im vorherigen Beispiel gezeigten Format definieren.

    4. Wählen Sie Aktualisieren aus, um alle an der Skripteinbindung vorgenommenen Änderungen zu speichern.