Publication de plusieurs informations d'effectivité
Un article ou un produit est fabriqué en fonction des effectivités appliquées. Il est important de publier les effectivités appliquées dans le système ERP (Enterprise Resource Planning) en aval.
Les effectivités sont appliquées aux articles, aux objets de données étendues et de données de service. L'effectivité peut être une date, un numéro de lot ou un numéro de série. Pour plus d'informations, consultez la rubrique A propos de l'effectivité.
Vous pouvez publier les informations d'effectivité appliquées dans la réponse Windchill Enterprise Systems Integration (ESI) vers une destination de publication à l'aide de l'ERP Connector. La configuration requise pour que les informations d'effectivité soient publiées dans la réponse Windchill ESI est fournie par défaut.
Vous pouvez publier l'effectivité à partir de l'objet de lien de la matière première avec la nomenclature.
1. Pour publier l'effectivité de l'objet d'historique de fabrication via l'avis de modification :
a. Dans le fichier esi.properties.xconf, définissez la valeur par défaut sur true dans la propriété suivante :
<Property default="false" name="com.ptc.windchill.esi.publishEffectivityInformationFromManufacturingHistory"/>
b. Exécutez la commande suivante :
xconfmanager -pf
c. Après la propagation de la propriété, vous verrez com.ptc.windchill.esi.publishEffectivityInformationFromManufacturingHistory dans le fichier esi.properties.
2. Ouvrez un article dans le transformateur de nomenclature et ajoutez des articles de matière première à l'aide de l'action 
> . Pour obtenir des instructions détaillées, consultez la rubrique Association d'un article de matière première ou semi-fini à un article.
> . Pour obtenir des instructions détaillées, consultez la rubrique Association d'un article de matière première ou semi-fini à un article.
3. Créez un avis de modification, ECN_001, associez-le à la structure de nomenclature et ajoutez l'effectivité.
4. Cliquez sur 
> . La page Mettre à jour les destinations de publication s'ouvre. Sur cette page, recherchez et cochez les cases de la cible sur laquelle vous souhaitez publier.
> . La page Mettre à jour les destinations de publication s'ouvre. Sur cette page, recherchez et cochez les cases de la cible sur laquelle vous souhaitez publier.5. Cliquez sur OK.
6. Sélectionnez l'article racine dans la vue en amont ou en aval, puis cliquez sur > . La page Envoyer vers la destination de publication s'ouvre.
> . La page Envoyer vers la destination de publication s'ouvre.7. Cliquez sur Suivant. La section Objets inclus affiche la liste des destinations sélectionnées pour la publication.
8. Cliquez sur Envoyer. Un message confirme le lancement de la publication.
9. Résolvez l'avis de modification.
La réponse suivante est générée :
Effectivité
<Effectivity>
<ObjectID>OR:wt.effectivity.WTDatedEffectivity:198919:222562873-1634234454365-525180031-1-0-0-127@vagrant.ptcnet.ptc.com</ObjectID>
<Class>com.ptc.windchill.esi.Part</Class>
<StartEffectivity>2021-10-27 00:00:00</StartEffectivity>
<EndEffectivity>2021-10-31 00:00:00</EndEffectivity>
<EffectivityCxtPartNumber/>
<EffectivityType>Date Effectivity</EffectivityType>
<EffectivityQualifier>Exact</EffectivityQualifier>
<PartMaster>0000000064</PartMaster>
<TargetID>FILE_0001</TargetID>
</Effectivity>
<ObjectID>OR:wt.effectivity.WTDatedEffectivity:198919:222562873-1634234454365-525180031-1-0-0-127@vagrant.ptcnet.ptc.com</ObjectID>
<Class>com.ptc.windchill.esi.Part</Class>
<StartEffectivity>2021-10-27 00:00:00</StartEffectivity>
<EndEffectivity>2021-10-31 00:00:00</EndEffectivity>
<EffectivityCxtPartNumber/>
<EffectivityType>Date Effectivity</EffectivityType>
<EffectivityQualifier>Exact</EffectivityQualifier>
<PartMaster>0000000064</PartMaster>
<TargetID>FILE_0001</TargetID>
</Effectivity>
Publication de l'effectivité en tant qu'élément d'un groupe distinct
Windchill ESI vous permet de publier plusieurs informations d'effectivité associées à un objet sur une destination de publication à l'aide d'ERP Connector. Par défaut, l'effectivité associée aux objets suivants est publiée en tant que groupe distinct dans la réponse ESI :
• Article
• Jeu "Fait de"
• Coproduction
• BOMHeader
• Composant de nomenclature
• Données d'entreprise
• Données d'usine
• Données de service
• Version de production
Dans la réponse ESI, l'effectivité est publiée dans les groupes Ajoutés, Inchangés ou Supprimés. L'effectivité appliquée aux données étendues et aux données de service est publiée en dehors de leurs groupes respectifs. Elle n'est pas combinée avec les informations d'effectivité de l'article, même si les attributs de données étendues et de données de service sont combinés avec les attributs de l'article.
Reportez-vous à l'exemple suivant d'article et d'éléments d'effectivité dans la réponse ESI. Notez que l'attribut AssociatedEffectivityID de l'article correspond à l'attribut ObjectID de l'effectivité.
<AddedBOMs NAME="AddedBOMs" TYPE="Unknown" STATUS="0">
<BOMHeader>
<ObjectID>OR:wt.part.WTPart:234172:885848332-1727961145874-1013430185-147-200-228-10@vagrant.ptcnet.ptc.com</ObjectID>
<Class>com.ptc.windchill.esi.BOMHeader</Class>
<LastChangedBy>wcadmin</LastChangedBy>
<Number>SXKMB00224</Number>
<Version>A</Version>
<Iteration>2</Iteration>
<EnterpriseVersion/>
<PreviousVersion/>
<Usage/>
<Alternate/>
<IsCADPhantom>false</IsCADPhantom>
<IsCollapsible>false</IsCollapsible>
<AssociatedEffectivityID>OR:wt.part.ProductSerialNumberEffectivity:234224:885848332-1727961145874-1013430185-147-200-228-10@vagrant.ptcnet.ptc.com</AssociatedEffectivityID>
<EffectivityCxtPartNumber>SXKMB00164</EffectivityCxtPartNumber>
<PreviousChangeNumber/>
<Type>Part</Type>
<TargetPlant/>
<Quantity/>
<Unit/>
<AssociatedMadeFromObjectID/>
<IsAllocatedAsResource>false</IsAllocatedAsResource>
<TargetID>FILE_DT_01</TargetID>
</BOMHeader>
</AddedBOMs>
...
<AddedEffectivities NAME="AddedEffectivities" TYPE="Unknown" STATUS="0">
<Effectivity>
<ObjectID>OR:wt.part.ProductSerialNumberEffectivity:234224:885848332-1727961145874-1013430185-147-200-228-10@vagrant.ptcnet.ptc.com</ObjectID>
<Class>com.ptc.windchill.esi.Part</Class>
<StartEffectivity>32</StartEffectivity>
<EndEffectivity>98</EndEffectivity>
<EffectivityCxtPartNumber>SXKMB00164</EffectivityCxtPartNumber>
<EffectivityType>End Item Serial Number Effectivity</EffectivityType>
<EffectivityQualifier>Exact</EffectivityQualifier>
<PartMaster>SXKMB00224</PartMaster>
<TargetID>FILE_DT_01</TargetID>
</Effectivity>
</AddedEffectivities>
<BOMHeader>
<ObjectID>OR:wt.part.WTPart:234172:885848332-1727961145874-1013430185-147-200-228-10@vagrant.ptcnet.ptc.com</ObjectID>
<Class>com.ptc.windchill.esi.BOMHeader</Class>
<LastChangedBy>wcadmin</LastChangedBy>
<Number>SXKMB00224</Number>
<Version>A</Version>
<Iteration>2</Iteration>
<EnterpriseVersion/>
<PreviousVersion/>
<Usage/>
<Alternate/>
<IsCADPhantom>false</IsCADPhantom>
<IsCollapsible>false</IsCollapsible>
<AssociatedEffectivityID>OR:wt.part.ProductSerialNumberEffectivity:234224:885848332-1727961145874-1013430185-147-200-228-10@vagrant.ptcnet.ptc.com</AssociatedEffectivityID>
<EffectivityCxtPartNumber>SXKMB00164</EffectivityCxtPartNumber>
<PreviousChangeNumber/>
<Type>Part</Type>
<TargetPlant/>
<Quantity/>
<Unit/>
<AssociatedMadeFromObjectID/>
<IsAllocatedAsResource>false</IsAllocatedAsResource>
<TargetID>FILE_DT_01</TargetID>
</BOMHeader>
</AddedBOMs>
...
<AddedEffectivities NAME="AddedEffectivities" TYPE="Unknown" STATUS="0">
<Effectivity>
<ObjectID>OR:wt.part.ProductSerialNumberEffectivity:234224:885848332-1727961145874-1013430185-147-200-228-10@vagrant.ptcnet.ptc.com</ObjectID>
<Class>com.ptc.windchill.esi.Part</Class>
<StartEffectivity>32</StartEffectivity>
<EndEffectivity>98</EndEffectivity>
<EffectivityCxtPartNumber>SXKMB00164</EffectivityCxtPartNumber>
<EffectivityType>End Item Serial Number Effectivity</EffectivityType>
<EffectivityQualifier>Exact</EffectivityQualifier>
<PartMaster>SXKMB00224</PartMaster>
<TargetID>FILE_DT_01</TargetID>
</Effectivity>
</AddedEffectivities>
Par défaut, l'effectivité est publiée en tant qu'élément dans un groupe distinct. Pour modifier le comportement par défaut, définissez l'une des propriétés suivantes :
• Pour publier l'effectivité dans le même groupe que celui de l'objet associé, définissez la propriété suivante sur vrai à l'aide du gestionnaire xconf :
xconfmanager -s com.ptc.windchill.esi.renderEffectivityElementInPartElement=true -t codebase/com/ptc/windchill/esi/esi.properties -p
• Pour publier l'effectivité en tant qu'attribut de l'élément d'objet, définissez la propriété suivante sur vrai à l'aide du gestionnaire xconf :
xconfmanager -s com.ptc.windchill.esi.renderEffectivityWithPartAttributes=true -t codebase/com/ptc/windchill/esi/esi.properties -p
Publication incrémentielle des nomenclature en fonction du contexte d'effectivité
Pour publier la nomenclature en fonction du contexte d'effectivité, définissez la préférence Activer le calcul des différences dans la nomenclature en fonction du contexte d'effectivité sur Oui. Cette préférence peut être configurée au niveau Site ou Organisations en accédant à > > > . Lorsque la préférence est définie sur Oui, la nomenclature en cours de publication est comparée à sa version antérieure publiée qui a été publiée avec le même contexte d'effectivité pour la même destination de publication. Lorsque qu'elle est définie sur Non (par défaut), la nomenclature en cours de publication est comparée à la dernière nomenclature publiée, sans tenir compte du contexte d'effectivité.
En mode de publication centré sur avis de modification, les préférences Inclure le contexte d'effectivité et Valider le contexte d'effectivité doivent être définies en conséquence pour publier la nomenclature en fonction du contexte d'effectivité.
Prenons les scénarios suivants lorsque vous publiez une nomenclature avec la préférence Activer le calcul des différences dans la nomenclature en fonction du contexte d'effectivité définie sur Oui :
Scénario | Structure de nomenclature | Réponse ESI | Remarques |
|---|---|---|---|
1 | Créez et publiez la structure d'article avec l'effectivité suivante : ParentPart_1 (A.1) ChildPart_1 ChildPart_2 Appliquer l'effectivité à ParentPart_1 Contexte : Cntxt_1 (Numéro d'article - 0000000001) Nº de série : 1-100 | Articles ajoutés : ParentPart_1 ChildPart_1 ChildPart_2 Effectivité ajoutée : Effectivité de numéro de série produit fini 1-100 EffectivityCxtPartNumber : 0000000001 (Cntxt_1) En-tête de nomenclature ajouté : ParentPart_1 Composants de nomenclature ajoutés : ChildPart_1 ChildPart_2 | Dans ce scénario, tous les articles, l'en-tête de nomenclature et les composants sont créés. L'effectivité est ajoutée. |
2 | Révisez ParentPart_1 pour ajouter ChildPart_3 et publier la structure suivante avec un contexte d'effectivité différent. ParentPart_1 (B.1) ChildPart_1 ChildPart_2 ChildPart_3 Appliquer l'effectivité à ParentPart_1 Contexte : Cntxt_2 (Numéro d'article 0000000002) Nº de série : 1001-1100 | Articles ajoutés : ChildPart_3 Articles modifiés : ParentPart_1 Articles inchangés : ChildPart_1 ChildPart_2 Effectivité ajoutée : Effectivité de numéro de série produit fini : 1001-1100 EffectivityCxtPartNumber : 0000000002 En-tête de nomenclature ajouté : ParentPart_1 Composants de nomenclature ajoutés : ChildPart_1 ChildPart_2 ChildPart_3 | • Les articles sont ajoutés, modifiés ou inchangés en fonction des actions effectuées. • L'effectivité est publiée comme ajoutée. • L'en-tête de nomenclature et les composants sont ajoutés, car le contexte d'effectivité de ParentPart_1 (B.1) est différent de celui de ParentPart_1 (A.1). |
3 | Révisez ParentPart_1. Mettez à jour la quantité de ChildPart_1 et de ChildPart_2. Publiez la structure suivante avec le même contexte d'effectivité que dans le scénario 1. ParentPart_1 (C.1) ChildPart_1 (avec quantité mise à jour) ChildPart_2 (avec quantité mise à jour) ChildPart_3 Appliquer l'effectivité à ParentPart_1 Contexte : Cntxt_1 (Numéro d'article 0000000001) Nº de série : 101-200 | Articles modifiés : ParentPart_1 Articles inchangés : ChildPart_1 ChildPart_2 ChildPart_3 Effectivité supprimée : Effectivité de numéro de série produit fini : 1-100 EffectivityCxtPartNumber : 0000000001 Effectivité ajoutée : Effectivité de numéro de série produit fini : 101-200 EffectivityCxtPartNumber : 0000000001 En-tête de nomenclature modifié : ParentPart_1 Composants de nomenclature ajoutés : ChildPart_3 Composants de nomenclature modifiés : ChildPart_1 ChildPart_2 | • Les articles sont ajoutés, modifiés ou inchangés en fonction des actions effectuées. • L'effectivité précédente est supprimée et la nouvelle effectivité est publiée comme ajoutée. • L'en-tête et les composants de nomenclature pour les articles ParentPart_1, ChildPart_1 et ChildPart_2 sont publiés comme modifiés, tels qu'ils ont été publiés précédemment (voir scénario 1). • Le composant de nomenclature pour ChildPart_3 est publié comme ajouté car cet article n'était pas disponible dans la nomenclature pour la version A.1. |
 | La publication d'objets de jeu Fait de et de coproduction en fonction de l'effectivité est prise en charge lorsque la préférence Activer le calcul des différences dans la nomenclature en fonction du contexte d'effectivité est définie sur Oui. |
Publication des informations d'effectivité dans les systèmes SAP
Tenez compte des points suivants lorsque vous publiez des informations d'effectivité dans des systèmes SAP :
• La variable globale RenderEffectivityInSeparateElement dans le middleware TIBCO détermine si les informations d'effectivité sont publiées dans des éléments distincts dans la réponse ESI. Par défaut, cette variable globale est définie sur vrai. Pour publier des informations d'effectivité dans l'élément d'article ou en tant qu'attributs d'article, vous devez définir cette variable globale sur faux.
• L'effectivité associée au rendu de l'objet dans l'élément AddedEffectivities dans la réponse ESI est prise en compte pour la consommation dans SAP.
• Plusieurs instances des informations d'effectivité du même type sont consommées dans les systèmes SAP.
• Les effectivités multiples de différents types d'effectivité sont ignorées et les objets sont publiés sans aucune information d'effectivité.
• Le comportement associé à la variable globale TIBCO PartEffectivityFlag n'est pas applicable si les informations d'effectivité sont publiées dans des éléments distincts dans la réponse ESI.
• Seules les informations d'effectivité publiées à l'aide d'un avis de modification sont consommées dans les systèmes SAP. Les informations d'effectivité publiées sans avis de modification ne sont pas consommées.
• Les effectivités sur les données d'entreprise et les données d'usine ne sont pas consommées par la logique métier TIBCO. Cela s'applique également aux données de service.
Consommation de nomenclatures incrémentielles dans SAP en fonction du contexte d'effectivité
• Les nomenclatures incrémentielles publiées en fonction du contexte d'effectivité sont consommées dans SAP uniquement si l'effectivité est publiée sous forme d'éléments distincts dans la réponse ESI et si la variable globale RenderEffectivityInSeparateElement dans le middleware est définie sur vrai.
• L'utilisation des nomenclatures incrémentielles publiées en fonction du contexte d'effectivité dépend de la valeur de l'attribut EffectivityCxtPartNumber de l'objet respectif. Si cet attribut est publié avec une valeur mais que la réponse ESI n'inclut pas d'avis de modification, un message d'erreur est généré par le middleware.
• SAP permet de publier plusieurs nomenclatures avec plusieurs contextes d'effectivité. Toutefois, tous les contextes d'effectivité seront appliqués à toutes les nomenclatures, conduisant à des résultats incorrects.
• Pour un avis de modification unique, vous ne devez publier qu'un seul contexte d'effectivité pour toutes les nomenclatures. Si un avis de modification contient plusieurs nomenclatures associées à plusieurs contextes d'effectivité, un message d'erreur est généré par le middleware.
• La consommation de nomenclatures incrémentielles en fonction du contexte d'effectivité ne concerne que l'effectivité de série. Dans les systèmes SAP, l'effectivité de date n'inclut pas les informations de contexte.