:Annexe : Bibliothèque d'exemples DataWorks Open Platform

Installez le Java Development Kit (JDK).

Pour installer le JDK, rendez-vous sur le site officiel d'Oracle et téléchargez la version du JDK compatible avec votre système d'exploitation.

Installez Maven.

Maven est un outil de gestion de projet Java. Rendez-vous sur le site officiel de Maven et téléchargez le package compatible avec votre système d'exploitation. Après le téléchargement, suivez les instructions de la page Installing Apache Maven pour décompresser le package et installer Maven.

Installez Node.js.

Cet exemple utilise une interface frontend. Vous devez donc installer l'environnement Node.js sur le client pour exécuter le code JavaScript. Pour installer l'environnement Node.js, rendez-vous sur le site officiel de Node.js et téléchargez l'environnement approprié.

Installez pnpm.

pnpm est un gestionnaire de packages pour les projets JavaScript. Dans cet exemple, la bibliothèque d'exemples utilise le mode workspace pour éviter l'envoi des composants courants vers npm. Vous devez donc installer pnpm. Cliquez sur Installation pour installer l'outil pnpm. Si Node.js est déjà installé, exécutez la commande suivante pour installer pnpm :

npm install -g pnpm

Vérifiez l'environnement de développement.

Après avoir effectué les étapes précédentes, exécutez les commandes suivantes pour vérifier que les environnements requis pour cet exemple sont bien installés :

java -version // If JDK is installed, the command output shows the JDK version. Otherwise, the "command not found" error is reported. 
mvn -v // If Maven is installed, the command output shows the Maven version. Otherwise, the "command not found" error is reported. 
npm -v // If Node.js is installed, the command output shows the Node.js version. Otherwise, the "command not found" error is reported. 
pnpm -v // If pnpm is installed, the command output shows the pnpm version. Otherwise, the "command not found" error is reported.

Installez les dépendances.

Une fois l'environnement de développement prêt, téléchargez le projet d'exemple sur votre machine locale et exécutez le code suivant pour installer les dépendances :

pnpm install

Saisissez votre AccessKey ID et votre AccessKey secret.

Une fois l'installation terminée, localisez le fichier de configuration application.properties dans le répertoire racine. Dans ce fichier, spécifiez les informations clés telles que l'Access Key (AK), la Secret Key (SK), le Region-id et l'endpoint. Ces informations seront lues et synchronisées avec chaque application d'exemple au démarrage du projet.

## The AccessKey ID of a RAM user.
api.access-key-id={access-key}

## The AccessKey secret of a RAM user.
api.access-key-secret={secret-key}

## The ID of the region where the DataWorks service is deployed. Sample values: cn-shanghai and cn-hangzhou.
# api.region-id=cn-hangzhou
api.region-id={regionId}

## The service of DataWorks API operations. The default value is dataworks-public.
api.product=dataworks-public

## The endpoint of DataWorks OpenAPI.
## If DataWorks OpenAPI is accessed over the Internet, the endpoint is in the format of dataworks.${regionId}.aliyuncs.com. By default, DataWorks OpenAPI is accessed over the Internet.
## If DataWorks OpenAPI is accessed over a virtual private cloud (VPC), the endpoint is in the format of dataworks-vpc.${regionId}.aliyuncs.com.
# api.endpoint=dataworks.cn-hangzhou.aliyuncs.com
api.endpoint={endpoint}

## Specify the network environment. For access over the Internet, set the parameter to false. For access over a VPC, set the parameter to true.
api.vpc-env=false

Exécutez le code d'exemple.

Une fois les configurations précédentes effectuées, exécutez les commandes suivantes pour lancer le code d'exemple.

npm run example:workbench-screen // Execute the sample code for Operation Center.
npm run example:meta-api // Execute the sample code for metadata.
npm run example:event-instance-status // Execute the sample code for subscribing to the status change events of an auto triggered node instance.
npm run example:extension-maxpt // Execute the sample code for prohibiting the use of the MAX_PT function.
npm run example:extension-deploy-control // Execute the sample code for configuring the settings in DataWorks Open Platform to perform a lockdown.

Consultez le résultat de l'exécution.

Après l'exécution du code, visualisez les résultats dans un navigateur web.

• Pour un exemple disposant d'une interface frontend interactive, accédez à la page via l'URL suivante :

  https://localhost:8080

• Pour un exemple backend uniquement, accédez au backend via l'URL suivante :

  http://localhost:8008