Définition des services d'interface

Sélectionnez > > .

Cliquez sur Nouveau.

Dans la fenêtre Nouveau service d'interface, entrez les informations suivantes :

Type d'interface

Sélectionnez le type d'interface. Voici les options :

Planification avancée
CSV
Base de données
EXCEL

Entité de données

Sélectionnez l'entité de données à associer à l'interface. Types d'entités de données :

Calendrier
Liste de codes
Affichage scénario
Remarque : Si vous sélectionnez cette option, vous devez indiquer le Comportement importation.
Données transactionnelles

Sens d'interface

En fonction de vos sélections précédentes, spécifiez Export, Import ou bien Importation ou Exportation selon le cas.

Colonne par mesure

Si cette case est cochée, chaque mesure s'affiche dans une nouvelle colonne de l'interface. Vous pouvez ajouter de nouvelles lignes et mesures avec les dimensions suivantes dans l'onglet Mappages :

Article
Emplacement
Période de calendrier

Si cette case n'est pas cochée, la liste de dimensions de l'onglet Mappages est fixée à cinq colonnes avec les dimensions suivantes :

Article
Emplacement
Période de calendrier
Mesure
Valeur

Remarque : Vous ne pouvez afficher ce champ que si l'entité de données définie est Valeur de scénario pour tous les types d'interfaces.

Cliquez sur OK. La liste est remplacée par un formulaire de détails dans lequel les valeurs des champs Type d'interface et Entité de données dépendent de votre sélection.

Selon l'entité de données que vous avez sélectionnée, entrez les informations suivantes :

Module: Module auquel est lié le service d'interface. Sélectionnez le module approprié.
Liste des codes cible: Nom de la source de données utilisée dans le cadre du service d'interface.

Entrez les informations suivantes :

Nom: Indiquez le nom du service d'interface d'interpolation.
Afficher le nom: Indiquez le nom à afficher dans l'application. Ce champ est facultatif.
Système: Il s'agit d'un champ en lecture seulement.
Source de données: Nom de la source de données utilisée dans le cadre du service d'interface.

Entrez les informations nécessaires, selon le type d'interface que vous avez sélectionné :

Si vous sélectionnez CSV :

Option	Description
Fichiers	Nom des fichiers CSV utilisés dans le cadre du service d'interface.
Noms de champ dans ligne d'en-tête	Cochez cette case pour fournir l'une des indications suivantes : La première ligne du fichier d'importation contient des libellés de champ et peut être ignorée. La première ligne du fichier d'exportation doit contenir des en-têtes de champs.
Définition de période de calendrier	Indique si les périodes de calendrier sont exportées en utilisant la date de début de rubrique, la date de fin de rubrique ou le nom de rubrique définis dans le format de calendrier (par exemple EX10 M03).

Option

Description

Fichiers

Nom des fichiers CSV utilisés dans le cadre du service d'interface.

Noms de champ dans ligne d'en-tête

Cochez cette case pour fournir l'une des indications suivantes :

La première ligne du fichier d'importation contient des libellés de champ et peut être ignorée.
La première ligne du fichier d'exportation doit contenir des en-têtes de champs.

Définition de période de calendrier

Indique si les périodes de calendrier sont exportées en utilisant la date de début de rubrique, la date de fin de rubrique ou le nom de rubrique définis dans le format de calendrier (par exemple EX10 M03).

Si vous sélectionnez Base de données et que, pour la source, vous utilisez la sélection de table par défaut, entrez les informations suivantes :

Option Description

Tables Nom de la table utilisée dans le cadre du service d'interface.

Filtre d'importation

Option	Description
Tables	Nom de la table utilisée dans le cadre du service d'interface.
Filtre d'importation	Spécifiez un filtre s'appliquant aux données transmises via le service d'interface. Dans le cas contraire, tous les enregistrements de la table source sélectionnée seront applicables. Le texte doit avoir le format d'une clause SQL WHERE standard, bien que le mot clé WHERE soit implicite. Pour filtrer les données au moyen de dimensions, vous pouvez également utiliser les variables suivantes : `%cycle%` : Nom du cycle `%cycleperiod%` : Libellé de la période de cycle `%cycleperiod-Startdate%` : Date de début de la rubrique de période courante (au niveau Cycle.Périodicité) dans le format de date requis. Il ne s'agit pas de la date à laquelle la période de cycle est lancée. `%cycleperiod-Enddate%` : Date de fin de la rubrique de période courante (au niveau Cycle.Périodicité) dans le format de date requis. Il ne s'agit pas de la date à laquelle la période de cycle est terminée ou de la date de fin de l'horizon de cycle de période. `%horizon-start%` : Date de début de l'horizon de période de cycle, dans le format de date requis ; il s'agit de la première (la plus ancienne) période de base au sein de la période de cycle courante. `%horizon-end%` : Date de fin de l'horizon de période de cycle, dans le format de date requis ; il s'agit de la dernière (la plus récente) période de base au sein de la période de cycle courante. `%scenario%` : nom de scénario Exemples : `CHAN_ID <> 'TOTAL' AND End_date > %CyclePeriod-StartDate%` ou `PROD_GROUP = %scenario% AND PERIOD >= %horizon-start% AND PERIOD <= %horizon-end%`

Spécifiez un filtre s'appliquant aux données transmises via le service d'interface. Dans le cas contraire, tous les enregistrements de la table source sélectionnée seront applicables. Le texte doit avoir le format d'une clause SQL WHERE standard, bien que le mot clé WHERE soit implicite.

Pour filtrer les données au moyen de dimensions, vous pouvez également utiliser les variables suivantes :

%cycle% : Nom du cycle
%cycleperiod% : Libellé de la période de cycle
%cycleperiod-Startdate% : Date de début de la rubrique de période courante (au niveau Cycle.Périodicité) dans le format de date requis. Il ne s'agit pas de la date à laquelle la période de cycle est lancée.
%cycleperiod-Enddate% : Date de fin de la rubrique de période courante (au niveau Cycle.Périodicité) dans le format de date requis. Il ne s'agit pas de la date à laquelle la période de cycle est terminée ou de la date de fin de l'horizon de cycle de période.
%horizon-start% : Date de début de l'horizon de période de cycle, dans le format de date requis ; il s'agit de la première (la plus ancienne) période de base au sein de la période de cycle courante.
%horizon-end% : Date de fin de l'horizon de période de cycle, dans le format de date requis ; il s'agit de la dernière (la plus récente) période de base au sein de la période de cycle courante.
%scenario% : nom de scénario

Exemples :

CHAN_ID <> 'TOTAL' AND End_date > %CyclePeriod-StartDate% ou PROD_GROUP = %scenario% AND PERIOD >= %horizon-start% AND PERIOD <= %horizon-end%

Si vous sélectionnez > > :

Option	Description
Requête	Entrez une instruction SQL et cliquez sur Vérifier pour valider le texte de la requête. Remarque : Si la requête est validée, les champs retournés sont enregistrés à des fins d'utilisation dans les onglets Mappages et Importer / exporter les mesures, ce qui vous permet de sélectionner les champs qui feront l'objet du mappage. Dans le cas contraire, vous devez ajouter ces champs manuellement dans la source de données pour cette interface.

Option

Description

Requête

Entrez une instruction SQL et cliquez sur Vérifier pour valider le texte de la requête.

Remarque : Si la requête est validée, les champs retournés sont enregistrés à des fins d'utilisation dans les onglets Mappages et Importer / exporter les mesures, ce qui vous permet de sélectionner les champs qui feront l'objet du mappage.

Dans le cas contraire, vous devez ajouter ces champs manuellement dans la source de données pour cette interface.

Pour tout autre type d'interface :

Définition de période de calendrier: Indique si les périodes de calendrier sont exportées en utilisant la date de début de rubrique, la date de fin de rubrique ou le nom de rubrique définis dans le format de calendrier (par exemple EX10 M03).

Cochez la case Effacer valeurs de scénario non modifiées pour réinitialiser les valeurs de scénario qui ne sont pas modifiées après l'importation des données en fonction du filtre de mesure.

Remarque : Si le filtre de mesure est spécifié, toutes les valeurs non modifiées pour les mesures dans le filtre sont réinitialisées. S'il n'est pas spécifié, toutes les valeurs non modifiées pour les mesures qui sont mises à jour pendant l'importation sont réinitialisées.

L'onglet Mappages contient, le cas échéant, une liste de dimensions à mapper et de paramètres de module. Dans cet onglet, changez si nécessaire les libellés de champs associés.

L'onglet Importer / exporter les mesures contient une liste de (lignes de) mesures qui interviennent en tant que source ou destination du transfert, ainsi que l'identifiant correspondant du service d'interface. Dans cet onglet, cliquez sur Nouveaupour entrer les mesures qui servent de filtre au service d'interface, en limitant l'importation ou l'exportation aux seules mesures définies ici.

Pour le type d'interface Base de données, l'onglet supplémentaire Exporter les constantes récapitule les données constantes applicables à exporter. Dans cet onglet, changez si nécessaire les valeurs et libellés de champs associés. Les constantes d'exportation indiquées dans cet onglet peuvent être utilisées pour exporter plusieurs scénarios dans une seule définition d'interface, en utilisant les variables Filtre d'importation. Par ex., si la constante d'exportation utilise la variable %scenario%, cette variable peut utiliser une simple définition d'interface pour exporter plusieurs scénarios.

Pour filtrer les données au moyen de dimensions, vous pouvez également utiliser les variables suivantes :

%cycle% : Nom du cycle
%cycleperiod% : Libellé de la période de cycle
%cycleperiod-Startdate% : Date de début de la rubrique de période courante (au niveau Cycle.Périodicité) dans le format de date requis. Il ne s'agit pas de la date à laquelle la période de cycle est lancée.
%cycleperiod-Enddate% : Date de fin de la rubrique de période courante (au niveau Cycle.Périodicité) dans le format de date requis. Il ne s'agit pas de la date à laquelle la période de cycle est terminée ou de la date de fin de l'horizon de cycle de période.
%horizon-start% : Date de début de l'horizon de période de cycle, dans le format de date requis ; il s'agit de la première (la plus ancienne) période de base au sein de la période de cycle courante.
%horizon-end% : Date de fin de l'horizon de période de cycle, dans le format de date requis ; il s'agit de la dernière (la plus récente) période de base au sein de la période de cycle courante.
%scenario% : Nom du scénario

Cliquez sur Soumettre.