Création ou modification d’un accord
Cette rubrique explique comment créer ou modifier un accord de partenaire commercial. Un accord de partenaire commercial configure la relation entre deux partenaires commerciaux, y compris leurs identités ; le processus d’interface partenaire (PIP) ; les URL d’action, de signal et de synchronisation ; et les protocoles associés.
Un contrat de partenaire commercial inclut les paramètres d’une configuration de processus, d’une organization d’accueil, d’un partenaire et d’un accord. Tous ces paramètres sont requis pour un contrat. Vous pouvez créer une configuration de processus basée sur un PIP RosettaNet ou un schéma personnalisé, mais vous devez créer la configuration. Vous devez également définir un organization d’accueil et un organization partenaire. Microsoft BizTalk Accelerator pour RosettaNet (BTARN) ne prend pas en charge l’échange de messages entre des parties inconnues.
BTARN traite et valide un message en fonction de tous ces paramètres. Par exemple, pour un message CIDX, BTARN valide en fonction de la version de RosettaNet Implementation Framework (RNIF) (1.1 uniquement), de l’accord 0A1 (n° 0A1 uniquement) et de Is Single Action la propriété (action unique uniquement). Un message CIDX est validé uniquement si vous définissez la version RNIF sur « 1.1 », le contrat 0A1 sur « No 0A1 » et la Is Single Action propriété sur True. BTARN vérifie également que toutes les propriétés d’accord sont cohérentes avec les paramètres du profil de configuration de processus. Par exemple, il vérifie que vous avez défini la Standard propriété du profil sur « CIDX » et que la propriété de contrat 0A1 du contrat est définie sur « No 0A1 ».
Si vous modifiez un contrat alors qu’un processus est actif, vous pouvez rencontrer des résultats imprévisibles. Les modifications apportées aux propriétés du contrat s’appliquent dès que vous cliquez sur Appliquer ou OK pour les accepter, mais vous ne pouvez pas prédire l’étape d’exécution d’un processus. Une fois que vous avez modifié le contrat, toute nouvelle activité d’un processus en cours ou d’un nouveau processus utilise les propriétés modifiées de l’accord. Toutefois, un processus en cours d’exécution lorsque vous modifiez le contrat peut avoir déjà utilisé les propriétés du contrat précédent pour un message qu’il traite.
Après avoir créé un contrat, vous devez l’activer pour permettre aux messages associés au contrat d’être envoyés ou reçus. Vous pouvez également désactiver un accord pour empêcher l’envoi ou la réception de messages associés à l’accord. Vous devez désactiver un contrat pour le modifier, puis le réactiver après la modification.
BTARN enregistre ces informations dans la table TPAConfig de la base de données BTARNCONFIG.
Les paramètres de l’accord de partenaire commercial sont indiqués dans le tableau suivant, organisés par onglet. Les paramètres par défaut sont les valeurs les plus couramment utilisées. Les procédures de création et de modification de ces paramètres s’affichent après le tableau.
| Onglet | Paramètre | Usage |
|---|---|---|
| Généralités | Nom | Nom unique de l’accord, tel que Fabrikam_To_Contoso_3A2. Ce champ est obligatoire. |
| Généralités | Il traite la configuration | Identificateur du PIP. Ce nombre identifie la configuration de processus associée à cet accord. La valeur par défaut est la première dans la liste des configurations de processus. La liste déroulante inclut toutes les configurations de processus précédemment entrées. Ce champ est obligatoire. |
| Généralités | Mon organisation | Le organization d’accueil, sélectionné dans une liste déroulante. Ce champ est obligatoire. |
| Généralités | Organization partenaires | Le partenaire organization, sélectionné dans une liste déroulante. Ce champ est obligatoire. |
| Généralités | Description | Description de l’accord de partenaire commercial. |
| Généralités | Version de RNIF | Version du RNIF que BTARN utilisera pour les communications d’accord. Il peut s’agir de V01.10.00 ou V02.00.01 (valeur par défaut). Doit être V01.10.00 pour CIDX. |
| Généralités | Rôle d’accueil | Rôle du organization d’accueil. Peut être un rôle d’initiateur ou de répondeur. |
| Généralités | Contrat 0A1 | Indique si BTARN retourne un message de notification d’échec (0A1 PIP) en cas d’échec. Peut être No 0A1 (la valeur par défaut) ou 0A1. Doit être no 0A1 pour CIDX. |
| Généralités | Utilisation | Indique le type de scénario que l’accord utilisera. Peut être Test (la valeur par défaut) ou Production. |
| Généralités (Zone adaptateur d’application ) |
Nom de l'assembly | Nom du fichier ApplicationAdapter que vous pouvez sélectionner dans le système de fichiers. La valeur par défaut est une chaîne vide. |
| Généralités (Zone adaptateur d’application) |
Nom de classe | Nom de la classe que BTARN utilisera à partir de ApplicationAdapter. La valeur par défaut est <none>. |
| Généralités (Zone de l’adaptateur de validation) |
Nom de l'assembly | Nom de fichier de ValidationAdapter que vous pouvez sélectionner dans le système de fichiers. La valeur par défaut est une chaîne vide. |
| Généralités (Zone de l’adaptateur de validation) |
Nom de classe | Nom de la classe que BTARN utilisera à partir de ValidationAdapter. La valeur par défaut est <none>. |
| Ports | URL d’action | URL à laquelle le organization d’accueil transmet un message d’action. Par exemple : http://FabrikamServer/BTARNApp/RNIFReceive.aspx.Il s’agit d’un champ obligatoire si les éléments suivants sont tous vrais : - Le paramètre de configuration de processus synchrone est False.- Le paramètre de configuration du processus Est une action unique est True.- Le paramètre d’accord de rôle Accueil est Initiateur. Il s’agit également d’un champ obligatoire si les éléments suivants sont true (auquel cas, le champ URL du signal est également requis) : - Le paramètre de configuration de processus synchrone est False.- Le paramètre de configuration du processus Est une action unique est False.- Vous devez entrer un URI valide dans ce champ, qui commence par «< http://domain> » ou « ».<https://domain> |
| Ports | URL de signal | URL à laquelle le organization de base transmettra un message de signal. Par exemple : http://FabrikamServer/BTARNApp/RNIFReceive.aspx.Il s’agit d’un champ obligatoire si les éléments suivants sont vrais : - Le paramètre de configuration de processus est synchrone est False.- Le paramètre de configuration du processus Is Single Action est True.- Le paramètre contrat de rôle Accueil est Répondeur. Il s’agit également d’un champ obligatoire si les éléments suivants sont vrais (auquel cas, le champ URL de l’action est également requis) : - Le paramètre de configuration de processus est synchrone est False.- Le paramètre de configuration du processus Is Single Action est False.Vous devez entrer un URI valide dans ce champ, qui commence par «< http://domain> » ou « ».<https://domain> |
| Ports | URL de synchronisation | URL que le organization de base utilisera pour établir une connexion via l’adaptateur HTTP. Par exemple : http://FabrikamServer/BTARNApp/RNIFReceive.aspx.Il s’agit d’un champ obligatoire si les éléments suivants sont vrais : - Le paramètre de configuration de processus est synchrone est True.- Le paramètre contrat de rôle Accueil est Initiateur. Vous devez entrer un URI valide dans ce champ, qui commence par «< http://domain> » ou « ».<https://domain> |
| Protocole | Méthode Digest | Protocole utilisé pour calculer le résumé des messages entrants à des fins de non-répudiation. À compter de BizTalk Server 2016 et des versions ultérieures, la prise en charge de SHA2 est automatiquement incluse. Les options sont les suivantes : MD5, SHA-1, SHA-256 (par défaut), SHA-384 et SHA-512. Pour les versions BizTalk Server précédentes, les options incluent MD5 ou SHA-1 (par défaut). Le pipeline de réception BTARN reçoit et déchiffre un message même si le protocole utilisé pour chiffrer le message et le paramètre Encodage sous cet onglet du contrat ne correspondent pas. Par conséquent, BTARN reçoit des messages chiffrés en RC2-40 ou 3DES. Tous les messages signés sortants ont un résumé de SHA-1. |
| Protocole | Encoder toutes les parties | Indique si le système encodera toutes les parties du message en plusieurs parties. Peut être True ou False (valeur par défaut).Quand True, toutes les parties du message en plusieurs parties sont encodées ensemble à l’aide de la méthode indiquée par la Encoding propriété .Quand False, le système code uniquement les pièces jointes à l’aide de la méthode indiquée par la Encoding propriété . (Les pièces jointes sont toujours encodées par le pipeline d’envoi à l’aide de la méthode indiquée par la Encoding propriété.) Par défaut, lorsque vous définissez cette propriété sur False, BTARN encode les autres parties du message (quatre parties dans RNIF 2.01, trois parties dans RNIF 1.1) au format imprimable entre guillemets. |
| Protocole | Encodage | Protocole utilisé pour encoder toutes les parties (si la zone Encoder toutes les parties est True) ou la pièce jointe (si la zone Encoder toutes les parties a la valeur False).Il peut s’agir de 8 bits, de base 64 (valeur par défaut) ou d’impression entre guillemets. |
| Protocole | Algorithme de chiffrement | Algorithme utilisé pour chiffrer les messages entrants et sortants. À compter de BizTalk Server 2016 et des versions ultérieures, la prise en charge d’AES est automatiquement incluse. Les options incluent RC2-40, 3DES, AES128 (par défaut), AES192 et AES256. Pour les versions BizTalk Server précédentes, les options incluent RC2-40 (par défaut) ou 3DES. L’algorithme de chiffrement prend effet uniquement si vous avez défini la Is Persistent Confidentiality Required propriété sur Payload ou Payload Container dans la configuration de processus correspondante. |
| Protocole | Sens du chiffrement | Indique si le système chiffre le message entrant ou le message sortant, ou les deux. Peut être entrant, sortant ou entrant/sortant (valeur par défaut). Le paramètre de direction de chiffrement prend effet uniquement si vous avez défini la propriété sur Is Persistent Confidentiality RequiredPayload ou Payload Container dans la configuration de processus correspondante. |
| Propriétés personnalisées | Nom | Nom de la propriété personnalisée. Vous pouvez définir des propriétés personnalisées par contrat. Si vous créez un processus privé personnalisé, vous pouvez utiliser ces propriétés personnalisées dans le traitement de différents contrats. Vous pouvez utiliser la RuntimeConfig.GetTPACustomConfigValue méthode dans le Kit de développement logiciel (SDK) BTARN pour récupérer des propriétés personnalisées à partir de la configuration BTARN.La Name propriété doit être unique et non vide.Vous pouvez entrer les valeurs personnalisées suivantes : - AAR. Il s’agit de la propriété personnalisée Acceptation requise. Cela s’applique uniquement à RNIF 1.1. Définissez cette valeur sur false (qui ne respecte pas la casse) pour exiger uniquement un accusé de réception, et non un accusé de réception. Si AAR est défini sur autre chose que false, le processus public du répondeur doit envoyer un accusé de réception d’acceptation, et le processus public de l’initiateur attend un accusé de réception. Si AAR est défini sur false, les processus publics se terminent après l’accusé de réception. - HPCC. Il s’agit du code de classification du partenaire d’accueil. Cela s’applique uniquement à RNIF 1.1. Cela vous permet de définir l’élément GlobalPartnerClassificationCode pour le partenaire de base dans l’en-tête de service d’un message sortant sur l’entrée de la colonne Value. Cette valeur remplace la propriété de classification Home organization dans la configuration de l’organisation d’origine. Utilisez cette propriété personnalisée lorsque le organization de base peut avoir plusieurs classifications. - PPCC. Il s’agit du code de classification du profil partenaire. Cela s’applique uniquement à RNIF 1.1. Cela vous permet de définir l’élément GlobalPartnerClassificationCode pour le partenaire dans l’en-tête de service d’un message sortant sur l’entrée de la colonne Value. Cette valeur remplace la propriété de classification du partenaire dans la configuration du partenaire. Utilisez cette propriété personnalisée lorsque le partenaire peut avoir plusieurs classifications. |
| Propriétés personnalisées | Valeur | Valeur de la propriété personnalisée. |
Création d'un accord de partenariat commercial
Cliquez sur Démarrer, pointez sur Tous les programmes, sur MicrosoftBizTalk Accelerator pour RosettaNet, puis cliquez sur BizTalk Accelerator pour RosettaNetManagement Console.
Dans la console de gestion BTARN, développez BizTalk Accelerator pour RosettaNet.
Cliquez avec le bouton droit sur Contrats, pointez sur Nouveau, puis cliquez sur Contrat.
Dans la boîte de dialogue Propriétés du nouveau contrat, sous les onglets Général, Ports, Protocole et Propriétés personnalisées , entrez les valeurs des paramètres. Pour plus d'informations sur ces paramètres, consultez le tableau précédent.
Cliquez sur OK.
Notes
BTARN n’acceptera pas les messages liés au contrat tant que vous n’aurez pas activé le contrat.
Cliquez avec le bouton droit sur le nom du contrat dans le volet droit, puis cliquez sur Activer.
Notes
Si vous avez déjà activé un contrat, vous pouvez cliquer avec le bouton droit sur le nom du contrat dans le volet droit, puis cliquer sur Désactiver pour empêcher l’envoi ou la réception de messages associés au contrat.
Modifier un contrat de partenaire commercial
Cliquez sur Démarrer, pointez sur Tous les programmes, sur MicrosoftBizTalk Accelerator pour RosettaNet, puis cliquez sur BizTalk Accelerator pour RosettaNetManagement Console.
Dans la console de gestion BTARN, développez Accélérateur BizTalk pour RosettaNet, puis cliquez sur le nœud Contrats .
Cliquez avec le bouton droit sur le contrat que vous souhaitez modifier, puis cliquez sur Propriétés.
Dans la < boîte de dialogue Propriétés du nom> du contrat, sous les onglets Général et Propriétés du contact, modifiez les paramètres en fonction des besoins. Pour plus d'informations sur ces paramètres, consultez le tableau précédent.
Cliquez sur OK.
Voir aussi
Gérer la configuration, les certificats, les bases de données et la sécurité
Administration de la configuration de BTARN