{"id":15044832,"url":"https://github.com/devopsgroup-io/veeva","last_synced_at":"2025-10-24T14:31:20.235Z","repository":{"id":5561562,"uuid":"53438319","full_name":"devopsgroup-io/veeva","owner":"devopsgroup-io","description":":wrench: Veeva CLM Generator \u0026 Workflow for building iRep Presentations.","archived":false,"fork":false,"pushed_at":"2022-12-30T17:14:02.000Z","size":2839,"stargazers_count":45,"open_issues_count":25,"forks_count":32,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-04-14T12:38:45.625Z","etag":null,"topics":["automation","clm","edetailing","salesforce","vault","veeva","workflow"],"latest_commit_sha":null,"homepage":"https://devopsgroup.io","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devopsgroup-io.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-03-08T19:15:24.000Z","updated_at":"2023-10-20T03:52:08.000Z","dependencies_parsed_at":"2023-01-13T13:36:08.827Z","dependency_job_id":null,"html_url":"https://github.com/devopsgroup-io/veeva","commit_stats":null,"previous_names":[],"tags_count":40,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devopsgroup-io%2Fveeva","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devopsgroup-io%2Fveeva/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devopsgroup-io%2Fveeva/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devopsgroup-io%2Fveeva/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devopsgroup-io","download_url":"https://codeload.github.com/devopsgroup-io/veeva/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237982321,"owners_count":19397244,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","clm","edetailing","salesforce","vault","veeva","workflow"],"created_at":"2024-09-24T20:51:06.721Z","updated_at":"2025-10-24T14:31:10.224Z","avatar_url":"https://github.com/devopsgroup-io.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Veeva \n[![NPM version](https://img.shields.io/npm/v/veeva.svg)](https://www.npmjs.com/package/veeva) [![Build Status](https://img.shields.io/travis/devopsgroup-io/veeva.svg?branch=master)](https://travis-ci.org/devopsgroup-io/veeva)\n[![npm](https://img.shields.io/npm/dt/veeva.svg)]()\n\n\n\u003e This npm package was developed to centralize core functionality and worklfow processes for building Veeva iRep CLM Presentations. \n\nIf you're developing and managing several client Veeva CLM projects, then you know it's cumbersome to introduce new functionality (outside of content) \nwhen your code-base is inconsistent across multiple repositories.\n\n:link: [Veeva CLM Example](https://github.com/devopsgroup-io/veeva/tree/master/examples/clm)\n\n## Features\n\n* Define Veeva CLM presentations in one central `configuration.yml` file\n* Template and partial system using Assemble.io\n* SASS compilation\n* Relative link conversion to veeva: protocol links\n* Automatic screen shot, thumbnail, and zip file generation\n* iRep control file generator based on `configuration.yml` file\n* Vault Multichannel .CSV generator based on `configuration.yml` file\n* Development Mode: - Watch, rebuild, and reload Key Messages locally in your web browser\n\n\n**In This Documentation**\n\n1. [Getting Started](#getting-started)\n2. [File Structure](#file-structure)\n3. [Working with the Source Files](#working-with-the-source-files)\n4. [Options \u0026 Settings](#options-and-settings)\n5. [Gulp Tasks \u0026 Workflow](#gulp-tasks-and-workflow)\n6. [Troubleshooting \u0026 FAQ](#troubleshooting-and-faq)\n\n\n## Getting Started\n\n### Dependencies\n\nInstall the following prerequisites on your development machine.\n\n* [Node.js](http://nodejs.org)\n* [Gulp](http://gulpjs.com) `sudo npm install -g gulp`\n* [imagemagick](http://www.imagemagick.org/script/binary-releases.php) \n  * OSX: `brew install imagemagick`\n  * Ubuntu: `apt-get install imagemagick`\n  * Windows or other: [http://www.imagemagick.org/script/binary-releases.php](http://www.imagemagick.org/script/binary-releases.php) \n\n\n### Quick Start\n\n```\n$ npm install veeva --save\n```\n\n### Setup\nOnce the `npm install` has completed, the following file structure below will need to be placed into your project root directory. \nFor a complete working example, please reference [Veeva CLM Example](https://github.com/devopsgroup-io/veeva/tree/master/examples/clm)\n\n## File Structure\n\nAdd your files to the appropriate `app` sub directories. Gulp will process and compile them into `build`.\n\n**Notes**:\n* Key Message naming convention is set as the following: **product name**-**Key Message Name**\n\n```\nroot/\n|—— app/\n|   |—— assets/\n|   |   |—— scss/\n|   |   |—— js/\n|   |—— templates/\n|   |   |—— includes\n|   |   |—— layouts\n|   |   |—— pages\n|   |   |   |—— globals\n|   |   |   |   |—— fonts\n|   |   |   |   |—— images\n|   |   |   |   |—— isi.hbs\n|   |   |   |   |—— terms.hbs\n|   |   |   |—— veeva-home\n|   |   |   |   |—— images\n|   |   |   |   |—— veeva-home.hbs\n|   |   |   |—— veeva-overview\n|   |   |   |   |—— images\n|   |   |   |   |—— veeva-overview.hbs\n|   |   |   |—— veeva-resources\n|   |   |   |   |—— images\n|   |   |   |   |—— veeva-resources.hbs\n|   |   |   |—— veeva-sitemap\n|   |   |   |   |—— images\n|   |   |   |   |—— js\n|   |   |   |   |—— veeva-sitemap.hbs\n|\n|\n|—— configuration.yml\n|—— gulfile.js\n|—— package.json\n```\n\n## Working with the Source Files\n\n### Sass\n\nSass files are located in `app` \u003e `assets` \u003e `scss`. Gulp watches and generates minified and unminified CSS files.\n\n### JavaScript\n\nJavaScript files are located in the `app` \u003e `assets` \u003e `js` directory.\n\n### Assemble.io Templates\n\nTemplate files are located in the `app` \u003e `templates`.\n\n## Options and Settings\n\n### Configuration File\n\n[View full configuration.yml example](https://github.com/devopsgroup-io/veeva/tree/master/examples/clm/configuration.yml)\n\nInside `configuration.yml`, add Key Messages under the clm node.\n\n```yml\nclm:\n  product:\n  name: 'Product-Name'\n  suffix: '-'\n primary:\n  name: 'CLM-Presentation-ID'\n  key_messages:\n  - key_message: 'home'\n    description: 'Home'\n    display_order: '0'\n    slides:\n    - slide: 'home'\n      id: '0'\n  - key_message: 'overview'\n    description: 'Veeva Test Overview'\n    display_order: '1'\n    slides:\n    - slide: 'Veeva Test Overview'\n      id: '2-0'\n  - key_message: 'sitemap'\n    description: 'Sitemap'\n    display_order: '2'\n    slides:\n    - slide: 'Sitemap'\n      id: '0-1'\n```\n\n### Changing the Directory Structure\nInside `configuration.yml` you'll see a variable named `paths`. Adjust the paths to suit your workflow.\n\n``` yml\n\"paths\": {\n    \"src\": \"app\",\n    \"dist\": \"build\",\n    \"deploy\": \"deploy\",\n    \"tmp\": \"build/.tmp\",\n    \"pages\": \"app/templates/pages\",\n    \"layouts\": \"app/templates/layouts\"\n}\n```\n\n\n## Gulp Tasks and Workflow\n\nFor a quick reference in your terminal:\n\n```bash\n$ gulp --help\n\nUsage: gulp \u003ctask\u003e [options]\n\nTASKS\n_________________________________________________________________________\n$ gulp                      Default task that kicks off development mode\n$ gulp build                Build task\n$ gulp stage                Stage task\n$ gulp veeva-deploy         Deploy task\n$ gulp veeva-vault-stage    Generates a Veeva Vault Multichannel Loader .CSV file\n\nOPTIONS\n_________________________________________________________________________\n    -a --all-key-messages  Include hidden Key Messages when staging and deploying\n    -c --config            Show merged configuration\n    -d --dry-run           Do not touch or write anything, but show the commands and interactivity\n    -e --debug             Output exceptions\n    -h --help              Print this help\n    -k --key-message       Build, Stage, and Deploy single Key Message\n    -v --version           Print version number\n    -V --verbose           Verbose output\n```\n\n```bash\n$ gulp\n```\nRuns the following workflow:\n* Assembles template files\n* Compiles Sass files\n* Copies project JS files\n* Copies the Veeva module JS dependencies\n* Copies images\n* Starts browserSync, watches for changes, and reloads browser when file changes are triggered\n\n```bash\n$ gulp build\n```\nRuns the following workflow:\n* Assembles template files\n* Compiles Sass files and minifies CSS\n* Uglfies project JS files\n* Copies the Veeva module JS dependencies\n* Copies images\n* Generates Veeva required thumbnails per Key Message\n* Enables **deploy mode**\n  * Converts relative links to Veeva protocol links (Navigation, Click Stream events, etc.)\n\n```bash\n$ gulp stage\n```\nRuns the following workflow:\n* Runs the **gulp build** process\n* Generates individual Key Message zip files and places them into the `deploy` directory\n* Creates individual Key Message ctl files based on `configuration.yml` file details and places them into the `deploy` directory\n\n```bash\n$ gulp veeva-deploy\n```\n**Note:** this process uses FTP information stored in the `configuration.yml` file\nRuns the following workflow:\n* Uploads all `.zip` files sitting in the `deploy` directory\n* Once all of the `.zip` files have been uploaded, all `.ctl` files sitting in the `deploy` directory are then uploaded\n\n```bash\n$ gulp veeva-vault-stage\n```\nRuns the following workflow:\n* Generates a Veeva Vault Multichannel Loader `.csv` file based on `configuration.yml` details\n\n\n\n## Notes\n\n* Generated thumbnails (screen shots) only process .html files, so static Key Messages (i.e., pdf) will still need to have Veeva required thumbnails generated\n\n## Troubleshooting\n\nIf you're having issues with the Veeva Node Package, submit a [submit a GitHub Issue](https://github.com/devopsgroup-io/veeva/issues/new).\n\n* Ensure you're running the correct node and npm versions specified in the package.json file\n* Make sure your configuration.yml file exists and is well formatted\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevopsgroup-io%2Fveeva","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevopsgroup-io%2Fveeva","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevopsgroup-io%2Fveeva/lists"}