Configurazione dell'esportazione per il Portale fornitori per M3

Panoramica

Il file di configurazione per l'esportazione è un componente cruciale nel portale fornitori, che definisce come i dati vengono mappati tra il portale fornitori e il sistema ERP. Questa configurazione garantisce che i dati vengano trasferiti e sincronizzati accuratamente tra i sistemi, consentendo operazioni fluide ed efficienti.

Struttura del File di Configurazione

Il file di configurazione per l'esportazione è strutturato come un oggetto JSON che contiene più mappature. Ogni mappatura è associata a un programma specifico nel sistema ERP e definisce le azioni da eseguire, i campi da mappare e eventuali condizioni da applicare.

Componenti Chiave

1. Programma

• Definizione: Specifica il programma ERP a cui si applica la mappatura.

• Esempio: "program": "CRS620MI"

2. Azioni

• Definizione: Definisce le azioni che possono essere eseguite, come aggiungere o aggiornare record.

• Esempio:

  "actions": {
      "add": "AddSupplier",
      "update": "UpdSupplier"
  }

3. Mappatura

• Definizione: Specifica la mappatura tra i campi nel sistema ERP e i campi nel portale fornitori.

• Componenti:

• erp_field_name: Il nome del campo nel sistema ERP.

• value_field_name: Il nome del campo corrispondente nel portale fornitori.

• value: Un valore statico da utilizzare se non esiste un campo corrispondente nel portale fornitori.

• if_conditions: Condizioni opzionali che determinano il valore in base a determinati criteri.

• Esempio:

{
    "erp_field_name": "SUNO",
    "value_field_name": "supplier_number"
}

4. Logica Condizionale (if_conditions)

• Definizione: Specifica le condizioni che devono essere soddisfatte affinché venga utilizzato un particolare valore.

• Componenti:

• field_name: Il nome del campo nel portale fornitori che viene valutato.

• field_value: Il valore che attiva la condizione.

• then_value: Il valore da utilizzare se la condizione è soddisfatta.

• Esempio:

{
    "erp_field_name": "SUTY",
    "value": "0",
    "if_conditions": [{
        "field_name": "supplier_group",
        "field_value": "FRT",
        "then_value": "5"
    }]
}

5. Cicli (loop_on)

• Definizione: Definisce le sezioni in cui la configurazione deve iterare su un elenco di elementi, come dettagli di indirizzo o di riferimento.

• Esempio:

"loop_on": "address_details"

6. Campi Calcolati (value_field_calculated)

• Definizione: Specifica i campi che devono essere calcolati durante l'esecuzione, come la generazione della data corrente.

• Esempio:

{
    "erp_field_name": "STDT",
    "value_field_calculated": "now()"
}

7. Mappature di Campo con Liste (mapping_field_name e mapping_list)

• Definizione: Mappa valori specifici dal portale fornitori ai valori corrispondenti nel sistema ERP in base a un elenco predefinito.

• Componenti:

• mapping_field_name: Il campo che determina la mappatura.

• mapping_list: Un dizionario che traduce i valori dal portale fornitori al sistema ERP.

• Esempio:

{
    "erp_field_name": "RFID",
    "mapping_field_name": "reference_type",
    "mapping_list": {
        "10": "PURCHASING",
        "15": "DLVRY PHN#",
        "20": "COA",
        "25": "QA",
        "30": "FINANCE",
        "35": "SALES"
    }
}

Esempio di Analisi della Configurazione

Aggiunta e Aggiornamento Fornitori (CRS620MI)

• Programma: CRS620MI

• Azioni:

• Aggiungi Fornitore: AddSupplier

• Aggiorna Fornitore: UpdSupplier

• Campi di Mappatura:

• SUNO → supplier_number

• SUNM → name

• CSCD → supplier_country

• TINO → tax_id

• I campi aggiuntivi includono valori statici e mappature condizionali.

Dettagli Indirizzo (CRS620MI)

• Ciclo Su: address_details

• Azioni:

• Aggiungi Indirizzo: AddAddress

• Aggiorna Indirizzo: AddAddress

• Campi di Mappatura:

• SUNO → supplier_number

• ADR1 → address

• TOWN → city

• I campi aggiuntivi includono campi calcolati come now() per la data corrente.

Dettagli di Riferimento (CRS620MI)

• Ciclo Su: reference_details

• Azioni:

• Aggiungi Riferimento Fornitore: AddSupplierRef

• Aggiorna Riferimento Fornitore: AddSupplierRef

• Campi di Mappatura:

• SUNO → supplier_number

• RFTY → reference_type

• RFID è mappato utilizzando un elenco per tradurre tipi come “PURCHASING”, “QA” e “FINANCE”.

Utilizzo della Configurazione per l'Esportazione

1. Caricamento del File di Configurazione

1. Navigare alla Configurazione per l'Esportazione:

• Vai alla sezione Configurazione per l'Esportazione dal menu principale.

2. Caricare il File di Configurazione:

• Clicca sulle sezioni ION-Mapping File o IDM Mapping File per caricare il rispettivo file di configurazione.

3. Salvare la Configurazione:

• Dopo aver caricato, clicca sul pulsante Salva per applicare la configurazione.

2. Utilizzo dei Modelli Predefiniti

• Clicca sul pulsante Usa Modello Predefinito se desideri tornare al modello di configurazione predefinito fornito dal sistema.

3. Formattazione del JSON

• Usa il pulsante Format per formattare automaticamente il codice JSON per una migliore leggibilità.

Conclusione

Questo file di configurazione è essenziale per garantire che i dati tra il portale fornitori e il sistema ERP siano correttamente mappati e sincronizzati. Comprendendo la struttura e i componenti chiave, gli amministratori possono gestire e personalizzare efficacemente il processo di esportazione per soddisfare le proprie esigenze aziendali specifiche.

Esempio Completo

[{
    "program": "CRS620MI",
    "actions": {
        "add": "AddSupplier",
        "update": "UpdSupplier"
    },
    "mapping": [{
        "erp_field_name": "SUNO",
        "value_field_name": "supplier_number"
    }, {
        "erp_field_name": "SUNM",
        "value_field_name": "name"
    }, {
        "erp_field_name": "SUTY",
        "value": "0",
        "if_conditions": [{
            "field_name": "supplier_group",
            "field_value": "FRT",
            "then_value": "5"
        }]
    }, {
        "erp_field_name": "CSCD",
        "value_field_name": "supplier_country"
    }, {
        "erp_field_name": "DTFM",
        "value_field_name": "date_format"
    }, {
        "erp_field_name": "ORTY",
        "value": "F20"
    }, {
        "erp_field_name": "DT4T",
        "value": "1"
    }, {
        "erp_field_name": "DTCD",
        "value": "2"
    }, {
        "erp_field_name": "CUCD",
        "value_field_name": "currency"
    }, {
        "erp_field_name": "TINO",
        "value_field_name": "tax_id"
    }, {
        "erp_field_name": "PHNO",
        "value_field_name": "supplier_phone"
    }, {
        "erp_field_name": "CRTP",
        "value": "1"
    }, {
        "erp_field_name": "ATPR",
        "value": "1"
    }, {
        "erp_field_name": "SUCL",
        "value_field_name": "supplier_group"
    }, {
        "erp_field_name": "LNCD",
        "value_field_name": "language"
    }, {
        "erp_field_name": "CONO",
        "value": "781_DDD"
    }, {
        "erp_field_name": "TEDL",
        "value": "FOB"
    }, {
        "erp_field_name": "TEPY",
        "value_field_name": "payment_term"
    }, {
        "erp_field_name": "TEPA",
        "value": "001"
    }, {
        "erp_field_name": "PYME",
        "value": "CRP"
    }]
}, {
    "program": "CRS620MI",
    "loop_on": "address_details",
    "actions": {
        "add": "AddAddress",
        "update": "AddAddress"
    },
    "mapping": [{
        "erp_field_name": "SUNO",
        "main_value_field": "supplier_number"
    }, {
        "erp_field_name": "ADTE",
        "value_field_name": "address_type"
    }, {
        "erp_field_name": "ADID",
        "value_field_name": "address_type",
        "if_conditions": [{
            "field_name": "address_type",
            "field_value": "10",
            "then_value": ""
        }]
    }, {
        "erp_field_name": "STDT",
        "value_field_calculated": "now()"
    }, {
        "erp_field_name": "ADR1",
        "value_field_name": "address"
    }, {
        "erp_field_name": "TOWN",
        "value_field_name": "city"
    }, {
        "erp_field_name": "ECAR",
        "value_field_name": "state"
    }, {
        "erp_field_name": "PONO",
        "value_field_name": "postal_code"
    }, {
        "erp_field_name": "CSCD",
        "value_field_name": "supplier_country"
    }]
}, {
    "program": "CRS620MI",
    "loop_on": "reference_details",
    "actions": {
        "add": "AddSupplierRef",
        "update": "AddSupplierRef"
    },
    "mapping": [{
        "erp_field_name": "SUNO",
        "main_value_field": "supplier_number"
    }, {
        "erp_field_name": "RFTY",
        "value_field_name": "reference_type"
    }, {
        "erp_field_name": "RFID",
        "mapping_field_name": "reference_type",
        "mapping_list": {
            "10": "PURCHASING",
            "15": "DLVRY PHN#",
            "20": "COA",
            "25": "QA",
            "30": "FINANCE",
            "35": "SALES"
        }
    }, {
        "erp_field_name": "YRE1",
        "value_field_name": "reference_name"
    }, {
        "erp_field_name": "PHNO",
        "value_field_name": "telephone_no"
    }, {
        "erp_field_name": "EMAL",
        "value_field_name": "email_address"
    }]
}]