Transformation des lignes de mise à jour groupée de Carte

Personnalisez le débit et l’analyse des lignes pour les imports en masse de « mise à jour des cartes », à l’aide de `runtime.import.updatePasses.rowTransformer`.

Ces deux hooks facultatifs personnalisent le pipeline d’import des « update passes » en masse (fichiers CSV déposés pour import, y compris via SFTP). Chacun peut être implémenté indépendamment, et aucun ne nécessite de configuration supplémentaire au-delà de l’enregistrement du point de terminaison dans un script.

/**
 * @param {string} fileName - Nom du fichier importé.
 * @returns {number|null} Une valeur de remplacement du débit pour ce fichier, ou null pour utiliser la valeur par défaut.
 */
function getThroughput(fileName) {
  return fileName.startsWith("priority-") ? 20 : null;
}

/**
 * @typedef {Object} UpdatePassInformation
 * @property {Record<string, string>} Identifiers
 * @property {string} [PassType]
 * @property {Record<string, string|null>} [AdditionalData]
 * @property {boolean} UpdateMetadata
 * @property {Record<string, string|null>} [NewIdentifiers]
 */

/**
 * @param {Record<string, string>} row - La ligne CSV actuelle, sous la forme nom de colonne → valeur.
 * @returns {UpdatePassInformation|null} La ligne transformée, ou null pour appliquer l’analyse par défaut des colonnes (conventions id./identifiers./additionalData./passType/updateMetadata).
 */
function transform(row) {
  return null; // revenir à l’analyse par défaut pour chaque ligne
}

export default function (context) {
  context.register('runtime.import.updatePasses.rowTransformer', {
    GetThroughput: getThroughput,
    Transform: transform
  });
}

GetThroughput est appelée une fois par fichier, avant la lecture des lignes. Transform est appelée une fois par ligne. L’une ou l’autre fonction peut être omise de l’objet enregistré — une fonction omise ou null-renvoyante revient au comportement par défaut de la plateforme pour cette ligne ou ce fichier.