1.1.1 • Published 4 years ago

veeva v1.1.1

Weekly downloads
18
License
MIT
Repository
github
Last release
4 years ago

Veeva

NPM version Build Status dependencies

Warning: This module is still in alpha and is not 100% ready for use.

This npm package was developed to centralize core functionality and worklfow processes for building Veeva iRep CLM Presentations.

If you're developing and managing several client Veeva CLM projects, then you know it's cumbersome to introduce new functionality (outside of content) when your code-base is inconsistent across multiple repositories.

:link: Veeva CLM Example

Features

  • Define Veeva CLM presentations in one central configuration.yml file
  • Template and partial system using Assemble.io
  • SASS compilation
  • Relative link conversion to veeva: protocol links
  • Automatic screen shot, thumbnail, and zip file generation
  • iRep control file generator based on configuration.yml file
  • Vault Multichannel .CSV generator based on configuration.yml file
  • Development Mode: - Watch, rebuild, and reload Key Messages locally in your web browser

In This Documentation

  1. Getting Started
  2. File Structure
  3. Working with the Source Files
  4. Options & Settings
  5. Veeva Tasks & Workflow
  6. Troubleshooting & FAQ

Getting Started

Dependencies

Install the following prerequisites on your development machine.

Quick Start

$ npm install veeva --save

Setup

Once the npm install has completed, the following file structure below will need to be placed into your project root directory. For a complete working example, please reference Veeva CLM Example

File Structure

Add your files to the appropriate app sub directories. Veeva module will process and compile them into build.

Notes:

  • Key Message naming convention is set as the following: product name-Key Message Name
root/
|—— app/
|   |—— assets/
|   |   |—— scss/
|   |   |—— js/
|   |—— templates/
|   |   |—— includes
|   |   |—— layouts
|   |   |—— pages
|   |   |   |—— globals
|   |   |   |   |—— fonts
|   |   |   |   |—— images
|   |   |   |   |—— isi.hbs
|   |   |   |   |—— terms.hbs
|   |   |   |—— veeva-home
|   |   |   |   |—— images
|   |   |   |   |—— veeva-home.hbs
|   |   |   |—— veeva-overview
|   |   |   |   |—— images
|   |   |   |   |—— veeva-overview.hbs
|   |   |   |—— veeva-resources
|   |   |   |   |—— images
|   |   |   |   |—— veeva-resources.hbs
|   |   |   |—— veeva-sitemap
|   |   |   |   |—— images
|   |   |   |   |—— js
|   |   |   |   |—— veeva-sitemap.hbs
|
|
|—— configuration.yml
|—— gulfile.js
|—— package.json

Working with the Source Files

Sass

Sass files are located in app > assets > scss. Veeva module watches and generates minified and unminified CSS files.

JavaScript

JavaScript files are located in the app > assets > js directory.

Assemble.io Templates

Template files are located in the app > templates.

Assemble Helpers

Options and Settings

Configuration File

View full configuration.yml example

Inside configuration.yml, add Key Messages under the clm node.

clm:
  product:
  name: 'Product-Name'
  suffix: '-'
 primary:
  name: 'CLM-Presentation-ID'
  key_messages:
  - key_message: 'home'
    description: 'Home'
    display_order: '0'
    slides:
    - slide: 'home'
      id: '0'
  - key_message: 'overview'
    description: 'Veeva Test Overview'
    display_order: '1'
    slides:
    - slide: 'Veeva Test Overview'
      id: '2-0'
  - key_message: 'sitemap'
    description: 'Sitemap'
    display_order: '2'
    slides:
    - slide: 'Sitemap'
      id: '0-1'

Changing the Directory Structure

Inside configuration.yml you'll see a variable named paths. Adjust the paths to suit your workflow.

"paths": {
    "src": "app",
    "dist": "build",
    "deploy": "deploy",
    "tmp": "build/.tmp",
    "pages": "app/templates/pages",
    "layouts": "app/templates/layouts"
}

Veeva Tasks and Workflow

For a quick reference in your terminal:

$ veeva --help

Usage: veeva <task> [options]

TASKS
_________________________________________________________________________
$ veeva                     Default task that kicks off development mode
$ veeva build               Build task
$ veeva stage               Stage task
$ veeva deploy              Deploy task
$ veeva vault-stage         Generates a Veeva Vault Multichannel Loader .CSV file

OPTIONS
_________________________________________________________________________
    -a --all-key-messages  Include hidden Key Messages when staging and deploying
    -c --config            Show merged configuration
    -d --dry-run           Do not touch or write anything, but show the commands and interactivity
    -e --debug             Output exceptions
    -h --help              Print this help
    -k --key-message       Build, Stage, and Deploy single Key Message
    -v --version           Print version number
    -V --verbose           Verbose output
$ veeva

Runs the following workflow:

  • Assembles template files
  • Compiles Sass files
  • Copies project JS files
  • Copies the Veeva module JS dependencies
  • Copies images
  • Starts browserSync, watches for changes, and reloads browser when file changes are triggered
$ veeva build

Runs the following workflow:

  • Assembles template files
  • Compiles Sass files and minifies CSS
  • Uglfies project JS files
  • Copies the Veeva module JS dependencies
  • Copies images
  • Generates Veeva required thumbnails per Key Message
  • Enables deploy mode
    • Converts relative links to Veeva protocol links (Navigation, Click Stream events, etc.)
$ veeva stage

Runs the following workflow:

  • Runs the veeva build process
  • Generates individual Key Message zip files and places them into the deploy directory
  • Creates individual Key Message ctl files based on configuration.yml file details and places them into the deploy directory
$ veeva deploy

Note: this process uses FTP information stored in the configuration.yml file Runs the following workflow:

  • Uploads all .zip files sitting in the deploy directory
  • Once all of the .zip files have been uploaded, all .ctl files sitting in the deploy directory are then uploaded
$ veeva vault-stage

Runs the following workflow:

  • Generates a Veeva Vault Multichannel Loader .csv file based on configuration.yml details

Notes

  • Generated thumbnails (screen shots) only process .html files, so static Key Messages (i.e., pdf) will still need to have Veeva required thumbnails generated

Troubleshooting

If you're having issues with the Veeva Node Package, submit a submit a GitHub Issue.

  • Ensure you're running the correct node and npm versions specified in the package.json file
  • Make sure your configuration.yml file exists and is well formatted
2.0.0-alpha.10

4 years ago

2.0.0-alpha.9

5 years ago

2.0.0-alpha.8

5 years ago

2.0.0-alpha.7

6 years ago

2.0.0-alpha.6

6 years ago

1.1.1

6 years ago

1.1.0

6 years ago

2.0.0-alpha.5

6 years ago

2.0.0-alpha.4

6 years ago

2.0.0-alpha.3

7 years ago

2.0.0-alpha.2

7 years ago

1.0.0

8 years ago

0.28.0

8 years ago

0.27.0

9 years ago

0.26.0

9 years ago

0.25.6

9 years ago

0.25.5

9 years ago

0.25.4

9 years ago

0.25.3

9 years ago

0.25.2

9 years ago

0.25.1

9 years ago

0.25.0

9 years ago

0.24.0

9 years ago

0.23.7

9 years ago

0.23.6

9 years ago

0.23.5

9 years ago

0.23.4

9 years ago

0.23.3

9 years ago

0.23.2

9 years ago

0.23.1

9 years ago

0.23.0

9 years ago

0.22.3

9 years ago

0.22.1

9 years ago

0.22.0

9 years ago

0.21.0

9 years ago

0.20.0

9 years ago