SAP BTP & Cloud Barcode RESTapi
Optimisez votre stratégie d'étiquetage par codes-barres avec SAP BTP Integration Suite. Ce guide couvre le cycle de vie technique complet, de la connectivité à la transformation par script.
Sécurité OAuth 2.0
Le Key Store BTP gère les jetons Bearer, éliminant ainsi le besoin de clés API codées en dur dans S/4HANA.
Traitement Groovy
Calculez dynamiquement les dimensions et formats de codes-barres basés sur les charges utiles OData de S/4HANA.
Sortie Multi-Format
Générez directement du flux SVG pour les applications web Fiori ou du PNG haute résolution pour les imprimantes thermiques.
Connectivité du Subaccount
Dans votre Subaccount SAP BTP, accédez à Connectivity > Destinations. Définissez une nouvelle destination HTTP pour router le trafic via le backbone cloud de SAP.
| Propriété | Valeur |
|---|---|
| Nom | BARCODESOFT_CLOUD |
| URL | https://www.barcodesoft.com |
| Authentification | NoAuthentication (Jeton géré dans l'iFlow) |
Traitement Dynamique des Requêtes (Groovy)
Au sein de votre iFlow SAP Integration Suite, utilisez un script Groovy pour garantir que les données du code-barres sont encodées en URL et conformes GS1 avant d'appeler l'endpoint.
import com.sap.gateway.ip.core.customdev.util.Message;
import java.util.HashMap;
def Message processData(Message message) {
def map = message.getHeaders();
def rawData = map.get("S4_Material_Batch"); // Provenance de S/4HANA
// Formatage données GS1 : (01)GTIN(10)BATCH
def encodedData = java.net.URLEncoder.encode(rawData, "UTF-8");
message.setHeader("EncodedBarcodeData", encodedData);
return message;
}
Gestion des Erreurs Entreprise
Les intégrations robustes doivent gérer les jetons expirés ou les entrées de données invalides. Configurez votre **Exception Subprocess** d'iFlow pour capturer ces états :
HTTP 401 (Unauthorized)
Déclenchez le processus d'intégration locale "Auth" pour rafraîchir automatiquement le jeton Bearer.
HTTP 400 (Bad Request)
Loguez la charge utile dans le MPL (Message Processing Log) pour identifier les caractères GS1 illégaux.
Bonnes Pratiques d'Intégration
- Mise en cache : Stockez les jetons d'accès dans les variables BTP pour leur durée totale de 3600s.
- SVG plutôt que PNG : Utilisez le SVG pour l'interface Fiori afin de garantir une mise à l'échelle parfaite sur mobile.
- Paramètres DPI : Utilisez
dpi=600pour les petits codes DataMatrix 2D dans Adobe Forms. - API Management : Appliquez une politique de quota pour éviter la surexploitation de l'API lors des pics de traitement.
Accès instantané à Barcodesoft Cloud
Un abonnement fournit un accès illimité à la génération de GS1-128, QR Code, DataMatrix et Code 128 pour votre intégration SAP. Identifiants envoyés immédiatement par e-mail[cite: 3, 4].
Assistance Technique
Notre équipe d'ingénierie est spécialisée dans les scénarios SAP BTP, Integration Suite (CPI) et ABAP pour vous aider à résoudre vos intégrations complexes.
Contacter le SupportPrêt pour la Mise en Production ?
Accélérez votre projet avec nos modèles d'iFlow pré-configurés et nos listes de contrôle de déploiement pour la production.